This repository contains a theme for Hugo, based on great Grav Learn Theme.

Visit the theme documentation to see what is going on. It is actually built with this theme.

• 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

Navigate to your themes folder in your Hugo site and use the following commands:

cd themes/
git clone https://github.com/matcornic/hugo-theme-learn.git

Check that your Hugo version is minimum 0.25 with hugo version.

• Visit the documentation

If you need old version for compatibility purpose, either download theme source code from releases or use the right git tag. For example, with 1.1.0

• Direct download way: https://github.com/matcornic/hugo-theme-learn/archive/1.1.0.zip
• Git way:

cd themes/hugo-theme-learn
git checkout tags/1.1.0

For both solutions, the documentation is available at https://github.com/matcornic/hugo-theme-learn/releases/download/1.1.0/hugo-learn-doc-1.1.0.zip

Many thanks to @vjeantet for the fork docdock. The v2 of this theme is mainly based on his work !

Somewhat work-in-progress steps to release with gren

• 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

  git tag <tag>
  git push origin <tag>

• Generate CHANGELOG.md with gren

  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

  git add CHANGELOG.md
  git commit -m "Ship tag <tag>"
  git push origin master
  git tag -f <tag>
  git push --force origin <tag>

• Generate release with gren

  gren release -t <tag>