go
/
gvisor
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
gvisor/themes/docsy
History
Ian Lewis c010346c76 Updated docsy to HEAD 
- Docsy has support for the _styles_project.scss file now so we don't need
  to override main.scss anymore.
- Docsy doc edit links now work for non-multilingual sites so we don't
  need to override page-meta-links.html anymore.
 		2019-04-23 11:51:39 +09:00
..
assets Updated docsy to HEAD 2019-04-23 11:51:39 +09:00
i18n Initial commit 2019-03-29 22:40:11 -04:00
layouts Updated docsy to HEAD 2019-04-23 11:51:39 +09:00
static Updated docsy to HEAD 2019-04-23 11:51:39 +09:00
.gitignore Initial commit 2019-03-29 22:40:11 -04:00
.s3deploy.yml Initial commit 2019-03-29 22:40:11 -04:00
CONTRIBUTING.md Initial commit 2019-03-29 22:40:11 -04:00
LICENSE Initial commit 2019-03-29 22:40:11 -04:00
README.md Initial commit 2019-03-29 22:40:11 -04:00
config.toml Initial commit 2019-03-29 22:40:11 -04:00
postcss.config.js Initial commit 2019-03-29 22:40:11 -04:00

README.md

Docsy

Docsy is a Hugo theme for technical documentation sets, providing simple navigation, site structure, and more.

You can find an example project that uses Docsy in the Docsy Example Project repo. The Docsy Example Project is hosted at https://testydocsy.netlify.com/, where you can find detailed theme instructions under Documentation -> Getting Started.

To use the Docsy 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, or
  • 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.

This is not an officially supported Google product. This project is currently maintained.

Installation and prerequisites

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

Theme documentation

Detailed documentation for this theme is in the Docsy Example Project under Documentation -> Getting Started. The Docsy Example Project is on GitHub and is hosted at https://testydocsy.netlify.com/.