Skip to content

CloudCannon/aviator-jekyll-template

Repository files navigation

Aviator [ LEGACY TEMPLATE NO LONGER MAINTAINED ]

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, themes and step-by-step Jekyll tutorials at CloudCannon Academy.

Deploy to CloudCannon

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.7.2, 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_number field in collection configuration in _config.yml.
  • Set the order of the documents inside a collection by setting the position_number in front matter.

Search

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