Need help with docuapi?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

bep
539 Stars 173 Forks Other 134 Commits 14 Opened issues

Description

Beautiful multilingual API documentation theme for Hugo

Services available

!
?

Need anything else?

Contributors list

# 138
Go
hugo
static-...
travis
114 commits
# 28,583
Terrafo...
golang
terrafo...
jira
4 commits
# 451
Algolia
CSS
html5
ruby-ge...
3 commits
# 15,995
coffees...
Atom
travis
helm-ch...
2 commits
# 24,139
hugo
hugo-th...
Shell
content...
1 commit
# 75,971
GraphQL
ico
gekko
Shell
1 commit
# 232,428
vhdl
Shell
Ada
gcc
1 commit
# 55,644
hugo
Shell
mjml
email-b...
1 commit
# 571,161
HTML
JavaScr...
1 commit
# 553
PHPUnit
HTML
Shell
Ruby
1 commit

Netlify Status

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.


Screenshot DocuAPI Example 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
in the page front matter is the easiest way to control page order.

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

layouts/index.html
template.

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

assets/scss/docuapi_overrides.scss
. See the exampleSite folder for an example.

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

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.