comparing d5fa01f36336b8728582ab4db2b046ce7108eb41 and master on hauleth.dev/blog

+2 -2

.github/workflows/rebuild.yml

···

       1
       1
        
       name: Trigger Netlify rebuild

     

       2
       2
        
       on:

     

       3
       3
        
         schedule:

     

       4
       4
       -
           # Run every 4h

     

       5
       5
       -
           - cron: '0 */4 * * *'

     

       4
       4
       +
           # Run every 8h

     

       5
       5
       +
           - cron: '0 */8 * * *'

     

       6
       6
        
       

     

       7
       7
        
       jobs:

     

       8
       8
        
         trigger:

-3

.gitmodules

···

       1
       1
       -
       [submodule "themes/zerm"]

     

       2
       2
       -
       	path = themes/zerm

     

       3
       3
       -
       	url = https://github.com/ejmg/zerm.git

+11 -5

config.toml

···

       8
       8
        
       

     

       9
       9
        
       theme = "zerm"

     

       10
       10
        
       

     

       11
       11
       -
       generate_feed = true

     

       11
       11
       +
       generate_feeds = true

     

       12
       12
        
       minify_html = true

     

       13
       13
        
       

     

       14
       14
        
       taxonomies = [

     

       15
       15
       -
         {name = "tags"},

     

       15
       15
       +
         {name = "tags", feed = true},

     

       16
       16
        
       ]

     

       17
       17
        
       

     

       18
       18
        
       [markdown]

     
···

       25
       25
        
       

     

       26
       26
        
       [extra]

     

       27
       27
        
       author = "Hauleth"

     

       28
       28
       -
       for_hire = false

     

       28
       28
       +
       for_hire = true

     

       29
       29
        
       theme_color = "blue"

     

       30
       30
       +
       

     

       31
       31
       +
       source = "https://tangled.sh/hauleth.dev/blog"

     

       30
       32
        
       

     

       31
       33
        
       logo_text = "~hauleth"

     

       32
       34
        
       logo_home_link = "/"

     
···

       50
       52
        
       # Menu items to display. You define a url and the name of the menu item.

     

       51
       53
        
       main_menu = [

     

       52
       54
        
         {url="https://plan.cat/~hauleth", name=".plan", rel="me"},

     

       53
       53
       -
         {url="https://twitter.com/hauleth", name="twitter", rel="me"},

     

       54
       54
       -
         {url="https://fosstodon.org/@hauleth", name="mastodon", rel="me"},

     

       55
       55
       +
         {url="https://fosstodon.org/@hauleth", name="toots", rel="me"},

     

       56
       56
       +
         {url="https://sr.ht/~hauleth", name="sourcehut", rel="me"},

     

       55
       57
        
         {url="https://github.com/hauleth", name="github", rel="me"},

     

       56
       58
        
         {url="https://gitlab.com/hauleth", name="gitlab", rel="me"},

     

       57
       59
        
       ]

     
···

       71
       73
        
       [extra.twitter]

     

       72
       74
        
         site = "@hauleth"

     

       73
       75
        
         creator = "@hauleth"

     

       76
       76
       +
       

     

       77
       77
       +
       [[extra.webrings]]

     

       78
       78
       +
         name = "Beambloggers"

     

       79
       79
       +
         url = "https://beambloggers.com/"

+1 -4

content/post/beam-process-memory-usage.md

···

       6
       6
        
       [taxonomies]

     

       7
       7
        
       tags = [

     

       8
       8
        
         "beam",

     

       9
       9
       -
         "elixir",

     

       10
       10
       -
         "erlang",

     

       11
       11
       -
         "benchmarks",

     

       12
       12
       -
         "programming"

     

       9
       9
       +
         "performance"

     

       13
       10
        
       ]

     

       14
       11
        
       +++

     

       15
       12

+6 -11

content/post/common-test-for-elixir.md

···

       4
       4
        
       

     

       5
       5
        
       [taxonomies]

     

       6
       6
        
       tags = [

     

       7
       7
       -
        "erlang",

     

       8
       7
        
        "beam",

     

       9
       9
       -
        "elixir",

     

       10
       10
       -
        "testing",

     

       11
       11
       -
        "programming",

     

       12
       12
       -
        "common_test",

     

       13
       13
       -
        "commoner"

     

       8
       8
       +
        "testing"

     

       14
       9
        
       ]

     

       15
       10
        
       

     

       16
       11
        
       [[extra.thanks]]

     
···

       108
       103
        
       

     

       109
       104
        
       Just check [this out](/common-test-example/simple/index.html). This is example report

     

       110
       105
        
       generated by the Common Test. As you can see it contains a lot of information in

     

       111
       111
       -
       quite readable format. Not only it contains informations about current run, but

     

       106
       106
       +
       quite readable format. Not only it contains information about current run, but

     

       112
       107
        
       all previous runs as well, which is really handy when tracking regressions.

     

       113
       108
        
       

     

       114
       114
       -
       But can we store even more informations there? Yes, as CT includes simple

     

       115
       115
       -
       logging facility it is completely possible to log your own informations during

     

       116
       116
       -
       tests, for example, lets modify our test to log some informations:

     

       109
       109
       +
       But can we store even more information there? Yes, as CT includes simple

     

       110
       110
       +
       logging facility it is completely possible to log your own information during

     

       111
       111
       +
       tests, for example, lets modify our test to log some information:

     

       117
       112
        
       

     

       118
       113
        
       ```erlang

     

       119
       114
        
       test_function_name(_Config) ->

     
···

       121
       116
        
           2 = 1 + 1.

     

       122
       117
        
       ```

     

       123
       118
        
       

     

       124
       124
       -
       Now when we run tests again, then we will see more informations (even coloured)

     

       119
       119
       +
       Now when we run tests again, then we will see more information (even coloured)

     

       125
       120
        
       in [our test log](/common-test-example/log/ct_run.ct@NiunioBook.2019-07-16_11.03.21/common-test-example.log.logs/run.2019-07-16_11.03.22/example_suite.test_function_name.html):

     

       126
       121
        
       

     

       127
       122
        
       ![Common Test log "Example message" on green background](/img/common-test/log.png)

+1 -5

content/post/eli5-ownership.md

···

       5
       5
        
       

     

       6
       6
        
       [taxonomies]

     

       7
       7
        
       tags = [

     

       8
       8
       -
         "rust",

     

       9
       9
       -
         "programming",

     

       10
       10
       -
         "ownership",

     

       11
       11
       -
         "eli5",

     

       12
       12
       -
         "borrowing"

     

       8
       8
       +
         "rust"

     

       13
       9
        
       ]

     

       14
       10
        
       +++

     

       15
       11

+1 -4

content/post/elixir-application.md

···

       8
       8
        
       

     

       9
       9
        
       [taxonomies]

     

       10
       10
        
       tags = [

     

       11
       11
       -
         "elixir",

     

       12
       12
       -
         "erlang",

     

       13
       13
       -
         "beam",

     

       14
       14
       -
         "programming"

     

       11
       11
       +
         "beam"

     

       15
       12
        
       ]

     

       16
       13
        
       +++

     

       17
       14

+71

content/post/jeopardy-world.md

···

       1
       1
       +
       +++

     

       2
       2
       +
       title = "Jeopardy! world"

     

       3
       3
       +
       date = 2025-07-28

     

       4
       4
       +
       

     

       5
       5
       +
       [taxonomies]

     

       6
       6
       +
       tags = ["ai", "culture"]

     

       7
       7
       +
       +++

     

       8
       8
       +
       

     

       9
       9
       +
       Some time ago, there was an anime available on Netflix — *Godzilla Singular

     

       10
       10
       +
       Point*. It wasn't a spectacular success, but it featured a plot device that I

     

       11
       11
       +
       think reflects something increasingly common today: you need to know the answer

     

       12
       12
       +
       to your question before you can ask it.

     

       13
       13
       +
       

     

       14
       14
       +
       This is something I see all the time in the current wave of AI hype. You need to

     

       15
       15
       +
       know what the answer *should* be before you can write a useful prompt.

     

       16
       16
       +
       

     

       17
       17
       +
       <!-- more -->

     

       18
       18
       +
       

     

       19
       19
       +
       The issue I have with many AI use cases is this: unless you have specialized

     

       20
       20
       +
       knowledge about the topic you're asking about, you can't reliably tell the

     

       21
       21
       +
       difference between a solid AI answer and complete nonsense.

     

       22
       22
       +
       

     

       23
       23
       +
       I've had a few discussions about this on various Discord servers. The example I

     

       24
       24
       +
       often use is this simple question posed to an AI:

     

       25
       25
       +
       

     

       26
       26
       +
       > Does 6 character long identification number, that contains digits and upper

     

       27
       27
       +
       > case letters (with exception to 0, O, 1, I, and L) is enough to randomly

     

       28
       28
       +
       > assign unique identification numbers for 10 million records?

     

       29
       29
       +
       

     

       30
       30
       +
       You can see for your self answer from ChatGPT [there][chatgpt].

     

       31
       31
       +
       

     

       32
       32
       +
       At first glance, the answer looks valid and sensible. The math checks out. It

     

       33
       33
       +
       calculates the number of available combinations correctly. Everything seems

     

       34
       34
       +
       *fine*.

     

       35
       35
       +
       

     

       36
       36
       +
       **BUT…**

     

       37
       37
       +
       

     

       38
       38
       +
       There is huge issue there, and probably most of the people who have been working

     

       39
       39
       +
       with basic statistic or cryptography will notice it. ChatGPT (and any other AI

     

       40
       40
       +
       that I have tested out) fail to notice very important word there

     

       41
       41
       +
       

     

       42
       42
       +
       > \[…] randomly \[…]

     

       43
       43
       +
       

     

       44
       44
       +
       This single word invalidates the entire reasoning, despite the correct

     

       45
       45
       +
       calculations. Because of the [birthday problem][], the answer isn't feasible.

     

       46
       46
       +
       While it's technically possible to assign a unique ID to every record, doing so

     

       47
       47
       +
       randomly introduces a high probability of collisions.

     

       48
       48
       +
       

     

       49
       49
       +
       - At around 35,000 generated IDs, there's already a 50% chance of a collision

     

       50
       50
       +
       - At around 90,000, the chance of at least one duplicate reaches 99%

     

       51
       51
       +
       

     

       52
       52
       +
       So even though the math is correct, the logic fails under the randomness constraint.

     

       53
       53
       +
       

     

       54
       54
       +
       ## *Jeopardy!* world

     

       55
       55
       +
       

     

       56
       56
       +
       This is my main issue with AI tools: if you already have knowledge about the

     

       57
       57
       +
       subject, you don’t really need to ask the AI. But if you don’t have that

     

       58
       58
       +
       knowledge, you have no reliable way of knowing whether the answer makes sense or

     

       59
       59
       +
       not. It’s like playing *Jeopardy!* — you need to know the answer before you can

     

       60
       60
       +
       phrase the right question.

     

       61
       61
       +
       

     

       62
       62
       +
       In my view, AI is most useful in areas where the results can be quickly reviewed

     

       63
       63
       +
       and discarded if needed. That’s why the whole “vibe coding” (aka slop

     

       64
       64
       +
       generation) approach falls short. If you don’t have a good sense of what the

     

       65
       65
       +
       output should look like, you probably don’t have the expertise to verify it.

     

       66
       66
       +
       

     

       67
       67
       +
       [And gods forbid you from allowing AI to do anything on production][replit-fuckup].

     

       68
       68
       +
       

     

       69
       69
       +
       [chatgpt]: https://chatgpt.com/share/68879fe7-d4e0-8007-9a30-3a9e2ace791d

     

       70
       70
       +
       [birthday problem]: https://en.wikipedia.org/wiki/Birthday_problem

     

       71
       71
       +
       [replit-fuckup]: https://www.businessinsider.com/replit-ceo-apologizes-ai-coding-tool-delete-company-database-2025-7?op=1

+2 -3

content/post/log-all-the-things.md

···

       4
       4
        
       

     

       5
       5
        
       [taxonomies]

     

       6
       6
        
       tags = [

     

       7
       7
       -
         "elixir",

     

       8
       8
       -
         "programming",

     

       7
       7
       +
         "beam",

     

       9
       8
        
         "observability"

     

       10
       9
        
       ]

     

       11
       10
        
       

     
