Profile
Back to NewsBack
GitHub Trending 3 min
Reader Mode
McShelby/hugo-theme-relearn: A theme for Hugo designed for documentation

McShelby/hugo-theme-relearn: A theme for Hugo designed for documentation

16 hours ago

Hugo Relearn Theme

A theme for Hugo designed for documentation.

★ What's new in the latest version ★

!Image of the Relearn theme in light and dark mode on phone, tablet and desktop

Overview

The Relearn theme is an enhanced fork of the popular Learn theme. It aims to address long-standing issues and incorporate the latest Hugo features while trying to maintain compatibility with its predecessor.

Key Features

  • Versatile Usage
- Responsive design for mobile devices - Looks nice on paper - if it has to - Accessible by keyboard and screen reader - Usable offline with no external dependencies - Usable from your local file system without a web server via file:// protocol - Servable with a strict Content Security Policy - Integration with the VSCode Front Matter CMS extension for on-premise CMS capabilities
  • Customizable Appearance
- Flexible brand image configuration - Automatic light/dark mode switching based on OS settings - Many pre-defined color variants - User-selectable variants - Built-in stylesheet generator - Customizable syntax highlighting
  • Advanced Functionality
- Chapter and site-wide printing capabilities - Versatile search options: in-page, popup, and dedicated search page - Customizable topbar buttons - Configurable sidebar menus - Support for hidden pages - Comprehensive taxonomy support - Versioning support - Social media integration - SBOM available
  • Multilingual Support
- Full right-to-left (RTL) language support - Extensive list of supported languages: Arabic, Chinese (Simplified and Traditional), Czech, Danish, Dutch, English, Finnish, French, German, Hindi, Hungarian, Indonesian, Italian, Japanese, Korean, Persian, Polish, Portuguese (European and Brazilian), Romanian, Russian, Spanish, Swahili, Turkish, Ukrainian, Vietnamese - Multilingual content search capabilities
  • Enhanced Markdown Features
- CommonMark compliant - Support for Markdown extensions like GitHub Flavored Markdown - Support for Obsidian callouts - Advanced link manipulation like download and target - Advanced image manipulation like lightbox, sizing, shadows, borders and alignment
  • Rich Shortcode Library
- Marker badges - Flexible buttons - Styled callouts - Card-based content organization - Expandable content areas - Font Awesome icon integration - File inclusion capabilities - Math support for mathematical and chemical formulae - Mermaid diagram integration - OpenAPI specification rendering - Page listings in various layouts - Page bundle resource display - Site configuration parameter display - Tab-based content organization - Nicely formatted tree lists

Getting Started

For a comprehensive guide on the theme's capabilities, please refer to the official documentation.

Updates and Changes

Visit the What's New page for feature highlights or the detailed changelog for a complete list of updates.

Contributing

We welcome contributions for bug fixes and new features. Please see the contribution guidelines before getting started.

If you want to go further - running the test suite or regenerating the documentation screenshots - the Development section explains the setup.

Licensing

The Relearn theme is distributed under the MIT License.

Credits

This theme is built on the shoulders of giants.

Chat with me