doc42

doc42

Jekyll-Kissui bundle to create awesome documentations

Doc42

Doc42 is a Jekyll and Kissui starter kit to create awesome documentations.

Kissui + Markdown = :rocket:

Installation

Before you start, make sure you have Jekyll installed. Read here for a quick installtion.

After installing Jekyll, clone or download this repo, open Terminal, cd to the doc42 folder and run:

jekyll server

Note: it's better to clone this repo instead of download the content. This way, you can always update the repo with a git pull command.

Adding, updating and removing docs

All documentation pages go under the /docs folder. Create folders under the /docs and put pages there:

Example:

/docs
   |- basics
        |- elements.html
   |- applications
        |- helloworld.html
   |- faq
        |- index.html

Each page can define this parameters:

  • layout
  • title
  • categories
  • permalink

Example:

layout: doc
title: Typography
categories: basics
permalink: /docs/basics/typography/

Details

What is Kissui?

Kissui is a web development kit. It has a lot of fancy features to create an awesome web app.

What is Jekyll?

Transform your plain text into static websites and blogs.

Jekyll is a platform to convert Markdown to HTML. It doesn't have any database and stores all data on a Git repo.

What doc42 means?

Doc means documentations and 42 is the answer to everything. Read more here.

Author

Afshin Mehrabani

License

MIT