blob: f61eff67cf03ebe268176c7e1feeb12dbf68799f (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
|
# 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](https://github.com/google/docsy-example). The Docsy Example Project is hosted at [https://testydocsy.netlify.com/](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](https://gohugo.io/themes/installing-and-using-themes/)
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](https://github.com/gohugoio/hugo/releases), 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](https://github.com/google/docsy-example) and is hosted at [https://testydocsy.netlify.com/](https://testydocsy.netlify.com/).
|
