Skip to content
/ mkdocs-jekyll Public template

The Material theme from MkDocs provided as a Jekyll template, optimized for GitHub Pages

License

Notifications You must be signed in to change notification settings

vsoch/mkdocs-jekyll

Repository files navigation

MkDocs Jekyll Theme

CircleCI

https://raw.githubusercontent.com/vsoch/mkdocs-jekyll/master/assets/img/mkdocs-jekyll.png

This is a starter template for a mkdocs jekyll theme, based on these two previous arts:

Usage

1. Get the code

You can clone the repository right to where you want to host the docs:

git clone https://github.com/vsoch/mkdocs-jekyll.git docs
cd docs

2. Customize

To edit configuration values, customize the _config.yml. To add pages, write them into the pages folder. 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.

3. Options

Most of the configuration values in the _config.yml are self explanatory, and for more details, see the about page rendered on the site.

4. Serve

Depending on how you installed jekyll:

jekyll serve
# or
bundle exec jekyll serve