Hugo Theme Techdoc

The Techdoc is a Hugo Theme for technical documentation.

View Documentation Download Source

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

GitHub