hugo-theme-relearn/README.md

74 lines
3.2 KiB
Markdown
Raw Normal View History

# Hugo Relearn Theme
2016-03-17 11:05:36 +00:00
2021-08-28 08:39:54 +00:00
A theme for [Hugo](https://gohugo.io/) designed for documentation.
2018-08-10 09:29:11 +00:00
2023-01-24 22:58:16 +00:00
![Overview](https://github.com/McShelby/hugo-theme-relearn/raw/main/images/hero.png)
2021-07-01 12:35:27 +00:00
## Motivation
The theme is a fork of the great [Learn theme](https://github.com/matcornic/hugo-theme-learn) 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.
## Features
2017-08-20 16:20:13 +00:00
2022-03-27 20:22:10 +00:00
- Usable offline, no external dependencies
2022-11-17 22:52:54 +00:00
- Usable without a HTTP server from the file system
2022-04-11 09:04:14 +00:00
- Support for Internet Explorer 11
- Responsive design
- Configurable hidden pages
- Automatic next/prev buttons to navigate through menu entries
2017-08-20 16:20:13 +00:00
- Automatic Search
2022-11-17 22:52:54 +00:00
- Dedicated search page
2022-12-02 15:20:45 +00:00
- Support for GFM (GitHub Flavored Markdown)
- Print whole chapters or even the complete site
2023-01-30 16:05:32 +00:00
- Multilingual mode for English, Arabic, Simplified Chinese, Traditional Chinese, Czech, Dutch, Finnish, French, German, Hindi, Indonesian, Italian, Japanese, Korean, Polish, Portuguese, Russian, Spanish, Turkish, Vietnamese
2023-02-09 23:34:47 +00:00
- Full support for languages written right to left
2022-04-11 09:04:14 +00:00
- Unrestricted menu configuration relating to amount of items and level of nesting
- Font Awesome icons
- Tagging support
- Image styling like sizing, shadow, border and alignment
2022-04-11 09:04:14 +00:00
- Syntax highlighting
- Customizable look and feel
- Predefined (light, dark) and customizable color variants
2023-02-04 23:21:38 +00:00
- Automatic switch for light/dark mode dependend on your OS settings
2017-08-20 16:20:13 +00:00
- Attachments files
- List child pages
2022-07-02 12:00:23 +00:00
- Math and chemical formulae using the MathJax library
2022-04-11 09:04:14 +00:00
- Mermaid diagrams for flowcharts, sequences, gantts, pie, etc.
- Swagger UI for OpenAPI Specifications
2022-12-01 00:44:20 +00:00
- Badges
2021-08-28 08:39:54 +00:00
- Buttons
- Tip/Note/Info/Warning boxes
- Expand
- Tabs
- File inclusion
2016-12-30 21:40:05 +00:00
## Installation
2017-08-20 16:20:13 +00:00
2021-10-17 21:37:32 +00:00
Visit the [installation instructions](https://mcshelby.github.io/hugo-theme-relearn/basics/installation) to learn how to setup the theme in your Hugo installation.
2017-04-08 08:30:09 +00:00
2016-12-30 21:40:05 +00:00
## Usage
2021-10-17 21:37:32 +00:00
Visit the [documentation](https://mcshelby.github.io/hugo-theme-relearn/) to learn about all available features and how to use them.
2017-08-20 23:29:54 +00:00
## Changelog
See the [What's New](https://mcshelby.github.io/hugo-theme-relearn/basics/migration) page for release highlights or the [history](https://mcshelby.github.io/hugo-theme-relearn/basics/history) for a complete list of changes per release.
## Contribution
You are most welcome to contribute bugfixes or even new features to the source code. Please visit the [contribution guidelines](https://mcshelby.github.io/hugo-theme-relearn/dev/contributing) first.
2021-07-01 12:35:27 +00:00
## License
2017-08-20 23:29:54 +00:00
2021-08-28 09:18:43 +00:00
This theme is licensed under the [MIT License](https://github.com/McShelby/hugo-theme-relearn/blob/main/LICENSE).
2021-07-01 12:35:27 +00:00
## Credits
Special thanks to [everyone who has contributed](https://github.com/McShelby/hugo-theme-relearn/graphs/contributors) to this project.
2021-07-01 12:57:26 +00:00
Many thanks to [Mathieu Cornic](https://github.com/matcornic) for his work on porting the [Learn theme](https://github.com/matcornic/hugo-theme-learn) to Hugo.
Many thanks to [Andy Miller](https://github.com/rhukster) for initially creating the [Learn theme](https://github.com/getgrav/grav-theme-learn2) for Grav.
2022-12-14 21:55:48 +00:00
See the [credits](https://mcshelby.github.io/hugo-theme-relearn/more/credits) for a detailed list.