Docsy is a Hugo theme for technical documentation sets, providing simple navigation, site structure, and more.
You can find an example site project that uses Docsy in Docsy-Example. To use the Docsy Hugo theme, you can either:
- Copy and edit the example site’s repo, which will also give you a skeleton structure for your top-level and documentation sections.
- Specify the Docsy theme like any other Hugo theme. when creating or updating your site. This gives you all the theme-y goodness but you’ll need to specify your own site structure.
You need a recent version of Hugo to build sites using this theme (preferably 0.45+). If you install from the release page, make sure to get the extended Hugo version which supports SCSS. Alternatively, on macOS you can install Hugo via Brew.
If you want to do stylesheet changes, you will also need PostCSS to create the final assets. You can also install it locally with:
npm install
To use a local version of the theme files, clone the repo using:
git clone --recurse-submodules --depth 1 https://github.com/google/docsy.git
Detailed documentation for this theme is in the Docsy example site under Documentation - Getting Started.