Web

• 1: Hugo Themes

1 - Hugo Themes

When creating Web pages often you are looking for an easy way to organize documentation tha is in a more structured form mthan simply a blog.

For this reason the following hugo themes may be useful:

Docsy

• Docsy: https://themes.gohugo.io/docsy/

  • cons: no modules, needs tto switch from master to main
  • pro: nice front page, we used this a lot, this Web sit is create with it
  

Dot

• Dot: https://themes.gohugo.io/dot-hugo-documentation-theme/

  

Syna

• Syna https://themes.gohugo.io/syna/

  

Compose

• Compose: https://themes.gohugo.io/compose/

  • pro: modules, menu with dynamic location update
  

Learn

• Learn: https://themes.gohugo.io/hugo-theme-learn/

  
  • pro colapsible menu menu, next button on pages

Hugo Clarity

A nice Blog theme

• hugo-clarity: https://themes.gohugo.io/hugo-clarity/

  

Dynamic Web Site (non documentation focused)

Although not a documentation oriented Wen page, The following recieved our attention as it show a very dynamic look. However it could be a bit distracting.

So one could develop two repos. One as frontpage with a splashy theme, the oster tha just focusses on the documentation

• Omega: https://themes.gohugo.io/omega-hugo-theme/

  

Converting Hugo to ePub

The following git repo contains documentation on how to convert hugo Web sites to epub

• https://github.com/weitblick/epub

An article in german is available at

• https://www.raspberrypi-spy.co.uk/wp-content/uploads/2012/11/Raspberry-Pi-Mounting-Hole-Template.pdf

The following script stes this up for you automatically:

git clone https://github.com/weitblick/epub.git
cd epub
cd exampleSite
mkdir themes
cd themes
git clone https://github.com/weitblick/epub.git
cd epub 
rm -rf .git
rm -rf exampleSite   # remove the example site in the theme
cd ../..
hugo
bash ./deploy.sh