README.md

tothlp's digital garden

A Digital Garden (see here) built with Jekyll Garden theme.

Jekyll Garden theme lets you publish your Obsidian vault (or a subset of it) as a Jekyll static website. The theme is markdown and Obsidian setup friendly. You can use your own server or Github page to set up your SSG. Check out the demo.

Credits & Thanks

• See Credits page

Additional resources

• https://tomcritchlow.com/2019/02/17/building-digital-garden/
• https://maggieappleton.com/garden-history
• https://hiran.in/index.html
• https://github.com/readme/guides/private-documentation

Contribution

To set up your environment to develop this theme, run bundle install after cloning this repository in your local machine.

Your theme is set up just like a normal Jekyll site! To test your theme, run bundle exec jekyll serve and open your browser at http://localhost:4000. This starts a Jekyll server using your theme. _notes contain all atomic notes. If you want to use this for blog, add posts inside _posts folder, following standard Jekyll frontamtter.

Hosting in a Docker Container

For hosting on your local network, inside a docker container, install docker and docker-compose and run,

$ docker-compose up -d

Note:-

This container is built upon on alpine based ruby image. There's an official Jekyll image available in docker hub which only support amd64 images. You can opt to use that if you are running the container on an 64bit PC. If you want to run this on an ARM based system like Raspberry Pi, this would be a better option.

The directories which will be frequently modified, are mapped as local volumes so that any changes made to those will be immediately picked up by the server and built. If you fancy changing content in other folders regularly, feel free to add them to the volumes section in docker-compose.yml before deploying.