mirror of
https://github.com/McShelby/hugo-theme-relearn.git
synced 2024-11-27 17:53:07 +00:00
54 lines
3 KiB
Markdown
54 lines
3 KiB
Markdown
+++
|
|
title = "Hugo Relearn Theme"
|
|
+++
|
|
|
|
# Hugo Relearn Theme
|
|
|
|
The [Relearn theme](http://github.com/McShelby/hugo-theme-relearn) is a theme for [Hugo](https://gohugo.io/), a static website generator written in Go. Where Hugo is often used for blogs, this theme is designed with documentation in mind.
|
|
|
|
{{% notice info %}}
|
|
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.
|
|
{{% /notice %}}
|
|
|
|
## Main features
|
|
|
|
{{% notice tip %}}
|
|
See [what's new]({{% relref "basics/migration" %}}) within the latest update.
|
|
{{% /notice %}}
|
|
|
|
* Usable offline, no external dependencies
|
|
* [Automatic Search]({{%relref "basics/configuration#activate-search" %}})
|
|
* [Print]({{%relref "basics/configuration#activate-print-support" %}}) whole chapters or even the complete site
|
|
* [Multilingual mode]({{%relref "cont/i18n" %}}) for English, Arabic, Simplified Chinese, Traditional Chinesse, Dutch, French, German, Hindi, Indonesian, Japanese, Korean, Portuguese, Russian, Spanish, Turkish, Vietnamese
|
|
* Unlimited menu levels
|
|
* Automatic next/prev buttons to navigate through menu entries
|
|
* [Image resizing, shadow...]({{%relref "cont/markdown#images" %}})
|
|
* [Attachments files]({{%relref "shortcodes/attachments" %}})
|
|
* [List child pages]({{%relref "shortcodes/children" %}})
|
|
* [Mermaid diagram]({{%relref "shortcodes/mermaid" %}}) (flowchart, sequence, gantt)
|
|
* [Swagger UI]({{%relref "shortcodes/swagger" %}}) for OpenAPI Specifications
|
|
* [Customizable look and feel]({{%relref "basics/customization"%}})
|
|
* [Predefined (light, dark) and customizable color variants]({{%relref "basics/generator" %}})
|
|
* [Buttons]({{%relref "shortcodes/button" %}})
|
|
* [Tip/Note/Info/Warning boxes]({{%relref "shortcodes/notice" %}})
|
|
* [Expand]({{%relref "shortcodes/expand" %}})
|
|
* [Tabs]({{%relref "shortcodes/tabs" %}})
|
|
* [File inclusion]({{%relref "shortcodes/include" %}})
|
|
|
|
## Getting support
|
|
|
|
To get support, feel free to open a new [discussion topic](https://github.com/McShelby/hugo-theme-relearn/discussions) or [issue](https://github.com/McShelby/hugo-theme-relearn/issues) in the official repository on GitHub.
|
|
|
|
## Become a contributor
|
|
|
|
Feel free to update this documentation by just clicking the **Edit** link displayed on top right of each page. Your changes will be deployed automatically once they were reviewed.
|
|
|
|
You are most welcome to contribute bugfixes or even new features to the source code by making pull requests to the [official repository](https://github.com/McShelby/hugo-theme-relearn) via GitHub. Please visit the [contribution guidelines](https://github.com/McShelby/hugo-theme-relearn/blob/main/.github/contributing.md) first.
|
|
|
|
## License
|
|
|
|
This theme is licensed under the [MIT License](https://github.com/McShelby/hugo-theme-relearn/blob/main/LICENSE).
|
|
|
|
## Credits
|
|
|
|
This theme would not be possible without the work of many others. See the [credits]({{%relref "more/credits" %}}) for a detailed list.
|