Tired of long and unmanageable single-page READMEs deployed as your project's documentation? This minimal Jekyll project template is specifically intended for simple static documentation sites deployable on GitHub Pages.

The template follows a very simple convention of defining categories that correspond to sections in the navigation. Here are the default ones (they are listed in the _config.yml):

  • doc - Documentation
  • ref - Reference
  • tut - Tutorial
  • dev - Developers
  • post - Posts

Start by creating a new post one of the categories listed in _config.yml. It will appear in the navigation on the left once recompiled. Or use the supplied script to make creating pages easier:

ruby bin/jekyll-page "Some Page Title" ref

Read more Usage page for more details or view the project on GitHub