Skip to content
Porting Grav Learn theme to Hugo
CSS HTML JavaScript
Branch: master
Clone or download

Latest commit

matalo33 Allow custom css files to be loaded by configuration
Previously adding custom css files would require the end user to copy
the header or footer partial into their overrides. They would then
need to maintain that partial into the future.

This config allows a user to provide a list of custom css files to load
into the theme, meaning they do not need to clone the partial.

  custom_css = ["css/foo.css", "css/bar.css"]

Inspiration taken from
Latest commit d4abb3c Mar 9, 2020


Type Name Latest commit message Commit time
Failed to load latest commit information.
archetypes TranslationBaseName replaced for Name on archetypes template May 27, 2018
exampleSite Allow custom css files to be loaded by configuration Apr 14, 2020
i18n Add Chinese i18n items for this theme Dec 4, 2019
images [ImgBot] Optimize images Mar 15, 2019
layouts Allow custom css files to be loaded by configuration Apr 14, 2020
static Added flag to turn off image featherlight Feb 1, 2020
.editorconfig Add .editorconfig Mar 15, 2019
.gitignore remove link in docs because of error Aug 20, 2017
.grenrc.yml Ship tag 2.2.0 Jan 28, 2019 Initial instructions on releasing with gren Sep 4, 2019 add @vjeantet to copyright Aug 20, 2017 Initial instructions on releasing with gren Sep 4, 2019
netlify.toml Netlify build on 0.66.0 Mar 9, 2020
theme.toml HTTPS links Dec 7, 2018
wercker.yml Fix/wercker (#178) Oct 10, 2018

Hugo Learn Theme

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.

wercker status FOSSA Status

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


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

cd themes/
git clone

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



Download old versions (prior to 2.0.0)

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

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

For both solutions, the documentation is available at


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


FOSSA Status


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 with gren

    gren changelog  --override --generate --tags=all
  • Fix the date for the current release in

  • Add the changelog to git and update the tag

    git add
    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>
You can’t perform that action at this time.