Aglio Default Theme
$ sudo npm install -g aglio
$ aglio -i blueprint.apib -o MyAPI.html
Theme engines for Aglio are described in more detail in the Aglio documentation.
Olio is designed from the ground up to be both fast and extensible while maintaining backward compatibility with most of the original Aglio theme. It uses the following technologies:
- Less to produce CSS
- Markdown-it to render Markdown
- Jade to produce HTML
- Highlight.js to highlight code snippets
For backward compatibility, Jade templates can continue to use inline Stylus and CoffeeScript.
Olio comes with a handful of configurable theme options. These are set via the
--theme-XXX parameter, where
XXX is one of the following:
|Whether to condense nagivation for resources with only a single action (default is
|Whether to use the full page width or a responsive layout (default is responsive).
|LESS or CSS to control the layout and style of the document using the variables from below. Can be a path to your own file or one of the following presets:
default. May be an array of paths and/or presets.
|Jade template to render HTML. Can be a path to your own file or one of the following presets:
|LESS variables that control theme colors, fonts, and spacing. Can be a path to your own file or one of the following presets:
cyborg. May be an array of paths and/or presets.
Olio makes use of aggressive caching whenever it can, which means that rendering HTML can be blazing fast. Benchmark taken on a 2015 Macbook Pro via
BENCHMARK=1 aglio -i example.apib -o example.html:
|Parse API Blueprint
Copyright © 2016 Daniel G. Taylor