This is a starter template for an open bases jekyll theme, based on these two previous arts:
The goal is that the documentation, although being hosted in a different repository,
looks like the main Open Bases documentation.
In that any repository can render documentation alongside code in the "docs" folder
github-pages branch if you prefer) it's a reasonable strategy to, for each
repository, copy this template into a folder called "docs" and customize the
_config.yml and documentation in the pages folder
You can clone the repository right to where you want to host the docs:
git clone https://github.com/openbases/openbases-jekyll-theme.git docs
You likely will want to use this theme to build directly on Github Pages for your
Open Bases component. This means editing the
_config.yml and documentation in the _pages folder
as appropriate. You define urls based on the
permalink attribute in your pages,
and then add them to the navigation by adding to the content of _data/toc.myl.
Most of the configuration values in the _config.yml are self explanatory, but we can describe a few here if it's helpful.
- Fixed Navigation
Depending on how you installed jekyll:
bundle exec jekyll serve