diff options
author | Ian Lewis <ianmlewis@gmail.com> | 2019-10-18 00:19:24 -0400 |
---|---|---|
committer | Ian Lewis <ianlewis@google.com> | 2019-11-13 13:03:16 -0800 |
commit | a2b055de52cb90180ad57c26119fe72e61d70494 (patch) | |
tree | a156c39ba5e044fa42600a6c2d7ddd7dd91c350c /themes/docsy/userguide/README.md | |
parent | cf5b8ec088eac99ede97a6c9e381485695638dee (diff) |
Updated to Docsy HEAD
This updates the vendored docsy to https://github.com/google/docsy/tree/1a09abe6d7eaf02e44f79de3eadf8178a3792e81
Diffstat (limited to 'themes/docsy/userguide/README.md')
-rw-r--r-- | themes/docsy/userguide/README.md | 58 |
1 files changed, 58 insertions, 0 deletions
diff --git a/themes/docsy/userguide/README.md b/themes/docsy/userguide/README.md new file mode 100644 index 000000000..9a6db02b0 --- /dev/null +++ b/themes/docsy/userguide/README.md @@ -0,0 +1,58 @@ +[Docsy](https://github.com/google/docsy) is a Hugo theme for technical documentation sites, providing easy site navigation, structure, and more. This **Docsy Example Project** uses the Docsy theme, as well as providing a skeleton documentation structure for you to use. You can either copy this project and edit it with your own content, or use the theme in your projects like any other [Hugo theme](https://gohugo.io/themes/installing-and-using-themes/). + +This Docsy Example Project is hosted at [https://testydocsy.netlify.com/](https://testydocsy.netlify.com/). + +You can find detailed theme instructions in the example project under **Documentation -> Getting Started**. + +This is not an officially supported Google product. This project is currently maintained. + +## Cloning the Docsy Example Project + +The following will give you a project that is set up and ready to use (don't forget to use `--recurse-submodules` or you won't pull down some of the code you need to generate a working site). The `hugo server` command builds and serves the site. If you just want to build the site, run `hugo` instead. + +```bash +git clone --recurse-submodules --depth 1 https://github.com/google/docsy-example.git +cd docsy-example +hugo server +``` + +The theme is included as a Git submodule: + +```bash +▶ git submodule + a053131a4ebf6a59e4e8834a42368e248d98c01d themes/docsy (heads/master) +``` + +If you want to do SCSS edits and want to publish these, you need to install `PostCSS` (not needed for `hugo server`): + +```bash +npm install +``` + +<!--### Cloning the Example from the Theme Project + + +```bash +git clone --recurse-submodules --depth 1 https://github.com/docsy.git +cd tech-doc-hugo-theme/exampleSite +HUGO_THEMESDIR="../.." hugo server +``` + + +Note that the Hugo Theme Site requires the `exampleSite` to live in a subfolder of the theme itself. To avoid recursive duplication, the example site is added as a Git subtree: + +```bash +git subtree add --prefix exampleSite https://github.com/google/docsy.git master --squash +``` + +To pull in changes, see `pull-deps.sh` script in the theme.--> + +## Running the website locally + +Once you've cloned the site repo, from the repo root folder, run: + +``` +hugo server +``` + +Navigate to http://localhost:1313/td/docs/getting-started/ to read the theme documentation. |