DocuAPI is a beautiful multilingual API documentation theme for Hugo. This theme is built on top of the beautiful work of Robert Lord and others on the Slate project (Apache 2 License). The JS part has recently been rewritten from Jquery to AlpineJS.

Visit the demo site.

Use

Import the theme in your Hugo config:

[[module.imports]]
path = "github.com/bep/docuapi/v2"

Note, if you want the older jQuery-versjon, replace the path with

github.com/bep/docuapi

If you want to edit the SCSS styles, you need:

• The extended Hugo version.
• PostCSS CLI (run

  npm install

  to install requirements)

See the exampleSite and more specific its site configuration for the available options.

Most notable: This theme will use all the (non drafts) pages in the site and build a single-page API documentation. Using

weight

If you want a different page selection, please provide your own

layouts/index.html

You can customize the look-and-feel by adding your own CSS variables in

assets/scss/docuapi_overrides.scss

Hooks

You can override the layouts by providing some custom partials:

• partials/hook_head_end.html

  is inserted right before the

  head

  end tag. Useful for additional styles etc.

• partials/hook_body_end.html

  which should be clear by its name.

• partials/hook_left_sidebar_start.html

  the start of the left sidebar

• partials/hook_left_sidebar_end.html

  the end of the left sidebar

• partials/hook_left_sidebar_logo.html

  the log

  img

  source

The styles and Javascript import are also put in each partial and as such can be overridden if really needed:

• partials/styles.html

• partials/js.html