Skip to main content

Aglio backend for Foliant documentation generator.

Project description

Aglio Backend for Foliant

Aglio backend generates API documentation from API Blueprint using aglio renderer.

This backend operates the site target.

Note, that aglio is designed to render API Blueprint documents. Blueprint syntax is very close to that of Markdown and you may be tempted to use this backend as a general purpose static site generator, which may work in some cases, but is not guaranteed to work in all of them.


$ pip install foliantcontrib.aglio


To use this backend aglio should be installed in your system. Follow the instruction in aglio repo.

To test if you've installed aglio properly run the aglio -h command, which should return you a list of options.

To generate a static website from your Foliant project run the following command:

$ foliant make site --with aglio
Parsing config... Done
Making site...
Result: My_Awesome_Project.aglio


You don't have to put anything in the config to use aglio backend. If it's installed, Foliant detects it.

To customize the output, use options in backend_config.aglio section:

    aglio_path: aglio
        theme-variables: flatly
        fullWidth: True

aglio_path : Path to the aglio binary. Default: aglio

params : Parameters which will be supplied to the aglio command. To get the list of possible parameters, run aglio -h or check the official docs.

Customizing output


You can customize the appearence of the static website build by aglio with Jade templates. Aglio has two built-in templates:

  • default — two-column web-page;
  • triple — three-column web-page.

To add your own template, follow the instructions in the official docs.

To specify the template add the theme-template field to the params option:

        theme-template: triple

Color scheme

You can customize the color scheme of the website by specifying the color scheme name in theme-variables param.

Available built-in color schemes:

  • default,
  • cyborg,
  • flatly,
  • slate,
  • streak.

You can also specify your own scheme in a LESS or CSS file.

        theme-variables: flatly


Finally, you can provide custom stylesheets in a LESS or CSS file in theme-style param:

        theme-style: !path my-style.less

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

foliantcontrib.aglio-1.0.0.tar.gz (4.5 kB view hashes)

Uploaded Source

Built Distribution

foliantcontrib.aglio-1.0.0-py3-none-any.whl (5.3 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page