💧 API Documentation template for Jekyll
CSS JavaScript HTML Ruby
Latest commit 391e7ff Dec 2, 2016 Mike Neumegen site icon

readme.md

Aviator

API documentation template for Jekyll. Browse through a live demo. Start documenting your API with this configurable theme.

Aviator template screenshot

Aviator was made by CloudCannon, the Cloud CMS for Jekyll. Find more templates and themes at Jekyll Tips.

Learn Jekyll with step-by-step tutorials and videos at Jekyll Tips.

Features

  • Three column layout
  • Fully responsive
  • Full text search
  • Pre-styled components
  • Auto-generated navigation based on category
  • Optimised for editing in CloudCannon
  • SEO tags
  • Google Analytics

Setup

  1. Add your site and author details in _config.yml.
  2. Get a workflow going to see your site's output (with CloudCannon or Jekyll locally).

Develop

Aviator was built with Jekyll version 3.1.6, but should support newer versions as well.

Install the dependencies with Bundler:

$ bundle install

Run jekyll commands through Bundler to ensure you're using the right versions:

$ bundle exec jekyll serve

Editing

Aviator is already optimised for adding, updating and removing documentation pages in CloudCannon.

Usage

  • Each section is a different collection, this helps organise your content.
  • Set the order of the collections with the position field in collection configuration in _config.yml.
  • Set the order of the documents inside a collection by setting the position in front matter.

Search

  • Add excluded_in_search: true to any documentation page's front matter to exclude that page in the search results.