Skip to content

CloudCannon/aviator-jekyll-template

Folders and files

NameName
Last commit message
Last commit date

Latest commit

1063442 Â· Sep 26, 2023

History

68 Commits
Dec 1, 2022
Aug 21, 2019
Aug 21, 2019
Aug 21, 2019
Feb 21, 2018
Feb 6, 2018
Jan 24, 2018
Jan 24, 2018
Mar 22, 2018
Jan 28, 2015
Feb 6, 2018
Feb 6, 2018
Jul 22, 2016
Sep 26, 2023
Aug 21, 2019
Dec 1, 2016
Dec 1, 2016
Aug 21, 2019
Aug 1, 2022
Feb 18, 2018
Jan 24, 2018
Dec 1, 2016
Dec 1, 2016

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.