···11+The MIT License (MIT)
22+33+Copyright (c) 2019 elias julian marko garcia
44+Copyright (c) 2019 Paweł Romanowski
55+Copyright (c) 2019 panr
66+77+Permission is hereby granted, free of charge, to any person obtaining a copy of
88+this software and associated documentation files (the "Software"), to deal in
99+the Software without restriction, including without limitation the rights to
1010+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
1111+the Software, and to permit persons to whom the Software is furnished to do so,
1212+subject to the following conditions:
1313+1414+The above copyright notice and this permission notice shall be included in all
1515+copies or substantial portions of the Software.
1616+1717+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
1818+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
1919+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
2020+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
2121+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
2222+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+61
themes/zerm/README.md
···11+# zerm
22+33+a minimalist and dark theme for [Zola](https://getzola.org).
44+55+
66+77+[**Live Preview!**](https://zerm.ejmg.now.sh/)
88+99+Largely a port of Radek Kozieł's [Terminal
1010+Theme](https://github.com/panr/hugo-theme-terminal) for Hugo. 4/5ths of my way
1111+through porting this theme, I discovered Paweł Romanowski own independent fork
1212+for Zola, [Terminimal](https://github.com/pawroman/zola-theme-terminimal),
1313+which helped me get the PostCSS to Sass styling conversion done more
1414+quickly. My sincerest thanks to both of you!
1515+1616+## differences
1717+1818+This theme is largely true to the original by Radek, but there are some mild
1919+differences. They are almost all stylistic in nature and are intended to
2020+emphasize minimalism even more. Some of them are as follows:
2121+- tags are now included in a post's meta data.
2222+- no post image previews.
2323+- categories are included in the taxonomy.
2424+- bullet points have slightly more margin and different symbols for nesting.
2525+- no social media or comment support.
2626+2727+Some of these might be added later and [PR's are always
2828+welcomed](https://github.com/ejmg/zerm/pulls).
2929+3030+## configuration
3131+3232+Please follow the Zola documentation for [how to use a
3333+theme](https://www.getzola.org/documentation/themes/installing-and-using-themes/#installing-a-theme).
3434+3535+In `config.toml`, you will find all values for customization that are supported
3636+thus far have documentation explaining how they are used. If there is any confusion or something is not working as intended, [please open an issue](https://github.com/ejmg/zerm/issues)!
3737+3838+## math
3939+You can use KaTeX for mathematical typesetting.
4040+Assets are only available if you opt-in on a per-page level through
4141+a single line (`math=true`) on the extra section of the page frontmatter.
4242+4343+``` md
4444+# index.md
4545++++
4646+title="this page title"
4747+...
4848+4949+[extra]
5050+math=true
5151++++
5252+5353+Content
5454+```
5555+5656+Pages wich doesn't opt-in are not affected in any way, so you doesn't have
5757+to worry about any performance hit.
5858+5959+## license
6060+6161+MIT. See `LICENSE.md` for more details.
+131
themes/zerm/config.toml
···11+# The URL the site will be built for
22+base_url = "/"
33+44+# Used in RSS by default
55+title = "My blog!"
66+description = "placeholder description text for your blog!"
77+88+# The default language, used in RSS
99+# TODO: I would love to support more languages and make this easy to handle
1010+# with other facets of the theme.
1111+default_language = "en"
1212+1313+# Whether to generate a RSS feed automatically
1414+generate_feed = true
1515+# 'atom.xml' (default if unspecified) and 'rss.xml' are officially supported
1616+# values for feed_filename in this theme. All other filenames will assume a
1717+# link type of 'application/rss+xml'.
1818+# feed_filename = "atom.xml"
1919+2020+# Theme name to use.
2121+# NOTE: should not need to mess with this if you are using zerm directly, i.e. cloning the
2222+# repository at root and not using as directed by the Zola docs via themes/ directory.
2323+# theme = ""
2424+2525+# Whether to automatically compile all Sass files in the sass directory
2626+compile_sass = true
2727+2828+# Whether to do syntax highlighting
2929+# Theme can be customised by setting the `highlight_theme` variable to a theme supported by Zola
3030+highlight_code = true
3131+3232+# Syntax highlighting theme. See:
3333+# https://www.getzola.org/documentation/getting-started/configuration/#syntax-highlighting
3434+# for more information and themes built into Zola.
3535+highlight_theme = "axar" # Other dark themes that work: "1337", "agola-dark",
3636+ # "visual-studio-dark"
3737+3838+# Whether to build a search index to be used later on by a JavaScript library
3939+build_search_index = false
4040+4141+# Built in taxonomies of zerm.
4242+taxonomies = [
4343+ {name = "tags"},
4444+ {name = "categories"},
4545+]
4646+4747+[extra]
4848+# Put all your custom variables here
4949+#
5050+# Many configurations are taken directly from Terminal's config.toml
5151+# ---------------------------------------------------------
5252+5353+# Author name to be added to posts, if enabled.
5454+author = "you!"
5555+5656+# Show author's name in blog post meta data.
5757+show_author = false
5858+5959+# Show categories a blog post is marked with in its meta data.
6060+show_categories = true
6161+6262+# Show tags a blog post is marked with in its meta data.
6363+show_tags = true
6464+6565+# Theme color. You can have any color you want, so long as it's...
6666+# ["orange", "blue", "red", "green", "pink"]
6767+theme_color = "orange"
6868+6969+# Custom css to style over the defaults. This is useful when you only have a
7070+# few small tweaks to make rather than a major rehaul to the theme.
7171+# It would be best to make this a proper .sass or .scss file in sass/ rather
7272+# than placing in static/
7373+# custom_css = "custom.css"
7474+7575+# How many menu items to show on desktop. if you set this to 0, only submenu
7676+# button will be visible.
7777+show_menu_items = 2
7878+7979+# set theme to full screen width.
8080+full_width = false
8181+8282+# center theme with default width.
8383+center = false
8484+8585+# set a custom favicon. Must be placed in root of static/ directory...
8686+# favicon = ""
8787+8888+8989+# Set a custom preview image for your website when posted as a link.
9090+# Must be placed in root of static/ directory...
9191+# og_preview_img = ""
9292+9393+# Copyright notice if desired. Defaults to
9494+# copyright = "copyright notice here"
9595+9696+# What is displayed in the top left corner of the website. Default is zerm.
9797+logo_text = "zerm"
9898+9999+# Link in logo. Default returns you to $BASE_URL.
100100+logo_home_link = "/"
101101+102102+# Menu items to display. You define a url and the name of the menu item.
103103+# NOTE: `$BASE_URL/` must be included in the url name.
104104+main_menu = [
105105+ {url="/about/", name="about"},
106106+ {url="/contact/", name="contact"},
107107+ {url="https://google.com", name="Google", external=true},
108108+]
109109+110110+# Displayed as title of drop-down menu when size of main_menu > show_menu_items.
111111+menu_more = "show more"
112112+113113+# Displayed after teaser text for a blog post.
114114+read_more = "read more"
115115+116116+# not currently used from previous theme, but leaving here for now in case I
117117+# feel like adding it.
118118+read_other_posts = "read other posts"
119119+120120+121121+# Enable math typesetting with KaTeX
122122+# Show math in pages with `math=true` in the TOML frontmatter
123123+enable_katex = true
124124+125125+# Options for disqus
126126+disqus = { enabled=false, short_name="" }
127127+128128+# generate Table of Contents for all articles
129129+# Table of Contents can be generated for individual articles
130130+# by adding `ToC = true` in [extra] section in frontmatter
131131+# ToC = true
···11++++
22+title = "about"
33+path = "about"
44+55+[extra]
66+date = 2019-03-21
77++++
88+99+Yet another theme for yet another static site generator; that said, I hope you
1010+like it.
+14
themes/zerm/content/contact/_index.md
···11++++
22+title="contact"
33+description="a basic demo of zola. Does it work?"
44+55+[extra]
66+date=2019-03-26
77++++
88+99+# some links
1010+1111+- [zola, the static site generator written in rust](https://getzola.org)
1212+- [source code for zerm](https://github.com/ejmg/zerm)
1313+- [Terminal, the theme zerm was derived from](https://github.com/panr/hugo-theme-terminal)
1414+- [Terminimal, another theme for zola based on Terminal](https://github.com/pawroman/zola-theme-terminimal)
+65
themes/zerm/content/demo/index.md
···11++++
22+title="demo"
33+description="a basic demo of zola."
44+date=2019-08-06
55+66+[taxonomies]
77+tags = ["demo", "zola", "highlighting"]
88+categories = ["programming", "wu tang",]
99+1010+[extra]
1111++++
1212+1313+Here's a general demo of Zola and how things look with zerm.
1414+1515+# Header I
1616+1717+Inline code: `println!("Wu Tang!");`
1818+1919+Zola has built in syntax highlighting. If there's not a theme you like, you can
2020+easily add more.
2121+2222+zerm uses Fira Code fonts, which means we get ligatures in addition to
2323+Zola's powerful syntax highlighting ✨.
2424+2525+```rs
2626+fn foo(arg: String) -> Result<u32, Io::Error> {
2727+ println!("Nice!"); // TODO: the thingy
2828+ if 1 != 0 {
2929+ println!("How many ligatures can I contrive??");
3030+ println!("Turns out a lot! ==> -/-> <!-- <$> >>=");
3131+ }
3232+ Ok(42)
3333+}
3434+```
3535+3636+## Header II
3737+3838+Want block quotes? We got block quotes.
3939+4040+Remember the wise words of Ras Kass:
4141+4242+> In Hotel Rwanda, reminder to honor these street scholars who ask why
4343+U.S. Defense is twenty percent of the tax dollar. Bush gave 6.46 billion to
4444+Halliburton for troops support efforts in Iraq; meanwhile, the hood is hurting,
4545+please believe that.
4646+>
4747+> -- "Verses", _Wu-Tang Meets The Indie Culture_
4848+4949+### Header III
5050+5151+| members | age | notable album | to be messed with? |
5252+|------------------|-----|----------------------------------------------|-------------------------------------------------------------------------|
5353+| GZA | 52 | Liquid Swords | no |
5454+| ODB | 35 | Return to the 36 Chambers: The Dirty Version | absolutely not |
5555+| Raekwon Da Chef | 49 | Only Built 4 Cuban Linx... | `"no"` that's spanish for "no" |
5656+| Ghostface Killah | 49 | Fishscale | i swear you keep asking that question and the answer ain't gonna change |
5757+| Inspectah Deck | 49 | CZARFACE | `protect ya neck, boy` |
5858+5959+6060+#### Header IV
6161+6262+Here's a video of my rabbit, Smalls, loaf'n to lofi beats:
6363+6464+{{ youtube(id="UUpuz8IObcs") }}
6565+
+13
themes/zerm/content/fiz/index.md
···11++++
22+title="fiz"
33+description="a basic demo of zola. Does it work?"
44+date=2019-03-25
55+author="elias"
66+77+[taxonomies]
88+tags = ["rust", "test"]
99+# categories = ["misc."]
1010++++
1111+1212+1313+Foo Bar Buzz Fizz Qux Fum
+21
themes/zerm/content/technology_is_hell/index.md
···11++++
22+title="technology is hell!"
33+description="Yet another blog post ranting about XYZ technology for ABC reasons"
44+date=2019-03-26
55+66+[taxonomies]
77+tags = ["rust", "test"]
88+categories = ["misc."]
99++++
1010+1111+1212+Nullam eu ante vel est convallis dignissim. Fusce suscipit, wisi nec facilisis
1313+facilisis, est dui fermentum leo, quis tempor ligula erat quis odio. Nunc
1414+porta vulputate tellus. Nunc rutrum turpis sed pede. Sed bibendum. Aliquam
1515+posuere. Nunc aliquet, augue nec adipiscing interdum, lacus tellus malesuada
1616+massa, quis varius mi purus non odio. Pellentesque condimentum, magna ut
1717+suscipit hendrerit, ipsum augue ornare nulla, non luctus diam neque sit amet
1818+urna. Curabitur vulputate vestibulum lorem. Fusce sagittis, libero non
1919+molestie mollis, magna orci ultrices dolor, at vulputate neque nulla lacinia
2020+eros. Sed id ligula quis est convallis tempor. Curabitur lacinia pulvinar
2121+nibh. Nam a sapien.
+57
themes/zerm/content/using_katex/index.md
···11++++
22+title="Using KaTeX for mathematical typesetting"
33+date=2021-06-16
44+55+[taxonomies]
66+categories=["test"]
77+tags=["math", "zola"]
88+99+[extra]
1010+math=true
1111++++
1212+1313+The usual way to include LaTeX is to use `$$`, as shown in the examples below.
1414+1515+These examples are taken from <http://khan.github.io/KaTeX/>
1616+1717+### Example 1
1818+If the text between `$$` contains newlines it will rendered in display mode:
1919+```
2020+$$
2121+f(x) = \int_{-\infty}^\infty\hat f(\xi)\,e^{2 \pi i \xi x}\,d\xi
2222+$$
2323+```
2424+2525+$$
2626+f(x) = \int_{-\infty}^\infty\hat f(\xi)\,e^{2 \pi i \xi x}\,d\xi
2727+$$
2828+2929+### Example 2
3030+3131+```
3232+$$
3333+\frac{1}{\Bigl(\sqrt{\phi \sqrt{5}}-\phi\Bigr) e^{\frac25 \pi}} = 1+\frac{e^{-2\pi}} {1+\frac{e^{-4\pi}} {1+\frac{e^{-6\pi}} {1+\frac{e^{-8\pi}} {1+\cdots} } } }
3434+$$
3535+3636+1(ϕ5−ϕ)e25π=1+e−2π1+e−4π1+e−6π1+e−8π1+⋯ \frac{1}{\Bigl(\sqrt{\phi \sqrt{5}}-\phi\Bigr) e^{\frac25 \pi}} = 1+\frac{e^{-2\pi}} {1+\frac{e^{-4\pi}} {1+\frac{e^{-6\pi}} {1+\frac{e^{-8\pi}} {1+\cdots} } } }
3737+```
3838+3939+$$
4040+\frac{1}{\Bigl(\sqrt{\phi \sqrt{5}}-\phi\Bigr) e^{\frac25 \pi}} = 1+\frac{e^{-2\pi}} {1+\frac{e^{-4\pi}} {1+\frac{e^{-6\pi}} {1+\frac{e^{-8\pi}} {1+\cdots} } } }
4141+$$
4242+4343+1(ϕ5−ϕ)e25π=1+e−2π1+e−4π1+e−6π1+e−8π1+⋯ \frac{1}{\Bigl(\sqrt{\phi \sqrt{5}}-\phi\Bigr) e^{\frac25 \pi}} = 1+\frac{e^{-2\pi}} {1+\frac{e^{-4\pi}} {1+\frac{e^{-6\pi}} {1+\frac{e^{-8\pi}} {1+\cdots} } } }
4444+4545+### Example 3
4646+4747+```
4848+$$
4949+1 + \frac{q^2}{(1-q)}+\frac{q^6}{(1-q)(1-q^2)}+\cdots = \prod_{j=0}^{\infty}\frac{1}{(1-q^{5j+2})(1-q^{5j+3})}, \quad\quad \text{for }\lvert q\rvert<1.
5050+$$
5151+```
5252+5353+$$
5454+1 + \frac{q^2}{(1-q)}+\frac{q^6}{(1-q)(1-q^2)}+\cdots = \prod_{j=0}^{\infty}\frac{1}{(1-q^{5j+2})(1-q^{5j+3})}, \quad\quad \text{for }\lvert q\rvert<1.
5555+$$
5656+5757+
+42
themes/zerm/content/waz/index.md
···11++++
22+title="waz"
33+description="a basic demo of zola. Does it work? This old man, he played one. He played knick knack on my drum."
44+date=2019-03-27
55+66+[taxonomies]
77+tags = ["rust", "test", "zola"]
88+categories = ["programming", "misc.", "programming languages"]
99+1010+[extra]
1111++++
1212+1313+# Hello Hello
1414+1515+Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Donec hendrerit
1616+tempor tellus. Donec pretium posuere tellus. Proin quam nisl, tincidunt et,
1717+mattis eget, convallis nec, purus. Cum sociis natoque penatibus et magnis dis
1818+parturient montes, nascetur ridiculus mus. Nulla posuere. Donec vitae dolor.
1919+Nullam tristique diam non turpis. Cras placerat accumsan nulla. Nullam
2020+rutrum. Nam vestibulum accumsan nisl.
2121+2222+2323+```python
2424+def foo(bar, **kwargs):
2525+ print("yo, this is nice!")
2626+```
2727+2828+## a list
2929+3030+* Donec hendrerit tempor tellus.
3131+* Nam a sapien.
3232+* Phasellus at dui in ligula mollis ultricies.
3333+* Mauris mollis tincidunt felis.
3434+* Nullam rutrum.
3535+3636+### Yet another list
3737+1. Nunc aliquet, augue nec adipiscing interdum, lacus tellus malesuada massa,
3838+ quis varius mi purus non odio.
3939+2. Donec hendrerit tempor tellus.
4040+3. Nunc aliquet, augue nec adipiscing interdum, lacus tellus malesuada massa,
4141+ quis varius mi purus non odio.
4242+
+69
themes/zerm/content/zerm/index.md
···11++++
22+title="what is zerm?"
33+description="a summary of what zerm is and why it is different."
44+date=2019-08-07
55+updated=2021-02-03
66+77+[taxonomies]
88+tags = ["rust", "test", "zola"]
99+categories = ["programming", "misc.",]
1010+1111+[extra]
1212+ToC = true
1313++++
1414+1515+# hello
1616+1717+This is zerm, a minimalist theme for Zola based[^1] off of [panr's](https://twitter.com/panr)
1818+theme for Hugo.
1919+2020+While it's largely faithful to the original, there are some changes:
2121+- no prism.js integration, instead we use Zola's syntax highlighting to reduce overhead.
2222+- removal of PostCSS and leveraging Zola's use of Sass for simple styling.
2323+ - much thanks to [Paweł
2424+ Romanowski's](https://github.com/pawroman/zola-theme-terminimal/)
2525+ independent fork of Terminal. Their Sass stylings saved me the overhead of
2626+ figuring it out myself.
2727+- no preview images. I want a theme that is focused on content.
2828+- support for anchor links.
2929+- Other small, opinionated changes that I think lend to the minimalism and
3030+ aesthetic of zerm.
3131+3232+3333+Things this theme does not have but either Terminal or Terminimal might:
3434+- better short-codes for things like embedding videos or images, though I will
3535+ work on this over time.
3636+- better support for things like comments and social media. As of now, I have
3737+ no plans to add this but [PR's are always
3838+ **welcomed**](https://github.com/ejmg/zerm/pulls).
3939+4040+## A quick demo
4141+4242+`println!("inline code");`
4343+4444+```rs
4545+fn main(n: String) {
4646+ println!("hello, zola!");
4747+}
4848+```
4949+5050+### Header III
5151+5252+> a somewhat kinda maybe large quote that maybe spans
5353+> more than one line but I mean really who even cares
5454+> okay maybe I do but point being is yes nice.
5555+5656+#### Header IV
5757+5858+| hello | tables | nice |
5959+|:-----:|:---------:|------|
6060+| wow | much love | yes |
6161+6262+6363+Like zerm? Then [install
6464+Zola](https://www.getzola.org/documentation/getting-started/installation/) and
6565+[get started](https://www.getzola.org/documentation/themes/installing-and-using-themes/#installing-a-theme)!
6666+6767+---
6868+6969+[^1]: fork? port? a little bit of the former, more of the latter?
···11+{% extends "index.html" %}
22+{%- block main -%}
33+<div class="post">
44+55+ <h1 class="post-title">#tags</h1>
66+ <ul>
77+ {%- for term in terms -%}
88+ <li class="tag-list">
99+ <a href="{{ get_taxonomy_url(kind="tags", name=term.name) }}">#{{ term.name }}</a>
1010+ ({{ term.pages | length }} post{{ term.pages | length | pluralize}})
1111+ </li>
1212+ {# End of pagination for-loop #}
1313+ {%- endfor -%}
1414+ {#- I don't put pagination here like Terminal does. I don't like how
1515+ the buttons move with the size of post entries in the content div. -#}
1616+ </ul>
1717+</div>
1818+{%- endblock main -%}
+23
themes/zerm/templates/tags/single.html
···11+{%- extends "index.html"-%}
22+{%- block main-%}
33+ <div class="post">
44+ <h1 class="post-title">
55+ tags ∋ #{{ term.name }}
66+ ({{ term.pages | length }} post{{ term.pages | length | pluralize}})
77+ </h1>
88+99+ <ul>
1010+ {%- for post in term.pages -%}
1111+ <li class="tag-list">
1212+ {{ post.date | date(format="%Y.%m.%d") }}
1313+ :: <a href="{{ post.permalink }}">{{ post.title }}</a>
1414+ :: {% for tag in post.taxonomies["tags"] -%} <a href="{%- set _tag = get_taxonomy_url(kind="tags", name=tag) -%}{{ _tag }}">#{{ tag }}</a> {% endfor %}
1515+ </li>
1616+ {# End of pagination for-loop #}
1717+ {%- endfor -%}
1818+ {#- I don't put pagination here like Terminal does. I don't like how
1919+ the buttons move with the size of post entries in the content div. -#}
2020+ </ul>
2121+2222+</div>
2323+{%- endblock main-%}
+26
themes/zerm/theme.toml
···11+name = "zerm"
22+description = "A minimalistic and dark theme based on Radek Kozieł's theme for Hugo"
33+license = "MIT"
44+homepage = "https://github.com/ejmg/zerm"
55+# The minimum version of Zola required
66+min_version = "0.8.0"
77+# An optional live demo URL
88+demo = "https://zerm.ejmg.now.sh/"
99+1010+# Any variable there can be overriden in the end user `config.toml`
1111+# You don't need to prefix variables by the theme name but as this will
1212+# be merged with user data, some kind of prefix or nesting is preferable
1313+# Use snake_casing to be consistent with the rest of Zola
1414+[extra]
1515+1616+# The theme author info: you!
1717+[author]
1818+name = "elias julian marko garcia"
1919+homepage = "https://github.com/ejmg"
2020+2121+# If this is porting a theme from another static site engine, provide
2222+# the info of the original author here
2323+[original]
2424+author = "Radek Kozieł"
2525+homepage = "https://radoslawkoziel.pl/"
2626+repo = "https://github.com/panr/hugo-theme-terminal"