org-mode + org-roam + Hugo + GitLabs

org-mode + org-roam + Hugo + GitLabs

1. https://docs.gitlab.com/ee/tutorials/hugo/
2. https://gitlab.com/pages/hugo

1. org to md

Done using ox-hugo

2. create a project from hugo template in gitlab

Clone the project into computer. Run it and test it.

3. publishing md to website

1. When you are happy with it, push the changes to gitlab.
2. Run the pipeline in gitlab.
3. Look at the live version of the website:
4. https://<your-namespace>.gitlab.io/<project-name>
5. https://explorer436.gitlab.io/personal-wiki/ (If you don’t share the website publicly, only you can see the website)

4. list of things to validate

Look at the things from “Things to consider when considering a publishing option for the org pages”

5. Issues encountered

1. Working with images seems to be a nightmare. I couldn’t get it to work. The way that hugo exports the line of code to import images and the way that the html pages try to read images from that generated line of code did not work. Since, there are so many steps involved between the org file and the final html file, it is not easy to implement a simple fix for it.
2. The org documents in the computer work with one form of file paths and that does not work well with Hugo’s expectations. It is difficult to manage the expectations between org-mode and ox-hugo and Hugo.