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.
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.
For hosting on your local network, inside a docker container, install
docker-compose and run,
$ docker-compose up -d
This container is built upon on alpine based ruby image. There's an official Jekyll image available in docker hub which only support
amd64images. 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
The theme is available as open source under the terms of the MIT License.