summary refs log tree commit diff stats
path: root/README.md
diff options
context:
space:
mode:
authorAlan Pearce2020-01-10 19:55:06 +0100
committerAlan Pearce2020-01-10 19:55:06 +0100
commit7befbf2f991e217aa4d52615f9f430cae30897f5 (patch)
tree03480e73ea3cad63417b5621140c58a84223edc6 /README.md
downloadwebsite-7befbf2f991e217aa4d52615f9f430cae30897f5.tar.lz
website-7befbf2f991e217aa4d52615f9f430cae30897f5.tar.zst
website-7befbf2f991e217aa4d52615f9f430cae30897f5.zip
Squashed 'themes/xmin/' content from commit 982dfb3
git-subtree-dir: themes/xmin
git-subtree-split: 982dfb320e8ac58a78203be76c5b06beae25d4f9
Diffstat (limited to 'README.md')
-rw-r--r--README.md28
1 files changed, 28 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3cd9a40
--- /dev/null
+++ b/README.md
@@ -0,0 +1,28 @@
+# HUGO XMIN
+
+## _Keep it simple, but not simpler_
+
+**XMin** is a Hugo theme written by [Yihui Xie](https://yihui.name) 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 130 lines of code in total, including the code in HTML templates and CSS (also counting empty lines).
+
+
+```bash
+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](https://github.com/yihui/hugo-xmin/raw/master/images/screenshot.png)](https://xmin.yihui.name)