hugo-theme-relearn/exampleSite/content/_index.en.md

55 lines
3 KiB
Markdown
Raw Normal View History

+++
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.
2021-08-28 08:39:54 +00:00
{{% 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
2021-10-07 19:19:55 +00:00
{{% notice tip %}}
See [what's new]({{% relref "basics/migration" %}}) within the latest update.
{{% /notice %}}
2022-03-27 20:22:10 +00:00
* 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
2022-04-03 10:26:25 +00:00
* [Multilingual mode]({{%relref "cont/i18n" %}}) for English, Arabic, Simplified Chinese, Traditional Chinesse, Dutch, French, German, Hindi, Indonesian, Japanese, Korean, Portuguese, Russian, Spanish, Vietnamese, Turkish
2021-08-28 08:39:54 +00:00
* 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" %}})
2021-08-28 09:18:43 +00:00
## Getting support
2021-07-01 14:25:08 +00:00
2021-08-28 09:18:43 +00:00
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.
2021-08-28 09:18:43 +00:00
## Become a contributor
2022-02-14 23:22:34 +00:00
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.
2021-07-01 14:25:08 +00:00
2021-10-19 15:24:10 +00:00
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.
2021-08-28 09:18:43 +00:00
## License
This theme is licensed under the [MIT License](https://github.com/McShelby/hugo-theme-relearn/blob/main/LICENSE).
## Credits
2022-02-21 23:04:16 +00:00
This theme would not be possible without the work of many others. See the [credits]({{%relref "more/credits" %}}) for a detailed list.