A theme for Hugo designed for documentation
Find a file
GitHub Actions Bot 75ec08e13e Ship tag 5.3.0
2022-10-07 20:26:36 +00:00
.github build: create new milestone after release 2022-07-15 14:08:29 +02:00
archetypes archetypes: introducing hooks #300 2022-07-06 00:15:33 +02:00
exampleSite Ship tag 5.3.0 2022-10-07 20:26:36 +00:00
i18n theme: remove W3C / WCAG validator errors #337 #307 2022-10-07 20:45:14 +02:00
images docs: new screenshots 2022-02-22 01:05:18 +01:00
layouts Ship tag 5.3.0 2022-10-07 20:26:36 +00:00
static menu: remove focus markers on menu expander #397 2022-10-07 21:31:50 +02:00
.editorconfig theme: wildspace config 2022-03-13 14:15:26 +01:00
.gitignore ignore new hugo 0.89 lock files 2021-11-08 20:14:56 +01:00
.grenrc.js task: remove irrelevant labels from changelog 2022-09-13 23:20:13 +02:00
.issuetracker repo: add issuetracker configuration 2022-03-03 23:49:28 +01:00
config.toml print: fix urls for uglyURLs=true #322 2022-08-23 21:09:20 +02:00
LICENSE theme: reorder license #40 2021-08-22 13:30:05 +02:00
README.md math: add mathjax rendering #235 2022-07-02 14:00:23 +02:00
theme.toml math: add mathjax rendering #235 2022-07-02 14:00:23 +02:00

Hugo Relearn Theme

A theme for Hugo designed for documentation.

Overview

Motivation

The theme is a fork of the great Learn theme with the aim of fixing long outstanding bugs and adepting to latest Hugo features. As far as possible this theme tries to be a drop-in replacement for the Learn theme.

Main features

  • Usable offline, no external dependencies
  • Support for Internet Explorer 11
  • Responsive design
  • Configurable hidden pages
  • Automatic next/prev buttons to navigate through menu entries
  • Automatic Search
  • Print whole chapters or even the complete site
  • Multilingual mode for English, Arabic, Simplified Chinese, Traditional Chinesse, Dutch, French, German, Hindi, Indonesian, Italian, Japanese, Korean, Polish, Portuguese, Russian, Spanish, Turkish, Vietnamese
  • Unrestricted menu configuration relating to amount of items and level of nesting
  • Font Awesome icons
  • Tagging support
  • Image resizing, shadow…
  • Syntax highlighting
  • Attachments files
  • List child pages
  • Math and chemical formulae using the MathJax library
  • Mermaid diagrams for flowcharts, sequences, gantts, pie, etc.
  • Swagger UI for OpenAPI Specifications
  • Customizable look and feel
  • Predefined (light, dark) and customizable color variants
  • Buttons
  • Tip/Note/Info/Warning boxes
  • Expand
  • Tabs
  • File inclusion

Installation

Visit the installation instructions to learn how to setup the theme in your Hugo installation.

Usage

Visit the documentation to learn about all available features and how to use them.

Changelog

See the changelog for a complete list of releases.

Contribution

You are most welcome to contribute to the source code but please visit the contribution guidelines first.

License

This theme is licensed under the MIT License.

Credits

Special thanks to everyone who has contributed to this project.

Many thanks to Mathieu Cornic for his work on porting the Learn theme to Hugo.

Many thanks to Andy Miller for initially creating the Learn theme for Grav.