https://github.com/davbree/nervous-broccoli

Jamstack site created with Stackbit
https://github.com/davbree/nervous-broccoli

git headless hugo jamstack ssg stackbit static

Last synced: 8 months ago
JSON representation

Jamstack site created with Stackbit

• Host: GitHub
• URL: https://github.com/davbree/nervous-broccoli
• Owner: davbree
• License: other
• Created: 2020-12-07T15:57:14.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2020-12-07T15:57:21.000Z (over 5 years ago)
• Last Synced: 2025-03-24T08:49:55.986Z (about 1 year ago)
• Topics: git, headless, hugo, jamstack, ssg, stackbit, static
• Language: HTML
• Homepage: https://jamstack.new
• Size: 173 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE.md

Awesome Lists containing this project

README

          
[![Netlify Status](https://api.netlify.com/api/v1/badges/49111249-0a1a-4b5a-a3ab-45d00732fdb3/deploy-status)](https://app.netlify.com/sites/docuapi/deploys)

**DocuAPI** is a beautiful multilingual API documentation theme for [Hugo](http://gohugo.io/). This theme is built on top of the beautiful work of [Robert Lord](https://github.com/lord) and others on the [Slate](https://github.com/slatedocs/slate) project ([Apache 2 License](https://github.com/slatedocs/slate/blob/master/LICENSE)).




> Visit the [demo site](https://docuapi.netlify.com/).




![Screenshot DocuAPI Example site](https://raw.githubusercontent.com/bep/docuapi/master/images/screenshot.png)

## Use

The client library used to build the ToC does not handle Unicode very well. To get around this in Hugo >= 0.62.2, put this in your site config:

```toml

[markup]

  [markup.goldmark]

    [markup.goldmark.parser]

      autoHeadingIDType = "github-ascii"

```

**Note:** this theme requires Hugo >= 0.56.0 to run. 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](https://github.com/bep/docuapi/tree/master/exampleSite) and more specific its site [configuration](https://github.com/bep/docuapi/blob/master/exampleSite/config.toml) 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`