Hugo Book Theme #

Hugo documentation theme as simple as plain book #

• Features
• Requirements
• Installation
• Menu
• Blog
• Configuration
• Shortcodes
• Versioning
• Contributing

Features #

• Clean simple design
• Light and Mobile-Friendly
• Multi-language support
• Customisable
• Zero initial configuration
• Handy shortcodes
• Comments support
• Simple blog and taxonomy
• Primary features work without JavaScript
• Dark Mode

Requirements #

• Hugo 0.79 or higher
• Hugo extended version, Installation Instructions

Installation #

Install as git submodule #

Navigate to your hugo project root and run:

git submodule add https://github.com/alex-shpak/hugo-book themes/hugo-book

Then run hugo (or set theme = "hugo-book"/theme: hugo-book in configuration file)

hugo server --minify --theme hugo-book

Install as hugo module #

You can also add this theme as a Hugo module instead of a git submodule.

Start with initializing hugo modules, if not done yet:

hugo mod init github.com/repo/path

Navigate to your hugo project root and add [module] section to your config.toml:

[module]
[[module.imports]]
path = 'github.com/alex-shpak/hugo-book'

Then, to load/update the theme module and run hugo:

hugo mod get -u
hugo server --minify

Creating site from scratch #

Below is an example on how to create a new site from scratch:

hugo new site mydocs; cd mydocs
git init
git submodule add https://github.com/alex-shpak/hugo-book themes/hugo-book
cp -R themes/hugo-book/exampleSite/content.en/* ./content

hugo server --minify --theme hugo-book