eXtremely Minimal Hugo theme: about 140 lines of code in total, including HTML and CSS (with no dependencies)
Go to file
Andreas Deininger b76b60eb94
Allow LaTeX in Markdown using standard syntax (#70)
Co-authored-by: Yihui Xie <xie@yihui.name>
2024-03-03 20:20:29 -06:00
.github Create FUNDING.yml 2023-12-29 18:19:04 -06:00
archetypes Hugo 0.24 requires title and date in archtypes for some reason 2017-06-22 14:38:34 -05:00
exampleSite Allow LaTeX in Markdown using standard syntax (#70) 2024-03-03 20:20:29 -06:00
images add readme and screenshots 2017-06-15 23:08:08 -05:00
layouts Pass relative .css path to relURL (#59) 2022-08-08 09:40:20 -05:00
static/css Make line-height unitless (#56) 2022-01-19 13:28:25 -06:00
.gitignore Allow LaTeX in Markdown using standard syntax (#70) 2024-03-03 20:20:29 -06:00
LICENSE.md update license year 2022-06-14 22:31:18 -05:00
README.md 137 is closer to 140 than 130 2024-02-02 09:46:24 -06:00
hugo-xmin.Rproj start the project in RStudio 2017-06-15 23:03:54 -05:00
theme.toml close #69: add link to demo site 2024-02-05 08:52:03 -06:00

HUGO XMIN

Keep it simple, but not simpler

XMin is a Hugo theme written by Yihui Xie in about four hours: half an hour was spent on the Hugo templates, and 3.5 hours were spent on styling. The main motivation for writing this theme was to provide a really minimal example to beginners of Hugo templates. This XMin theme contains about 140 lines of code in total, including the code in HTML templates and CSS (also counting empty lines).

find . -not -path '*/exampleSite/*' \( -name '*.html' -o -name '*.css' \) | xargs wc -l
       5 ./layouts/404.html
      12 ./layouts/_default/single.html
      20 ./layouts/_default/list.html
      13 ./layouts/_default/terms.html
       0 ./layouts/partials/foot_custom.html
       0 ./layouts/partials/head_custom.html
       9 ./layouts/partials/footer.html
      20 ./layouts/partials/header.html
      51 ./static/css/style.css
       7 ./static/css/fonts.css
     137 total

I can certainly further reduce the code, for example, by eliminating the CSS, but I believe a tiny bit of CSS can greatly improve readability. You cannot really find many CSS frameworks that only contain 50 lines of code.

Screenshot