···

       309
       308
        
       )

     

       310
       309
        
       ```

     

       311
       310
        
       

     

       312
       312
       -
       As we can see there, the report contains informations like:

     

       311
       311
       +
       As we can see there, the report contains information like:

     

       313
       312
        
       

     

       314
       313
        
       - `:label` - that describes type of the event

     

       315
       314
        
       - `:report` - content of the "main" event

-1

content/post/stop-spreading-crap-at-my-home.md

···

       4
       4
        
       

     

       5
       5
        
       [taxonomies]

     

       6
       6
        
       tags = [

     

       7
       7
       -
         "programming",

     

       8
       7
        
         "culture"

     

       9
       8
        
       ]

     

       10
       9
        
       +++

-2

content/post/treachery-of-representation.md

···

       8
       8
        
       

     

       9
       9
        
       [taxonomies]

     

       10
       10
        
       tags = [

     

       11
       11
       -
         "programming",

     

       12
       12
       -
         "linguistic",

     

       13
       11
        
         "culture"

     

       14
       12
        
       ]

     

       15
       13
        
       +++

+2 -5

content/post/vim-for-elixir.md

···

       5
       5
        
       

     

       6
       6
        
       [taxonomies]

     

       7
       7
        
       tags = [

     

       8
       8
       -
         "elixir",

     

       9
       9
       -
         "erlang",

     

       10
       10
       -
         "vim",

     

       11
       11
       -
         "neovim",

     

       12
       12
       -
         "programming"

     

       8
       8
       +
         "beam",

     

       9
       9
       +
         "vim"

     

       13
       10
        
       ]

     

       14
       11
        
       +++

     

       15
       12

+5 -7

content/post/who-watches-watchmen-i.md

···

       12
       12
        
       

     

       13
       13
        
       [taxonomies]

     

       14
       14
        
       tags = [

     

       15
       15
       -
         "elixir",

     

       16
       16
       -
         "programming",

     

       17
       17
       -
         "systemd",

     

       18
       18
       -
         "deployment"

     

       15
       15
       +
         "beam",

     

       16
       16
       +
         "systemd"

     

       19
       17
        
       ]

     

       20
       18
        
       +++

     

       21
       19
        
       

     
···

       240
       238
        
       

     

       241
       239
        
       systemd supports the second approach via [`sd_notify`][sd_notify]. The approach

     

       242
       240
        
       there is simple - we have `NOTIFY_SOCKET` environment variable that contain path

     

       243
       243
       -
       to the Unix datagram socket, that we can use to send informations about state of

     

       241
       241
       +
       to the Unix datagram socket, that we can use to send information about state of

     

       244
       242
        
       our application. This socket accept set of different messages, but right now,

     

       245
       243
        
       for our purposes, we will focus only on few of them:

     

       246
       244
        
       

     

       247
       245
        
       - `READY=1` - marks our service as ready, aka it is ready to do its work (for

     

       248
       246
        
         example accept incoming HTTP connections in our example). It need to be sent

     

       249
       249
       -
         withing given timespan after start of the VM, otherwise the process will be

     

       247
       247
       +
         within given timespan after start of the VM, otherwise the process will be

     

       250
       248
        
         killed and possibly restarted

     

       251
       249
        
       - `STATUS=name` - sets status of our application that can be checked via

     

       252
       250
        
         `systemctl status hello.service`, this allows us to have better insight into

     
···

       444
       442
        
       

     

       445
       443
        
       Next thing is that we can do, is to [disable crash dumps generated by BEAM][crash].

     

       446
       444
        
       While not strictly needed in this case, it is worth remembering, that it isn't

     

       447
       447
       -
       hard to achieve, it is just using `Environment=ERL_CRASH_DUMP_SECONDS=0`.

     

       445
       445
       +
       hard to achieve, just use `Environment=ERL_CRASH_DUMP_SECONDS=0`.

     

       448
       446
        
       

     

       449
       447
        
       Our new, more secure, `hello.service` will look like:

     

       450
       448

+7 -9

content/post/who-watches-watchmen-ii.md

···

       1
       1
        
       +++

     

       2
       2
        
       title = "Who Watches Watchmen? - Part 2"

     

       3
       3
       -
       date = 2023-07-04

     

       3
       3
       +
       date = 2023-11-14

     

       4
       4
        
       

     

       5
       5
        
       description = """

     

       6
       6
        
       Continuation of travel into making systemd to work for us, not against us. This

     
···

       10
       10
        
       

     

       11
       11
        
       [taxonomies]

     

       12
       12
        
       tags = [

     

       13
       13
       -
         "elixir",

     

       14
       14
       -
         "programming",

     

       15
       15
       -
         "systemd",

     

       16
       16
       -
         "deployment"

     

       13
       13
       +
         "beam",

     

       14
       14
       +
         "systemd"

     

       17
       15
        
       ]

     

       18
       16
        
       

     

       19
       17
        
       [[extra.thanks]]

     

       20
       18
        
       name = "Nicodemus"

     

       21
       21
       -
       why = "Helping me with my poor English"

     

       19
       19
       +
       why = "helping me with my poor English"

     

       22
       20
        
       +++

     

       23
       21
        
       

     

       24
       22
        
       This is continuation of [Part I][part-i] where I described the basics of the

     
···

       187
       185
        
       Requires=sockets.target

     

       188
       186
        
       

     

       189
       187
        
       [Socket]

     

       190
       190
       -
       # We declare the name of the file descriptor here to simplify extraction in

     

       191
       191
       -
       # the application afterwards. By default it will be the socket name (so

     

       192
       192
       -
       # `hello-http` in our case), but `http` is much cleaner.

     

       188
       188
       +
       # We declare the name of the file descriptor here to simplify extraction

     

       189
       189
       +
       # in the application afterwards. By default it will be the socket name

     

       190
       190
       +
       # (so `hello-http` in our case), but `http` is much cleaner.

     

       193
       191
        
       FileDescriptorName=http

     

       194
       192
        
       ListenStream=80

     

       195
       193
        
       Service=hello.service

+291

content/post/writing-tests.md

···

       1
       1
       +
       +++

     

       2
       2
       +
       date = 2023-11-20

     

       3
       3
       +
       title = "How do I write Elixir tests?"

     

       4
       4
       +
       

     

       5
       5
       +
       draft = true

     

       6
       6
       +
       

     

       7
       7
       +
       [taxonomies]

     

       8
       8
       +
       tags = [

     

       9
       9
       +
           "beam",

     

       10
       10
       +
           "testing"

     

       11
       11
       +
       ]

     

       12
       12
       +
       +++

     

       13
       13
       +
       

     

       14
       14
       +
       This post was created for myself to codify some basic guides that I use while

     

       15
       15
       +
       writing tests. If you, my dear reader, read this then there is one important

     

       16
       16
       +
       thing for you to remember:

     

       17
       17
       +
       

     

       18
       18
       +
       These are **guides** not *rules*. Each code base is different deviations and are

     

       19
       19
       +
       expected and *will* happen. Just use the thing between your ears.

     

       20
       20
       +
       

     

       21
       21
       +
       ## `@subject` module attribute for module under test

     

       22
       22
       +
       

     

       23
       23
       +
       While writing test in Elixir it is not always obvious what we are testing. Just

     

       24
       24
       +
       imagine test like:

     

       25
       25
       +
       

     

       26
       26
       +
       ```elixir

     

       27
       27
       +
       test "foo should frobnicate when bar" do

     

       28
       28
       +
         bar = pick_bar()

     

       29
       29
       +
       

     

       30
       30
       +
         assert :ok == MyBehaviour.foo(MyImplementation, bar)

     

       31
       31
       +
       end

     

       32
       32
       +
       ```

     

       33
       33
       +
       

     

       34
       34
       +
       It is not obvious at the first sight what we are testing. And it is pretty

     

       35
       35
       +
       simplified example, in real world it can became even harder to notice what is

     

       36
       36
       +
       module under test (MUT).

     

       37
       37
       +
       

     

       38
       38
       +
       To resolve that I came up with a simple solution. I create module attribute

     

       39
       39
       +
       named `@subject` that points to the MUT:

     

       40
       40
       +
       

     

       41
       41
       +
       ```elixir

     

       42
       42
       +
       @subject MyImplementation

     

       43
       43
       +
       

     

       44
       44
       +
       test "foo should frobnicate when bar" do

     

       45
       45
       +
         bar = pick_bar()

     

       46
       46
       +
       

     

       47
       47
       +
         assert :ok == MyBehaviour.foo(@subject, bar)

     

       48
       48
       +
       end

     

       49
       49
       +
       ```

     

       50
       50
       +
       

     

       51
       51
       +
       Now it is more obvious what is MUT and what is just wrapper code around it.

     

       52
       52
       +
       

     

       53
       53
       +
       In the past I have been using `alias` with `:as` option, like:

     

       54
       54
       +
       

     

       55
       55
       +
       ```elixir

     

       56
       56
       +
       alias MyImplementation, as: Subject

     

       57
       57
       +
       ```

     

       58
       58
       +
       

     

       59
       59
       +
       However I find module attribute to be more visually outstanding and make it

     

       60
       60
       +
       easier for me to notice `@subject` than `Subject`. But your mileage may vary.

     

       61
       61
       +
       

     

       62
       62
       +
       ## `describe` with function name

     

       63
       63
       +
       

     

       64
       64
       +
       That one is pretty basic, and I have seen that it is pretty standard for people:

     

       65
       65
       +
       when you are writing tests for module functions, then group them in `describe`

     

       66
       66
       +
       blocks that will contain name (and arity) of the function in the name. Example:

     

       67
       67
       +
       

     

       68
       68
       +
       ```elixir

     

       69
       69
       +
       # Module under test

     

       70
       70
       +
       defmodule Foo do

     

       71
       71
       +
         def a(x, y, z) do

     

       72
       72
       +
           # some code

     

       73
       73
       +
         end

     

       74
       74
       +
       end

     

       75
       75
       +
       

     

       76
       76
       +
       # Tests

     

       77
       77
       +
       defmodule FooTest do

     

       78
       78
       +
         use ExUnit.Case, async: true

     

       79
       79
       +
       

     

       80
       80
       +
         @subject Foo

     

       81
       81
       +
       

     

       82
       82
       +
         describe "a/3" do

     

       83
       83
       +
           # Some tests here

     

       84
       84
       +
         end

     

       85
       85
       +
       end

     

       86
       86
       +
       ```

     

       87
       87
       +
       

     

       88
       88
       +
       This allows me to see what functionality I am testing.

     

       89
       89
       +
       

     

       90
       90
       +
       Of course that doesn't apply to the Phoenix controllers, as there we do not test

     

       91
       91
       +
       functions, but tuples in form `{method, path}` which I then write as `METHOD

     

       92
       92
       +
       path`, for example `POST /users`.

     

       93
       93
       +
       

     

       94
       94
       +
       ## Avoid module mocking

     

       95
       95
       +
       

     

       96
       96
       +
       In Elixir we have bunch of the mocking libraries out there, but most of them

     

       97
       97
       +
       have quite substantial issue for me - these prevent me from using `async: true`

     

       98
       98
       +
       for my tests. This often causes substantial performance hit, as it prevents

     

       99
       99
       +
       different modules to run in parallel (not single tests, *modules*, but that is

     

       100
       100
       +
       probably material for another post).

     

       101
       101
       +
       

     

       102
       102
       +
       Instead of mocks I prefer to utilise dependency injection. Some people may argue

     

       103
       103
       +
       that "Elixir is FP, not OOP, there is no need for DI" and they cannot be further

     

       104
       104
       +
       from truth. DI isn't related to OOP, it just have different form, called

     

       105
       105
       +
       function arguments. For example, if we want to have function that do something

     

       106
       106
       +
       with time, in particular - current time. Then instead of writing:

     

       107
       107
       +
       

     

       108
       108
       +
       ```elixir

     

       109
       109
       +
       def my_function(a, b) do

     

       110
       110
       +
         do_foo(a, b, DateTime.utc_now())

     

       111
       111
       +
       end

     

       112
       112
       +
       ```

     

       113
       113
       +
       

     

       114
       114
       +
       Which would require me to use mocks for `DateTime` or other workarounds to make

     

       115
       115
       +
       tests time-independent. I would do:

     

       116
       116
       +
       

     

       117
       117
       +
       ```elixir

     

       118
       118
       +
       def my_function(a, b, now \\ DateTime.utc_now()) do

     

       119
       119
       +
         do_foo(a, b, now)

     

       120
       120
       +
       end

     

       121
       121
       +
       ```

     

       122
       122
       +
       

     

       123
       123
       +
       Which still provide me the ergonomics of `my_function/2` as above, but is way

     

       124
       124
       +
       easier to test, as I can pass the date to the function itself. This allows me to

     

       125
       125
       +
       run this test in parallel as it will not cause other tests to do weird stuff

     

       126
       126
       +
       because of altered `DateTime` behaviour.

     

       127
       127
       +
       

     

       128
       128
       +
       ## Avoid `ex_machina` factories

     

       129
       129
       +
       

     

       130
       130
       +
       I have poor experience with tools like `ex_machina` or similar. These often

     

       131
       131
       +
       bring whole [Banana Gorilla Jungle problem][bgj] back, just changed a little, as

     

       132
       132
       +
       now instead of just passing data around, we create all needless structures for

     

       133
       133
       +
       sole purpose of test, even when they aren't needed for anything.

     

       134
       134
       +
       

     

       135
       135
       +
       [bgj]: https://softwareengineering.stackexchange.com/q/368797

     

       136
       136
       +
       

     

       137
       137
       +
       Start with example from [ExMachina README](https://github.com/beam-community/ex_machina#overview):

     

       138
       138
       +
       

     

       139
       139
       +
       ```elixir

     

       140
       140
       +
       defmodule MyApp.Factory do

     

       141
       141
       +
         # with Ecto

     

       142
       142
       +
         use ExMachina.Ecto, repo: MyApp.Repo

     

       143
       143
       +
       

     

       144
       144
       +
         # without Ecto

     

       145
       145
       +
         use ExMachina

     

       146
       146
       +
       

     

       147
       147
       +
         def user_factory do

     

       148
       148
       +
           %MyApp.User{

     

       149
       149
       +
             name: "Jane Smith",

     

       150
       150
       +
             email: sequence(:email, &"email-#{&1}@example.com"),

     

       151
       151
       +
             role: sequence(:role, ["admin", "user", "other"]),

     

       152
       152
       +
           }

     

       153
       153
       +
         end

     

       154
       154
       +
       

     

       155
       155
       +
         def article_factory do

     

       156
       156
       +
           title = sequence(:title, &"Use ExMachina! (Part #{&1})")

     

       157
       157
       +
           # derived attribute

     

       158
       158
       +
           slug = MyApp.Article.title_to_slug(title)

     

       159
       159
       +
           %MyApp.Article{

     

       160
       160
       +
             title: title,

     

       161
       161
       +
             slug: slug,

     

       162
       162
       +
             # associations are inserted when you call `insert`

     

       163
       163
       +
             author: build(:user),

     

       164
       164
       +
           }

     

       165
       165
       +
         end

     

       166
       166
       +
       

     

       167
       167
       +
         # derived factory

     

       168
       168
       +
         def featured_article_factory do

     

       169
       169
       +
           struct!(

     

       170
       170
       +
             article_factory(),

     

       171
       171
       +
             %{

     

       172
       172
       +
               featured: true,

     

       173
       173
       +
             }

     

       174
       174
       +
           )

     

       175
       175
       +
         end

     

       176
       176
       +
       

     

       177
       177
       +
         def comment_factory do

     

       178
       178
       +
           %MyApp.Comment{

     

       179
       179
       +
             text: "It's great!",

     

       180
       180
       +
             article: build(:article),

     

       181
       181
       +
             author: build(:user) # That line is added by me

     

       182
       182
       +
           }

     

       183
       183
       +
         end

     

       184
       184
       +
       end

     

       185
       185
       +
       ```

     

       186
       186
       +
       

     

       187
       187
       +
       For start we can see a single problem there - we do not validate our factories

     

       188
       188
       +
       against our schema changesets. Without additional tests like:

     

       189
       189
       +
       

     

       190
       190
       +
       ```elixir

     

       191
       191
       +
       @subject MyApp.Article

     

       192
       192
       +
       

     

       193
       193
       +
       test "factory conforms to changeset" do

     

       194
       194
       +
         changeset = @subject.changeset(%@subject{}, params_for(:article))

     

       195
       195
       +
       

     

       196
       196
       +
         assert changeset.valid?

     

       197
       197
       +
       end

     

       198
       198
       +
       ```

     

       199
       199
       +
       

     

       200
       200
       +
       We cannot be sure that our tests test what we want them to test. And if we pass

     

       201
       201
       +
       custom attribute values in some tests it gets even worse, because we cannot be

     

       202
       202
       +
       sure if these are conforming either.

     

       203
       203
       +
       

     

       204
       204
       +
       That mean that our tests may be moot, because we aren't testing against real

     

       205
       205
       +
       situations, but against some predefined state.

     

       206
       206
       +
       

     

       207
       207
       +
       Another problem is that if we need to alter the behaviour of the factory it can

     

       208
       208
       +
       became quite convoluted. Imagine situation when we want to test if comments by

     

       209
       209
       +
       author of the post have some special behaviour (for example it has some

     

       210
       210
       +
       additional CSS class to be able to mark them in CSS). That require from us to do

     

       211
       211
       +
       some dancing around passing custom attributes:

     

       212
       212
       +
       

     

       213
       213
       +
       ```elixir

     

       214
       214
       +
       test "comments by author are special" do

     

       215
       215
       +
         post = insert(:post)

     

       216
       216
       +
         comment = insert(:comment, post: post, author: post.author)

     

       217
       217
       +
       

     

       218
       218
       +
         # rest of the test

     

       219
       219
       +
       end

     

       220
       220
       +
       ```

     

       221
       221
       +
       

     

       222
       222
       +
       And this is simplified example. In the past I needed to deal with situations

     

       223
       223
       +
       where I was creating a lot of data to pass through custom attributes to make

     

       224
       224
       +
       test sensible.

     

       225
       225
       +
       

     

       226
       226
       +
       Instead I prefer to do stuff directly in code. Instead of relying on some

     

       227
       227
       +
       "magical" functions provided by some "magical" macros from external library I

     

       228
       228
       +
       can use what I already have - functions in my application.

     

       229
       229
       +
       

     

       230
       230
       +
       Instead of:

     

       231
       231
       +
       

     

       232
       232
       +
       ```elixir

     

       233
       233
       +
       test "comments by author are special" do

     

       234
       234
       +
         post = insert(:post)

     

       235
       235
       +
         comment = insert(:comment, post: post, author: post.author)

     

       236
       236
       +
       

     

       237
       237
       +
         # rest of the test

     

       238
       238
       +
       end

     

       239
       239
       +
       ```

     

       240
       240
       +
       

     

       241
       241
       +
       Write:

     

       242
       242
       +
       

     

       243
       243
       +
       ```elixir

     

       244
       244
       +
       test "comments by author are special" do

     

       245
       245
       +
         author = MyApp.Users.create(%{

     

       246
       246
       +
             name: "John Doe",

     

       247
       247
       +
             email: "john@example.com"

     

       248
       248
       +
           })

     

       249
       249
       +
         post = MyApp.Blog.create_article(%{

     

       250
       250
       +
             author: author,

     

       251
       251
       +
             content: "Foo bar",

     

       252
       252
       +
             title: "Foo bar"

     

       253
       253
       +
           })

     

       254
       254
       +
         comment = MyApp.Blog.create_comment_for(article, %{

     

       255
       255
       +
             author: author,

     

       256
       256
       +
             content: "Foo bar"

     

       257
       257
       +
           })

     

       258
       258
       +
       

     

       259
       259
       +
         # rest of the test

     

       260
       260
       +
       end

     

       261
       261
       +
       ```

     

       262
       262
       +
       

     

       263
       263
       +
       It may be a little bit more verbose, but it makes tests way more readable in my

     

       264
       264
       +
       opinion. You have all details just in place and you know what to expect. And if

     

       265
       265
       +
       you need some piece of data in all (or almost all) tests within

     

       266
       266
       +
       module/`describe` block, then you can always can use `setup/1` blocks. Or you

     

       267
       267
       +
       can create function per module that will generate data for you. As long as your

     

       268
       268
       +
       test module is self-contained and do not receive "magical" data out of thin air,

     

       269
       269
       +
       it is ok for me. But `ex_machina` is, in my opinion, terrible idea brought from

     

       270
       270
       +
       Rails world, that make little to no sense in Elixir.

     

       271
       271
       +
       

     

       272
       272
       +
       If you really need such factories, then just write your own functions that will

     

       273
       273
       +
       use your contexts instead of relying on another library. For example:

     

       274
       274
       +
       

     

       275
       275
       +
       ```elixir

     

       276
       276
       +
       import ExUnit.Assertions

     

       277
       277
       +
       

     

       278
       278
       +
       def create_user(name, email \\ nil, attrs \\ %{}) do

     

       279
       279
       +
         email = email || "#{String.replace(name, " ", ".")}@example.com"

     

       280
       280
       +
         attrs = Map.merge(attrs, %{name: name, email: email})

     

       281
       281
       +
       

     

       282
       282
       +
         assert {:ok, user} = MyApp.Users.create(attrs)

     

       283
       283
       +
       

     

       284
       284
       +
         user

     

       285
       285
       +
       end

     

       286
       286
       +
       

     

       287
       287
       +
       # And so on…

     

       288
       288
       +
       ```

     

       289
       289
       +
       

     

       290
       290
       +
       This way you do not need to check if all tests use correct validations any

     

       291
       291
       +
       longer, as your system will do that for you.

+2 -3

content/post/writing-vim-plugin.md

···

       3
       3
        
       date = 2019-11-04T18:21:18+01:00

     

       4
       4
        
       description = """

     

       5
       5
        
       Article about writing Vim plugins, but not about writing Vim plugins. It is

     

       6
       6
       -
       how to concieve plugin, how to go from an idea to the full fledged plugin."""

     

       6
       6
       +
       how to conceive plugin, how to go from an idea to the full fledged plugin."""

     

       7
       7
        
       

     

       8
       8
        
       [taxonomies]

     

       9
       9
        
       tags = [

     

       10
       10
       -
         "vim",

     

       11
       11
       -
         "viml"

     

       10
       10
       +
         "vim"

     

       12
       11
        
       ]

     

       13
       12
        
       +++

     

       14
       13

+6 -7

flake.lock

···

       5
       5
        
               "systems": "systems"

     

       6
       6
        
             },

     

       7
       7
        
             "locked": {

     

       8
       8
       -
               "lastModified": 1687709756,

     

       9
       9
       -
               "narHash": "sha256-Y5wKlQSkgEK2weWdOu4J3riRd+kV/VCgHsqLNTTWQ/0=",

     

       8
       8
       +
               "lastModified": 1731533236,

     

       9
       9
       +
               "narHash": "sha256-l0KFg5HjrsfsO/JpG+r7fRrqm12kzFHyUHqHCVpMMbI=",

     

       10
       10
        
               "owner": "numtide",

     

       11
       11
        
               "repo": "flake-utils",

     

       12
       12
       -
               "rev": "dbabf0ca0c0c4bce6ea5eaf65af5cb694d2082c7",

     

       12
       12
       +
               "rev": "11707dc2f618dd54ca8739b309ec4fc024de578b",

     

       13
       13
        
               "type": "github"

     

       14
       14
        
             },

     

       15
       15
        
             "original": {

     
···

       20
       20
        
           },

     

       21
       21
        
           "nixpkgs": {

     

       22
       22
        
             "locked": {

     

       23
       23
       -
               "lastModified": 1687103638,

     

       24
       24
       -
               "narHash": "sha256-dwy/TK6Db5W7ivcgmcxUykhFwodIg0jrRzOFt7H5NUc=",

     

       25
       25
       -
               "path": "/nix/store/p57nnwjhfvmsn75y9l6hn00pl2xv7ivm-source",

     

       26
       26
       -
               "rev": "91430887645a0953568da2f3e9a3a3bb0a0378ac",

     

       23
       23
       +
               "lastModified": 0,

     

       24
       24
       +
               "narHash": "sha256-cnL5WWn/xkZoyH/03NNUS7QgW5vI7D1i74g48qplCvg=",

     

       25
       25
       +
               "path": "/nix/store/h15y13p2w17dhpiyh8pk42v1k4c38a0h-source",

     

       27
       26
        
               "type": "path"

     

       28
       27
        
             },

     

       29
       28
        
             "original": {

+11 -4

flake.nix

···

       13
       13
        
       

     

       14
       14
        
                 nativeBuildInputs = [

     

       15
       15
        
                   pkgs.zola

     

       16
       16
       -
                   pkgs.gitMinimal

     

       17
       16
        
                 ];

     

       18
       17
        
       

     

       19
       18
        
                 buildPhase = ''

     

       20
       20
       -
                   git submodule update --init --recursive --depth=1

     

       21
       21
       -
                   zola build -o $out

     

       19
       19
       +
                   zola --version

     

       20
       20
       +
                   zola build --output-dir $out

     

       22
       21
        
                 '';

     

       23
       22
        
       

     

       24
       23
        
                 dontInstall = true;

     

       25
       24
        
               };

     

       26
       25
        
             in

     

       27
       26
        
             {

     

       27
       27
       +
               apps.publish = let

     

       28
       28
       +
                 program = pkgs.writeShellScript "publish" ''

     

       29
       29
       +
                   cp -r ${self.packages.${system}.blog} public

     

       30
       30
       +
                   '';

     

       31
       31
       +
               in {

     

       32
       32
       +
                 type = "app";

     

       33
       33
       +
                 program = "${program}";

     

       34
       34
       +
               };

     

       28
       35
        
               packages = {

     

       29
       36
        
                 inherit blog;

     

       30
       37
        
               };

     
···

       34
       41
        
                 inputsFrom = [ blog ];

     

       35
       42
        
       

     

       36
       43
        
                 packages = [

     

       37
       37
       -
                   pkgs.netlify-cli

     

       44
       44
       +
                   # pkgs.netlify-cli

     

       38
       45
        
                   pkgs.vale

     

       39
       46
        
                   pkgs.mdl

     

       40
       47
        
                 ];

+15 -4

netlify.toml

···

       2
       2
        
         command = "zola build"

     

       3
       3
        
         publish = "public/"

     

       4
       4
        
       

     

       5
       5
       +
         [build.environment]

     

       6
       6
       +
           ZOLA_VERSION = "0.20.0"

     

       7
       7
       +
       

     

       5
       8
        
       [context.deploy-preview]

     

       6
       9
        
         command = "zola build --drafts --base-url $DEPLOY_PRIME_URL"

     

       7
       10
        
       

     
···

       14
       17
        
           X-Frame-Options = "DENY"

     

       15
       18
        
           X-XSS-Protection = "1; mode=block"

     

       16
       19
        
           X-Content-Type-Options = "nosniff"

     

       17
       17
       -
           Content-Security-Policy = "default-src 'self'; script-src 'self' https://plausible.io; connect-src https://plausible.io; img-src https:"

     

       20
       20
       +
           X-Clacks-Overhead = "GNU Terry Pratchett"

     

       21
       21
       +
           Content-Security-Policy = "default-src 'self'; script-src 'self'; connect-src 'self'; img-src https:"

     

       18
       22
        
           Permissions-Policy = "accelerometer=(), ambient-light-sensor=(), autoplay=(), battery=(), camera=(), cross-origin-isolated=(), display-capture=(), document-domain=(), encrypted-media=(), execution-while-not-rendered=(), execution-while-out-of-viewport=(), fullscreen=(), geolocation=(), gyroscope=(), keyboard-map=(), magnetometer=(), microphone=(), midi=(), navigation-override=(), payment=(), picture-in-picture=(), publickey-credentials-get=(), screen-wake-lock=(), sync-xhr=(), usb=(), web-share=(), xr-spatial-tracking=(), clipboard-read=(), clipboard-write=(), gamepad=(), speaker-selection=()"

     

       19
       23
        
           Referrer-Policy = "no-referrer-when-downgrade"

     

       20
       24
        
       

     
···

       33
       37
        
         to = "https://fosstodon.org/.well-known/webfinger?resource=acct:hauleth@fosstodon.org"

     

       34
       38
        
         status = 200

     

       35
       39
        
       

     

       40
       40
       +
       [[redirects]]

     

       41
       41
       +
         from = "/js/script.js"

     

       42
       42
       +
         to = "https://plausible.io/js/script.js"

     

       43
       43
       +
         status = 200

     

       44
       44
       +
       

     

       45
       45
       +
       [[redirects]]

     

       46
       46
       +
         from = "/api/event"

     

       47
       47
       +
         to = "https://plausible.io/api/event"

     

       48
       48
       +
         status = 200

     

       49
       49
       +
       

     

       36
       50
        
       [[plugins]]

     

       37
       51
        
         package = "netlify-plugin-webmentions"

     

       38
       52
        
       

     

       39
       53
        
         [plugins.inputs]

     

       40
       54
        
         feedPath = "atom.xml"

     

       41
       41
       -
       

     

       42
       42
       -
       [[plugins]]

     

       43
       43
       -
         package = "netlify-plugin-submit-sitemap"

-12

sass/_header.scss

···

       1
       1
        
       @import "variables";

     

       2
       2
        
       

     

       3
       3
       -
       @mixin menu {

     

       4
       4
       -
         position: absolute;

     

       5
       5
       -
         background: var(--background);

     

       6
       6
       -
         box-shadow: var(--shadow);

     

       7
       7
       -
         color: white;

     

       8
       8
       -
         border: 2px solid;

     

       9
       9
       -
         margin: 0;

     

       10
       10
       -
         padding: 10px;

     

       11
       11
       -
         list-style: none;

     

       12
       12
       -
         z-index: 99;

     

       13
       13
       -
       }

     

       14
       14
       -
       

     

       15
       3
        
       .header {

     

       16
       4
        
         @media print {

     

       17
       5
        
           display: none;

+15 -9

sass/_main.scss

···

       1
       1
        
       @import "variables";

     

       2
       2
        
       

     

       3
       3
       +
       :root {

     

       4
       4
       +
         font-size: calc(1rem + 0.05vw);

     

       5
       5
       +
         line-height: 1.54;

     

       6
       6
       +
         color: var(--color);

     

       7
       7
       +
       

     

       8
       8
       +
         @media print {

     

       9
       9
       +
           color: #000;

     

       10
       10
       +
           line-height: 1.2;

     

       11
       11
       +
           font-size: 10pt;

     

       12
       12
       +
         }

     

       13
       13
       +
       }

     

       14
       14
       +
       

     

       3
       15
        
       html {

     

       4
       16
        
         box-sizing: border-box;

     

       5
       17
        
       }

     
···

       14
       26
        
         margin: 0;

     

       15
       27
        
         padding: 0;

     

       16
       28
        
         font-family: ui-monospace, monospace;

     

       17
       17
       -
         font-size: 12pt;

     

       18
       18
       -
         line-height: 1.54;

     

       19
       29
        
         background-color: var(--background);

     

       20
       20
       -
         color: var(--color);

     

       21
       30
        
         // text-shadow: 0 0 3px currentcolor;

     

       22
       31
        
         text-rendering: optimizeLegibility;

     

       23
       32
        
         -webkit-font-smoothing: antialiased;

     

       24
       33
        
         -webkit-overflow-scrolling: touch;

     

       25
       34
        
         -webkit-text-size-adjust: 100%;

     

       26
       26
       -
       

     

       27
       27
       -
         @media print {

     

       28
       28
       -
           color: #000;

     

       29
       29
       -
           line-height: 1.2;

     

       30
       30
       -
           font-size: 10pt;

     

       31
       31
       -
         }

     

       32
       35
        
       }

     

       33
       36
        
       

     

       34
       37
        
       h1, h2, h3, h4, h5, h6 {

     
···

       102
       105
        
         padding: 1px 6px;

     

       103
       106
        
         margin: 0 2px;

     

       104
       107
        
         font-size: .95rem;

     

       108
       108
       +
         hyphens: none;

     

       105
       109
        
       }

     

       106
       110
        
       

     

       107
       111
        
       pre {

     
···

       164
       168
        
             display: block;

     

       165
       169
        
             position: absolute;

     

       166
       170
        
             left: -25px;

     

       171
       171
       +
             top: .1em;

     

       167
       172
        
             color: var(--accent);

     

       168
       173
        
           }

     

       169
       174
        
         }

     
···

       253
       258
        
       

     

       254
       259
        
           // Todo change it to ::marker when Safari will support it

     

       255
       260
        
           &::before {

     

       261
       261
       +
             margin-left: -2rem;

     

       256
       262
        
             content: counters(li, ".") ". ";

     

       257
       263
        
           }

     

       258
       264
        
         }

+5 -2

sass/_post.scss

···

       2
       2
        
       

     

       3
       3
        
       .post {

     

       4
       4
        
         width: 100%;

     

       5
       5
       -
         text-align: left;

     

       5
       5
       +
         text-align: justify;

     

       6
       6
       +
         text-wrap: pretty;

     

       7
       7
       +
         hyphens: auto;

     

       8
       8
       +
         hyphenate-limit-chars: 10;

     

       6
       9
        
         margin: 20px auto;

     

       7
       10
        
         padding: 20px 0 0 0;

     

       11
       11
       +
       

     

       8
       12
        
       

     

       9
       13
        
         @media (max-width: $tablet-max-width) {

     

       10
       14
        
           margin: 0 auto;

     
···

       62
       66
        
       

     

       63
       67
        
         &-content {

     

       64
       68
        
           margin-top: 30px;

     

       65
       65
       -
           position: relative;

     

       66
       69
        
         }

     

       67
       70
        
       

     

       68
       71
        
         &-cover {

+40

sass/_rings.scss

···

       1
       1
       +
       .rings {

     

       2
       2
       +
         margin-top: 1rem;

     

       3
       3
       +
         text-align: center;

     

       4
       4
       +
       

     

       5
       5
       +
         details > summary {

     

       6
       6
       +
           list-style: none;

     

       7
       7
       +
           cursor: pointer;

     

       8
       8
       +
       

     

       9
       9
       +
           &::before, &::after {

     

       10
       10
       +
             margin: 0 .5rem;

     

       11
       11
       +
           }

     

       12
       12
       +
       

     

       13
       13
       +
           &::before { content: '▶'; }

     

       14
       14
       +
           &::after { content: '◀'; }

     

       15
       15
       +
       

     

       16
       16
       +
           &::-webkit-details-marker {

     

       17
       17
       +
             display: none;

     

       18
       18
       +
           }

     

       19
       19
       +
         }

     

       20
       20
       +
       

     

       21
       21
       +
         details[open] {

     

       22
       22
       +
           summary {

     

       23
       23
       +
             &::before, &::after {

     

       24
       24
       +
               content: '▼';

     

       25
       25
       +
             }

     

       26
       26
       +
       

     

       27
       27
       +
             margin-bottom: 1rem;

     

       28
       28
       +
           }

     

       29
       29
       +
         }

     

       30
       30
       +
       

     

       31
       31
       +
         ul {

     

       32
       32
       +
           list-style: none;

     

       33
       33
       +
           margin: 0;

     

       34
       34
       +
         }

     

       35
       35
       +
       

     

       36
       36
       +
         li {

     

       37
       37
       +
           margin: 0;

     

       38
       38
       +
           padding: 0;

     

       39
       39
       +
         }

     

       40
       40
       +
       }

+1

sass/style.scss

···

       6
       6
        
       @import 'post';

     

       7
       7
        
       @import 'pagination';

     

       8
       8
        
       @import 'footer';

     

       9
       9
       +
       @import 'rings';

     

       9
       10
        
       

     

       10
       11
        
       :root {

     

       11
       12
        
         --phoneWidth: (max-width: #{$phone-max-width + 1px});

+9

static/_headers

···

       1
       1
       +
       *

     

       2
       2
       +
         Permission-Policy: interest-cohort=()

     

       3
       3
       +
         X-Frame-Options: DENY

     

       4
       4
       +
         X-XSS-Protection: 1; mode=block

     

       5
       5
       +
         X-Clacks-Overhead: GNU Terry Pratchet

     

       6
       6
       +
         X-Clacks-Overhead: GNU Joe Armstrong

     

       7
       7
       +
         Content-Security-Policy: default-src 'self'; script-src 'self'; connect-src 'self'; img-src 'self'; frame-src 'none'; frame-ancestors 'none'; form-action 'none'; base-uri 'self';

     

       8
       8
       +
         Permissions-Policy: accelerometer=(), ambient-light-sensor=(), autoplay=(), battery=(), camera=(), cross-origin-isolated=(), display-capture=(), document-domain=(), encrypted-media=(), execution-while-not-rendered=(), execution-while-out-of-viewport=(), fullscreen=(), geolocation=(), gyroscope=(), keyboard-map=(), magnetometer=(), microphone=(), midi=(), navigation-override=(), payment=(), picture-in-picture=(), publickey-credentials-get=(), screen-wake-lock=(), sync-xhr=(), usb=(), web-share=(), xr-spatial-tracking=(), clipboard-read=(), clipboard-write=(), gamepad=(), speaker-selection=()

     

       9
       9
       +
         Referrer-Policy: strict-origin-when-cross-origin

+3

static/_redirects

···

       1
       1
       +
       /js/script.js https://plausible.io/js/script.js 200

     

       2
       2
       +
       /api/event https://plausible.io/api/event 200

     

       3
       3
       +
       /.well-known/webfinger https://fosstodon.org/.well-known/webfinger?resource=acct:hauleth@fosstodon.org 200

+9

statichost.yml

···

       1
       1
       +
       image: ghcr.io/getzola/zola:v0.21.0

     

       2
       2
       +
       command: build

     

       3
       3
       +
       public: public

     

       4
       4
       +
       image_entrypoint: true

     

       5
       5
       +
       

     

       6
       6
       +
       # TODO: Usa nix there

     

       7
       7
       +
       # image: ghcr.io/lix-project/lix:latest

     

       8
       8
       +
       # command: nix --extra-experimental-features nix-command --extra-experimental-features flakes run .#publish

     

       9
       9
       +
       # public: public

+45 -7

templates/index.html

···

       1
       1
        
       {% extends "zerm/templates/index.html" %}

     

       2
       2
        
       

     

       3
       3
        
       {% block fonts %}

     

       4
       4
       -
       {% endblock %}

     

       4
       4
       +
       {% endblock fonts %}

     

       5
       5
        
       

     

       6
       6
        
       {% block rss %}

     

       7
       7
        
         {%- if config.generate_feed -%}

     

       8
       8
       -
           <link rel="alternate" type="application/atom+xml" title="{{ config.title }} Feed" href="{{ get_url(path=config.feed_filename) | safe}}">

     

       8
       8
       +
           <link rel="alternate" type="application/atom+xml" title="{{ config.title }} Feed" href="{{ get_url(path="atom.xml", trailing_slash=false) }}">

     

       9
       9
        
         {%- endif -%}

     

       10
       10
       -
       {% endblock %}

     

       10
       10
       +
       {% endblock rss %}

     

       11
       11
        
       

     

       12
       12
        
       {% block og_preview %}

     

       13
       13
       +
         {%- if section -%}

     

       14
       14
       +
           <link rel="canonical" href="{{ section.permalink }}" />

     

       15
       15
       +
         {%- elif page -%}

     

       16
       16
       +
           <link rel="canonical" href="{{ page.permalink }}" />

     

       17
       17
       +
         {%- else -%}

     

       18
       18
       +
           <link rel="canonical" href="{{ current_url }}" />

     

       19
       19
       +
         {%- endif -%}

     

       13
       20
        
         {{ social::og_preview() }}

     

       14
       21
        
       

     

       15
       22
        
         {%- if config.extra.twitter.site -%}

     
···

       22
       29
        
         {%- if config.extra.webmention -%}

     

       23
       30
        
           <link rel="webmention" href="{{ config.extra.webmention }}" >

     

       24
       31
        
         {%- endif -%}

     

       25
       25
       -
       {% endblock %}

     

       32
       32
       +
       {% endblock og_preview %}

     

       26
       33
        
       

     

       27
       34
        
       {% block copyright %}

     

       28
       35
        
         <div class="copyright">

     

       29
       36
        
           <div class="copyright--user">{{ config.extra.copyright | safe }}</div>

     

       30
       37
        
           <div class="copyright--tracking">

     

       31
       31
       -
             Public tracking available at <a href="https://plausible.io/hauleth.dev">Plausible.io</a>

     

       38
       38
       +
             public tracking available at <a href="https://plausible.io/hauleth.dev">Plausible.io</a>

     

       39
       39
       +
           </div>

     

       40
       40
       +
           <div class="copyright--source">

     

       41
       41
       +
               <a href="{{ config.extra.source }}">source code</a>

     

       32
       42
        
           </div>

     

       33
       43
        
         </div>

     

       34
       44
        
       {% endblock copyright %}

     

       35
       45
        
       

     

       36
       46
        
       {% block script %}

     

       37
       37
       -
         <script async defer data-domain="hauleth.dev" src="https://plausible.io/js/plausible.js"></script>

     

       47
       47
       +
         <script defer data-domain="hauleth.dev" src="/js/script.js"></script>

     

       38
       48
        
       {% endblock script %}

     

       39
       49
        
       

     

       40
       50
        
       {% block css %}

     
···

       67
       77
        
             </ul>

     

       68
       78
        
           </nav>

     

       69
       79
        
         </header>

     

       70
       70
       -
       {% endblock %}

     

       80
       80
       +
       {% endblock header %}

     

       81
       81
       +
       

     

       82
       82
       +
       {% block general_meta %}

     

       83
       83
       +
           <meta http-equiv="content-type" content="text/html; charset=utf-8">

     

       84
       84
       +
           <meta name="viewport" content="width=device-width, initial-scale=1">

     

       85
       85
       +
           {%- if page.title -%}

     

       86
       86
       +
               <meta name="description" content="{{ config.description }} {{ page.title }} {{ page.description }}"/>

     

       87
       87
       +
           {%- else -%}

     

       88
       88
       +
               <meta name="description" content="{{ config.description }}"/>

     

       89
       89
       +
           {%- endif -%}

     

       90
       90
       +
       

     

       91
       91
       +
           {%- if page.taxonomies.tags or page.taxonomies.categories -%}

     

       92
       92
       +
               <meta name="keywords" content="

     

       93
       93
       +
               {%- if page.taxonomies.categories -%}

     

       94
       94
       +
                   {%- for cat in page.taxonomies.categories -%}

     

       95
       95
       +
                           {{ cat }}, {% endfor -%}

     

       96
       96
       +
               {%- endif -%}

     

       97
       97
       +
       

     

       98
       98
       +
               {%- if page.taxonomies.tags -%}

     

       99
       99
       +
                   {%- for tag in page.taxonomies.tags -%}

     

       100
       100
       +
                       {%- if loop.last -%}

     

       101
       101
       +
                           {{ tag }}

     

       102
       102
       +
                       {%- else -%}

     

       103
       103
       +
                           {{ tag }}, {% endif -%}

     

       104
       104
       +
                   {%- endfor -%}

     

       105
       105
       +
               {%- endif -%}

     

       106
       106
       +
               " />

     

       107
       107
       +
           {%- endif -%}

     

       108
       108
       +
       {% endblock general_meta %}

+16

templates/macros/extended_footer.html

···

       1
       1
       +
       {% macro extended_footer() %}

     

       2
       2
       +
         <div class="rings">

     

       3
       3
       +
           <details>

     

       4
       4
       +
             <summary>Webrings</summary>

     

       5
       5
       +
             <ul>

     

       6
       6
       +
               {%- for ring in config.extra.webrings -%}

     

       7
       7
       +
               <li>

     

       8
       8
       +
                 <a href="{{ ring.url }}/prev?referrer={{ get_url(path = "/") | safe }}">&laquo;</a>

     

       9
       9
       +
                 <a href="{{ ring.url }}">{{ ring.name }}</a>

     

       10
       10
       +
                 <a href="{{ ring.url }}/next?referrer={{ get_url(path = "/") | safe }}">&raquo;</a>

     

       11
       11
       +
               </li>

     

       12
       12
       +
               {%- endfor -%}

     

       13
       13
       +
             </ul>

     

       14
       14
       +
           </details>

     

       15
       15
       +
         </div>

     

       16
       16
       +
       {% endmacro extended_footer %}

+1 -1

templates/robots.txt

···

       1
       1
        
       User-agent: *

     

       2
       2
       -
       Disallow: /cv/

     

       2
       2
       +
       Disallow: /cv/ /404/ /common-test-example/

     

       3
       3
        
       Allow: /

     

       4
       4
        
       Sitemap: {{ get_url(path="sitemap.xml") }}

+65 -44

templates/shortcodes/cv.md

···

       3
       3
        
       ## Personal information

     

       4
       4
        
       

     

       5
       5
        
       Email:

     

       6
       6
       -
         <lukasz@niemier.pl>

     

       6
       6
       +
         <~@hauleth.dev>

     

       7
       7
        
       

     

       8
       8
        
       Website:

     

       9
       9
        
         <https://hauleth.dev>

     
···

       18
       18
        
       

     

       19
       19
        
       ## Experience

     

       20
       20
        
       

     

       21
       21
       -
       - Prograils - Junior Developer - 2013

     

       22
       22
       -
       - Nukomeet - Full-stack Developer - 2015-2016

     

       21
       21
       +
       - Hauleth.dev - Consultant - 2021+

     

       22
       22
       +
           + DockYard/Karambit.ai - 2025

     

       23
       23
       +
               * Architectural analysis of Karambit product

     

       24
       24
       +
               * Prepared security analysis with detailed report with fixes

     

       25
       25
       +
           + Eiger - 2022-2023

     

       26
       26
       +
               * Forte.io

     

       27
       27
       +
                   - Implemented Interledger protocol for cross-chain transactions

     

       28
       28
       +
               * Aleo Blockchain

     

       29
       29
       +
                   - Implemented GraphQL API for the on-chain data

     

       30
       30
       +
                   - Created syntax colouring library for Aleo assembly-like language

     

       31
       31
       +
                     for smart contracts

     

       32
       32
       +
           + Erlang Solutions/Kloeckner GmbH - 2021 - Consultant for Elixir, Ruby,

     

       33
       33
       +
             and SQL (PostgreSQL)

     

       34
       34
       +
               * Optimised DB query performance by providing PostgreSQL structure

     

       35
       35
       +
                 analysis and improving indices usage

     

       36
       36
       +
           + Remote Inc. - Senior Backend Engineer - 2020-2021

     

       37
       37
       +
               * Architectural analysis of existing codebase

     

       38
       38
       +
           + Kobil GmbH - Erlang/Elixir Developer - 2019-2020

     

       39
       39
       +
               * Maintained MongoDB driver for Elixir

     

       40
       40
       +
               * Implemented transactions for MongoDB driver in Elixir

     

       41
       41
       +
       - Supabase - 2023-2025

     

       42
       42
       +
           + Logflare - logs aggregation service:

     

       43
       43
       +
               * Implemented on-the-fly decompression of incoming data that improved

     

       44
       44
       +
                 ingestion possibilities and reduced transfer usage (created library

     

       45
       45
       +
                 [`plug_caisson`][] for that purpose)

     

       46
       46
       +
               * Implemented DataDog-compatible ingestion endpoint for seamless

     

       47
       47
       +
                 transition from DataDog provider to Logflare

     

       48
       48
       +
               * Improved BigQuery pipeline workflow to reduce congestion on database

     

       49
       49
       +
                 connections

     

       50
       50
       +
               * Added support for AWS Cloud Events metadata extraction

     

       51
       51
       +
               * Improved CI usage by splitting different actions to separate steps ran

     

       52
       52
       +
                 in parallel

     

       53
       53
       +
               * Replaced dynamic generation of connection modules for PostgreSQL

     

       54
       54
       +
                 storage system with Ecto's dynamic repositories to avoid atom exhaustion

     

       55
       55
       +
           + Supavisor - a cloud-native, multi-tenant Postgres connection pooler

     

       56
       56
       +
               * Deployment management

     

       57
       57
       +
               * Optimised metrics gathering system that resulted in an order of

     

       58
       58
       +
                 magnitude performance boost

     

       59
       59
       +
               * Updated used OTP and Elixir versions from OTP 24 to OTP 27 and Elixir

     

       60
       60
       +
                 from 1.14 to 1.18

     

       61
       61
       +
               * Reduced usage of mocking in tests to improve tests performance and

     

       62
       62
       +
                 volatility, resulting in reduced CI usage and improved developer

     

       63
       63
       +
                 experience

     

       64
       64
       +
               * Implemented e2e tests against existing Node.js PostgreSQL clients to

     

       65
       65
       +
                 improve production issues

     

       66
       66
       +
               * Implemented multi-region deployment system to provide blue/green

     

       67
       67
       +
                 deployments

     

       68
       68
       +
               * Improved system observability features by making it more resilient and

     

       69
       69
       +
                 performant

     

       70
       70
       +
               * Replaced usage of `ct_slave` with newer `peer` module in OTP

     

       23
       71
        
       - AppUnite - Full-stack Developer/DevOps - 2016-2019:

     

       24
       72
        
           + JaFolders/AlleFolders

     

       25
       73
        
               * 2x performance improvement by optimising PostgreSQL usage

     

       26
       74
        
               * Reduced geo-queries using PostGIS thanks to better indices and

     

       27
       27
       -
               materialised views usage

     

       28
       28
       -
               * Implementation of the UI and brochure viewer in Vue and SVG

     

       75
       75
       +
                 materialised views usage

     

       76
       76
       +
               * Implemented UI and brochure viewer in Vue and SVG

     

       29
       77
        
           + OneMedical/Helium Health

     

       30
       78
        
               * Architectural redesign of application from Rails/MongoDB to

     

       31
       31
       -
               Phoenix/PostgreSQL

     

       32
       32
       -
               * Preparing hybrid deployment with on-premise/in-cloud system

     

       33
       33
       -
               * Migration of the existing deployments from MongoDB to PostgreSQL

     

       34
       34
       -
       - Kobil GmbH - Erlang/Elixir Developer - 2019-2020

     

       35
       35
       -
           + Maintaining MongoDB driver for Elixir

     

       36
       36
       -
           + Implemented transactions for MongoDB driver in Elixir

     

       37
       37
       -
       - Remote Inc. - Senior Backend Engineer - 2020-2021

     

       38
       38
       -
       - Hauleth.dev - Consultant - 2021+

     

       39
       39
       -
           + Erlang Solutions/Kloeckner GmbH - 2021 - Consultant for Elixir, Ruby, and SQL (PostgreSQL)

     

       40
       40
       -
               * Substantial query performance optimisations by optimising PostgreSQL indices

     

       41
       41
       -
       - Eiger - Senior Backend Engineer - 2022-2023

     

       42
       42
       -
           + Forte.io

     

       43
       43
       -
               - Implementation of the Interledger protocol for cross-chain transactions

     

       44
       44
       -
           + Aleo Blokchain

     

       45
       45
       -
               - Implementation of the GraphQL API for the on-chain data

     

       79
       79
       +
                 Phoenix/PostgreSQL

     

       80
       80
       +
               * Prepared hybrid deployment with on-premise/in-cloud system

     

       81
       81
       +
               * Migrated of the existing deployments from MongoDB to PostgreSQL

     

       82
       82
       +
       - Nukomeet - Full-stack Developer - 2015-2016

     

       83
       83
       +
       - Prograils - Junior Developer - 2013

     

       46
       84
        
       

     

       47
       85
        
       ### Organisations

     

       48
       86
        
       

     
···

       57
       95
        
               * Organizer - 2015

     

       58
       96
        
           + UEFA Championship 2012 - Poland-Ukraine

     

       59
       97
        
               * ICT Accreditation support

     

       98
       98
       +
       - Times Person of the Year - 2006

     

       60
       99
        
       

     

       61
       100
        
       ### Languages

     

       62
       101
        
       

     
···

       67
       106
        
       

     

       68
       107
        
       - GitHub: <https://github.com/hauleth>

     

       69
       108
        
       - GitLab: <https://gitlab.com/hauleth>

     

       70
       70
       -
       - StackOverflow: <https://stackoverflow.com/users/1017941/hauleth>

     

       109
       109
       +
       - SourceHut: <https://sr.ht/~hauleth>

     

       110
       110
       +
       - StackOverflow: <https://stackoverflow.com/u/1017941>

     

       71
       111
        
       

     

       72
       112
        
       ### Notable contributions

     

       73
       113
        
       

     
···

       78
       118
        
           + `is_struct/1`

     

       79
       119
        
           + Fixing module inspection on case-insensitive file systems

     

       80
       120
        
           + Support for parsing extra arguments via `mix eval` and `eval` command in

     

       81
       81
       -
           release

     

       121
       121
       +
             release

     

       82
       122
        
       - Erlang OTP:

     

       83
       123
        
           + Support for custom devices in `logger_std_h`

     

       84
       124
        
           + Fixing `socket` module to support broader set of protocols (for example

     
···

       102
       142
        
         projects

     

       103
       143
        
       - <https://github.com/hauleth/mix_unused> - Mix compiler for detecting unused

     

       104
       144
        
         code

     

       105
       105
       -
       - Elixir's Logger implementation in 1.10+

     

       106
       145
        
       - <https://github.com/open-telemetry/opentelemetry-erlang> - maintainer of

     

       107
       146
        
         the Erlang's OpenTelemetry implementation

     

       108
       147
        
       - Vim plugins:

     
···

       111
       150
        
           + <https://gitlab.com/hauleth/qfx.vim> - display signs next to QF matches

     

       112
       151
        
       

     

       113
       152
        
       ### Languages and Frameworks

     

       114
       114
       -
       

     

       115
       115
       -
       Expert:

     

       116
       153
        
       

     

       117
       154
        
       - Elixir

     

       118
       155
        
           + Phoenix

     
···

       121
       158
        
           + OpenTelemetry collaborator

     

       122
       159
        
           + EEF Member

     

       123
       160
        
           + OTP contributor

     

       124
       124
       -
       

     

       125
       125
       -
       Advanced:

     

       126
       126
       -
       

     

       161
       161
       +
       - Nix/NixOS

     

       127
       162
        
       - Rust

     

       128
       128
       -
       - C

     

       129
       163
        
       - PostgreSQL

     

       130
       164
        
       - sh/Bash

     

       131
       165
        
       - Ruby

     

       132
       166
        
           + Ruby on Rails

     

       133
       167
        
       

     

       134
       134
       -
       Fluent:

     

       135
       135
       -
       

     

       136
       136
       -
       - C++

     

       137
       137
       -
       - JavaScript

     

       138
       138
       -
       

     

       139
       168
        
       ### Technologies

     

       140
       169
        
       

     

       141
       141
       -
       Expert:

     

       142
       142
       -
       

     

       143
       170
        
       - Git

     

       144
       171
        
       - Vim

     

       145
       145
       -
       

     

       146
       146
       -
       Advanced:

     

       147
       147
       -
       

     

       148
       172
        
       - HashiStack

     

       149
       173
        
           + Terraform

     

       150
       174
        
           + Consul

     
···

       153
       177
        
       - TDD/BDD methodologies

     

       154
       178
        
       - Property testing

     

       155
       179
        
       

     

       156
       156
       -
       Fluent:

     

       157
       157
       -
       

     

       158
       158
       -
       - SaltStack

     

       159
       159
       -
       - Puppet

     

       160
       160
       -
       

     

       161
       180
        
       ## Other

     

       162
       181
        
       

     

       163
       182
        
       - Viking reenactor

     

       164
       183
        
       - Keyboard fan

     

       165
       184
        
       - Sci-fi/Fantasy fan and Poznań's Sci-fi/Fantasy club member

     

       185
       185
       +
       

     

       186
       186
       +
       [`plug_caisson`]: https://github.com/supabase/plug_caisson

+1

themes/zerm/.gitignore

···

       1
       1
       +
       public

+22

themes/zerm/LICENSE.md

···

       1
       1
       +
       The MIT License (MIT)

     

       2
       2
       +
       

     

       3
       3
       +
       Copyright (c) 2019 elias julian marko garcia

     

       4
       4
       +
       Copyright (c) 2019 Paweł Romanowski

     

       5
       5
       +
       Copyright (c) 2019 panr

     

       6
       6
       +
       

     

       7
       7
       +
       Permission is hereby granted, free of charge, to any person obtaining a copy of

     

       8
       8
       +
       this software and associated documentation files (the "Software"), to deal in

     

       9
       9
       +
       the Software without restriction, including without limitation the rights to

     

       10
       10
       +
       use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of

     

       11
       11
       +
       the Software, and to permit persons to whom the Software is furnished to do so,

     

       12
       12
       +
       subject to the following conditions:

     

       13
       13
       +
       

     

       14
       14
       +
       The above copyright notice and this permission notice shall be included in all

     

       15
       15
       +
       copies or substantial portions of the Software.

     

       16
       16
       +
       

     

       17
       17
       +
       THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR

     

       18
       18
       +
       IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS

     

       19
       19
       +
       FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR

     

       20
       20
       +
       COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER

     

       21
       21
       +
       IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN

     

       22
       22
       +
       CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

+61

themes/zerm/README.md

···

       1
       1
       +
       # zerm

     

       2
       2
       +
       

     

       3
       3
       +
       a minimalist and dark theme for [Zola](https://getzola.org).

     

       4
       4
       +
       

     

       5
       5
       +
       ![Screenshot](../master/zerm-preview.png?raw=true)

     

       6
       6
       +
       

     

       7
       7
       +
       [**Live Preview!**](https://zerm.ejmg.now.sh/)

     

       8
       8
       +
       

     

       9
       9
       +
       Largely a port of Radek Kozieł's [Terminal

     

       10
       10
       +
       Theme](https://github.com/panr/hugo-theme-terminal) for Hugo. 4/5ths of my way

     

       11
       11
       +
       through porting this theme, I discovered Paweł Romanowski own independent fork

     

       12
       12
       +
       for Zola, [Terminimal](https://github.com/pawroman/zola-theme-terminimal),

     

       13
       13
       +
       which helped me get the PostCSS to Sass styling conversion done more

     

       14
       14
       +
       quickly. My sincerest thanks to both of you!

     

       15
       15
       +
       

     

       16
       16
       +
       ## differences

     

       17
       17
       +
       

     

       18
       18
       +
       This theme is largely true to the original by Radek, but there are some mild

     

       19
       19
       +
       differences. They are almost all stylistic in nature and are intended to

     

       20
       20
       +
       emphasize minimalism even more. Some of them are as follows:

     

       21
       21
       +
       - tags are now included in a post's meta data.

     

       22
       22
       +
       - no post image previews.

     

       23
       23
       +
       - categories are included in the taxonomy.

     

       24
       24
       +
       - bullet points have slightly more margin and different symbols for nesting.

     

       25
       25
       +
       - no social media or comment support.

     

       26
       26
       +
       

     

       27
       27
       +
       Some of these might be added later and [PR's are always

     

       28
       28
       +
       welcomed](https://github.com/ejmg/zerm/pulls).

     

       29
       29
       +
       

     

       30
       30
       +
       ## configuration

     

       31
       31
       +
       

     

       32
       32
       +
       Please follow the Zola documentation for [how to use a

     

       33
       33
       +
       theme](https://www.getzola.org/documentation/themes/installing-and-using-themes/#installing-a-theme).

     

       34
       34
       +
       

     

       35
       35
       +
       In `config.toml`, you will find all values for customization that are supported

     

       36
       36
       +
       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)!

     

       37
       37
       +
       

     

       38
       38
       +
       ## math

     

       39
       39
       +
       You can use KaTeX for mathematical typesetting.

     

       40
       40
       +
       Assets are only available if you opt-in on a per-page level through

     

       41
       41
       +
       a single line (`math=true`) on the extra section of the page frontmatter.

     

       42
       42
       +
       

     

       43
       43
       +
       ``` md

     

       44
       44
       +
       # index.md

     

       45
       45
       +
       +++

     

       46
       46
       +
       title="this page title"

     

       47
       47
       +
       ...

     

       48
       48
       +
       

     

       49
       49
       +
       [extra]

     

       50
       50
       +
       math=true

     

       51
       51
       +
       +++

     

       52
       52
       +
       

     

       53
       53
       +
       Content

     

       54
       54
       +
       ```

     

       55
       55
       +
       

     

       56
       56
       +
       Pages wich doesn't opt-in are not affected in any way, so you doesn't have

     

       57
       57
       +
       to worry about any performance hit.

     

       58
       58
       +
       

     

       59
       59
       +
       ## license

     

       60
       60
       +
       

     

       61
       61
       +
       MIT. See `LICENSE.md` for more details.

+131

themes/zerm/config.toml

···

       1
       1
       +
       # The URL the site will be built for

     

       2
       2
       +
       base_url = "/"

     

       3
       3
       +
       

     

       4
       4
       +
       # Used in RSS by default

     

       5
       5
       +
       title = "My blog!"

     

       6
       6
       +
       description = "placeholder description text for your blog!"

     

       7
       7
       +
       

     

       8
       8
       +
       # The default language, used in RSS

     

       9
       9
       +
       # TODO: I would love to support more languages and make this easy to handle

     

       10
       10
       +
       # with other facets of the theme.

     

       11
       11
       +
       default_language = "en"

     

       12
       12
       +
       

     

       13
       13
       +
       # Whether to generate a RSS feed automatically

     

       14
       14
       +
       generate_feed = true

     

       15
       15
       +
       # 'atom.xml' (default if unspecified) and 'rss.xml' are officially supported

     

       16
       16
       +
       # values for feed_filename in this theme. All other filenames will assume a

     

       17
       17
       +
       # link type of 'application/rss+xml'.

     

       18
       18
       +
       # feed_filename = "atom.xml"

     

       19
       19
       +
       

     

       20
       20
       +
       # Theme name to use.

     

       21
       21
       +
       # NOTE: should not need to mess with this if you are using zerm directly, i.e. cloning the

     

       22
       22
       +
       # repository at root and not using as directed by the Zola docs via themes/ directory.

     

       23
       23
       +
       # theme = ""

     

       24
       24
       +
       

     

       25
       25
       +
       # Whether to automatically compile all Sass files in the sass directory

     

       26
       26
       +
       compile_sass = true

     

       27
       27
       +
       

     

       28
       28
       +
       # Whether to do syntax highlighting

     

       29
       29
       +
       # Theme can be customised by setting the `highlight_theme` variable to a theme supported by Zola

     

       30
       30
       +
       highlight_code = true

     

       31
       31
       +
       

     

       32
       32
       +
       # Syntax highlighting theme. See:

     

       33
       33
       +
       # https://www.getzola.org/documentation/getting-started/configuration/#syntax-highlighting

     

       34
       34
       +
       # for more information and themes built into Zola.

     

       35
       35
       +
       highlight_theme = "axar" # Other dark themes that work: "1337", "agola-dark",

     

       36
       36
       +
                                # "visual-studio-dark"

     

       37
       37
       +
       

     

       38
       38
       +
       # Whether to build a search index to be used later on by a JavaScript library

     

       39
       39
       +
       build_search_index = false

     

       40
       40
       +
       

     

       41
       41
       +
       # Built in taxonomies of zerm.

     

       42
       42
       +
       taxonomies = [

     

       43
       43
       +
                  {name = "tags"},

     

       44
       44
       +
                  {name = "categories"},

     

       45
       45
       +
       ]

     

       46
       46
       +
       

     

       47
       47
       +
       [extra]

     

       48
       48
       +
       # Put all your custom variables here

     

       49
       49
       +
       #

     

       50
       50
       +
       # Many configurations are taken directly from Terminal's config.toml

     

       51
       51
       +
       # ---------------------------------------------------------

     

       52
       52
       +
       

     

       53
       53
       +
       # Author name to be added to posts, if enabled.

     

       54
       54
       +
       author = "you!"

     

       55
       55
       +
       

     

       56
       56
       +
       # Show author's name in blog post meta data.

     

       57
       57
       +
       show_author = false

     

       58
       58
       +
       

     

       59
       59
       +
       # Show categories a blog post is marked with in its meta data.

     

       60
       60
       +
       show_categories = true

     

       61
       61
       +
       

     

       62
       62
       +
       # Show tags a blog post is marked with in its meta data.

     

       63
       63
       +
       show_tags = true

     

       64
       64
       +
       

     

       65
       65
       +
       # Theme color. You can have any color you want, so long as it's...

     

       66
       66
       +
       # ["orange", "blue", "red", "green", "pink"]

     

       67
       67
       +
       theme_color = "orange"

     

       68
       68
       +
       

     

       69
       69
       +
       # Custom css to style over the defaults. This is useful when you only have a

     

       70
       70
       +
       # few small tweaks to make rather than a major rehaul to the theme.

     

       71
       71
       +
       # It would be best to make this a proper .sass or .scss file in sass/ rather

     

       72
       72
       +
       # than placing in static/

     

       73
       73
       +
       # custom_css = "custom.css"

     

       74
       74
       +
       

     

       75
       75
       +
       # How many menu items to show on desktop. if you set this to 0, only submenu

     

       76
       76
       +
       # button will be visible.

     

       77
       77
       +
       show_menu_items = 2

     

       78
       78
       +
       

     

       79
       79
       +
       # set theme to full screen width.

     

       80
       80
       +
       full_width = false

     

       81
       81
       +
       

     

       82
       82
       +
       # center theme with default width.

     

       83
       83
       +
       center = false

     

       84
       84
       +
       

     

       85
       85
       +
       # set a custom favicon. Must be placed in root of static/ directory...

     

       86
       86
       +
       # favicon = ""

     

       87
       87
       +
       

     

       88
       88
       +
       

     

       89
       89
       +
       # Set a custom preview image for your website when posted as a link.

     

       90
       90
       +
       # Must be placed in root of static/ directory...

     

       91
       91
       +
       # og_preview_img = ""

     

       92
       92
       +
       

     

       93
       93
       +
       # Copyright notice if desired. Defaults to

     

       94
       94
       +
       # copyright = "copyright notice here"

     

       95
       95
       +
       

     

       96
       96
       +
       # What is displayed in the top left corner of the website. Default is zerm.

     

       97
       97
       +
       logo_text = "zerm"

     

       98
       98
       +
       

     

       99
       99
       +
       # Link in logo. Default returns you to $BASE_URL.

     

       100
       100
       +
       logo_home_link = "/"

     

       101
       101
       +
       

     

       102
       102
       +
       # Menu items to display. You define a url and the name of the menu item.

     

       103
       103
       +
       # NOTE: `$BASE_URL/` must be included in the url name.

     

       104
       104
       +
       main_menu = [

     

       105
       105
       +
                     {url="/about/", name="about"},

     

       106
       106
       +
                     {url="/contact/", name="contact"},

     

       107
       107
       +
                     {url="https://google.com", name="Google", external=true},

     

       108
       108
       +
       ]

     

       109
       109
       +
       

     

       110
       110
       +
       # Displayed as title of drop-down menu when size of main_menu > show_menu_items.

     

       111
       111
       +
       menu_more = "show more"

     

       112
       112
       +
       

     

       113
       113
       +
       # Displayed after teaser text for a blog post.

     

       114
       114
       +
       read_more = "read more"

     

       115
       115
       +
       

     

       116
       116
       +
       # not currently used from previous theme, but leaving here for now in case I

     

       117
       117
       +
       # feel like adding it.

     

       118
       118
       +
       read_other_posts = "read other posts"

     

       119
       119
       +
       

     

       120
       120
       +
       

     

       121
       121
       +
       # Enable math typesetting with KaTeX

     

       122
       122
       +
       # Show math in pages with `math=true` in the TOML frontmatter

     

       123
       123
       +
       enable_katex = true

     

       124
       124
       +
       

     

       125
       125
       +
       # Options for disqus

     

       126
       126
       +
       disqus = { enabled=false, short_name="" }

     

       127
       127
       +
       

     

       128
       128
       +
       # generate Table of Contents for all articles

     

       129
       129
       +
       # Table of Contents can be generated for individual articles

     

       130
       130
       +
       # by adding `ToC = true` in [extra] section in frontmatter

     

       131
       131
       +
       # ToC = true

+6

themes/zerm/content/_index.md

···

       1
       1
       +
       +++

     

       2
       2
       +
       sort_by = "date"

     

       3
       3
       +
       transparent = true

     

       4
       4
       +
       paginate_by = 3

     

       5
       5
       +
       insert_anchor_links = "right"

     

       6
       6
       +
       +++

+10

themes/zerm/content/about/_index.md

···

       1
       1
       +
       +++

     

       2
       2
       +
       title = "about"

     

       3
       3
       +
       path = "about"

     

       4
       4
       +
       

     

       5
       5
       +
       [extra]

     

       6
       6
       +
       date = 2019-03-21

     

       7
       7
       +
       +++

     

       8
       8
       +
       

     

       9
       9
       +
       Yet another theme for yet another static site generator; that said, I hope you

     

       10
       10
       +
       like it.

+14

themes/zerm/content/contact/_index.md

···

       1
       1
       +
       +++

     

       2
       2
       +
       title="contact"

     

       3
       3
       +
       description="a basic demo of zola. Does it work?"

     

       4
       4
       +
       

     

       5
       5
       +
       [extra]

     

       6
       6
       +
       date=2019-03-26

     

       7
       7
       +
       +++

     

       8
       8
       +
       

     

       9
       9
       +
       # some links

     

       10
       10
       +
       

     

       11
       11
       +
       - [zola, the static site generator written in rust](https://getzola.org)

     

       12
       12
       +
       - [source code for zerm](https://github.com/ejmg/zerm)

     

       13
       13
       +
       - [Terminal, the theme zerm was derived from](https://github.com/panr/hugo-theme-terminal)

     

       14
       14
       +
       - [Terminimal, another theme for zola based on Terminal](https://github.com/pawroman/zola-theme-terminimal)

+65

themes/zerm/content/demo/index.md

···

       1
       1
       +
       +++

     

       2
       2
       +
       title="demo"

     

       3
       3
       +
       description="a basic demo of zola."

     

       4
       4
       +
       date=2019-08-06

     

       5
       5
       +
       

     

       6
       6
       +
       [taxonomies]

     

       7
       7
       +
       tags = ["demo", "zola", "highlighting"]

     

       8
       8
       +
       categories = ["programming", "wu tang",]

     

       9
       9
       +
       

     

       10
       10
       +
       [extra]

     

       11
       11
       +
       +++

     

       12
       12
       +
       

     

       13
       13
       +
       Here's a general demo of Zola and how things look with zerm.

     

       14
       14
       +
       

     

       15
       15
       +
       # Header I

     

       16
       16
       +
       

     

       17
       17
       +
       Inline code: `println!("Wu Tang!");`

     

       18
       18
       +
       

     

       19
       19
       +
       Zola has built in syntax highlighting. If there's not a theme you like, you can

     

       20
       20
       +
       easily add more.

     

       21
       21
       +
       

     

       22
       22
       +
       zerm uses Fira Code fonts, which means we get ligatures in addition to

     

       23
       23
       +
       Zola's powerful syntax highlighting ✨.

     

       24
       24
       +
       

     

       25
       25
       +
       ```rs

     

       26
       26
       +
       fn foo(arg: String) -> Result<u32, Io::Error> {

     

       27
       27
       +
           println!("Nice!"); // TODO: the thingy

     

       28
       28
       +
           if 1 != 0 {

     

       29
       29
       +
               println!("How many ligatures can I contrive??");

     

       30
       30
       +
               println!("Turns out a lot! ==> -/-> <!-- <$> >>=");

     

       31
       31
       +
           }

     

       32
       32
       +
           Ok(42)

     

       33
       33
       +
       }

     

       34
       34
       +
       ```

     

       35
       35
       +
       

     

       36
       36
       +
       ## Header II

     

       37
       37
       +
       

     

       38
       38
       +
       Want block quotes? We got block quotes.

     

       39
       39
       +
       

     

       40
       40
       +
       Remember the wise words of Ras Kass:

     

       41
       41
       +
       

     

       42
       42
       +
       > In Hotel Rwanda, reminder to honor these street scholars who ask why

     

       43
       43
       +
       U.S. Defense is twenty percent of the tax dollar. Bush gave 6.46 billion to

     

       44
       44
       +
       Halliburton for troops support efforts in Iraq; meanwhile, the hood is hurting,

     

       45
       45
       +
       please believe that.

     

       46
       46
       +
       > 

     

       47
       47
       +
       > -- "Verses", _Wu-Tang Meets The Indie Culture_

     

       48
       48
       +
       

     

       49
       49
       +
       ### Header III

     

       50
       50
       +
       

     

       51
       51
       +
       | members          | age | notable album                                | to be messed with?                                                      |

     

       52
       52
       +
       |------------------|-----|----------------------------------------------|-------------------------------------------------------------------------|

     

       53
       53
       +
       | GZA              | 52  | Liquid Swords                                | no                                                                      |

     

       54
       54
       +
       | ODB              | 35  | Return to the 36 Chambers: The Dirty Version | absolutely not                                                          |

     

       55
       55
       +
       | Raekwon Da Chef  | 49  | Only Built 4 Cuban Linx...                   | `"no"`  that's spanish for "no"                                         |

     

       56
       56
       +
       | Ghostface Killah | 49  | Fishscale                                    | i swear you keep asking that question and the answer ain't gonna change |

     

       57
       57
       +
       | Inspectah Deck   | 49  | CZARFACE                                     | `protect ya neck, boy`                                                  |

     

       58
       58
       +
       

     

       59
       59
       +
       

     

       60
       60
       +
       #### Header IV

     

       61
       61
       +
       

     

       62
       62
       +
       Here's a video of my rabbit, Smalls, loaf'n to lofi beats:

     

       63
       63
       +
       

     

       64
       64
       +
       {{ youtube(id="UUpuz8IObcs") }}

     

       65
       65
       +

+13

themes/zerm/content/fiz/index.md

···

       1
       1
       +
       +++

     

       2
       2
       +
       title="fiz"

     

       3
       3
       +
       description="a basic demo of zola. Does it work?"

     

       4
       4
       +
       date=2019-03-25

     

       5
       5
       +
       author="elias"

     

       6
       6
       +
       

     

       7
       7
       +
       [taxonomies]

     

       8
       8
       +
       tags = ["rust", "test"]

     

       9
       9
       +
       # categories = ["misc."]

     

       10
       10
       +
       +++

     

       11
       11
       +
       

     

       12
       12
       +
       

     

       13
       13
       +
       Foo Bar Buzz Fizz Qux Fum

+21

themes/zerm/content/technology_is_hell/index.md

···

       1
       1
       +
       +++

     

       2
       2
       +
       title="technology is hell!"

     

       3
       3
       +
       description="Yet another blog post ranting about XYZ technology for ABC reasons"

     

       4
       4
       +
       date=2019-03-26

     

       5
       5
       +
       

     

       6
       6
       +
       [taxonomies]

     

       7
       7
       +
       tags = ["rust", "test"]

     

       8
       8
       +
       categories = ["misc."]

     

       9
       9
       +
       +++

     

       10
       10
       +
       

     

       11
       11
       +
       

     

       12
       12
       +
       Nullam eu ante vel est convallis dignissim.  Fusce suscipit, wisi nec facilisis

     

       13
       13
       +
       facilisis, est dui fermentum leo, quis tempor ligula erat quis odio.  Nunc

     

       14
       14
       +
       porta vulputate tellus.  Nunc rutrum turpis sed pede.  Sed bibendum.  Aliquam

     

       15
       15
       +
       posuere.  Nunc aliquet, augue nec adipiscing interdum, lacus tellus malesuada

     

       16
       16
       +
       massa, quis varius mi purus non odio.  Pellentesque condimentum, magna ut

     

       17
       17
       +
       suscipit hendrerit, ipsum augue ornare nulla, non luctus diam neque sit amet

     

       18
       18
       +
       urna.  Curabitur vulputate vestibulum lorem.  Fusce sagittis, libero non

     

       19
       19
       +
       molestie mollis, magna orci ultrices dolor, at vulputate neque nulla lacinia

     

       20
       20
       +
       eros.  Sed id ligula quis est convallis tempor.  Curabitur lacinia pulvinar

     

       21
       21
       +
       nibh.  Nam a sapien.

+57

themes/zerm/content/using_katex/index.md

···

       1
       1
       +
       +++

     

       2
       2
       +
       title="Using KaTeX for mathematical typesetting"

     

       3
       3
       +
       date=2021-06-16

     

       4
       4
       +
       

     

       5
       5
       +
       [taxonomies]

     

       6
       6
       +
       categories=["test"]

     

       7
       7
       +
       tags=["math", "zola"]

     

       8
       8
       +
       

     

       9
       9
       +
       [extra]

     

       10
       10
       +
       math=true

     

       11
       11
       +
       +++

     

       12
       12
       +
       

     

       13
       13
       +
       The usual way to include LaTeX is to use `$$`, as shown in the examples below.

     

       14
       14
       +
       

     

       15
       15
       +
       These examples are taken from <http://khan.github.io/KaTeX/>

     

       16
       16
       +
       

     

       17
       17
       +
       ### Example 1

     

       18
       18
       +
       If the text between `$$` contains newlines it will rendered in display mode:

     

       19
       19
       +
       ```

     

       20
       20
       +
       $$

     

       21
       21
       +
       f(x) = \int_{-\infty}^\infty\hat f(\xi)\,e^{2 \pi i \xi x}\,d\xi

     

       22
       22
       +
       $$

     

       23
       23
       +
       ```

     

       24
       24
       +
       

     

       25
       25
       +
       $$

     

       26
       26
       +
       f(x) = \int_{-\infty}^\infty\hat f(\xi)\,e^{2 \pi i \xi x}\,d\xi

     

       27
       27
       +
       $$

     

       28
       28
       +
       

     

       29
       29
       +
       ### Example 2

     

       30
       30
       +
       

     

       31
       31
       +
       ```

     

       32
       32
       +
       $$

     

       33
       33
       +
       \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} } } }

     

       34
       34
       +
       $$

     

       35
       35
       +
       

     

       36
       36
       +
       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} } } } 

     

       37
       37
       +
       ```

     

       38
       38
       +
       

     

       39
       39
       +
       $$

     

       40
       40
       +
       \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} } } }

     

       41
       41
       +
       $$

     

       42
       42
       +
       

     

       43
       43
       +
       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} } } } 

     

       44
       44
       +
       

     

       45
       45
       +
       ### Example 3

     

       46
       46
       +
       

     

       47
       47
       +
       ```

     

       48
       48
       +
       $$

     

       49
       49
       +
       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.

     

       50
       50
       +
       $$

     

       51
       51
       +
       ```

     

       52
       52
       +
       

     

       53
       53
       +
       $$

     

       54
       54
       +
       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.

     

       55
       55
       +
       $$

     

       56
       56
       +
       

     

       57
       57
       +

+42

themes/zerm/content/waz/index.md

···

       1
       1
       +
       +++

     

       2
       2
       +
       title="waz"

     

       3
       3
       +
       description="a basic demo of zola. Does it work? This old man, he played one. He played knick knack on my drum."

     

       4
       4
       +
       date=2019-03-27

     

       5
       5
       +
       

     

       6
       6
       +
       [taxonomies]

     

       7
       7
       +
       tags = ["rust", "test", "zola"]

     

       8
       8
       +
       categories = ["programming", "misc.", "programming languages"]

     

       9
       9
       +
       

     

       10
       10
       +
       [extra]

     

       11
       11
       +
       +++

     

       12
       12
       +
       

     

       13
       13
       +
       # Hello Hello

     

       14
       14
       +
       

     

       15
       15
       +
       Lorem ipsum dolor sit amet, consectetuer adipiscing elit.  Donec hendrerit

     

       16
       16
       +
       tempor tellus.  Donec pretium posuere tellus.  Proin quam nisl, tincidunt et,

     

       17
       17
       +
       mattis eget, convallis nec, purus.  Cum sociis natoque penatibus et magnis dis

     

       18
       18
       +
       parturient montes, nascetur ridiculus mus.  Nulla posuere.  Donec vitae dolor.

     

       19
       19
       +
       Nullam tristique diam non turpis.  Cras placerat accumsan nulla.  Nullam

     

       20
       20
       +
       rutrum.  Nam vestibulum accumsan nisl.

     

       21
       21
       +
       

     

       22
       22
       +
       

     

       23
       23
       +
       ```python

     

       24
       24
       +
       def foo(bar, **kwargs):

     

       25
       25
       +
           print("yo, this is nice!")

     

       26
       26
       +
       ```

     

       27
       27
       +
       

     

       28
       28
       +
       ## a list

     

       29
       29
       +
       

     

       30
       30
       +
       * Donec hendrerit tempor tellus.

     

       31
       31
       +
       * Nam a sapien.

     

       32
       32
       +
       * Phasellus at dui in ligula mollis ultricies.

     

       33
       33
       +
       * Mauris mollis tincidunt felis.

     

       34
       34
       +
       * Nullam rutrum.

     

       35
       35
       +
       

     

       36
       36
       +
       ### Yet another list

     

       37
       37
       +
       1. Nunc aliquet, augue nec adipiscing interdum, lacus tellus malesuada massa,

     

       38
       38
       +
          quis varius mi purus non odio.

     

       39
       39
       +
       2. Donec hendrerit tempor tellus. 

     

       40
       40
       +
       3. Nunc aliquet, augue nec adipiscing interdum, lacus tellus malesuada massa,

     

       41
       41
       +
          quis varius mi purus non odio.

     

       42
       42
       +

+69

themes/zerm/content/zerm/index.md

···

       1
       1
       +
       +++

     

       2
       2
       +
       title="what is zerm?"

     

       3
       3
       +
       description="a summary of what zerm is and why it is different."

     

       4
       4
       +
       date=2019-08-07

     

       5
       5
       +
       updated=2021-02-03

     

       6
       6
       +
       

     

       7
       7
       +
       [taxonomies]

     

       8
       8
       +
       tags = ["rust", "test", "zola"]

     

       9
       9
       +
       categories = ["programming", "misc.",]

     

       10
       10
       +
       

     

       11
       11
       +
       [extra]

     

       12
       12
       +
       ToC = true

     

       13
       13
       +
       +++

     

       14
       14
       +
       

     

       15
       15
       +
       # hello

     

       16
       16
       +
       

     

       17
       17
       +
       This is zerm, a minimalist theme for Zola based[^1] off of [panr's](https://twitter.com/panr)

     

       18
       18
       +
       theme for Hugo.

     

       19
       19
       +
       

     

       20
       20
       +
       While it's largely faithful to the original, there are some changes:

     

       21
       21
       +
       - no prism.js integration, instead we use Zola's syntax highlighting to reduce overhead.

     

       22
       22
       +
       - removal of PostCSS and leveraging Zola's use of Sass for simple styling.

     

       23
       23
       +
         - much thanks to [Paweł

     

       24
       24
       +
           Romanowski's](https://github.com/pawroman/zola-theme-terminimal/)

     

       25
       25
       +
           independent fork of Terminal. Their Sass stylings saved me the overhead of

     

       26
       26
       +
           figuring it out myself.

     

       27
       27
       +
       - no preview images. I want a theme that is focused on content.

     

       28
       28
       +
       - support for anchor links.

     

       29
       29
       +
       - Other small, opinionated changes that I think lend to the minimalism and

     

       30
       30
       +
         aesthetic of zerm.

     

       31
       31
       +
         

     

       32
       32
       +
         

     

       33
       33
       +
       Things this theme does not have but either Terminal or Terminimal might:

     

       34
       34
       +
       - better short-codes for things like embedding videos or images, though I will

     

       35
       35
       +
         work on this over time.

     

       36
       36
       +
       - better support for things like comments and social media. As of now, I have

     

       37
       37
       +
         no plans to add this but [PR's are always

     

       38
       38
       +
         **welcomed**](https://github.com/ejmg/zerm/pulls).

     

       39
       39
       +
         

     

       40
       40
       +
       ## A quick demo

     

       41
       41
       +
       

     

       42
       42
       +
       `println!("inline code");`

     

       43
       43
       +
       

     

       44
       44
       +
       ```rs

     

       45
       45
       +
       fn main(n: String) {

     

       46
       46
       +
           println!("hello, zola!");

     

       47
       47
       +
       }

     

       48
       48
       +
       ```

     

       49
       49
       +
       

     

       50
       50
       +
       ### Header III

     

       51
       51
       +
       

     

       52
       52
       +
       > a somewhat kinda maybe large quote that maybe spans

     

       53
       53
       +
       > more than one line but I mean really who even cares

     

       54
       54
       +
       > okay maybe I do but point being is yes nice.

     

       55
       55
       +
       

     

       56
       56
       +
       #### Header IV

     

       57
       57
       +
       

     

       58
       58
       +
       | hello | tables    | nice |

     

       59
       59
       +
       |:-----:|:---------:|------|

     

       60
       60
       +
       | wow   | much love | yes  |

     

       61
       61
       +
       

     

       62
       62
       +
         

     

       63
       63
       +
       Like zerm? Then [install

     

       64
       64
       +
       Zola](https://www.getzola.org/documentation/getting-started/installation/) and

     

       65
       65
       +
       [get started](https://www.getzola.org/documentation/themes/installing-and-using-themes/#installing-a-theme)!

     

       66
       66
       +
       

     

       67
       67
       +
       ---

     

       68
       68
       +
       

     

       69
       69
       +
       [^1]: fork? port? a little bit of the former, more of the latter?

+7

themes/zerm/package.json

···

       1
       1
       +
       {

     

       2
       2
       +
           "scripts":

     

       3
       3
       +
           {

     

       4
       4
       +
               "install": "curl -L -O https://github.com/getzola/zola/releases/download/v0.13.0/zola-v0.13.0-x86_64-unknown-linux-gnu.tar.gz && tar -xzf zola-v0.13.0-x86_64-unknown-linux-gnu.tar.gz",

     

       5
       5
       +
               "build": "./zola build"

     

       6
       6
       +
           }

     

       7
       7
       +
       }

+29

themes/zerm/sass/_buttons.scss

···

       1
       1
       +
       button,

     

       2
       2
       +
       .button,

     

       3
       3
       +
       a.button {

     

       4
       4
       +
         position: relative;

     

       5
       5
       +
         display: flex;

     

       6
       6
       +
         align-items: center;

     

       7
       7
       +
         justify-content: center;

     

       8
       8
       +
         padding: 8px 18px;

     

       9
       9
       +
         margin-bottom: 5px;

     

       10
       10
       +
         text-decoration: none;

     

       11
       11
       +
         text-align: center;

     

       12
       12
       +
         border-radius: 8px;

     

       13
       13
       +
         border: 1px solid transparent;

     

       14
       14
       +
         appearance: none;

     

       15
       15
       +
         cursor: pointer;

     

       16
       16
       +
         outline: none;

     

       17
       17
       +
       }

     

       18
       18
       +
       

     

       19
       19
       +
       a.read-more,

     

       20
       20
       +
       a.read-more:hover,

     

       21
       21
       +
       a.read-more:active {

     

       22
       22
       +
         display: inline-flex;

     

       23
       23
       +
         background: none;

     

       24
       24
       +
         box-shadow: none;

     

       25
       25
       +
         padding: 0;

     

       26
       26
       +
         margin: 20px 0;

     

       27
       27
       +
         max-width: 100%;

     

       28
       28
       +
       }

     

       29
       29
       +

+15

themes/zerm/sass/_font.scss

···

       1
       1
       +
       @font-face {

     

       2
       2
       +
           font-family: 'Fira Code';

     

       3
       3
       +
           font-style:  normal;

     

       4
       4
       +
           font-weight: 400;

     

       5
       5
       +
           font-display: swap;

     

       6
       6
       +
           src: url("assets/fonts/FiraCode-Regular.woff2") format("woff2"), url("assets/fonts/FiraCode-Regular.woff") format("woff");

     

       7
       7
       +
       }

     

       8
       8
       +
       

     

       9
       9
       +
       @font-face {

     

       10
       10
       +
           font-family: 'Fira Code';

     

       11
       11
       +
           font-style:  normal;

     

       12
       12
       +
           font-weight: 800;

     

       13
       13
       +
           font-display: swap;

     

       14
       14
       +
           src: url("assets/fonts/FiraCode-Bold.woff2") format("woff2"), url("assets/fonts/FiraCode-Bold.woff") format("woff");

     

       15
       15
       +
       }

+67

themes/zerm/sass/_footer.scss

···

       1
       1
       +
       @import "variables";

     

       2
       2
       +
       

     

       3
       3
       +
       .footer {

     

       4
       4
       +
         padding: 40px 0;

     

       5
       5
       +
         flex-grow: 0;

     

       6
       6
       +
         opacity: .5;

     

       7
       7
       +
       

     

       8
       8
       +
         &__inner {

     

       9
       9
       +
           display: flex;

     

       10
       10
       +
           align-items: center;

     

       11
       11
       +
           justify-content: space-between;

     

       12
       12
       +
           margin: 0;

     

       13
       13
       +
           width: 760px;

     

       14
       14
       +
           max-width: 100%;

     

       15
       15
       +
       

     

       16
       16
       +
           @media (max-width: $tablet-max-width) {

     

       17
       17
       +
             flex-direction: column;

     

       18
       18
       +
           }

     

       19
       19
       +
         }

     

       20
       20
       +
       

     

       21
       21
       +
         a {

     

       22
       22
       +
           color: inherit;

     

       23
       23
       +
         }

     

       24
       24
       +
       

     

       25
       25
       +
         .copyright {

     

       26
       26
       +
           display: flex;

     

       27
       27
       +
           flex-direction: row;

     

       28
       28
       +
           align-items: center;

     

       29
       29
       +
           font-size: 1rem;

     

       30
       30
       +
           // so `--light-color-secondary` color exists no where else in the stylings

     

       31
       31
       +
           // color: var(--light-color-secondary);

     

       32
       32
       +
           // As a substitute, I'm going to use the alpha-70 version of accent.

     

       33
       33
       +
           color: var(--accent-alpha-70);

     

       34
       34
       +
       

     

       35
       35
       +
           &--user {

     

       36
       36
       +
             margin: auto;

     

       37
       37
       +
             text-align: center;

     

       38
       38
       +
           }

     

       39
       39
       +
       

     

       40
       40
       +
           & > *:first-child:not(:only-child) {

     

       41
       41
       +
             margin-right: 10px;

     

       42
       42
       +
       

     

       43
       43
       +
              @media (max-width: $tablet-max-width) {

     

       44
       44
       +
               border: none;

     

       45
       45
       +
               padding: 0;

     

       46
       46
       +
               margin: 0;

     

       47
       47
       +
             }

     

       48
       48
       +
           }

     

       49
       49
       +
       

     

       50
       50
       +
           @media (max-width: $tablet-max-width) {

     

       51
       51
       +
             flex-direction: column;

     

       52
       52
       +
             margin-top: 10px;

     

       53
       53
       +
           }

     

       54
       54
       +
         }

     

       55
       55
       +
       

     

       56
       56
       +
         // .copyright-theme-sep {

     

       57
       57
       +
         //   @media (max-width: $tablet-max-width) {

     

       58
       58
       +
         //     display: none;

     

       59
       59
       +
         //   }

     

       60
       60
       +
         // }

     

       61
       61
       +
       

     

       62
       62
       +
         // .copyright-theme {

     

       63
       63
       +
         //   @media (max-width: $tablet-max-width) {

     

       64
       64
       +
         //     font-size: 0.75rem;

     

       65
       65
       +
         //   }

     

       66
       66
       +
         // }

     

       67
       67
       +
       }

+139

themes/zerm/sass/_header.scss

···

       1
       1
       +
       @import "variables";

     

       2
       2
       +
       

     

       3
       3
       +
       @mixin menu {

     

       4
       4
       +
         background: var(--background);

     

       5
       5
       +
         box-shadow: var(--shadow);

     

       6
       6
       +
         color: var(--color);

     

       7
       7
       +
         border: 2px solid;

     

       8
       8
       +
         margin: 0;

     

       9
       9
       +
         padding: 10px;

     

       10
       10
       +
         list-style: none;

     

       11
       11
       +
         z-index: 99;

     

       12
       12
       +
       }

     

       13
       13
       +
       

     

       14
       14
       +
       .header {

     

       15
       15
       +
         display: flex;

     

       16
       16
       +
         flex-direction: column;

     

       17
       17
       +
         position: relative;

     

       18
       18
       +
       

     

       19
       19
       +
         &__inner {

     

       20
       20
       +
           display: flex;

     

       21
       21
       +
           align-items: center;

     

       22
       22
       +
           justify-content: space-between;

     

       23
       23
       +
         }

     

       24
       24
       +
       

     

       25
       25
       +
         &__logo {

     

       26
       26
       +
           display: flex;

     

       27
       27
       +
           flex: 1;

     

       28
       28
       +
       

     

       29
       29
       +
           &:after {

     

       30
       30
       +
             content: '';

     

       31
       31
       +
             background: repeating-linear-gradient(90deg, var(--accent), var(--accent) 2px, transparent 0, transparent 10px);

     

       32
       32
       +
             display: block;

     

       33
       33
       +
             width: 100%;

     

       34
       34
       +
             right: 10px;

     

       35
       35
       +
           }

     

       36
       36
       +
       

     

       37
       37
       +
           a {

     

       38
       38
       +
             flex: 0 0 auto;

     

       39
       39
       +
             max-width: 100%;

     

       40
       40
       +
             text-decoration: none;

     

       41
       41
       +
           }

     

       42
       42
       +
         }

     

       43
       43
       +
       

     

       44
       44
       +
         .menu {

     

       45
       45
       +
           margin: 20px 0;

     

       46
       46
       +
           --shadow-color: var(--accent-alpha-70);

     

       47
       47
       +
           --shadow: 0 10px var(--shadow-color), -10px 10px var(--shadow-color), 10px 10px var(--shadow-color);

     

       48
       48
       +
       

     

       49
       49
       +
           @media (max-width: $phone-max-width) {

     

       50
       50
       +
               @include menu;

     

       51
       51
       +
               position: absolute;

     

       52
       52
       +
               top: 50px;

     

       53
       53
       +
               right: 0;

     

       54
       54
       +
           }

     

       55
       55
       +
       

     

       56
       56
       +
           &__inner {

     

       57
       57
       +
             // @include menu;

     

       58
       58
       +
             display: flex;

     

       59
       59
       +
             flex-wrap: wrap;

     

       60
       60
       +
             list-style: none;

     

       61
       61
       +
             margin: 0;

     

       62
       62
       +
             padding: 0;

     

       63
       63
       +
       

     

       64
       64
       +
             &--desktop {

     

       65
       65
       +
                 @media (max-width: $phone-max-width) {

     

       66
       66
       +
                     display: none;

     

       67
       67
       +
                 }

     

       68
       68
       +
             }

     

       69
       69
       +
       

     

       70
       70
       +
             &--mobile {

     

       71
       71
       +
               display: none;

     

       72
       72
       +
       

     

       73
       73
       +
               @media (max-width: $phone-max-width) {

     

       74
       74
       +
                 display: block;

     

       75
       75
       +
               }

     

       76
       76
       +
             }

     

       77
       77
       +
       

     

       78
       78
       +
             li {

     

       79
       79
       +
               // &.active {

     

       80
       80
       +
               //   color: var(--accent-alpha-70);

     

       81
       81
       +
               // }

     

       82
       82
       +
               &:not(:last-of-type) {

     

       83
       83
       +
                 margin-right: 20px;

     

       84
       84
       +
                 margin-bottom: 10px;

     

       85
       85
       +
                 flex: 0 0 auto;

     

       86
       86
       +
               }

     

       87
       87
       +
             }

     

       88
       88
       +
       

     

       89
       89
       +
             @media (max-width: $phone-max-width) {

     

       90
       90
       +
               flex-direction: column;

     

       91
       91
       +
               align-items: flex-start;

     

       92
       92
       +
               padding: 0;

     

       93
       93
       +
       

     

       94
       94
       +
               li {

     

       95
       95
       +
                 margin: 0;

     

       96
       96
       +
                 padding: 5px;

     

       97
       97
       +
               }

     

       98
       98
       +
             }

     

       99
       99
       +
           }

     

       100
       100
       +
       

     

       101
       101
       +
           &__sub-inner {

     

       102
       102
       +
             position: relative;

     

       103
       103
       +
             list-style: none;

     

       104
       104
       +
             padding: 0;

     

       105
       105
       +
             margin: 0;

     

       106
       106
       +
       

     

       107
       107
       +
             &:not(:only-child) {

     

       108
       108
       +
               margin-left: 20px;

     

       109
       109
       +
             }

     

       110
       110
       +
       

     

       111
       111
       +
             &-more {

     

       112
       112
       +
               @include menu;

     

       113
       113
       +
               top: 35px;

     

       114
       114
       +
               left: 0;

     

       115
       115
       +
       

     

       116
       116
       +
               &-trigger {

     

       117
       117
       +
                 color: var(--accent);

     

       118
       118
       +
                 user-select: none;

     

       119
       119
       +
                 cursor: pointer;

     

       120
       120
       +
               }

     

       121
       121
       +
       

     

       122
       122
       +
               li {

     

       123
       123
       +
                 margin: 0;

     

       124
       124
       +
                 padding: 5px;

     

       125
       125
       +
                 white-space: nowrap;

     

       126
       126
       +
               }

     

       127
       127
       +
             }

     

       128
       128
       +
           }

     

       129
       129
       +
             

     

       130
       130
       +
           &-trigger {

     

       131
       131
       +
             color: var(--accent);

     

       132
       132
       +
             border: 2px solid;

     

       133
       133
       +
             margin-left: 10px;

     

       134
       134
       +
             height: 100%;

     

       135
       135
       +
             padding: 3px 8px;

     

       136
       136
       +
             position: relative;

     

       137
       137
       +
           }

     

       138
       138
       +
         }

     

       139
       139
       +
       }

+8

themes/zerm/sass/_logo.scss

···

       1
       1
       +
       .logo {

     

       2
       2
       +
         display: flex;

     

       3
       3
       +
         align-items: center;

     

       4
       4
       +
         text-decoration: none;

     

       5
       5
       +
         background: var(--accent);

     

       6
       6
       +
         color: black;

     

       7
       7
       +
         padding: 5px 10px;

     

       8
       8
       +
       }

+335

themes/zerm/sass/_main.scss

···

       1
       1
       +
       @import "variables";

     

       2
       2
       +
       

     

       3
       3
       +
       html {

     

       4
       4
       +
         box-sizing: border-box;

     

       5
       5
       +
       }

     

       6
       6
       +
       

     

       7
       7
       +
       *,

     

       8
       8
       +
       *:before,

     

       9
       9
       +
       *:after {

     

       10
       10
       +
         box-sizing: inherit;

     

       11
       11
       +
       }

     

       12
       12
       +
       

     

       13
       13
       +
       body {

     

       14
       14
       +
         margin: 0;

     

       15
       15
       +
         padding: 0;

     

       16
       16
       +
         font-family: 'Fira Code', Menlo, DejaVu Sans Mono, Monaco, Consolas, Ubuntu Mono, monospace;

     

       17
       17
       +
         font-size: 1rem;

     

       18
       18
       +
         line-height: 1.54;

     

       19
       19
       +
         background-color: var(--background);

     

       20
       20
       +
         color: var(--color);

     

       21
       21
       +
         text-rendering: optimizeLegibility;

     

       22
       22
       +
         -webkit-font-smoothing: antialiased;

     

       23
       23
       +
         -webkit-overflow-scrolling: touch;

     

       24
       24
       +
         -webkit-text-size-adjust: 100%;

     

       25
       25
       +
         font-feature-settings: "liga";

     

       26
       26
       +
       

     

       27
       27
       +
         @media (max-width: $phone-max-width) {

     

       28
       28
       +
           font-size: 1rem;

     

       29
       29
       +
         }

     

       30
       30
       +
       }

     

       31
       31
       +
       

     

       32
       32
       +
       h1, h2, h3, h4, h5, h6 {

     

       33
       33
       +
         line-height: 1.3;

     

       34
       34
       +
       

     

       35
       35
       +
         &:not(first-child) {

     

       36
       36
       +
           margin-top: 40px;

     

       37
       37
       +
         }

     

       38
       38
       +
       

     

       39
       39
       +
         .zola-anchor {

     

       40
       40
       +
           font-size: 1.5rem;

     

       41
       41
       +
           visibility: hidden;

     

       42
       42
       +
           margin-left: 0.5rem;

     

       43
       43
       +
           vertical-align: 1%;

     

       44
       44
       +
           text-decoration: none;

     

       45
       45
       +
           border-bottom-color: transparent;

     

       46
       46
       +
           cursor: pointer;

     

       47
       47
       +
       

     

       48
       48
       +
           @media(max-width: $phone-max-width){

     

       49
       49
       +
               visibility: visible;

     

       50
       50
       +
           }

     

       51
       51
       +
         }

     

       52
       52
       +
       

     

       53
       53
       +
         &:hover {

     

       54
       54
       +
           .zola-anchor {

     

       55
       55
       +
             visibility: visible;

     

       56
       56
       +
           }

     

       57
       57
       +
         }

     

       58
       58
       +
       }

     

       59
       59
       +
       

     

       60
       60
       +
       // Actually keeping Pawroman's stylings here for font-size over h1-h6.

     

       61
       61
       +
       // I prefer differentiated header height.

     

       62
       62
       +
       

     

       63
       63
       +
       // OLD

     

       64
       64
       +
       // ---------------------

     

       65
       65
       +
       // h1, h2, h3 {

     

       66
       66
       +
       //   font-size: 1.4rem;

     

       67
       67
       +
       // }

     

       68
       68
       +
       

     

       69
       69
       +
       // h4, h5, h6 {

     

       70
       70
       +
       //   font-size: 1.2rem;

     

       71
       71
       +
       // }

     

       72
       72
       +
       

     

       73
       73
       +
       // Pawroman's

     

       74
       74
       +
       // ---------------------

     

       75
       75
       +
       h1 {

     

       76
       76
       +
         font-size: 1.4rem;

     

       77
       77
       +
       }

     

       78
       78
       +
       

     

       79
       79
       +
       h2 {

     

       80
       80
       +
         font-size: 1.3rem;

     

       81
       81
       +
       }

     

       82
       82
       +
       

     

       83
       83
       +
       h3 {

     

       84
       84
       +
         font-size: 1.2rem;

     

       85
       85
       +
       }

     

       86
       86
       +
       

     

       87
       87
       +
       h4, h5, h6 {

     

       88
       88
       +
         font-size: 1.15rem;

     

       89
       89
       +
       }

     

       90
       90
       +
       

     

       91
       91
       +
       

     

       92
       92
       +
       a {

     

       93
       93
       +
         color: inherit;

     

       94
       94
       +
       }

     

       95
       95
       +
       

     

       96
       96
       +
       img {

     

       97
       97
       +
         display: block;

     

       98
       98
       +
         max-width: 100%;

     

       99
       99
       +
       

     

       100
       100
       +
         &.left {

     

       101
       101
       +
           margin-right: auto;

     

       102
       102
       +
         }

     

       103
       103
       +
       

     

       104
       104
       +
         &.center {

     

       105
       105
       +
           margin-left: auto;

     

       106
       106
       +
           margin-right: auto;

     

       107
       107
       +
         }

     

       108
       108
       +
       

     

       109
       109
       +
         &.right {

     

       110
       110
       +
           margin-left: auto;

     

       111
       111
       +
         }

     

       112
       112
       +
       }

     

       113
       113
       +
       

     

       114
       114
       +
       p {

     

       115
       115
       +
         margin-bottom: 20px;

     

       116
       116
       +
       }

     

       117
       117
       +
       

     

       118
       118
       +
       figure {

     

       119
       119
       +
         display: table;

     

       120
       120
       +
         max-width: 100%;

     

       121
       121
       +
         margin: 25px 0;

     

       122
       122
       +
       

     

       123
       123
       +
         &.left {

     

       124
       124
       +
           // img {

     

       125
       125
       +
             margin-right: auto;

     

       126
       126
       +
           // }

     

       127
       127
       +
         }

     

       128
       128
       +
       

     

       129
       129
       +
         &.center {

     

       130
       130
       +
           // img {

     

       131
       131
       +
             margin-left: auto;

     

       132
       132
       +
             margin-right: auto;

     

       133
       133
       +
           // }

     

       134
       134
       +
         }

     

       135
       135
       +
       

     

       136
       136
       +
         &.right {

     

       137
       137
       +
           // img {

     

       138
       138
       +
             margin-left: auto;

     

       139
       139
       +
           // }

     

       140
       140
       +
         }

     

       141
       141
       +
       

     

       142
       142
       +
         figcaption {

     

       143
       143
       +
           font-size: 14px;

     

       144
       144
       +
           padding: 5px 10px;

     

       145
       145
       +
           margin-top: 5px;

     

       146
       146
       +
           background: var(--accent);

     

       147
       147
       +
           color: var(--background);

     

       148
       148
       +
       

     

       149
       149
       +
           &.left {

     

       150
       150
       +
             text-align: left;

     

       151
       151
       +
           }

     

       152
       152
       +
       

     

       153
       153
       +
           &.center {

     

       154
       154
       +
             text-align: center;

     

       155
       155
       +
           }

     

       156
       156
       +
       

     

       157
       157
       +
           &.right {

     

       158
       158
       +
             text-align: right;

     

       159
       159
       +
           }

     

       160
       160
       +
         }

     

       161
       161
       +
       }

     

       162
       162
       +
       

     

       163
       163
       +
       code {

     

       164
       164
       +
         font-family: 'Fira Code', Menlo, DejaVu Sans Mono, Monaco, Consolas, Ubuntu Mono, monospace;

     

       165
       165
       +
         font-feature-settings: normal;

     

       166
       166
       +
         background: var(--accent-alpha-20);

     

       167
       167
       +
         color: var(--accent);

     

       168
       168
       +
         padding: 1px 6px;

     

       169
       169
       +
         margin: 0 2px;

     

       170
       170
       +
         font-size: .95rem;

     

       171
       171
       +
       }

     

       172
       172
       +
       

     

       173
       173
       +
       pre {

     

       174
       174
       +
         font-family: 'Fira Code', Menlo, DejaVu Sans Mono, Monaco, Consolas, Ubuntu Mono, monospace;

     

       175
       175
       +
         font-feature-settings: "liga";  

     

       176
       176
       +
         padding: 20px 10px;

     

       177
       177
       +
         font-size: .95rem;

     

       178
       178
       +
         overflow: auto;

     

       179
       179
       +
         border-top: 1px solid rgba(255, 255, 255, .1);

     

       180
       180
       +
         border-bottom: 1px solid rgba(255, 255, 255, .1);

     

       181
       181
       +
       

     

       182
       182
       +
         + pre {

     

       183
       183
       +
           border-top: 0;

     

       184
       184
       +
           margin-top: -40px;

     

       185
       185
       +
         }

     

       186
       186
       +
         

     

       187
       187
       +
         @media (max-width: $phone-max-width) {

     

       188
       188
       +
           white-space: pre-wrap;

     

       189
       189
       +
           word-wrap: break-word;

     

       190
       190
       +
         }

     

       191
       191
       +
       

     

       192
       192
       +
           code {

     

       193
       193
       +
             background: none !important;

     

       194
       194
       +
             margin: 0;

     

       195
       195
       +
             padding: 0;

     

       196
       196
       +
             font-size: inherit;

     

       197
       197
       +
             border: none;

     

       198
       198
       +
       

     

       199
       199
       +
             table {

     

       200
       200
       +
               table-layout: auto;

     

       201
       201
       +
               border-collapse: collapse;

     

       202
       202
       +
               box-sizing: border-box;

     

       203
       203
       +
               width: 100%;

     

       204
       204
       +
               margin: 00px 0;

     

       205
       205
       +
             }

     

       206
       206
       +
       

     

       207
       207
       +
             table, th, td {

     

       208
       208
       +
               border: none;

     

       209
       209
       +
               padding: 0px;

     

       210
       210
       +
             }

     

       211
       211
       +
       

     

       212
       212
       +
             table tr td:first-child {

     

       213
       213
       +
               padding-right: 10px;

     

       214
       214
       +
             }

     

       215
       215
       +
       

     

       216
       216
       +
         }

     

       217
       217
       +
       }

     

       218
       218
       +
       

     

       219
       219
       +
       blockquote {

     

       220
       220
       +
         border-top: 1px solid var(--accent);

     

       221
       221
       +
         border-bottom: 1px solid var(--accent);

     

       222
       222
       +
         margin: 40px 0;

     

       223
       223
       +
         padding: 25px;

     

       224
       224
       +
       

     

       225
       225
       +
         @media (max-width: $phone-max-width) {

     

       226
       226
       +
           padding-right: 0;

     

       227
       227
       +
         }

     

       228
       228
       +
       

     

       229
       229
       +
         &:before {

     

       230
       230
       +
           content: '”';

     

       231
       231
       +
           font-family: Georgia, serif;

     

       232
       232
       +
           font-size: 3.875rem;

     

       233
       233
       +
           position: absolute;

     

       234
       234
       +
           left: -40px;

     

       235
       235
       +
           top: -20px;

     

       236
       236
       +
         }

     

       237
       237
       +
       

     

       238
       238
       +
         p:first-of-type {

     

       239
       239
       +
           margin-top: 0;

     

       240
       240
       +
         }

     

       241
       241
       +
       

     

       242
       242
       +
         p:last-of-type {

     

       243
       243
       +
           margin-bottom: 0;

     

       244
       244
       +
         }

     

       245
       245
       +
       

     

       246
       246
       +
         p {

     

       247
       247
       +
           position: relative;

     

       248
       248
       +
         }

     

       249
       249
       +
       

     

       250
       250
       +
         p:before {

     

       251
       251
       +
           content: '>';

     

       252
       252
       +
           display: block;

     

       253
       253
       +
           position: absolute;

     

       254
       254
       +
           left: -25px;

     

       255
       255
       +
           color: var(--accent);

     

       256
       256
       +
         }

     

       257
       257
       +
       }

     

       258
       258
       +
       

     

       259
       259
       +
       table {

     

       260
       260
       +
         table-layout: fixed;

     

       261
       261
       +
         border-collapse: collapse;

     

       262
       262
       +
         width: 100%;

     

       263
       263
       +
         margin: 40px 0;

     

       264
       264
       +
       }

     

       265
       265
       +
       

     

       266
       266
       +
       table, th, td {

     

       267
       267
       +
         border: 1px dashed var(--accent);

     

       268
       268
       +
         padding: 10px;

     

       269
       269
       +
       }

     

       270
       270
       +
       

     

       271
       271
       +
       th {

     

       272
       272
       +
         color: var(--accent);

     

       273
       273
       +
       }

     

       274
       274
       +
       

     

       275
       275
       +
       ul, ol {

     

       276
       276
       +
         margin-left: 30px;

     

       277
       277
       +
         padding: 0;

     

       278
       278
       +
       

     

       279
       279
       +
         li {

     

       280
       280
       +
             position: relative;

     

       281
       281
       +
             margin-top: 5px;

     

       282
       282
       +
             margin-bottom: 5px;

     

       283
       283
       +
         }

     

       284
       284
       +
       

     

       285
       285
       +
         @media (max-width: $phone-max-width) {

     

       286
       286
       +
           margin-left: 20px;

     

       287
       287
       +
         }

     

       288
       288
       +
       

     

       289
       289
       +
         ul, ol {

     

       290
       290
       +
             margin-top: 10px;

     

       291
       291
       +
             margin-bottom: 10px;

     

       292
       292
       +
         }

     

       293
       293
       +
       }

     

       294
       294
       +
       

     

       295
       295
       +
       ol ol {

     

       296
       296
       +
         list-style-type: lower-alpha;

     

       297
       297
       +
       }

     

       298
       298
       +
       

     

       299
       299
       +
       .container {

     

       300
       300
       +
         display: flex;

     

       301
       301
       +
         flex-direction: column;

     

       302
       302
       +
         padding: 40px;

     

       303
       303
       +
         max-width: 864px;

     

       304
       304
       +
         min-height: 100vh;

     

       305
       305
       +
         border-right: 1px solid rgba(255, 255, 255, 0.1);

     

       306
       306
       +
       

     

       307
       307
       +
         &.full,

     

       308
       308
       +
         &.center {

     

       309
       309
       +
           border: none;

     

       310
       310
       +
           margin: 0 auto;

     

       311
       311
       +
         }

     

       312
       312
       +
       

     

       313
       313
       +
         &.full {

     

       314
       314
       +
           max-width: 100%;

     

       315
       315
       +
         }

     

       316
       316
       +
       

     

       317
       317
       +
         @media (max-width: $phone-max-width) {

     

       318
       318
       +
           padding: 20px;

     

       319
       319
       +
         }

     

       320
       320
       +
       }

     

       321
       321
       +
       

     

       322
       322
       +
       .content {

     

       323
       323
       +
         display: flex;

     

       324
       324
       +
       }

     

       325
       325
       +
       

     

       326
       326
       +
       hr {

     

       327
       327
       +
         width: 100%;

     

       328
       328
       +
         border: none;

     

       329
       329
       +
         background: var(--border-color);

     

       330
       330
       +
         height: 1px;

     

       331
       331
       +
       }

     

       332
       332
       +
       

     

       333
       333
       +
       .hidden {

     

       334
       334
       +
         display: none;

     

       335
       335
       +
       }

+63

themes/zerm/sass/_pagination.scss

···

       1
       1
       +
       @import 'variables';

     

       2
       2
       +
       

     

       3
       3
       +
       .pagination {

     

       4
       4
       +
         margin-top: 50px;

     

       5
       5
       +
       

     

       6
       6
       +
         &__buttons {

     

       7
       7
       +
           display: flex;

     

       8
       8
       +
           align-items: center;

     

       9
       9
       +
           justify-content: center;

     

       10
       10
       +
       

     

       11
       11
       +
           // @media (max-width: $phone-max-width) {

     

       12
       12
       +
           //   flex-direction: column;

     

       13
       13
       +
           // }

     

       14
       14
       +
       

     

       15
       15
       +
           a {

     

       16
       16
       +
               text-decoration: none;

     

       17
       17
       +
           }

     

       18
       18
       +
         }

     

       19
       19
       +
       }

     

       20
       20
       +
       

     

       21
       21
       +
       .button {

     

       22
       22
       +
         position: relative;

     

       23
       23
       +
         display: inline-flex;

     

       24
       24
       +
         align-items: center;

     

       25
       25
       +
         justify-content: center;

     

       26
       26
       +
         font-size: 1rem;

     

       27
       27
       +
         border-radius: 8px;

     

       28
       28
       +
         max-width: 40%;

     

       29
       29
       +
         padding: 0;

     

       30
       30
       +
         cursor: pointer;

     

       31
       31
       +
         appearance: none;

     

       32
       32
       +
       

     

       33
       33
       +
         + .button {

     

       34
       34
       +
             margin-left: 10px;

     

       35
       35
       +
         }

     

       36
       36
       +
       

     

       37
       37
       +
         // @media (max-width: $phone-max-width) {

     

       38
       38
       +
         //   max-width: 80%;

     

       39
       39
       +
         // }

     

       40
       40
       +
       

     

       41
       41
       +
         a {

     

       42
       42
       +
           display: flex;

     

       43
       43
       +
           padding: 8px 16px;

     

       44
       44
       +
           text-decoration: none;

     

       45
       45
       +
           text-overflow: ellipsis;

     

       46
       46
       +
           white-space: nowrap;

     

       47
       47
       +
           overflow: hidden;

     

       48
       48
       +
         }

     

       49
       49
       +
       

     

       50
       50
       +
         &__text {

     

       51
       51
       +
           text-overflow: ellipsis;

     

       52
       52
       +
           white-space: nowrap;

     

       53
       53
       +
           overflow: hidden;

     

       54
       54
       +
         }

     

       55
       55
       +
       

     

       56
       56
       +
         &.next .button__icon {

     

       57
       57
       +
           margin-left: 8px;

     

       58
       58
       +
         }

     

       59
       59
       +
       

     

       60
       60
       +
         &.previous .button__icon {

     

       61
       61
       +
           margin-right: 8px;

     

       62
       62
       +
         }

     

       63
       63
       +
       }

+114

themes/zerm/sass/_post.scss

···

       1
       1
       +
       @import "variables";

     

       2
       2
       +
       

     

       3
       3
       +
       // .posts {

     

       4
       4
       +
       //   margin: 0 auto;

     

       5
       5
       +
       // }

     

       6
       6
       +
       

     

       7
       7
       +
       .post {

     

       8
       8
       +
         width: 100%;

     

       9
       9
       +
         text-align: left;

     

       10
       10
       +
         margin: 20px auto;

     

       11
       11
       +
         padding: 20px 0;

     

       12
       12
       +
       

     

       13
       13
       +
         @media (max-width: $tablet-max-width) {

     

       14
       14
       +
           max-width: 660px;

     

       15
       15
       +
         }

     

       16
       16
       +
       

     

       17
       17
       +
         &:not(:last-of-type) {

     

       18
       18
       +
           border-bottom: 1px solid var(--border-color);

     

       19
       19
       +
         }

     

       20
       20
       +
       

     

       21
       21
       +
         // %meta {

     

       22
       22
       +
         //   font-size: 1rem;

     

       23
       23
       +
         //   margin-bottom: 10px;

     

       24
       24
       +
         //   color: var(--accent-alpha-70);

     

       25
       25
       +
         // }

     

       26
       26
       +
       

     

       27
       27
       +
         // &-meta {

     

       28
       28
       +
         //   @extend %meta;

     

       29
       29
       +
         // }

     

       30
       30
       +
         // &-meta-inline {

     

       31
       31
       +
         //   @extend %meta;

     

       32
       32
       +
       

     

       33
       33
       +
         //   display: inline;

     

       34
       34
       +
         // }

     

       35
       35
       +
       

     

       36
       36
       +
         &-meta {

     

       37
       37
       +
           font-size: 1rem;

     

       38
       38
       +
           margin-bottom: 10px;

     

       39
       39
       +
           color: var(--accent-alpha-70);

     

       40
       40
       +
         }

     

       41
       41
       +
       

     

       42
       42
       +
         &-title {

     

       43
       43
       +
           --border: 3px dotted var(--accent);

     

       44
       44
       +
           position: relative;

     

       45
       45
       +
           color: var(--accent);

     

       46
       46
       +
           margin: 0 0 15px;

     

       47
       47
       +
           padding-bottom: 15px;

     

       48
       48
       +
           border-bottom: var(--border);

     

       49
       49
       +
       

     

       50
       50
       +
           &:after {

     

       51
       51
       +
             content: '';

     

       52
       52
       +
             position: absolute;

     

       53
       53
       +
             bottom: 2px;

     

       54
       54
       +
             display: block;

     

       55
       55
       +
             width: 100%;

     

       56
       56
       +
             border-bottom: var(--border);

     

       57
       57
       +
           }

     

       58
       58
       +
           

     

       59
       59
       +
           a {

     

       60
       60
       +
             text-decoration: none;

     

       61
       61
       +
           }

     

       62
       62
       +
         }

     

       63
       63
       +
       

     

       64
       64
       +
         &-content {

     

       65
       65
       +
           margin-top: 30px;

     

       66
       66
       +
         }

     

       67
       67
       +
       

     

       68
       68
       +
         ul {

     

       69
       69
       +
           list-style: none;

     

       70
       70
       +
       

     

       71
       71
       +
           li:before {

     

       72
       72
       +
             content: '⦿';

     

       73
       73
       +
             position: absolute;

     

       74
       74
       +
             left: -20px;

     

       75
       75
       +
             color: var(--accent);

     

       76
       76
       +
           }

     

       77
       77
       +
           ul {

     

       78
       78
       +
       

     

       79
       79
       +
             li:before {

     

       80
       80
       +
               content: '■';

     

       81
       81
       +
               position: absolute;

     

       82
       82
       +
               left: -20px;

     

       83
       83
       +
               color: var(--accent);

     

       84
       84
       +
             }

     

       85
       85
       +
       

     

       86
       86
       +
             ul {

     

       87
       87
       +
       

     

       88
       88
       +
               li:before {

     

       89
       89
       +
                 content: '►';

     

       90
       90
       +
                 position: absolute;

     

       91
       91
       +
                 left: -20px;

     

       92
       92
       +
                 color: var(--accent);

     

       93
       93
       +
               }

     

       94
       94
       +
             }

     

       95
       95
       +
           }

     

       96
       96
       +
         }

     

       97
       97
       +
       }

     

       98
       98
       +
       

     

       99
       99
       +
       // TODO: try adapting this using a properly nested selector in the block above

     

       100
       100
       +
       //       for ul items.

     

       101
       101
       +
       .tag-list {

     

       102
       102
       +
           @media(max-width: $phone-max-width) {

     

       103
       103
       +
               margin-left: 5%;

     

       104
       104
       +
           }

     

       105
       105
       +
       }

     

       106
       106
       +
       

     

       107
       107
       +
       .footnote-definition {

     

       108
       108
       +
         color: var(--accent);

     

       109
       109
       +
       

     

       110
       110
       +
         p {

     

       111
       111
       +
           display: inline;

     

       112
       112
       +
           color: var(--footnote-color);

     

       113
       113
       +
         }

     

       114
       114
       +
       }

+3

themes/zerm/sass/_semantic.scss

···

       1
       1
       +
       section, article, aside, footer, header, nav {

     

       2
       2
       +
           display: block;

     

       3
       3
       +
       }

+6

themes/zerm/sass/_toc.scss

···

       1
       1
       +
       div.toc {

     

       2
       2
       +
       	--shadow-color: var(--accent-alpha-70);

     

       3
       3
       +
           --shadow: 10px 10px var(--shadow-color);

     

       4
       4
       +
       	@include menu;	

     

       5
       5
       +
       	margin: 20px 0;

     

       6
       6
       +
       }

+10

themes/zerm/sass/_variables.scss

···

       1
       1
       +
       :root {

     

       2
       2
       +
         // *NOTE*:

     

       3
       3
       +
         // ------------------------------------------------

     

       4
       4
       +
         //Keep the same as the values in variables.scss!!!!!

     

       5
       5
       +
         --phoneWidth: (max-width: 684px);

     

       6
       6
       +
         --tabletWidth: (max-width: 900px);

     

       7
       7
       +
       }

     

       8
       8
       +
       

     

       9
       9
       +
       $phone-max-width: 683px;

     

       10
       10
       +
       $tablet-max-width: 899px;

+9

themes/zerm/sass/color/blue.scss

···

       1
       1
       +
       :root {

     

       2
       2
       +
         --accent: rgb(35,176,255);

     

       3
       3
       +
         --accent-alpha-20: rgba(35,176,255,.2);

     

       4
       4
       +
         --accent-alpha-70: rgba(35,176,255,.7);

     

       5
       5
       +
         --background: #1D1E28;

     

       6
       6
       +
         --color: whitesmoke;

     

       7
       7
       +
         --border-color: rgba(255, 255, 255, .1);

     

       8
       8
       +
         --footnote-color: rgba(255, 255, 255, .5);

     

       9
       9
       +
       }

+12

themes/zerm/sass/color/green.scss

···

       1
       1
       +
       :root {

     

       2
       2
       +
         // --accent: rgb(120,226,160);

     

       3
       3
       +
         // --accent-alpha-20: rgba(120,226,160,.2);

     

       4
       4
       +
         // --accent-alpha-70: rgba(120,226,160,.7);

     

       5
       5
       +
         --accent: rgb(72, 251, 53);

     

       6
       6
       +
         --accent-alpha-20: rgba(72, 251, 53,.2);

     

       7
       7
       +
         --accent-alpha-70: rgba(72, 251, 53,.7);

     

       8
       8
       +
         --background: #1F222A;

     

       9
       9
       +
         --color: whitesmoke;

     

       10
       10
       +
         --border-color: rgba(255, 255, 255, .1);

     

       11
       11
       +
         --footnote-color: rgba(255, 255, 255, .5);

     

       12
       12
       +
       }

+9

themes/zerm/sass/color/orange.scss

···

       1
       1
       +
       :root {

     

       2
       2
       +
         --accent: rgb(255,168,106);

     

       3
       3
       +
         --accent-alpha-20: rgba(255, 168, 106, .2);

     

       4
       4
       +
         --accent-alpha-70: rgba(255, 168, 106,.7);

     

       5
       5
       +
         --background: #211f1a;

     

       6
       6
       +
         --color: whitesmoke;

     

       7
       7
       +
         --border-color: rgba(255, 255, 255, .1);

     

       8
       8
       +
         --footnote-color: rgba(255, 255, 255, .5);

     

       9
       9
       +
       }

+9

themes/zerm/sass/color/pink.scss

···

       1
       1
       +
       :root {

     

       2
       2
       +
         --accent: rgb(238,114,241);

     

       3
       3
       +
         --accent-alpha-20: rgba(238,114,241,.2);

     

       4
       4
       +
         --accent-alpha-70: rgba(238,114,241,.7);

     

       5
       5
       +
         --background: #21202C;

     

       6
       6
       +
         --color: whitesmoke;

     

       7
       7
       +
         --border-color: rgba(255, 255, 255, .1);

     

       8
       8
       +
         --footnote-color: rgba(255, 255, 255, .5);

     

       9
       9
       +
       }

+9

themes/zerm/sass/color/red.scss

···

       1
       1
       +
       :root {

     

       2
       2
       +
         --accent: rgb(255,98,102);

     

       3
       3
       +
         --accent-alpha-20: rgba(255,98,102,.2);

     

       4
       4
       +
         --accent-alpha-70: rgba(255,98,102,.7);

     

       5
       5
       +
         --background: #221F29;

     

       6
       6
       +
         --color: whitesmoke;

     

       7
       7
       +
         --border-color: rgba(255, 255, 255, .1);

     

       8
       8
       +
         --footnote-color: rgba(255, 255, 255, .5);

     

       9
       9
       +
       }

+10

themes/zerm/sass/style.scss

···

       1
       1
       +
       @import 'buttons';

     

       2
       2
       +
       @import 'font';

     

       3
       3
       +
       @import 'header';

     

       4
       4
       +
       @import 'logo';

     

       5
       5
       +
       @import 'main';

     

       6
       6
       +
       @import 'post';

     

       7
       7
       +
       @import 'pagination';

     

       8
       8
       +
       @import 'footer';

     

       9
       9
       +
       @import 'semantic';

     

       10
       10
       +
       @import 'toc';

themes/zerm/screenshot.png

This is a binary file and will not be displayed.

+1

themes/zerm/static/assets/js/main.js

···

       1
       1
       +
       !function(e){var t={};function n(o){if(t[o])return t[o].exports;var r=t[o]={i:o,l:!1,exports:{}};return e[o].call(r.exports,r,r.exports,n),r.l=!0,r.exports}n.m=e,n.c=t,n.d=function(e,t,o){n.o(e,t)||Object.defineProperty(e,t,{enumerable:!0,get:o})},n.r=function(e){"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},n.t=function(e,t){if(1&t&&(e=n(e)),8&t)return e;if(4&t&&"object"==typeof e&&e&&e.__esModule)return e;var o=Object.create(null);if(n.r(o),Object.defineProperty(o,"default",{enumerable:!0,value:e}),2&t&&"string"!=typeof e)for(var r in e)n.d(o,r,function(t){return e[t]}.bind(null,r));return o},n.n=function(e){var t=e&&e.__esModule?function(){return e.default}:function(){return e};return n.d(t,"a",t),t},n.o=function(e,t){return Object.prototype.hasOwnProperty.call(e,t)},n.p="",n(n.s=0)}([function(e,t,n){n(1),e.exports=n(2)},function(e,t){},function(e,t){var n=document.querySelector(".container"),o=document.querySelector(".menu"),r=document.querySelector(".menu-trigger"),i=(document.querySelector(".menu__inner--desktop"),document.querySelector(".menu__sub-inner-more-trigger")),u=document.querySelector(".menu__sub-inner-more"),c=getComputedStyle(document.body).getPropertyValue("--phoneWidth"),d=function(){return window.matchMedia(c).matches},s=function(){r&&r.classList.toggle("hidden",!d()),o&&o.classList.toggle("hidden",d()),u&&u.classList.toggle("hidden",!d())};o&&o.addEventListener("click",function(e){return e.stopPropagation()}),u&&u.addEventListener("click",function(e){return e.stopPropagation()}),s(),document.body.addEventListener("click",function(){d()||!u||u.classList.contains("hidden")?d()&&!o.classList.contains("hidden")&&o.classList.add("hidden"):u.classList.add("hidden")}),window.addEventListener("resize",s),r&&r.addEventListener("click",function(e){e.stopPropagation(),o&&o.classList.toggle("hidden")}),i&&i.addEventListener("click",function(e){e.stopPropagation(),u&&u.classList.toggle("hidden"),u.getBoundingClientRect().right>n.getBoundingClientRect().right&&(u.style.left="auto",u.style.right=0)})}]);

+1

themes/zerm/templates/.gitignore

···

       1
       1
       +
       !tags

+12

themes/zerm/templates/404.html

···

       1
       1
       +
       {% extends "index.html" -%}

     

       2
       2
       +
       

     

       3
       3
       +
       {%- block title %}

     

       4
       4
       +
           <title>Page not found</title>

     

       5
       5
       +
       {%- endblock title -%}

     

       6
       6
       +
       

     

       7
       7
       +
       {%- block main -%}

     

       8
       8
       +
       

     

       9
       9
       +
       Sorry, this page doesn't exist.

     

       10
       10
       +
       

     

       11
       11
       +
       Go back&nbsp<a href="{%- if config.extra.logo_home_link -%}{{ config.extra.logo_home_link }}{%- else -%}{{ config.base_url }}{%- endif -%}">home?</a>

     

       12
       12
       +
       {%- endblock main -%}

+1

themes/zerm/templates/anchor-link.html

···

       1
       1
       +
       <a class="zola-anchor" href="#{{ id }}" aria-label="Anchor link for: {{ id }}">§</a>

+18

themes/zerm/templates/categories/list.html

···

       1
       1
       +
       {% extends "index.html" %}

     

       2
       2
       +
       {%- block main -%}

     

       3
       3
       +
           <div class="post">

     

       4
       4
       +
       

     

       5
       5
       +
               <h1 class="post-title">{categories}</h1>

     

       6
       6
       +
               <ul>

     

       7
       7
       +
                   {%- for cat in terms -%}

     

       8
       8
       +
                       <li class="tag-list">

     

       9
       9
       +
                           <a href="{{ get_taxonomy_url(kind="categories", name=cat.name) }}">{{ "{" }}{{ cat.name }}{{ "}" }}</a>

     

       10
       10
       +
                           ({{ cat.pages | length }} post{{ cat.pages | length | pluralize }})

     

       11
       11
       +
                       </li>

     

       12
       12
       +
                       {# End of pagination for-loop #}

     

       13
       13
       +
                   {%- endfor -%}

     

       14
       14
       +
                   {#- I don't put pagination here like Terminal does. I don't like how

     

       15
       15
       +
                   the buttons move with the size of post entries in the content div. -#}

     

       16
       16
       +
               </ul>

     

       17
       17
       +
           </div>

     

       18
       18
       +
       {%- endblock main -%}

+30

themes/zerm/templates/categories/single.html

···

       1
       1
       +
       {%- extends "index.html"-%}

     

       2
       2
       +
       {%- block main-%}

     

       3
       3
       +
           <div class="post">

     

       4
       4
       +
               <h1 class="post-title">

     

       5
       5
       +
                   categories ∋ {{ "{" }}{{ term.name }}{{ "}" }}

     

       6
       6
       +
                   ({{ term.pages | length }} post{{ term.pages | length | pluralize }})

     

       7
       7
       +
               </h1>

     

       8
       8
       +
       

     

       9
       9
       +
               <ul>

     

       10
       10
       +
                   {%- for post in term.pages -%}

     

       11
       11
       +
                       <li class="tag-list">

     

       12
       12
       +
                           {{ post.date | date(format="%Y.%m.%d") }}

     

       13
       13
       +
                           :: <a href="{{ post.permalink }}">{{ post.title }}</a>

     

       14
       14
       +
                           :: {{ "{" }}

     

       15
       15
       +
                           {%- for cat in post.taxonomies["categories"] -%}

     

       16
       16
       +
                               {%- set _cat = get_taxonomy_url(kind="categories", name=cat) -%}

     

       17
       17
       +
                               {%- if loop.last -%}

     

       18
       18
       +
                                   <a href="{{ _cat }}">{{ cat }}</a>

     

       19
       19
       +
                               {%- else -%}

     

       20
       20
       +
                                   <a href="{{ _cat }}">{{ cat }}</a>,&nbsp;

     

       21
       21
       +
                               {%- endif -%}

     

       22
       22
       +
                           {% endfor %}{{ "}" }}

     

       23
       23
       +
                       </li>

     

       24
       24
       +
                       {# End of pagination for-loop #}

     

       25
       25
       +
                   {%- endfor -%}

     

       26
       26
       +
                   {#- I don't put pagination here like Terminal does. I don't like how

     

       27
       27
       +
                   the buttons move with the size of post entries in the content div. -#}

     

       28
       28
       +
           </ul>

     

       29
       29
       +
       </div>

     

       30
       30
       +
       {%- endblock main-%}

+97

themes/zerm/templates/index.html

···

       1
       1
       +
       {% import "macros/head.html" as head -%}

     

       2
       2
       +
       {% import "macros/logo.html" as logo -%}

     

       3
       3
       +
       {% import "macros/header.html" as header -%}

     

       4
       4
       +
       {% import "macros/extended_header.html" as extended_header -%}

     

       5
       5
       +
       {% import "macros/lists.html" as lists -%}

     

       6
       6
       +
       {% import "macros/posts.html" as posts -%}

     

       7
       7
       +
       {% import "macros/social.html" as social -%}

     

       8
       8
       +
       {% import "macros/utils.html" as utils -%}

     

       9
       9
       +
       {% import "macros/menu.html" as menu -%}

     

       10
       10
       +
       {% import "macros/pagination.html" as pagination -%}

     

       11
       11
       +
       {% import "macros/footer.html" as footer -%}

     

       12
       12
       +
       {% import "macros/extended_footer.html" as extended_footer -%}

     

       13
       13
       +
       {% import "macros/comments.html" as comments -%}

     

       14
       14
       +
       

     

       15
       15
       +
       <!DOCTYPE html>

     

       16
       16
       +
       <html lang="{{ lang }}">

     

       17
       17
       +
           <head>

     

       18
       18
       +
               {%- block title -%}

     

       19
       19
       +
                   <title>{{ config.title }}</title>

     

       20
       20
       +
               {%- endblock title -%}

     

       21
       21
       +
       

     

       22
       22
       +
               {%- block general_meta -%}

     

       23
       23
       +
                   {{ head::general_meta() }}

     

       24
       24
       +
               {%- endblock general_meta -%}

     

       25
       25
       +
       

     

       26
       26
       +
               {%- block og_preview -%}

     

       27
       27
       +
                   {{ social::og_preview() }}

     

       28
       28
       +
               {%- endblock og_preview -%}

     

       29
       29
       +
       

     

       30
       30
       +
               {%- block fonts -%}

     

       31
       31
       +
                   {{ head::fonts() }}

     

       32
       32
       +
               {%- endblock fonts -%}

     

       33
       33
       +
       

     

       34
       34
       +
               {%- block css -%}

     

       35
       35
       +
                   {{ head::styling() }}

     

       36
       36
       +
               {%- endblock css -%}

     

       37
       37
       +
       

     

       38
       38
       +
               {%- block favicon -%}

     

       39
       39
       +
                   {{ head::favicon() }}

     

       40
       40
       +
               {%- endblock favicon -%}

     

       41
       41
       +
       

     

       42
       42
       +
               {%- block rss -%}

     

       43
       43
       +
                   {{ head::rss() }}

     

       44
       44
       +
               {%- endblock rss -%}

     

       45
       45
       +
       

     

       46
       46
       +
               {%- block math -%}

     

       47
       47
       +
               {%- endblock math -%}

     

       48
       48
       +
           </head>

     

       49
       49
       +
           <body>

     

       50
       50
       +
               {#

     

       51
       51
       +
               "container full" when width == True, regardless of center

     

       52
       52
       +
               "container center" when only center == True

     

       53
       53
       +
               "container" when both false.

     

       54
       54
       +
               #}

     

       55
       55
       +
               {%- if config.extra.full_width -%}

     

       56
       56
       +
                   {%- set container = "container full" -%}

     

       57
       57
       +
               {%- elif config.extra.center -%}

     

       58
       58
       +
                   {%- set container = "container center" -%}

     

       59
       59
       +
               {%- else -%}

     

       60
       60
       +
                   {%- set container = "container" -%}

     

       61
       61
       +
               {%- endif -%}

     

       62
       62
       +
       

     

       63
       63
       +
               <div class="{{ container }}">

     

       64
       64
       +
                   {%- block header -%}

     

       65
       65
       +
                       {{ header::header() }}

     

       66
       66
       +
                   {%- endblock header -%}

     

       67
       67
       +
                   <div class="content">

     

       68
       68
       +
                       {%-  block main -%}

     

       69
       69
       +
                           {{ lists::list_pages() }}

     

       70
       70
       +
                       {%- endblock main -%}

     

       71
       71
       +
                   </div>

     

       72
       72
       +
                   {#-

     

       73
       73
       +
                   I keep pagination out of list, unlike Terminal, because I don't

     

       74
       74
       +
                   like how the pagination buttons move with the width of the content

     

       75
       75
       +
                   div.

     

       76
       76
       +
                   -#}

     

       77
       77
       +
                   {%- block pagination -%}

     

       78
       78
       +
                       {{ pagination::paginate() }}

     

       79
       79
       +
                   {%- endblock pagination -%}

     

       80
       80
       +
       

     

       81
       81
       +
                   {%- block footer -%}

     

       82
       82
       +
                       <footer class="footer">

     

       83
       83
       +
                           <div class="footer__inner">

     

       84
       84
       +
                               {%- block copyright -%}

     

       85
       85
       +
                                   {{ footer::copyright() }}

     

       86
       86
       +
                               {%- endblock copyright -%}

     

       87
       87
       +
       

     

       88
       88
       +
                               {%- block script -%}

     

       89
       89
       +
                                   {{ footer::script() }}

     

       90
       90
       +
                               {%- endblock script -%}

     

       91
       91
       +
                           </div>

     

       92
       92
       +
                           {{ extended_footer::extended_footer() }}

     

       93
       93
       +
                       </footer>

     

       94
       94
       +
                   {%- endblock footer -%}

     

       95
       95
       +
               </div>

     

       96
       96
       +
           </body>

     

       97
       97
       +
       </html>

+30

themes/zerm/templates/macros/comments.html

···

       1
       1
       +
       {% macro comments() %}

     

       2
       2
       +
           {% if config.extra.disqus.enabled is defined and config.extra.disqus.enabled == true %}

     

       3
       3
       +
               {{ comments::disqus() }}

     

       4
       4
       +
           {% endif %}

     

       5
       5
       +
       {% endmacro comments %}

     

       6
       6
       +
       

     

       7
       7
       +
       

     

       8
       8
       +
       {% macro disqus() %}

     

       9
       9
       +
       

     

       10
       10
       +
           <div id="disqus_thread"></div>

     

       11
       11
       +
           <script>

     

       12
       12
       +
               /**

     

       13
       13
       +
               *  RECOMMENDED CONFIGURATION VARIABLES: EDIT AND UNCOMMENT THE SECTION BELOW TO INSERT DYNAMIC VALUES FROM YOUR PLATFORM OR CMS.

     

       14
       14
       +
               *  LEARN WHY DEFINING THESE VARIABLES IS IMPORTANT: https://disqus.com/admin/universalcode/#configuration-variables    */

     

       15
       15
       +
               

     

       16
       16
       +
               var disqus_config = function () {

     

       17
       17
       +
                   this.page.url = '{{ page.permalink | safe }}';  // Replace PAGE_URL with your page's canonical URL variable

     

       18
       18
       +
                   this.page.identifier = '{{ page.permalink | safe }}'; // Replace PAGE_IDENTIFIER with your page's unique identifier variable

     

       19
       19
       +
               };

     

       20
       20
       +
               

     

       21
       21
       +
               (function() { // DON'T EDIT BELOW THIS LINE

     

       22
       22
       +
               var d = document, s = d.createElement('script');

     

       23
       23
       +
               s.src = 'https://{{config.extra.disqus.short_name}}.disqus.com/embed.js';

     

       24
       24
       +
               s.setAttribute('data-timestamp', +new Date());

     

       25
       25
       +
               (d.head || d.body).appendChild(s);

     

       26
       26
       +
               })();

     

       27
       27
       +
           </script>

     

       28
       28
       +
           <noscript>Please enable JavaScript to view the <a href="https://disqus.com/?ref_noscript">comments powered by Disqus.</a></noscript>

     

       29
       29
       +
       

     

       30
       30
       +
       {% endmacro disqus %}

+2

themes/zerm/templates/macros/extended_footer.html

···

       1
       1
       +
       {% macro extended_footer() %}

     

       2
       2
       +
       {% endmacro extended_footer %}

+2

themes/zerm/templates/macros/extended_header.html

···

       1
       1
       +
       {% macro extended_header() %}

     

       2
       2
       +
       {% endmacro extended_header %}

+14

themes/zerm/templates/macros/footer.html

···

       1
       1
       +
       {% macro copyright() %}

     

       2
       2
       +
           {%- if config.extra.copyright -%}

     

       3
       3
       +
               <div class="copyright copyright--user">{{ config.extra.copyright | safe }}</div>

     

       4
       4
       +
           {%- else -%}

     

       5
       5
       +
               <div class="copyright">

     

       6
       6
       +
                   <span>© {{ now() | date(format="%Y") }} <a href="https://github.com/ejmg/zerm">zerm</a> :: Powered by <a href="https://www.getzola.org/">Zola</a></span>

     

       7
       7
       +
                   <span>:: Theme made by <a href="https://github.com/ejmg">ejmg</a></span>

     

       8
       8
       +
               </div>

     

       9
       9
       +
           {%- endif -%}

     

       10
       10
       +
       {% endmacro copyright %}

     

       11
       11
       +
       

     

       12
       12
       +
       {% macro script() %}

     

       13
       13
       +
           <script type="text/javascript" src="{{ get_url(path="assets/js/main.js") }}"></script>

     

       14
       14
       +
       {% endmacro script %}

+84

themes/zerm/templates/macros/head.html

···

       1
       1
       +
       {#- TODO:

     

       2
       2
       +
           - [x] add rss

     

       3
       3
       +
           - [x] favicons

     

       4
       4
       +
           - [x] media preview

     

       5
       5
       +
           - [ ] twitter

     

       6
       6
       +
           - [ ] maybe google adsense

     

       7
       7
       +
           -#}

     

       8
       8
       +
           

     

       9
       9
       +
       {% macro fonts() %}

     

       10
       10
       +
           <link rel="preload" href="{{ get_url(path="/assets/fonts/FiraCode-Regular.woff2") }}" as="font" type="font/woff2" crossorigin="anonymous">

     

       11
       11
       +
           <link rel="preload" href="{{ get_url(path="/assets/fonts/FiraCode-Bold.woff2") }}" as="font" type="font/woff2" crossorigin="anonymous">

     

       12
       12
       +
       {% endmacro fonts %}

     

       13
       13
       +
       

     

       14
       14
       +
       {% macro styling() %}

     

       15
       15
       +
           <link rel="stylesheet" href="{{ get_url(path="style.css", cachebust=true) }}">

     

       16
       16
       +
           {% if config.extra.theme_color != "orange" -%}

     

       17
       17
       +
               {% set color = "color/" ~ config.extra.theme_color ~ ".css" -%}

     

       18
       18
       +
               <link rel="stylesheet" href="{{ get_url(path=color, cachebust=true) }}">

     

       19
       19
       +
           {%- else -%}

     

       20
       20
       +
               <link rel="stylesheet" href=" {{ get_url(path="color/orange.css", cachebust=true) }}">

     

       21
       21
       +
           {% endif %}

     

       22
       22
       +
           {%- if config.extra.custom_css is defined -%}

     

       23
       23
       +
               <link rel="stylesheet" href="{{ get_url(path="custom.css", cachebust=true) }}">

     

       24
       24
       +
           {% endif %}

     

       25
       25
       +
       {% endmacro styling %}

     

       26
       26
       +
       

     

       27
       27
       +
       {% macro favicon() %}

     

       28
       28
       +
           {%- if config.extra.favicon is defined -%}

     

       29
       29
       +
               <link rel="shortcut icon" href="{{ get_url(path=config.extra.favicon) }}" type="image/x-icon" />

     

       30
       30
       +
           {%- endif -%}

     

       31
       31
       +
       {% endmacro favicon %}

     

       32
       32
       +
       

     

       33
       33
       +
       {% macro rss() %}

     

       34
       34
       +
           {%- if config.generate_feed -%}

     

       35
       35
       +
               <link rel="alternate" type={% if config.feed_filename == "atom.xml" %}"application/atom+xml"{% else %}"application/rss+xml"{% endif %} title="{{ config.title }} RSS" href="{{ get_url(path=config.feed_filename) }}">

     

       36
       36
       +
           {%- endif -%}

     

       37
       37
       +
       {% endmacro rss %}

     

       38
       38
       +
       

     

       39
       39
       +
       {% macro general_meta() %}

     

       40
       40
       +
           <meta http-equiv="content-type" content="text/html; charset=utf-8">

     

       41
       41
       +
           <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1">

     

       42
       42
       +
           {%- if page.title -%}

     

       43
       43
       +
               <meta name="description" content="{{ config.description }} {{ page.title }} {{ page.description }}"/>

     

       44
       44
       +
           {%- else -%}

     

       45
       45
       +
               <meta name="description" content="{{ config.description }}"/>

     

       46
       46
       +
           {%- endif -%}

     

       47
       47
       +
       

     

       48
       48
       +
           {%- if page.taxonomies.tags or page.taxonomies.categories -%}

     

       49
       49
       +
               <meta name="keywords" content="

     

       50
       50
       +
               {%- if page.taxonomies.categories -%}

     

       51
       51
       +
                   {%- for cat in page.taxonomies.categories -%}

     

       52
       52
       +
                           {{ cat }}, {% endfor -%}

     

       53
       53
       +
               {%- endif -%}

     

       54
       54
       +
       

     

       55
       55
       +
               {%- if page.taxonomies.tags -%}

     

       56
       56
       +
                   {%- for tag in page.taxonomies.tags -%}

     

       57
       57
       +
                       {%- if loop.last -%}

     

       58
       58
       +
                           {{ tag }}

     

       59
       59
       +
                       {%- else -%}

     

       60
       60
       +
                           {{ tag }}, {% endif -%}

     

       61
       61
       +
                   {%- endfor -%}

     

       62
       62
       +
               {%- endif -%}

     

       63
       63
       +
               " />

     

       64
       64
       +
           {%- endif -%}

     

       65
       65
       +
       {% endmacro general_meta %}

     

       66
       66
       +
       

     

       67
       67
       +
       {% macro katex() %}

     

       68
       68
       +
       {% if config.extra.enable_katex %}

     

       69
       69
       +
         <link rel="stylesheet" href="{{ get_url(path="assets/katex/katex.min.css") }}">

     

       70
       70
       +
       

     

       71
       71
       +
         <script defer type="text/javascript" src="{{ get_url(path="assets/katex/katex.min.js") | safe }}"></script>

     

       72
       72
       +
         <script defer type="text/javascript" src="{{ get_url(path="assets/katex/mathtex-script-type.min.js") | safe }}"></script>

     

       73
       73
       +
       

     

       74
       74
       +
         <script defer src="{{ get_url(path="assets/katex/auto-render.min.js") | safe }}"

     

       75
       75
       +
           onload="renderMathInElement(document.body, {

     

       76
       76
       +
       				delimiters: [

     

       77
       77
       +
       					{left: '$$', right: '$$', display: true},

     

       78
       78
       +
       					{left: '$', right: '$', display: false},

     

       79
       79
       +
       					{left: '\\(', right: '\\)', display: false},

     

       80
       80
       +
       					{left: '\\[', right: '\\]', display: true}

     

       81
       81
       +
       				]

     

       82
       82
       +
       			});"></script>

     

       83
       83
       +
       {% endif %}

     

       84
       84
       +
       {% endmacro katek %}

+16

themes/zerm/templates/macros/header.html

···

       1
       1
       +
       {% macro header() %}

     

       2
       2
       +
       <header class="header">

     

       3
       3
       +
           <div class="header__inner">

     

       4
       4
       +
               <div class="header__logo">

     

       5
       5
       +
                   {{ logo::logo() }}

     

       6
       6
       +
               </div>

     

       7
       7
       +
               <div class="menu-trigger">menu</div>

     

       8
       8
       +
           </div>

     

       9
       9
       +
           {# Check if there are menu items to render, yes if > 0 #}

     

       10
       10
       +
           {%- set num = config.extra.main_menu | length -%}

     

       11
       11
       +
           {% if num > 0 -%}

     

       12
       12
       +
               {{ menu::menu() }}

     

       13
       13
       +
           {% endif -%}

     

       14
       14
       +
       </header>

     

       15
       15
       +
       {% endmacro header %}

     

       16
       16
       +

+39

themes/zerm/templates/macros/lists.html

···

       1
       1
       +
       {% macro list_pages() %}

     

       2
       2
       +
       <section class="posts">

     

       3
       3
       +
           

     

       4
       4
       +
           {%- for page in paginator.pages -%}

     

       5
       5
       +
           

     

       6
       6
       +
           <div class="post on-list">

     

       7
       7
       +
               <header>

     

       8
       8
       +
                   <h1 class="post-title">

     

       9
       9
       +
                       <a href="{{ page.permalink }}">{{ page.title }}</a>

     

       10
       10
       +
                   </h1>

     

       11
       11
       +
               </header>

     

       12
       12
       +
               

     

       13
       13
       +
               

     

       14
       14
       +
               {{ posts::meta(page=page, author=config.extra.show_author) }}

     

       15
       15
       +
               

     

       16
       16
       +
               {#-                NOTE              -#}

     

       17
       17
       +
               {#- --------------------------------  -#}

     

       18
       18
       +
               {#- Skipping the Cover page implementation. Not included/covered for now. -#}

     

       19
       19
       +
       

     

       20
       20
       +
               <div class="post-content">

     

       21
       21
       +
                   {%  if page.description -%}

     

       22
       22
       +
                   {{ page.description }}

     

       23
       23
       +
                   {#- end if-check for description -#}

     

       24
       24
       +
                   {%  elif page.summary -%}

     

       25
       25
       +
                   {{ page.summary | safe }}

     

       26
       26
       +
                   {%  endif -%}

     

       27
       27
       +
               </div>

     

       28
       28
       +
               {% if page.description or page.summary -%}

     

       29
       29
       +
               <div>

     

       30
       30
       +
                   <a class="read-more button" href="{{ page.permalink }}">{{ config.extra.read_more }} →</a>

     

       31
       31
       +
               </div>

     

       32
       32
       +
               {% endif -%}

     

       33
       33
       +
           </div>

     

       34
       34
       +
           {# End of pagination for-loop #}

     

       35
       35
       +
           {%- endfor -%}

     

       36
       36
       +
           {#- I don't put pagination here like Terminal does. I don't like how

     

       37
       37
       +
           the buttons move with the size of post entries in the content div. -#}

     

       38
       38
       +
       </section>

     

       39
       39
       +
       {% endmacro list_pages %}

+7

themes/zerm/templates/macros/logo.html

···

       1
       1
       +
       {%- macro logo() -%}

     

       2
       2
       +
       <a href="{%- if config.extra.logo_home_link -%}{{ config.extra.logo_home_link }}{%- else -%}{{ config.base_url }}{%- endif -%}">

     

       3
       3
       +
           <div class="logo">

     

       4
       4
       +
               {{config.extra.logo_text | default(value="Terminal") }}

     

       5
       5
       +
           </div>

     

       6
       6
       +
       </a>

     

       7
       7
       +
       {%- endmacro logo -%}

+58

themes/zerm/templates/macros/menu.html

···

       1
       1
       +
       {% macro menu() %}

     

       2
       2
       +
           <nav class="menu">

     

       3
       3
       +
               <ul class="menu__inner menu__inner--desktop">

     

       4
       4
       +
                   {# 

     

       5
       5
       +
                   I am almost certain this check isn't necessary, that it will always

     

       6
       6
       +
                   return true, but the only alternative I can think of is the case where

     

       7
       7
       +
                   this config value simply doesn't exist (null)? IDK, just copying from

     

       8
       8
       +
                   original implementation for now.

     

       9
       9
       +
                   #}

     

       10
       10
       +
                   {% if config.extra.show_menu_items is defined -%}

     

       11
       11
       +
                       {% for menu_item in config.extra.main_menu | slice(end=config.extra.show_menu_items) -%}

     

       12
       12
       +
                           {# 

     

       13
       13
       +
                           Original theme has sub-children checks on main-menu, not worrying about that here.

     

       14
       14
       +
                           #}

     

       15
       15
       +
                           <li>

     

       16
       16
       +
                               <a href="{{ menu::get_link(item=menu_item) }}">{{ menu_item.name }}</a>

     

       17
       17
       +
                           </li>

     

       18
       18
       +
                       {% endfor -%}

     

       19
       19
       +
       

     

       20
       20
       +
                       {%- set main_len = config.extra.main_menu | length -%}

     

       21
       21
       +
                       {%- set show_len = config.extra.show_menu_items -%}

     

       22
       22
       +
       

     

       23
       23
       +
                       {%- if main_len > show_len -%}

     

       24
       24
       +
                           <ul class="menu__sub-inner">

     

       25
       25
       +
                               <li class="menu__sub-inner-more-trigger">{{ config.extra.menu_more }} ▾</li>

     

       26
       26
       +
                               <ul class="menu__sub-inner-more hidden">

     

       27
       27
       +
                                   {{ menu::items(menu=config.extra.main_menu | slice(start=config.extra.show_menu_items)) }}

     

       28
       28
       +
                               </ul>

     

       29
       29
       +
                           </ul>

     

       30
       30
       +
                       {%- endif -%}

     

       31
       31
       +
                       {# Continues the original if-check at top of file for show_menu_items #}

     

       32
       32
       +
                   {% else -%}

     

       33
       33
       +
                       {{ menu::items(menu=config.extra.main_menu) }}

     

       34
       34
       +
                   {%- endif -%}

     

       35
       35
       +
               </ul>

     

       36
       36
       +
       

     

       37
       37
       +
               <ul class="menu__inner menu__inner--mobile">

     

       38
       38
       +
                   {{ menu::items(menu=config.extra.main_menu) }}

     

       39
       39
       +
               </ul>

     

       40
       40
       +
           </nav>

     

       41
       41
       +
       {% endmacro menu %}

     

       42
       42
       +
       

     

       43
       43
       +
       {% macro items(menu) %}

     

       44
       44
       +
           {%- for menu_item in menu -%}

     

       45
       45
       +
               {# skipping sub-child check #}

     

       46
       46
       +
               <li>

     

       47
       47
       +
                   <a href="{{ menu::get_link(item=menu_item) }}">{{ menu_item.name }}</a>

     

       48
       48
       +
               </li>

     

       49
       49
       +
           {%- endfor-%}

     

       50
       50
       +
       {% endmacro items %}

     

       51
       51
       +
       

     

       52
       52
       +
       {% macro get_link(item) %}

     

       53
       53
       +
           {% if item.external is defined and item.external == true %}

     

       54
       54
       +
               {{ item.url }}

     

       55
       55
       +
           {% else %}

     

       56
       56
       +
               {{ get_url(path=item.url) }}

     

       57
       57
       +
           {% endif %}

     

       58
       58
       +
       {% endmacro get_link %}

+24

themes/zerm/templates/macros/pagination.html

···

       1
       1
       +
       {% macro paginate() %}

     

       2
       2
       +
           <div class="pagination">

     

       3
       3
       +
               <div class="pagination__buttons">

     

       4
       4
       +
                   {% if paginator.previous -%}

     

       5
       5
       +
                       <span class="button previous">

     

       6
       6
       +
                           <a href="{{ paginator.previous }}">

     

       7
       7
       +
                               <span class="button__icon">←</span>

     

       8
       8
       +
                               <span class="button__text">newer</span>

     

       9
       9
       +
                           </a>

     

       10
       10
       +
                       </span>

     

       11
       11
       +
                       {# end of if-check for page.previous #}

     

       12
       12
       +
                   {%  endif -%}

     

       13
       13
       +
                   {% if paginator.next -%}

     

       14
       14
       +
                       {# end of if-check for page.next #}

     

       15
       15
       +
                       <span class="button next">

     

       16
       16
       +
                           <a href="{{ paginator.next }}">

     

       17
       17
       +
                               <span class="button__text">older</span>

     

       18
       18
       +
                               <span class="button__icon">→</span>

     

       19
       19
       +
                           </a>

     

       20
       20
       +
                       </span>

     

       21
       21
       +
                   {% endif-%}

     

       22
       22
       +
               </div>

     

       23
       23
       +
           </div>

     

       24
       24
       +
       {% endmacro paginate %}

+100

themes/zerm/templates/macros/posts.html

···

       1
       1
       +
       {% macro section_meta(section, author) %}

     

       2
       2
       +
           <div class="post-meta">

     

       3
       3
       +
               <span class="post-date">

     

       4
       4
       +
       

     

       5
       5
       +
                   {%- if section.extra["date"] -%}

     

       6
       6
       +
                       {{ section.extra["date"] | date(format="%Y.%m.%d") }}

     

       7
       7
       +
                       {# end of section.date if-check #}

     

       8
       8
       +
                   {%- endif -%}

     

       9
       9
       +
               </span>

     

       10
       10
       +
       

     

       11
       11
       +
               <span class="post-author">

     

       12
       12
       +
                   {%- if author -%}

     

       13
       13
       +
                       {{ utils::author(page=section) }}

     

       14
       14
       +
                   {%- endif -%}

     

       15
       15
       +
               </span>

     

       16
       16
       +
           </div>

     

       17
       17
       +
       {% endmacro section_meta %}

     

       18
       18
       +
       

     

       19
       19
       +
       {% macro langs(page) %}

     

       20
       20
       +
           {% if page.translations | length > 1 %}

     

       21
       21
       +
           <div class="post-langs" style="opacity: .5;">

     

       22
       22
       +
             <span>Translations: </span>{# TODO translate the span content too #}

     

       23
       23
       +
             {% for translated in page.translations %}

     

       24
       24
       +
             <a href="{{ translated.permalink }}">{{ translated.lang }}</a>

     

       25
       25
       +
             {% endfor %}

     

       26
       26
       +
           </div>

     

       27
       27
       +
           {% endif %}

     

       28
       28
       +
       {% endmacro langs %}

     

       29
       29
       +
       

     

       30
       30
       +
       {% macro meta(page, author) %}

     

       31
       31
       +
           <div class="post-meta">

     

       32
       32
       +
               <span class="post-date">

     

       33
       33
       +
                   {%- if page.date -%}

     

       34
       34
       +
                       {{ page.date | date(format="%Y.%m.%d") }}

     

       35
       35
       +
                       {# end of page.date if-check #}

     

       36
       36
       +
                   {%- endif -%}

     

       37
       37
       +
       

     

       38
       38
       +
                   {%- if page.updated -%}

     

       39
       39
       +
                       [Updated: {{ page.updated | date(format="%Y.%m.%d") }}]

     

       40
       40
       +
                       {# end of page.updated if-check #}

     

       41
       41
       +
                   {%- endif -%}

     

       42
       42
       +
               </span>

     

       43
       43
       +
       

     

       44
       44
       +
               <span class="post-author">

     

       45
       45
       +
                   {%- if author -%}

     

       46
       46
       +
                       {{ utils::author(page=page) }}

     

       47
       47
       +
                   {%- endif -%}

     

       48
       48
       +
               </span>

     

       49
       49
       +
       

     

       50
       50
       +
               {{  posts::taxonomies(taxonomy=page.taxonomies,

     

       51
       51
       +
                   disp_cat=config.extra.show_categories,

     

       52
       52
       +
                   disp_tag=config.extra.show_tags) }}

     

       53
       53
       +
           </div>

     

       54
       54
       +
       {% endmacro meta %}

     

       55
       55
       +
       

     

       56
       56
       +
       {% macro taxonomies(taxonomy, disp_cat, disp_tag) %}

     

       57
       57
       +
       

     

       58
       58
       +
           {% if disp_cat and disp_tag -%}

     

       59
       59
       +
               {% if taxonomy.categories -%}

     

       60
       60
       +
                   {{ posts::categories(categories=taxonomy.categories) }}

     

       61
       61
       +
                   {# end if-check for categories #}

     

       62
       62
       +
               {%- endif -%}

     

       63
       63
       +
       

     

       64
       64
       +
               {% if taxonomy.tags -%}

     

       65
       65
       +
                   {{ posts::tags(tags=taxonomy.tags) }}

     

       66
       66
       +
                   {# end if-check for tags #}

     

       67
       67
       +
               {% endif -%}

     

       68
       68
       +
           {% elif disp_cat -%}

     

       69
       69
       +
               {% if taxonomy.categories-%}

     

       70
       70
       +
                   {{ posts::categories(categories=taxonomy.categories) }}

     

       71
       71
       +
                   {# end if-check for categories #}

     

       72
       72
       +
               {% endif -%}

     

       73
       73
       +
           {% elif disp_tag -%}

     

       74
       74
       +
               {% if taxonomy.tags -%}

     

       75
       75
       +
                   {{ posts::tags(tags=taxonomy.tags) }}

     

       76
       76
       +
                   {# end if-check for tags #}

     

       77
       77
       +
               {% endif -%}

     

       78
       78
       +
               {# end if-check for BOTH disp bools #}

     

       79
       79
       +
           {% endif -%}

     

       80
       80
       +
       {% endmacro taxonomies %}

     

       81
       81
       +
       

     

       82
       82
       +
       {% macro categories(categories) %}

     

       83
       83
       +
           :: {

     

       84
       84
       +
           {%- for cat in categories -%}

     

       85
       85
       +
               {%- if loop.last -%}

     

       86
       86
       +
                   <a href="{{ get_taxonomy_url(kind="categories", name=cat ) }}">{{ cat }}</a>

     

       87
       87
       +
               {%- else -%}

     

       88
       88
       +
                   <a href="{{ get_taxonomy_url(kind="categories", name=cat ) }}">{{ cat }}</a>,

     

       89
       89
       +
                   {# end of if-check for whether last item or not #}

     

       90
       90
       +
               {%- endif -%}

     

       91
       91
       +
           {%- endfor -%}} {# <--- NOTE: OPEN CURLY BRACE #}

     

       92
       92
       +
       {% endmacro categories %}

     

       93
       93
       +
       

     

       94
       94
       +
       {% macro tags(tags) %}

     

       95
       95
       +
           ::

     

       96
       96
       +
           {% for tag in tags -%}

     

       97
       97
       +
               #<a href="{{get_taxonomy_url(kind="tags", name=tag )}}">{{ tag }}</a>

     

       98
       98
       +
               {# end of tags for-loop #}

     

       99
       99
       +
           {% endfor -%}

     

       100
       100
       +
       {% endmacro tags %}

+46

themes/zerm/templates/macros/social.html

···

       1
       1
       +
       {% macro og_preview() %}

     

       2
       2
       +
           <meta property="og:title" content="{{ social::og_title() }}" />

     

       3
       3
       +
           <meta property="og:type" content="website"/>

     

       4
       4
       +
           {%- if current_url -%}

     

       5
       5
       +
               <meta property="og:url" content="{{ current_url }}"/>

     

       6
       6
       +
           {%- endif -%}

     

       7
       7
       +
           <meta property="og:description" content="{{ social::og_description() }}"/>

     

       8
       8
       +
           {%- if config.extra.og_preview_img -%}

     

       9
       9
       +
               <meta property="og:image" content="{{ get_url(path=config.extra.og_preview_img) }}"/>

     

       10
       10
       +
           {%- endif -%}

     

       11
       11
       +
       {% endmacro og_preview %}

     

       12
       12
       +
       

     

       13
       13
       +
       {% macro og_description() %}

     

       14
       14
       +
           {%- if section -%}

     

       15
       15
       +
               {%-  if section.description -%}

     

       16
       16
       +
                   {{ section.description }}

     

       17
       17
       +
               {%- else -%}

     

       18
       18
       +
                   {{ config.description }}

     

       19
       19
       +
               {%- endif -%}

     

       20
       20
       +
           {%- elif page -%}

     

       21
       21
       +
               {%- if page.summary | string -%}

     

       22
       22
       +
                   {{ page.summary | striptags | truncate(length=200) }}

     

       23
       23
       +
               {%- elif page.description -%}

     

       24
       24
       +
                   {{ page.description }}

     

       25
       25
       +
               {%- else -%}

     

       26
       26
       +
                   {{ config.description }}

     

       27
       27
       +
               {%- endif -%}

     

       28
       28
       +
           {%- endif -%}

     

       29
       29
       +
       {% endmacro og_description %}

     

       30
       30
       +
       

     

       31
       31
       +
       {% macro og_title() -%}

     

       32
       32
       +
           {{ config.title }} -&nbsp;

     

       33
       33
       +
           {%- if section -%}

     

       34
       34
       +
               {%- if section.title -%}

     

       35
       35
       +
                   {{ section.title | striptags }}

     

       36
       36
       +
               {%- else -%}

     

       37
       37
       +
                   {{ config.description }}

     

       38
       38
       +
               {%- endif -%}

     

       39
       39
       +
           {%- elif page -%}

     

       40
       40
       +
               {%- if page.title -%}

     

       41
       41
       +
                   {{ page.title | striptags }}

     

       42
       42
       +
               {%- else -%}

     

       43
       43
       +
                   {{ config.description }}

     

       44
       44
       +
               {%- endif -%}

     

       45
       45
       +
           {%- endif -%}

     

       46
       46
       +
       {% endmacro og_title %}

+61

themes/zerm/templates/macros/toc.html

···

       1
       1
       +
       {% macro toc (t) %}

     

       2
       2
       +
       {% if t %}

     

       3
       3
       +
       <div class="toc" id="nav-container">

     

       4
       4
       +
       	<p class="toc-head">Table of Contents</p>

     

       5
       5
       +
       		<div id="nav-content" >

     

       6
       6
       +
       		<ul>

     

       7
       7
       +
       		{% for h1 in page.toc %}

     

       8
       8
       +
       			<li>

     

       9
       9
       +
       				<a href="{{ h1.permalink | safe }}">{{ h1.title }}</a>

     

       10
       10
       +
       				{% if h1.children %}

     

       11
       11
       +
       					<ul>

     

       12
       12
       +
       						{% for h2 in h1.children %}

     

       13
       13
       +
       							<li>

     

       14
       14
       +
       								<a href="{{ h2.permalink | safe }}">{{ h2.title }}</a>

     

       15
       15
       +
       							</li>

     

       16
       16
       +
       							{% if h2.children %}

     

       17
       17
       +
       								<ul>

     

       18
       18
       +
       								{% for h3 in h2.children %}

     

       19
       19
       +
       									<li>

     

       20
       20
       +
       										<a href="{{ h3.permalink | safe }}">{{ h3.title }}</a>

     

       21
       21
       +
       										{% if h3.children %}

     

       22
       22
       +
       											<ul>

     

       23
       23
       +
       												{% for h4 in h3.children %}

     

       24
       24
       +
       													<li>

     

       25
       25
       +
       														<a href="{{ h4.permalink | safe }}">{{ h4.title }}</a>

     

       26
       26
       +
       													</li>

     

       27
       27
       +
       													{% if h4.children %}

     

       28
       28
       +
       														<ul>

     

       29
       29
       +
       															{% for h5 in h4.children %}

     

       30
       30
       +
       																<li>

     

       31
       31
       +
       																	<a href="{{ h5.permalink | safe }}">{{ h5.title }}</a>

     

       32
       32
       +
       																	{% if h5.children %}

     

       33
       33
       +
       																		<ul>

     

       34
       34
       +
       																		{% for h6 in h5.children %}

     

       35
       35
       +
       																			<li>

     

       36
       36
       +
       																				<a href="{{ h5.permalink | safe }}">{{ h6.title }}</a>

     

       37
       37
       +
       																			</li>

     

       38
       38
       +
       																		{% endfor %}

     

       39
       39
       +
       																		</ul>

     

       40
       40
       +
       																	{% endif %}

     

       41
       41
       +
       																</li>

     

       42
       42
       +
       															{% endfor %}

     

       43
       43
       +
       														</ul>

     

       44
       44
       +
       													{% endif %}

     

       45
       45
       +
       												{% endfor %}

     

       46
       46
       +
       											</ul>

     

       47
       47
       +
       										{% endif %}

     

       48
       48
       +
       									</li>

     

       49
       49
       +
       								{% endfor %}

     

       50
       50
       +
       								</ul>

     

       51
       51
       +
       							{% endif %}

     

       52
       52
       +
       						{% endfor %}

     

       53
       53
       +
       					</ul>

     

       54
       54
       +
       				{% endif %}

     

       55
       55
       +
       			</li>

     

       56
       56
       +
       		{% endfor %}

     

       57
       57
       +
       		</ul>

     

       58
       58
       +
       		</div>

     

       59
       59
       +
       </div>

     

       60
       60
       +
       {% endif %}

     

       61
       61
       +
       {% endmacro %}

+8

themes/zerm/templates/macros/utils.html

···

       1
       1
       +
       {% macro author(page) %}

     

       2
       2
       +
           ::

     

       3
       3
       +
           {% if page.extra.author -%}

     

       4
       4
       +
               {{ page.extra.author }}

     

       5
       5
       +
           {%- else -%}    

     

       6
       6
       +
               {{ config.extra.author }}

     

       7
       7
       +
           {%- endif -%}

     

       8
       8
       +
       {%- endmacro author-%}

+41

themes/zerm/templates/page.html

···

       1
       1
       +
       {% import "macros/head.html" as head -%}

     

       2
       2
       +
       {% import "macros/toc.html" as toc -%}

     

       3
       3
       +
       {% extends "index.html" -%}

     

       4
       4
       +
       

     

       5
       5
       +
       {%- block math -%}

     

       6
       6
       +
         {% if page.extra.math %}

     

       7
       7
       +
         {{ head::katex() }}

     

       8
       8
       +
         {% endif %}

     

       9
       9
       +
       {%- endblock math -%}

     

       10
       10
       +
       

     

       11
       11
       +
       {%- block title %}

     

       12
       12
       +
           <title>{{ page.title }} - {{  config.extra.author }}</title>

     

       13
       13
       +
           {# TODO: make some kind of social media linking, i guess? #}

     

       14
       14
       +
           {#%- include "snippets/social.html" %#}

     

       15
       15
       +
       {%- endblock title -%}

     

       16
       16
       +
       

     

       17
       17
       +
       {%- block main -%}

     

       18
       18
       +
           <article class="post">

     

       19
       19
       +
               <header>

     

       20
       20
       +
                   <h1 class="post-title">

     

       21
       21
       +
                       <a href="{{ page.permalink  }}">{{ page.title }}</a>

     

       22
       22
       +
                   </h1>

     

       23
       23
       +
                   {{ posts::meta(page=page, author=config.extra.show_author) }}

     

       24
       24
       +
                   {{ posts::langs(page=page) }}

     

       25
       25
       +
       

     

       26
       26
       +
                   {%- block ToC -%}

     

       27
       27
       +
                       {%- if page.extra.ToC or config.extra.ToC -%}

     

       28
       28
       +
                           {{ toc::toc(t=page.toc) }}

     

       29
       29
       +
                       {%- endif -%}

     

       30
       30
       +
                   {%- endblock ToC -%}

     

       31
       31
       +
               </header>

     

       32
       32
       +
       

     

       33
       33
       +
               {#- Skipping logic for cover as was in original Terminal theme -#}

     

       34
       34
       +
       

     

       35
       35
       +
               {{ page.content | safe }}

     

       36
       36
       +
       

     

       37
       37
       +
               {{ comments::comments() }}

     

       38
       38
       +
               {# TODO: Decide if any sort of commenting functionality is desired? #}

     

       39
       39
       +
               {#%- include "snippets/comments.html"  -%#}

     

       40
       40
       +
           </article>

     

       41
       41
       +
       {%- endblock main -%}

+24

themes/zerm/templates/section.html

···

       1
       1
       +
       {% extends "index.html" -%}

     

       2
       2
       +
       

     

       3
       3
       +
       {%- block title %}

     

       4
       4
       +
           <title>{{ section.title }} - {{ config.extra.author }}</title>

     

       5
       5
       +
           {# TODO: make some kind of social media linking, i guess? #}

     

       6
       6
       +
           {#%- include "snippets/social.html" %#}

     

       7
       7
       +
       {%- endblock title -%}

     

       8
       8
       +
       

     

       9
       9
       +
       {%- block main -%}

     

       10
       10
       +
           <article class="post">

     

       11
       11
       +
               <header>

     

       12
       12
       +
                   <h1 class="post-title">

     

       13
       13
       +
                       <a href="{{ section.permalink  }}">{{ section.title }}</a>

     

       14
       14
       +
                   </h1>

     

       15
       15
       +
                   {{ posts::section_meta(section=section, author=config.extra.show_author) }}

     

       16
       16
       +
               </header>

     

       17
       17
       +
       

     

       18
       18
       +
               {#- Skipping logic for cover as was in original Terminal theme -#}

     

       19
       19
       +
       

     

       20
       20
       +
                   {{ section.content | safe }}

     

       21
       21
       +
               {# TODO: Decide if any sort of commenting functionality is desired? #}

     

       22
       22
       +
               {#%- include "snippets/comments.html"  -%#}

     

       23
       23
       +
           </article>

     

       24
       24
       +
       {%- endblock main -%}

+12

themes/zerm/templates/static.html

···

       1
       1
       +
       {% extends "index.html" %}

     

       2
       2
       +
       

     

       3
       3
       +
       {% block header %}

     

       4
       4
       +
           <title>{{ page.title }} | elias </title>

     

       5
       5
       +
       {% endblock header %}

     

       6
       6
       +
       

     

       7
       7
       +
       {% block content %}

     

       8
       8
       +
           <article>

     

       9
       9
       +
               <h1>{{ page.title }}</h1>

     

       10
       10
       +
               {{ page.content | safe }}

     

       11
       11
       +
           </article>

     

       12
       12
       +
       {% endblock content %}

+18

themes/zerm/templates/tags/list.html

···

       1
       1
       +
       {% extends "index.html" %}

     

       2
       2
       +
       {%- block main -%}

     

       3
       3
       +
       <div class="post">

     

       4
       4
       +
       

     

       5
       5
       +
           <h1 class="post-title">#tags</h1>

     

       6
       6
       +
           <ul>

     

       7
       7
       +
               {%- for term in terms -%}

     

       8
       8
       +
                   <li class="tag-list">

     

       9
       9
       +
                       <a href="{{ get_taxonomy_url(kind="tags", name=term.name) }}">#{{ term.name }}</a>

     

       10
       10
       +
                       ({{ term.pages | length }} post{{ term.pages | length | pluralize}})

     

       11
       11
       +
                   </li>

     

       12
       12
       +
                   {# End of pagination for-loop #}

     

       13
       13
       +
               {%- endfor -%}

     

       14
       14
       +
               {#- I don't put pagination here like Terminal does. I don't like how

     

       15
       15
       +
               the buttons move with the size of post entries in the content div. -#}

     

       16
       16
       +
           </ul>

     

       17
       17
       +
       </div>

     

       18
       18
       +
       {%- endblock main -%}

+23

themes/zerm/templates/tags/single.html

···

       1
       1
       +
       {%- extends "index.html"-%}

     

       2
       2
       +
       {%- block main-%}

     

       3
       3
       +
           <div class="post">

     

       4
       4
       +
               <h1 class="post-title">

     

       5
       5
       +
                   tags ∋ #{{ term.name }}

     

       6
       6
       +
                   ({{ term.pages | length }} post{{ term.pages | length | pluralize}})

     

       7
       7
       +
               </h1>

     

       8
       8
       +
       

     

       9
       9
       +
               <ul>

     

       10
       10
       +
                   {%- for post in term.pages -%}

     

       11
       11
       +
                       <li class="tag-list">

     

       12
       12
       +
                           {{ post.date | date(format="%Y.%m.%d") }}

     

       13
       13
       +
                           :: <a href="{{ post.permalink }}">{{ post.title }}</a>

     

       14
       14
       +
                           :: {% for tag in post.taxonomies["tags"] -%} <a href="{%- set _tag = get_taxonomy_url(kind="tags", name=tag) -%}{{ _tag }}">#{{ tag }}</a> {% endfor %}

     

       15
       15
       +
                       </li>

     

       16
       16
       +
                       {# End of pagination for-loop #}

     

       17
       17
       +
                   {%- endfor -%}

     

       18
       18
       +
                   {#- I don't put pagination here like Terminal does. I don't like how

     

       19
       19
       +
                   the buttons move with the size of post entries in the content div. -#}

     

       20
       20
       +
               </ul>

     

       21
       21
       +
       

     

       22
       22
       +
       </div>

     

       23
       23
       +
       {%- endblock main-%}

+26

themes/zerm/theme.toml

···

       1
       1
       +
       name = "zerm"

     

       2
       2
       +
       description = "A minimalistic and dark theme based on Radek Kozieł's theme for Hugo"

     

       3
       3
       +
       license = "MIT"

     

       4
       4
       +
       homepage = "https://github.com/ejmg/zerm"

     

       5
       5
       +
       # The minimum version of Zola required

     

       6
       6
       +
       min_version = "0.8.0"

     

       7
       7
       +
       # An optional live demo URL

     

       8
       8
       +
       demo = "https://zerm.ejmg.now.sh/"

     

       9
       9
       +
       

     

       10
       10
       +
       # Any variable there can be overriden in the end user `config.toml`

     

       11
       11
       +
       # You don't need to prefix variables by the theme name but as this will

     

       12
       12
       +
       # be merged with user data, some kind of prefix or nesting is preferable

     

       13
       13
       +
       # Use snake_casing to be consistent with the rest of Zola

     

       14
       14
       +
       [extra]

     

       15
       15
       +
       

     

       16
       16
       +
       # The theme author info: you!

     

       17
       17
       +
       [author]

     

       18
       18
       +
       name = "elias julian marko garcia"

     

       19
       19
       +
       homepage = "https://github.com/ejmg"

     

       20
       20
       +
       

     

       21
       21
       +
       # If this is porting a theme from another static site engine, provide

     

       22
       22
       +
       # the info of the original author here

     

       23
       23
       +
       [original]

     

       24
       24
       +
       author =  "Radek Kozieł"

     

       25
       25
       +
       homepage = "https://radoslawkoziel.pl/"

     

       26
       26
       +
       repo = "https://github.com/panr/hugo-theme-terminal"

themes/zerm/zerm-preview.png

This is a binary file and will not be displayed.

Compare changes