Hugo Theme Techdoc

The Techdoc is a Hugo Theme for technical documentation.

Features

• Modern, Simple layout
• Responsive web design
• Documentation menu
• Edit link to documentation repository
• Custom Shortcodes
• Analytics with Google Analytics, Google Tag Manager

Getting Started

Download Hugo theme

If you have git installed, you can do the following at the command-line-interface within the Hugo directory:

cd themes
git clone https://github.com/thingsym/hugo-theme-techdoc.git

For more information read the Hugo documentation.

Configure

You may specify options in config.toml (or config.yaml/config.json) of your site to make use of this theme's features.

For an example of config.toml, config.toml in exampleSite.

Preview site

To preview your site, run Hugo's built-in local server.

hugo server -t hugo-theme-techdoc

Browse site on http://localhost:1313

Deploy Site to public_html directory

hugo -d public_html

Development environment

cd /path/to/hugo-theme-techdoc
yarn install
gulp watch

Preview exampleSite

cd /path/to/dir/themes/hugo-theme-techdoc/exampleSite

hugo server --themesDir ../..

Browse site on http://localhost:1313

Contribution

Patches and Bug Fixes

Small patches and bug reports can be submitted a issue tracker in Github. Forking on Github is another good way. You can send a pull request.

1. Fork Hugo Theme Techdoc from GitHub repository
2. Create a feature branch: git checkout -b my-new-feature
3. Commit your changes: git commit -am 'Add some feature'
4. Push to the branch: git push origin my-new-feature
5. Create new Pull Request

Changelog

• Version 0.2.2 - 2019.04.27
  • fix Lastmod's and PublishDate's initial value of 0001-01-01
• Version 0.2.1 - 2018.12.07
  • fix scss lint errors
  • change lint from scss-lint to stylelint
  • add published date
  • change the font color of powered by
  • fix link on powered by
• Version 0.2.0 - 2018.11.21
  • add screenshot images
  • add exampleSite
  • fix sub-menu for responsive
  • improve menu and pagination
• Version 0.1.0 - 2018.03.04
  • initial release

License

Licensed under the MIT License.

Author

thingsym

Copyright (c) 2017-2018 by thingsym