mirror of
https://github.com/McShelby/hugo-theme-relearn
synced 2025-05-12 20:14:51 +08:00
83 lines
2.3 KiB
Markdown
83 lines
2.3 KiB
Markdown
# Hugo Relearn Theme
|
|
|
|
This repository contains a theme for [Hugo](https://gohugo.io/).
|
|
|
|
Visit the [theme documentation](https://relearn.netlify.app/) to see what is going on. It is actually built with this theme.
|
|
|
|
[](https://app.wercker.com/project/byKey/062e9604da64b79944d87434cb63fa53)
|
|
|
|
## Main features
|
|
|
|
- Automatic Search
|
|
- Multilingual mode
|
|
- Unlimited menu levels
|
|
- Automatic next/prev buttons to navigate through menu entries
|
|
- Image resizing, shadow…
|
|
- Attachments files
|
|
- List child pages
|
|
- Mermaid diagram (flowchart, sequence, gantt)
|
|
- Customizable look and feel and themes variants
|
|
- Buttons, Tip/Note/Info/Warning boxes, Expand
|
|
|
|
## Installation
|
|
|
|
Navigate to your themes folder in your Hugo site and use the following commands:
|
|
|
|
```shell
|
|
cd themes/
|
|
git clone https://github.com/McShelby/hugo-theme-relearn.git
|
|
```
|
|
|
|
Check that your Hugo version is minimum `0.25` with `hugo version`.
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
- [Visit the documentation](https://relearn.netlify.app/)
|
|
|
|
## Credits
|
|
|
|
Many thanks to [@vjeantet](https://github.com/vjeantet/) for the fork [docdock](https://github.com/vjeantet/hugo-theme-docdock). The v2 of this theme is mainly based on his work !
|
|
|
|
## License
|
|
|
|
[](https://app.fossa.io/projects/git%2Bgithub.com%2FMcShelby%2Fhugo-theme-relearn?ref=badge_large)
|
|
|
|
## Releasing
|
|
|
|
Somewhat work-in-progress steps to release with [gren](https://github.com/github-tools/github-release-notes)
|
|
|
|
- Check all MRs assigned to the milestone are closed or pushed back to another release
|
|
- Close the milestone
|
|
- Check merged MRs on the milestone have a tag (Bug, Enhancement, etc.)
|
|
- Tag and push the repo
|
|
|
|
```shell
|
|
git tag <tag>
|
|
git push origin <tag>
|
|
```
|
|
|
|
- Generate CHANGELOG.md with _gren_
|
|
|
|
```shell
|
|
gren changelog --override --generate --tags=all
|
|
```
|
|
|
|
- Fix the date for the current release in CHANGELOG.md
|
|
- Add the changelog to git and update the tag
|
|
|
|
```shell
|
|
git add CHANGELOG.md
|
|
git commit -m "Ship tag <tag>"
|
|
git push origin main
|
|
git tag -f <tag>
|
|
git push --force origin <tag>
|
|
```
|
|
|
|
- Generate release with _gren_
|
|
|
|
```shell
|
|
gren release -t <tag>
|
|
```
|