comparing 851dbe5f8f8cc2afa7365bce73f8bb892336c5ee 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:

.gitignore

···

       1
       1
        
       node_modules/

     

       2
       2
        
       /public

     

       3
       3
       +
       

     

       4
       4
       +
       # Local Netlify folder

     

       5
       5
       +
       .netlify

-3

.gitmodules

···

       1
       1
       -
       [submodule "themes/zerm"]

     

       2
       2
       -
       	path = themes/zerm

     

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

.mdlrc

···

       1
       1
        
       style 'styles/markdown.rb'

     

       2
       2
       +
       

     

       3
       3
       +
       # vi: ft=ruby

.vale.ini

···

       3
       3
        
       [*.md]

     

       4
       4
        
       BasedOnStyles = proselint, write-good

     

       5
       5
        
       write-good.Passive = NO

     

       6
       6
       +
       write-good.TooWordy = NO

+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"},

     

       16
       16
       -
         {name = "categories"},

     

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

     

       17
       16
        
       ]

     

       18
       17
        
       

     

       19
       18
        
       [markdown]

     
···

       26
       25
        
       

     

       27
       26
        
       [extra]

     

       28
       27
        
       author = "Hauleth"

     

       29
       29
       -
       for_hire = false

     

       28
       28
       +
       for_hire = true

     

       30
       29
        
       theme_color = "blue"

     

       31
       30
        
       

     

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

     

       32
       32
       +
       

     

       32
       33
        
       logo_text = "~hauleth"

     

       33
       34
        
       logo_home_link = "/"

     

       34
       35
        
       

     
···

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

     

       52
       53
        
       main_menu = [

     

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

     

       54
       54
       -
         {url="https://twitter.com/hauleth", name="twitter", 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/"

content/cv/_index.md

···

       1
       1
       +
       +++

     

       2
       2
       +
       title = "CV"

     

       3
       3
       +
       

     

       4
       4
       +
       [extra]

     

       5
       5
       +
       no_comments = true

     

       6
       6
       +
       sitemap = false

     

       7
       7
       +
       +++

     

       8
       8
       +
       

     

       9
       9
       +
       {{ cv() }}

-8

content/cv/index.md

···

       1
       1
       -
       +++

     

       2
       2
       -
       title = "CV"

     

       3
       3
       -
       

     

       4
       4
       -
       [extra]

     

       5
       5
       -
       no_comments = true

     

       6
       6
       -
       +++

     

       7
       7
       -
       

     

       8
       8
       -
       {{ cv() }}

+472

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

···

       1
       1
       +
       +++

     

       2
       2
       +
       date = 2023-06-10

     

       3
       3
       +
       title = "How much memory is needed to run 1M Erlang processes?"

     

       4
       4
       +
       description = "How to not write benchmarks"

     

       5
       5
       +
       

     

       6
       6
       +
       [taxonomies]

     

       7
       7
       +
       tags = [

     

       8
       8
       +
         "beam",

     

       9
       9
       +
         "performance"

     

       10
       10
       +
       ]

     

       11
       11
       +
       +++

     

       12
       12
       +
       

     

       13
       13
       +
       Recently [benchmark for concurrency implementation in different

     

       14
       14
       +
       languages][benchmark]. In this article [Piotr Kołaczkowski][] used Chat GPT to

     

       15
       15
       +
       generate the examples in the different languages and benchmarked them. This was

     

       16
       16
       +
       poor choice as I have found this article and read the Elixir example:

     

       17
       17
       +
       

     

       18
       18
       +
       [benchmark]: https://pkolaczk.github.io/memory-consumption-of-async/ "How Much Memory Do You Need to Run 1 Million Concurrent Tasks?"

     

       19
       19
       +
       [Piotr Kołaczkowski]: https://github.com/pkolaczk

     

       20
       20
       +
       

     

       21
       21
       +
       ```elixir

     

       22
       22
       +
       tasks =

     

       23
       23
       +
           for _ <- 1..num_tasks do

     

       24
       24
       +
               Task.async(fn ->

     

       25
       25
       +
                   :timer.sleep(10000)

     

       26
       26
       +
               end)

     

       27
       27
       +
           end

     

       28
       28
       +
       

     

       29
       29
       +
       Task.await_many(tasks, :infinity)

     

       30
       30
       +
       ```

     

       31
       31
       +
       

     

       32
       32
       +
       And, well, it's pretty poor example of BEAM's process memory usage, and I am

     

       33
       33
       +
       not talking about the fact that it uses 4 spaces for indentation.

     

       34
       34
       +
       

     

       35
       35
       +
       For 1 million processes this code reported 3.94 GiB of memory used by the process

     

       36
       36
       +
       in Piotr's benchmark, but with little work I managed to reduce it about 4 times

     

       37
       37
       +
       to around 0.93 GiB of RAM usage. In this article I will describe:

     

       38
       38
       +
       

     

       39
       39
       +
       - how I did that

     

       40
       40
       +
       - why the original code was consuming so much memory

     

       41
       41
       +
       - why in the real world you probably should not optimise like I did here

     

       42
       42
       +
       - why using ChatGPT to write benchmarking code sucks (TL;DR because that will

     

       43
       43
       +
         nerd snipe people like me)

     

       44
       44
       +
       

     

       45
       45
       +
       ## What are Erlang processes?

     

       46
       46
       +
       

     

       47
       47
       +
       Erlang is ~~well~~ known of being language which support for concurrency is

     

       48
       48
       +
       superb, and Erlang processes are the main reason for that. But what are these?

     

       49
       49
       +
       

     

       50
       50
       +
       In Erlang *process* is the common name for what other languages call *virtual

     

       51
       51
       +
       threads* or *green threads*, but in Erlang these have small neat twist - each of

     

       52
       52
       +
       the process is isolated from the rest and these processes can communicate only

     

       53
       53
       +
       via message passing. That gives Erlang processes 2 features that are rarely

     

       54
       54
       +
       spotted in other implementations:

     

       55
       55
       +
       

     

       56
       56
       +
       - Failure isolation - bug, unhandled case, or other issue in single process will

     

       57
       57
       +
         not directly affect any other process in the system. VM can send some messages

     

       58
       58
       +
         due to process shutdown, and other processes may be killed because of that,

     

       59
       59
       +
         but by itself shutting down single process will not cause problems in any

     

       60
       60
       +
         process not related to that.

     

       61
       61
       +
       - Location transparency - process can be spawned locally or on different

     

       62
       62
       +
         machine, but from the viewpoint of the programmer, there is no difference.

     

       63
       63
       +
       

     

       64
       64
       +
       The above features and requirements results in some design choices, but for our

     

       65
       65
       +
       purpose only one is truly needed today - each process have separate and (almost)

     

       66
       66
       +
       independent memory stack from any other process.

     

       67
       67
       +
       

     

       68
       68
       +
       ### Process dictionary

     

       69
       69
       +
       

     

       70
       70
       +
       Each process in Erlang VM has dedicated *mutable* memory space for their

     

       71
       71
       +
       internal uses. Most people do not use it for anything because in general it

     

       72
       72
       +
       should not be used unless you know exactly what you are doing (in my case, a bad

     

       73
       73
       +
       carpenter could count cases when I needed it, on single hand). In general it's

     

       74
       74
       +
       *here be dragons* area.

     

       75
       75
       +
       

     

       76
       76
       +
       How it's relevant to us?

     

       77
       77
       +
       

     

       78
       78
       +
       Well, OTP internally uses process dictionary (`pdict` for short) to store

     

       79
       79
       +
       metadata about given process that can be later used for debugging purposes. Some

     

       80
       80
       +
       data that it store are:

     

       81
       81
       +
       

     

       82
       82
       +
       - Initial function that was run by the given process

     

       83
       83
       +
       - PIDs to all ancestors of the given process

     

       84
       84
       +
       

     

       85
       85
       +
       Different processes abstractions (like `gen_server`/`GenServer`, Elixir's

     

       86
       86
       +
       `Task`, etc.) can store even more metadata there, `logger` store process

     

       87
       87
       +
       metadata in process dictionary, `rand` store state of the PRNGs in the process

     

       88
       88
       +
       dictionary. it's used quite extensively by some OTP features.

     

       89
       89
       +
       

     

       90
       90
       +
       ### "Well behaved" OTP process

     

       91
       91
       +
       

     

       92
       92
       +
       In addition to the above metadata if the process is meant to be "well behaved"

     

       93
       93
       +
       process in OTP system, i.e. process that can be observed and debugged using OTP

     

       94
       94
       +
       facilities, it must respond to some additional messages defined by [`sys`][]

     

       95
       95
       +
       module. Without that the features like [`observer`][] would not be able to "see"

     

       96
       96
       +
       the content of the process state.

     

       97
       97
       +
       

     

       98
       98
       +
       [`sys`]: https://erlang.org/doc/man/sys.html

     

       99
       99
       +
       [`observer`]: https://erlang.org/doc/man/observer.html

     

       100
       100
       +
       

     

       101
       101
       +
       ## Process memory usage

     

       102
       102
       +
       

     

       103
       103
       +
       As we have seen above, the `Task.async/1` function form Elixir **must** do

     

       104
       104
       +
       much more than just simple "start process and live with it". That was one of the

     

       105
       105
       +
       most important problems with the original process, it was using system, that was

     

       106
       106
       +
       allocating quite substantial memory alongside of the process itself, just to

     

       107
       107
       +
       operate this process. In general, that would be desirable approach (as you

     

       108
       108
       +
       **really, really, want the debugging facilities**), but in synthetic benchmarks,

     

       109
       109
       +
       it reduce the feasibility of such benchmark.

     

       110
       110
       +
       

     

       111
       111
       +
       If we want to avoid that additional memory overhead in our spawned processes we

     

       112
       112
       +
       need to go back to more primitive functions in Erlang, namely `erlang:spawn/1`

     

       113
       113
       +
       (`Kernel.spawn/1` in Elixir). But that mean that we cannot use

     

       114
       114
       +
       `Task.await_many/2` anymore, so we need to workaround it by using custom

     

       115
       115
       +
       function:

     

       116
       116
       +
       

     

       117
       117
       +
       ```elixir

     

       118
       118
       +
       defmodule Bench do

     

       119
       119
       +
         def await(pid) when is_pid(pid) do

     

       120
       120
       +
           # Monitor is internal feature of Erlang that will inform you (by sending

     

       121
       121
       +
           # message) when process you monitor die. The returned value is type called

     

       122
       122
       +
           # "reference" which is just simply unique value returned by the VM.

     

       123
       123
       +
           # If the process is already dead, then message will be delivered

     

       124
       124
       +
           # immediately.

     

       125
       125
       +
           ref = Process.monitor(pid)

     

       126
       126
       +
       

     

       127
       127
       +
           receive do

     

       128
       128
       +
             {:DOWN, ^ref, :process, _, _} -> :ok

     

       129
       129
       +
           end

     

       130
       130
       +
         end

     

       131
       131
       +
       

     

       132
       132
       +
         def await_many(pids) do

     

       133
       133
       +
           Enum.each(pids, &await/1)

     

       134
       134
       +
         end

     

       135
       135
       +
       end

     

       136
       136
       +
       

     

       137
       137
       +
       tasks =

     

       138
       138
       +
         for _ <- 1..num_tasks do

     

       139
       139
       +
           # `Kernel` module is imported by default, so no need for `Kernel.` prefix

     

       140
       140
       +
           spawn(fn ->

     

       141
       141
       +
             :timer.sleep(10000)

     

       142
       142
       +
           end)

     

       143
       143
       +
         end

     

       144
       144
       +
       

     

       145
       145
       +
       Bench.await_many(tasks)

     

       146
       146
       +
       ```

     

       147
       147
       +
       

     

       148
       148
       +
       We already removed one problem (well, two in fact, but we will go into

     

       149
       149
       +
       details in next section).

     

       150
       150
       +
       

     

       151
       151
       +
       ## All your lists are belongs to us now

     

       152
       152
       +
       

     

       153
       153
       +
       Erlang, like most of the functional programming languages, have 2 built-in

     

       154
       154
       +
       sequence types:

     

       155
       155
       +
       

     

       156
       156
       +
       - Tuples - which are non-growable product type of the values, so you can access

     

       157
       157
       +
         any field quite fast, but adding more values is performance no-no

     

       158
       158
       +
       - (Singly) linked lists - growable type (in most case it will have single type

     

       159
       159
       +
         values in it, but in Erlang that is not always the case), which is fast to

     

       160
       160
       +
         prepend or pop data from the beginning, but do not try to do anything else if

     

       161
       161
       +
         you care about performance.

     

       162
       162
       +
       

     

       163
       163
       +
       In this case we will focus on the 2nd one, as there tuples aren't important at

     

       164
       164
       +
       all.

     

       165
       165
       +
       

     

       166
       166
       +
       Singly linked list is simple data structure. It's either special value `[]`

     

       167
       167
       +
       (an empty list) or it's something called "cons-cell". Cons-cells are also

     

       168
       168
       +
       simple structures - it's 2ary tuple (tuple with 2 elements) where first value

     

       169
       169
       +
       is head - the value in the list cell, and another one is the "tail" of the list (aka

     

       170
       170
       +
       rest of the list). In Elixir the cons-cell is denoted like that `[head | tail]`.

     

       171
       171
       +
       Super simple structure as you can see, and perfect for the functional

     

       172
       172
       +
       programming as you can add new values to the list without modifying existing

     

       173
       173
       +
       values, so you can be immutable and fast. However if you need to construct the

     

       174
       174
       +
       sequence of a lot of values (like our list of all tasks) then we have problem.

     

       175
       175
       +
       Because Elixir promises that list returned from the `for` will be **in-order**

     

       176
       176
       +
       of the values passed to it. That mean that we either need to process our data

     

       177
       177
       +
       like that:

     

       178
       178
       +
       

     

       179
       179
       +
       ```elixir

     

       180
       180
       +
       def map([], _), do: []

     

       181
       181
       +
       

     

       182
       182
       +
       def map([head | tail], func) do

     

       183
       183
       +
         [func.(head) | map(tail, func)]

     

       184
       184
       +
       end

     

       185
       185
       +
       ```

     

       186
       186
       +
       

     

       187
       187
       +
       Where we build call stack (as we cannot have tail call optimisation there, of

     

       188
       188
       +
       course sans compiler optimisations). Or we need to build our list in reverse

     

       189
       189
       +
       order, and then reverse it before returning (so we can have TCO):

     

       190
       190
       +
       

     

       191
       191
       +
       ```elixir

     

       192
       192
       +
       def map(list, func), do: do_map(list, func, [])

     

       193
       193
       +
       

     

       194
       194
       +
       def map([], _func, agg), do: :lists.reverse(agg)

     

       195
       195
       +
       

     

       196
       196
       +
       def map([head | tail], func, agg) do

     

       197
       197
       +
         map(tail, func, [func.(head) | agg])

     

       198
       198
       +
       end

     

       199
       199
       +
       ```

     

       200
       200
       +
       

     

       201
       201
       +
       Which one of these approaches is more performant is irrelevant[^erlang-perf],

     

       202
       202
       +
       what is relevant is that we need either build call stack or construct our list

     

       203
       203
       +
       *twice* to be able to conform to the Elixir promises (even if in this case we do

     

       204
       204
       +
       not care about order of the list returned by the `for`).

     

       205
       205
       +
       

     

       206
       206
       +
       [^erlang-perf]: Sometimes body recursion will be faster, sometimes TCO will be

     

       207
       207
       +
       faster. it's impossible to tell without more benchmarking. For more info check

     

       208
       208
       +
       out [superb article by Ferd Herbert](https://ferd.ca/erlang-s-tail-recursion-is-not-a-silver-bullet.html).

     

       209
       209
       +
       

     

       210
       210
       +
       Of course we could mitigate our problem by using `Enum.reduce/3` function (or

     

       211
       211
       +
       writing it on our own) and end with code like:

     

       212
       212
       +
       

     

       213
       213
       +
       ```elixir

     

       214
       214
       +
       defmodule Bench do

     

       215
       215
       +
         def await(pid) when is_pid(pid) do

     

       216
       216
       +
           ref = Process.monitor(pid)

     

       217
       217
       +
       

     

       218
       218
       +
           receive do

     

       219
       219
       +
             {:DOWN, ^ref, :process, _, _} -> :ok

     

       220
       220
       +
           end

     

       221
       221
       +
         end

     

       222
       222
       +
       

     

       223
       223
       +
         def await_many(pids) do

     

       224
       224
       +
           Enum.each(pids, &await/1)

     

       225
       225
       +
         end

     

       226
       226
       +
       end

     

       227
       227
       +
       

     

       228
       228
       +
       tasks =

     

       229
       229
       +
         Enum.reduce(1..num_tasks, [], fn _, agg ->

     

       230
       230
       +
           # `Kernel` module is imported by default, so no need for `Kernel.` prefix

     

       231
       231
       +
           pid =

     

       232
       232
       +
             spawn(fn -> :timer.sleep(10000) end)

     

       233
       233
       +
       

     

       234
       234
       +
           [pid | agg]

     

       235
       235
       +
         end)

     

       236
       236
       +
       

     

       237
       237
       +
       Bench.await_many(tasks)

     

       238
       238
       +
       ```

     

       239
       239
       +
       

     

       240
       240
       +
       Even then we build list of all PIDs.

     

       241
       241
       +
       

     

       242
       242
       +
       Here I can also go back to the "second problem* I have mentioned above.

     

       243
       243
       +
       `Task.await_many/1` *also construct a list*. it's list of return value from all

     

       244
       244
       +
       the processes in the list, so not only we constructed list for the tasks' PIDs,

     

       245
       245
       +
       we also constructed list of return values (which will be `:ok` for all processes

     

       246
       246
       +
       as it's what `:timer.sleep/1` returns), and immediately discarded all of that.

     

       247
       247
       +
       

     

       248
       248
       +
       How we can better? See that **all** we care is that all `num_task` processes

     

       249
       249
       +
       have gone down. We do not care about any of the return values, all what we want

     

       250
       250
       +
       is to know that all processes that we started went down. For that we can just

     

       251
       251
       +
       send messages from the spawned processes and count the received messages count:

     

       252
       252
       +
       

     

       253
       253
       +
       ```elixir

     

       254
       254
       +
       defmodule Bench do

     

       255
       255
       +
         def worker(parent) do

     

       256
       256
       +
           :timer.sleep(10000)

     

       257
       257
       +
           send(parent, :done)

     

       258
       258
       +
         end

     

       259
       259
       +
       

     

       260
       260
       +
         def start(0), do: :ok

     

       261
       261
       +
         def start(n) when n > 0 do

     

       262
       262
       +
           this = self()

     

       263
       263
       +
           spawn(fn -> worker(this) end)

     

       264
       264
       +
       

     

       265
       265
       +
           start(n - 1)

     

       266
       266
       +
         end

     

       267
       267
       +
       

     

       268
       268
       +
         def await(0), do: :ok

     

       269
       269
       +
         def await(n) when n > 0 do

     

       270
       270
       +
           receive do

     

       271
       271
       +
             :done -> await(n - 1)

     

       272
       272
       +
           end

     

       273
       273
       +
         end

     

       274
       274
       +
       end

     

       275
       275
       +
       

     

       276
       276
       +
       Bench.start(num_tasks)

     

       277
       277
       +
       Bench.await(num_tasks)

     

       278
       278
       +
       ```

     

       279
       279
       +
       

     

       280
       280
       +
       Now we do not have any lists involved and we still do what the original task

     

       281
       281
       +
       meant to do - spawn `num_tasks` processes and wait till all go down.

     

       282
       282
       +
       

     

       283
       283
       +
       ## Arguments copying

     

       284
       284
       +
       

     

       285
       285
       +
       One another thing that we can account there - lambda context and data passing

     

       286
       286
       +
       between processes.

     

       287
       287
       +
       

     

       288
       288
       +
       You see, we need to pass `this` (which is PID of the parent) to our newly

     

       289
       289
       +
       spawned process. That is suboptimal, as we are looking for the way to reduce

     

       290
       290
       +
       amount of the memory (and ignore all other metrics at the same time). As Erlang

     

       291
       291
       +
       processes are meant to be "share nothing" type of processes there is problem -

     

       292
       292
       +
       we need to copy that PID to all processes. it's just 1 word (which mean 8 bytes

     

       293
       293
       +
       on 64-bit architectures, 4 bytes on 32-bit), but hey, we are microbenchmarking,

     

       294
       294
       +
       so we cut whatever we can (with 1M processes, this adds up to 8 MiBs).

     

       295
       295
       +
       

     

       296
       296
       +
       Hey, we can avoid that by using yet another feature of Erlang, called

     

       297
       297
       +
       *registry*. This is yet another simple feature that allows us to assign PID of

     

       298
       298
       +
       the process to the atom, which allows us then to send messages to that process

     

       299
       299
       +
       using just name, we have given. While atoms are also 1 word that wouldn't make

     

       300
       300
       +
       sense to send it as well, but instead we can do what any reasonable

     

       301
       301
       +
       microbenchmarker would do - *hardcode stuff*:

     

       302
       302
       +
       

     

       303
       303
       +
       ```elixir

     

       304
       304
       +
       defmodule Bench do

     

       305
       305
       +
         def worker do

     

       306
       306
       +
           :timer.sleep(10000)

     

       307
       307
       +
           send(:parent, :done)

     

       308
       308
       +
         end

     

       309
       309
       +
       

     

       310
       310
       +
         def start(0), do: :ok

     

       311
       311
       +
         def start(n) when n > 0 do

     

       312
       312
       +
           spawn(fn -> worker() end)

     

       313
       313
       +
       

     

       314
       314
       +
           start(n - 1)

     

       315
       315
       +
         end

     

       316
       316
       +
       

     

       317
       317
       +
         def await(0), do: :ok

     

       318
       318
       +
         def await(n) when n > 0 do

     

       319
       319
       +
           receive do

     

       320
       320
       +
             :done -> await(n - 1)

     

       321
       321
       +
           end

     

       322
       322
       +
         end

     

       323
       323
       +
       end

     

       324
       324
       +
       

     

       325
       325
       +
       Process.register(self(), :parent)

     

       326
       326
       +
       

     

       327
       327
       +
       Bench.start(num_tasks)

     

       328
       328
       +
       Bench.await(num_tasks)

     

       329
       329
       +
       ```

     

       330
       330
       +
       

     

       331
       331
       +
       Now we do not pass any arguments, and instead rely on the registry to dispatch

     

       332
       332
       +
       our messages to respective processes.

     

       333
       333
       +
       

     

       334
       334
       +
       ## One more thing

     

       335
       335
       +
       

     

       336
       336
       +
       As you may have already noticed we are passing lambda to the `spawn/1`. That is

     

       337
       337
       +
       also quite suboptimal, because of [difference between remote and local call][remote-vs-local].

     

       338
       338
       +
       This mean that we are paying slight memory cost for these processes to keep the

     

       339
       339
       +
       old module in memory. Instead we can use either fully qualified function capture

     

       340
       340
       +
       or `spawn/3` function that accepts MFA (module, function name, arguments list)

     

       341
       341
       +
       argument. We end with:

     

       342
       342
       +
       

     

       343
       343
       +
       [remote-vs-local]: https://www.erlang.org/doc/reference_manual/code_loading.html#code-replacement

     

       344
       344
       +
       

     

       345
       345
       +
       ```elixir

     

       346
       346
       +
       defmodule Bench do

     

       347
       347
       +
         def worker do

     

       348
       348
       +
           :timer.sleep(10000)

     

       349
       349
       +
           send(:parent, :done)

     

       350
       350
       +
         end

     

       351
       351
       +
       

     

       352
       352
       +
         def start(0), do: :ok

     

       353
       353
       +
         def start(n) when n > 0 do

     

       354
       354
       +
           spawn(&__MODULE__.worker/0)

     

       355
       355
       +
       

     

       356
       356
       +
           start(n - 1)

     

       357
       357
       +
         end

     

       358
       358
       +
       

     

       359
       359
       +
         def await(0), do: :ok

     

       360
       360
       +
         def await(n) when n > 0 do

     

       361
       361
       +
           receive do

     

       362
       362
       +
             :done -> await(n - 1)

     

       363
       363
       +
           end

     

       364
       364
       +
         end

     

       365
       365
       +
       end

     

       366
       366
       +
       

     

       367
       367
       +
       Process.register(self(), :parent)

     

       368
       368
       +
       

     

       369
       369
       +
       Bench.start(num_tasks)

     

       370
       370
       +
       Bench.await(num_tasks)

     

       371
       371
       +
       ```

     

       372
       372
       +
       

     

       373
       373
       +
       ## Results

     

       374
       374
       +
       

     

       375
       375
       +
       With given Erlang compilation:

     

       376
       376
       +
       

     

       377
       377
       +
       ```txt

     

       378
       378
       +
       Erlang/OTP 25 [erts-13.2.2.1] [source] [64-bit] [smp:8:8] [ds:8:8:10] [async-threads:1]

     

       379
       379
       +
       

     

       380
       380
       +
       Elixir 1.14.5 (compiled with Erlang/OTP 25)

     

       381
       381
       +
       ```

     

       382
       382
       +
       

     

       383
       383
       +
       > Note no JIT as Nix on macOS currently[^currently] disable it and I didn't bother to enable

     

       384
       384
       +
       > it in the derivation (it was disabled because there were some issues, but IIRC

     

       385
       385
       +
       > these are resolved now).

     

       386
       386
       +
       

     

       387
       387
       +
       [^currently]: Nixpkgs rev `bc3ec5ea`

     

       388
       388
       +
       

     

       389
       389
       +
       The results are as follow (in bytes of peak memory footprint returned by

     

       390
       390
       +
       `/usr/bin/time` on macOS):

     

       391
       391
       +
       

     

       392
       392
       +
       | Implementation |       1k |      100k |         1M |

     

       393
       393
       +
       | -------------- | -------: | --------: | ---------: |

     

       394
       394
       +
       | Original       | 45047808 | 452837376 | 4227715072 |

     

       395
       395
       +
       | Spawn          | 43728896 | 318230528 | 2869723136 |

     

       396
       396
       +
       | Reduce         | 43552768 | 314798080 | 2849304576 |

     

       397
       397
       +
       | Count          | 43732992 | 313507840 | 2780540928 |

     

       398
       398
       +
       | Registry       | 44453888 | 311988224 | 2787237888 |

     

       399
       399
       +
       | RemoteCall     | 43597824 | 310595584 | 2771525632 |

     

       400
       400
       +
       

     

       401
       401
       +
       As we can see we have reduced the memory use by about 30% by just changing

     

       402
       402
       +
       from `Task.async/1` to `spawn/1`. Further optimisations reduced memory usage

     

       403
       403
       +
       slightly, but with no such drastic changes.

     

       404
       404
       +
       

     

       405
       405
       +
       Can we do better?

     

       406
       406
       +
       

     

       407
       407
       +
       Well, with some VM flags tinkering - of course.

     

       408
       408
       +
       

     

       409
       409
       +
       You see, by default Erlang VM will not only create some data required for

     

       410
       410
       +
       handling process itself[^word]:

     

       411
       411
       +
       

     

       412
       412
       +
       [^word]: Again, word here mean 8 bytes on 64-bit and 4 bytes on 32-bit architectures.

     

       413
       413
       +
       

     

       414
       414
       +
       > | Data Type | Memory Size |

     

       415
       415
       +
       > | - | - |

     

       416
       416
       +
       > | … | … |

     

       417
       417
       +
       > | Erlang process | 338 words when spawned, including a heap of 233 words. |

     

       418
       418
       +
       >

     

       419
       419
       +
       > -- [Erlang Efficiency Guide: 11. Advanced](https://erlang.org/doc/efficiency_guide/advanced.html#Advanced)

     

       420
       420
       +
       

     

       421
       421
       +
       As we can see, there are 105 words that are required and 233 words which are

     

       422
       422
       +
       used for preallocated heap. But this is microbenchmarking, so as we do not need

     

       423
       423
       +
       that much of memory (because our processes basically does nothing), we can

     

       424
       424
       +
       reduce it. We do not care about time performance anyway. For that we can use

     

       425
       425
       +
       `+hms` flag and set it to some small value, for example `1`.

     

       426
       426
       +
       

     

       427
       427
       +
       In addition to heap size Erlang by default load some additional data from the

     

       428
       428
       +
       BEAM files. That data is used for debugging and error reporting, but again, we

     

       429
       429
       +
       are microbenchmarking, and who need debugging support anyway (answer: everyone,

     

       430
       430
       +
       so **do not** do it in production). Luckily for us, the VM has yet another flag

     

       431
       431
       +
       for that purpose `+L`.

     

       432
       432
       +
       

     

       433
       433
       +
       Erlang also uses some [ETS][] (Erlang Term Storage) tables by default (for

     

       434
       434
       +
       example to support process registry we have mentioned above). ETS tables can be

     

       435
       435
       +
       compressed, but by default it's not done, as it can slow down some kinds of

     

       436
       436
       +
       operations on such tables. Fortunately there is, another, flag `+ec` that has

     

       437
       437
       +
       description:

     

       438
       438
       +
       

     

       439
       439
       +
       > Forces option compressed on all ETS tables. Only intended for test and

     

       440
       440
       +
       > evaluation.

     

       441
       441
       +
       

     

       442
       442
       +
       [ETS]: https://erlang.org/doc/man/ets.html

     

       443
       443
       +
       

     

       444
       444
       +
       Sounds good enough for me.

     

       445
       445
       +
       

     

       446
       446
       +
       With all these flags enabled we get peak memory footprint at 996257792 bytes.

     

       447
       447
       +
       

     

       448
       448
       +
       Compare it in more human readable units.

     

       449
       449
       +
       

     

       450
       450
       +
       |                          | Peak Memory Footprint for 1M processes |

     

       451
       451
       +
       | ------------------------ | -------------------------------------- |

     

       452
       452
       +
       | Original code            | 3.94 GiB                               |

     

       453
       453
       +
       | Improved code            | 2.58 GiB                               |

     

       454
       454
       +
       | Improved code with flags | 0.93 GiB                               |

     

       455
       455
       +
       

     

       456
       456
       +
       Result - about 76% of the peak memory usage reduction. Not bad.

     

       457
       457
       +
       

     

       458
       458
       +
       ## Summary

     

       459
       459
       +
       

     

       460
       460
       +
       First of all:

     

       461
       461
       +
       

     

       462
       462
       +
       > Please, do not use ChatGPT for writing code for microbenchmarks.

     

       463
       463
       +
       

     

       464
       464
       +
       The thing about *micro*benchmarking is that we write code that does as little as

     

       465
       465
       +
       possible to show (mostly) meaningless features of the given technology in

     

       466
       466
       +
       abstract environment. ChatGPT cannot do that, not out of malice or incompetence,

     

       467
       467
       +
       but because it used (mostly) *good* and idiomatic code to teach itself,

     

       468
       468
       +
       microbenchmarks rarely are something that people will consider to have these

     

       469
       469
       +
       qualities. It also cannot consider other features that [wetware][] can take into

     

       470
       470
       +
       account (like our "we do not need lists there" thing).

     

       471
       471
       +
       

     

       472
       472
       +
       [wetware]: https://en.wikipedia.org/wiki/Wetware_(brain)

+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

content/post/indie-web.md

···

       1
       1
       +
       +++

     

       2
       2
       +
       title = "IndieWeb"

     

       3
       3
       +
       date = 2022-06-08T11:25:55+00:00

     

       4
       4
       +
       draft = true

     

       5
       5
       +
       

     

       6
       6
       +
       [taxonomies]

     

       7
       7
       +
       tags = []

     

       8
       8
       +
       +++

+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

+7 -9

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
        
       

     
···

       508
       506
        
       This blog post is already quite lengthy, so I will split it into separate parts.

     

       509
       507
        
       There probably will be 3 of them:

     

       510
       508
        
       

     

       511
       511
       -
       - <a href="#top">Part 1 - Basics, security, and FD passing (this one)</a>

     

       512
       512
       -
       - Part 2 - Socket activation

     

       509
       509
       +
       - [Part 1 - Basics, security, and FD passing (this one)](./#top)

     

       510
       510
       +
       - [Part 2 - Socket activation](@/post/who-watches-watchmen-ii.md)

     

       513
       511
        
       - Part 3 - Logging

+412

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

···

       1
       1
       +
       +++

     

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

     

       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

     

       7
       7
       +
       time we will talk about socket activation and how to make our application run

     

       8
       8
       +
       only when we need it to run.

     

       9
       9
       +
       """

     

       10
       10
       +
       

     

       11
       11
       +
       [taxonomies]

     

       12
       12
       +
       tags = [

     

       13
       13
       +
         "beam",

     

       14
       14
       +
         "systemd"

     

       15
       15
       +
       ]

     

       16
       16
       +
       

     

       17
       17
       +
       [[extra.thanks]]

     

       18
       18
       +
       name = "Nicodemus"

     

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

     

       20
       20
       +
       +++

     

       21
       21
       +
       

     

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

     

       23
       23
       +
       supervising BEAM applications with systemd and how to create basic, secure

     

       24
       24
       +
       service for your Elixir application with it. In this article I will assume that

     

       25
       25
       +
       you have read [the previous one][part-i].

     

       26
       26
       +
       

     

       27
       27
       +
       ______________________________________________________________________

     

       28
       28
       +
       

     

       29
       29
       +
       We already have our super simple service description. Just to refresh your

     

       30
       30
       +
       memory, it is the `hello.service` file once again:

     

       31
       31
       +
       

     

       32
       32
       +
       ```ini

     

       33
       33
       +
       [Unit]

     

       34
       34
       +
       Description=Hello World service

     

       35
       35
       +
       Requires=network.target

     

       36
       36
       +
       

     

       37
       37
       +
       [Service]

     

       38
       38
       +
       Type=notify

     

       39
       39
       +
       Environment=PORT=80

     

       40
       40
       +
       ExecStart=/opt/hello/bin/hello start

     

       41
       41
       +
       WatchdogSec=1min

     

       42
       42
       +
       

     

       43
       43
       +
       # We need to add capability to be able to bind on port 80

     

       44
       44
       +
       CapabilityBoundingSet=CAP_NET_BIND_SERVICE

     

       45
       45
       +
       

     

       46
       46
       +
       # Hardening

     

       47
       47
       +
       DynamicUser=true

     

       48
       48
       +
       PrivateDevices=true

     

       49
       49
       +
       Environment=ERL_CRASH_DUMP_SECONDS=0

     

       50
       50
       +
       ```

     

       51
       51
       +
       

     

       52
       52
       +
       However there is one small problem. It allows our service to listen on **any**

     

       53
       53
       +
       restricted port, not just `80` that we want to listen on. This can be

     

       54
       54
       +
       troublesome as an attacker that gains RCE on our server can then capture any

     

       55
       55
       +
       traffic on any port that we do not want to open (for example exposing port 22

     

       56
       56
       +
       using the [`ssh`] module).

     

       57
       57
       +
       

     

       58
       58
       +
       It would be nice if we could somehow inject sockets for only the ports we want

     

       59
       59
       +
       to listen to into our application.

     

       60
       60
       +
       

     

       61
       61
       +
       ## Socket passing

     

       62
       62
       +
       

     

       63
       63
       +
       Thanks to the [`systemd.socket`][systemd.socket] feature we can achieve that

     

       64
       64
       +
       with a little work on our side.

     

       65
       65
       +
       

     

       66
       66
       +
       First we need to create new unit named `hello.socket` next to our

     

       67
       67
       +
       `hello.service`:

     

       68
       68
       +
       

     

       69
       69
       +
       ```ini

     

       70
       70
       +
       [Unit]

     

       71
       71
       +
       Description=Listening socket

     

       72
       72
       +
       Requires=sockets.target

     

       73
       73
       +
       

     

       74
       74
       +
       [Socket]

     

       75
       75
       +
       ListenStream=80

     

       76
       76
       +
       BindIPv6Only=both

     

       77
       77
       +
       ReusePort=true

     

       78
       78
       +
       NoDelay=true

     

       79
       79
       +
       ```

     

       80
       80
       +
       

     

       81
       81
       +
       It will create a socket connected to TCP 80 (because we used `ListenStream=`,

     

       82
       82
       +
       and TCP is the stream protocol). By default it will bind that socket to a

     

       83
       83
       +
       service named the same as our socket, so now we need to edit our `hello.service`

     

       84
       84
       +
       a little bit:

     

       85
       85
       +
       

     

       86
       86
       +
       ```ini

     

       87
       87
       +
       [Unit]

     

       88
       88
       +
       Description=Hello World service

     

       89
       89
       +
       Requires=network.target

     

       90
       90
       +
       

     

       91
       91
       +
       [Service]

     

       92
       92
       +
       Type=notify

     

       93
       93
       +
       Environment=PORT=80

     

       94
       94
       +
       ExecStart=/opt/hello/bin/hello start

     

       95
       95
       +
       WatchdogSec=1min

     

       96
       96
       +
       

     

       97
       97
       +
       # See, we no longer need to insecurely allow binding to any port

     

       98
       98
       +
       # CapabilityBoundingSet=CAP_NET_BIND_SERVICE

     

       99
       99
       +
       

     

       100
       100
       +
       # Hardening

     

       101
       101
       +
       DynamicUser=true

     

       102
       102
       +
       PrivateDevices=true

     

       103
       103
       +
       Environment=ERL_CRASH_DUMP_SECONDS=0

     

       104
       104
       +
       ```

     

       105
       105
       +
       

     

       106
       106
       +
       And we need to modify our `Hello.Application.cowboy_opts/0` to handle the socket

     

       107
       107
       +
       which is passed to us a file descriptor:

     

       108
       108
       +
       

     

       109
       109
       +
       ```elixir

     

       110
       110
       +
       # hello/application.ex

     

       111
       111
       +
       defmodule Hello.Application do

     

       112
       112
       +
         use Application

     

       113
       113
       +
       

     

       114
       114
       +
         def start(_type, _opts) do

     

       115
       115
       +
           fds = :systemd.listen_fds()

     

       116
       116
       +
       

     

       117
       117
       +
           children = [

     

       118
       118
       +
             {Plug.Cowboy, [scheme: :http, plug: Hello.Router] ++ cowboy_opts(fds)},

     

       119
       119
       +
             {Plug.Cowboy.Drainer, refs: :all}

     

       120
       120
       +
           ]

     

       121
       121
       +
       

     

       122
       122
       +
           Supervisor.start_link(children, strategy: :one_for_one)

     

       123
       123
       +
         end

     

       124
       124
       +
       

     

       125
       125
       +
         # If there are no sockets passed to the application, then start listening on

     

       126
       126
       +
         # the port specified by the `PORT` environment variable

     

       127
       127
       +
         defp cowboy_opts([]) do

     

       128
       128
       +
           [port: String.to_integer(System.get_env("PORT", "5000"))]

     

       129
       129
       +
         end

     

       130
       130
       +
       

     

       131
       131
       +
         # If there are any socket passed, then use first one

     

       132
       132
       +
         defp cowboy_opts([socket | _]) do

     

       133
       133
       +
           fd =

     

       134
       134
       +
             case socket do

     

       135
       135
       +
               # Sockets can be named, which will be passed as the second element in

     

       136
       136
       +
               # a tuple

     

       137
       137
       +
               {fd, _name} -> fd

     

       138
       138
       +
               # Or unnamed, and then it will be just the file descriptor

     

       139
       139
       +
               fd -> fd

     

       140
       140
       +
             end

     

       141
       141
       +
       

     

       142
       142
       +
           [

     

       143
       143
       +
             net: :inet6, # (1)

     

       144
       144
       +
             port: 0,     # (2)

     

       145
       145
       +
             fd: fd       # (3)

     

       146
       146
       +
           ]

     

       147
       147
       +
         end

     

       148
       148
       +
       end

     

       149
       149
       +
       ```

     

       150
       150
       +
       

     

       151
       151
       +
       1. Systemd sockets are IPv6 enabled (we explicitly said that we want to listen

     

       152
       152
       +
          on both). That means, that we need to mark our connection as an INET6

     

       153
       153
       +
          connection. This will not affect IPv4 (INET) connections.

     

       154
       154
       +
       1. We are required to pass `:port` key, but its value will be ignored, so we

     

       155
       155
       +
          just pass `0`.

     

       156
       156
       +
       1. We pass the file descriptor that will be then passed to the Cowboy listener.

     

       157
       157
       +
       

     

       158
       158
       +
       Now when we will start our service:

     

       159
       159
       +
       

     

       160
       160
       +
       ```txt

     

       161
       161
       +
       # systemctl start hello.service

     

       162
       162
       +
       ```

     

       163
       163
       +
       

     

       164
       164
       +
       It will be available at `https://localhost/` while still running as an

     

       165
       165
       +
       unprivileged user.

     

       166
       166
       +
       

     

       167
       167
       +
       ### Multiple ports

     

       168
       168
       +
       

     

       169
       169
       +
       The question may arise - how to allow our service to listen on more than one

     

       170
       170
       +
       port, for example you want to have your website available as HTTPS alongside

     

       171
       171
       +
       "regular" HTTP. This means that our application needs to listen on two

     

       172
       172
       +
       restricted ports:

     

       173
       173
       +
       

     

       174
       174
       +
       - 80 - for HTTP

     

       175
       175
       +
       - 443 - for HTTPS

     

       176
       176
       +
       

     

       177
       177
       +
       Now we need to slightly modify a little our socket service and add another one.

     

       178
       178
       +
       First rename our `hello.socket` to `hello-http.socket` and add a line

     

       179
       179
       +
       `Service=hello.service` and `FileDescriptorName=http` to `[Socket]` section, so

     

       180
       180
       +
       we end with:

     

       181
       181
       +
       

     

       182
       182
       +
       ```ini

     

       183
       183
       +
       [Unit]

     

       184
       184
       +
       Description=HTTP Socket

     

       185
       185
       +
       Requires=sockets.target

     

       186
       186
       +
       

     

       187
       187
       +
       [Socket]

     

       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.

     

       191
       191
       +
       FileDescriptorName=http

     

       192
       192
       +
       ListenStream=80

     

       193
       193
       +
       Service=hello.service

     

       194
       194
       +
       BindIPv6Only=both

     

       195
       195
       +
       ReusePort=true

     

       196
       196
       +
       NoDelay=true

     

       197
       197
       +
       ```

     

       198
       198
       +
       

     

       199
       199
       +
       Next we create a similar file, but for HTTPS named `hello-https.socket`

     

       200
       200
       +
       

     

       201
       201
       +
       ```ini

     

       202
       202
       +
       [Unit]

     

       203
       203
       +
       Description=HTTPS Socket

     

       204
       204
       +
       Requires=sockets.target

     

       205
       205
       +
       

     

       206
       206
       +
       [Socket]

     

       207
       207
       +
       FileDescriptorName=https

     

       208
       208
       +
       ListenStream=443

     

       209
       209
       +
       Service=hello.service

     

       210
       210
       +
       BindIPv6Only=both

     

       211
       211
       +
       ReusePort=true

     

       212
       212
       +
       NoDelay=true

     

       213
       213
       +
       ```

     

       214
       214
       +
       

     

       215
       215
       +
       And we add the dependency on both of our sockets to the `hello.service`:

     

       216
       216
       +
       

     

       217
       217
       +
       ```ini

     

       218
       218
       +
       [Unit]

     

       219
       219
       +
       Description=Hello World service

     

       220
       220
       +
       After=hello-http.socket hello-https.socket

     

       221
       221
       +
       BindTo=hello-http.socket hello-https.socket

     

       222
       222
       +
       

     

       223
       223
       +
       [Service]

     

       224
       224
       +
       ExecStart=/opt/hello/bin/hello start

     

       225
       225
       +
       

     

       226
       226
       +
       # Hardening

     

       227
       227
       +
       DynamicUser=true

     

       228
       228
       +
       PrivateDevices=true

     

       229
       229
       +
       Environment=ERL_CRASH_DUMB_SECONDS=0

     

       230
       230
       +
       ```

     

       231
       231
       +
       

     

       232
       232
       +
       Now we need to somehow differentiate between our sockets in the

     

       233
       233
       +
       `Hello.Application`, so we will be able to pass the proper FD to each of the

     

       234
       234
       +
       listeners. The `:systemd.listen_fds/0` will return a list of file descriptors,

     

       235
       235
       +
       and if they are named, the format will be a 2-tuple where the first element is

     

       236
       236
       +
       the file descriptor and the second is the name as a string:

     

       237
       237
       +
       

     

       238
       238
       +
       ```elixir

     

       239
       239
       +
       # hello/application.ex

     

       240
       240
       +
       defmodule Hello.Application do

     

       241
       241
       +
         use Application

     

       242
       242
       +
       

     

       243
       243
       +
         def start(_type, _opts) do

     

       244
       244
       +
           fds = :systemd.listen_fds()

     

       245
       245
       +
       

     

       246
       246
       +
           router = Hello.Router

     

       247
       247
       +
       

     

       248
       248
       +
           children = [

     

       249
       249
       +
             {Plug.Cowboy, [

     

       250
       250
       +
               scheme: :http,

     

       251
       251
       +
               plug: router

     

       252
       252
       +
             ] ++ cowboy_opts(fds, "http")},

     

       253
       253
       +
             {Plug.Cowboy, [

     

       254
       254
       +
               scheme: :https,

     

       255
       255
       +
               plug: router,

     

       256
       256
       +
               keyfile: "path/to/keyfile.pem",

     

       257
       257
       +
               certfile: "path/to/certfile.pem",

     

       258
       258
       +
               dhfile: "path/to/dhfile.pem"

     

       259
       259
       +
             ] ++ cowboy_opts(fds, "https")},

     

       260
       260
       +
             {Plug.Cowboy.Drainer, refs: :all}

     

       261
       261
       +
           ]

     

       262
       262
       +
       

     

       263
       263
       +
           Supervisor.start_link(children, strategy: :one_for_one)

     

       264
       264
       +
         end

     

       265
       265
       +
       

     

       266
       266
       +
         defp cowboy_opts(fds, protocol) do

     

       267
       267
       +
           case List.keyfind(fds, protocol, 1) do

     

       268
       268
       +
             # If there is socket passed for given protocol, then use that one

     

       269
       269
       +
             {fd, ^protocol} ->

     

       270
       270
       +
               [

     

       271
       271
       +
                 net: :inet6,

     

       272
       272
       +
                 port: 0,

     

       273
       273
       +
                 fd: fd

     

       274
       274
       +
               ]

     

       275
       275
       +
       

     

       276
       276
       +
             # If there are no sockets passed to the application that match

     

       277
       277
       +
             # the protocol, then start listening on the port specified by

     

       278
       278
       +
             # `PORT_{protocol}` environment variable

     

       279
       279
       +
             _ ->

     

       280
       280
       +
               [

     

       281
       281
       +
                 port: String.to_integer(System.get_env("PORT_#{protocol}", "5000"))

     

       282
       282
       +
               ]

     

       283
       283
       +
         end

     

       284
       284
       +
       end

     

       285
       285
       +
       ```

     

       286
       286
       +
       

     

       287
       287
       +
       Now our application will listen on both - HTTP and HTTPS, despite running as

     

       288
       288
       +
       unprivileged user.

     

       289
       289
       +
       

     

       290
       290
       +
       ## Socket activation

     

       291
       291
       +
       

     

       292
       292
       +
       Now, that we can inject sockets to our application with ease we can achieve even

     

       293
       293
       +
       more fascinating feature - socket activation.

     

       294
       294
       +
       

     

       295
       295
       +
       Some of you may used `inetd` in the past, that allows you to dynamically start

     

       296
       296
       +
       processes on network requests. It is quite an interesting tool that detects

     

       297
       297
       +
       traffic on certain ports, then spawns a new process to handle it, passing data

     

       298
       298
       +
       to and from that process via `STDIN` and `STDOUT`. There was a quirk though, it

     

       299
       299
       +
       required the spawned process to shutdown after it handled the request and it was

     

       300
       300
       +
       starting a new instance for each request. That works poorly with VMs like BEAM

     

       301
       301
       +
       that have substantial startup time and are expected to be long-running systems.

     

       302
       302
       +
       BEAM is capable of handling network requests on it's own.

     

       303
       303
       +
       

     

       304
       304
       +
       Fortunately for us, the way that we have implemented our systemd service is all

     

       305
       305
       +
       that we need to have our application dynamically activated. To observe that we

     

       306
       306
       +
       just need to shutdown everything:

     

       307
       307
       +
       

     

       308
       308
       +
       ```txt

     

       309
       309
       +
       # systemctl stop hello-http.socket hello-https.socket hello.service

     

       310
       310
       +
       ```

     

       311
       311
       +
       

     

       312
       312
       +
       And now relaunch **only the sockets**:

     

       313
       313
       +
       

     

       314
       314
       +
       ```txt

     

       315
       315
       +
       # systemctl start hello-http.socket hello-https.socket

     

       316
       316
       +
       ```

     

       317
       317
       +
       

     

       318
       318
       +
       We can check, that our service is not running:

     

       319
       319
       +
       

     

       320
       320
       +
       ```txt

     

       321
       321
       +
       $ systemctl status hello.service

     

       322
       322
       +
       ● hello.service - Hello World service

     

       323
       323
       +
            Loaded: loaded (/usr/local/lib/systemd/system/hello.service; static; vendor preset: enabled)

     

       324
       324
       +
            Active: inactive (dead)

     

       325
       325
       +
       TriggeredBy: ● hello-http.socket ● hello-https.socket

     

       326
       326
       +
       ```

     

       327
       327
       +
       

     

       328
       328
       +
       We can see the `TriggeredBy` section that tells us, that this service will be

     

       329
       329
       +
       started by one of the sockets listed there. Let see what will happen when we

     

       330
       330
       +
       will try to request anything from our application:

     

       331
       331
       +
       

     

       332
       332
       +
       ```txt

     

       333
       333
       +
       $ curl http://localhost/

     

       334
       334
       +
       Hello World!

     

       335
       335
       +
       ```

     

       336
       336
       +
       

     

       337
       337
       +
       You can see that we got a response from our application. This mean that our

     

       338
       338
       +
       application must have started, and indeed when we check:

     

       339
       339
       +
       

     

       340
       340
       +
       ```txt

     

       341
       341
       +
       $ systemctl status hello.service

     

       342
       342
       +
       ● hello.service - Hello

     

       343
       343
       +
            Loaded: loaded (/usr/local/lib/systemd/system/hello.service; static; vendor preset: enabled)

     

       344
       344
       +
            Active: active (running) since Thu 2022-02-03 13:20:27 CET; 4s ago

     

       345
       345
       +
       TriggeredBy: ● hello-http.socket ● hello-https.socket

     

       346
       346
       +
          Main PID: 1106 (beam.smp)

     

       347
       347
       +
             Tasks: 19 (limit: 1136)

     

       348
       348
       +
            Memory: 116.7M

     

       349
       349
       +
            CGroup: /system.slice/hello.service

     

       350
       350
       +
                    ├─1106 /opt/hello/erts-12.2/bin/beam.smp -- -root /opt/hello -progname erl -- -home /run/hello -- -noshell -s elixir start_cli -mode embedded -setcookie CR63SVI6L5JAMJSDL3H4XPNMOPHEWSV2FPHCHCAN65CY6ASHMXBA==== -sname hello -c>

     

       351
       351
       +
                    └─1138 erl_child_setup 1024

     

       352
       352
       +
       ```

     

       353
       353
       +
       

     

       354
       354
       +
       It seems to be running, and if we stop it, then we will get information that it

     

       355
       355
       +
       still can be activated by our sockets:

     

       356
       356
       +
       

     

       357
       357
       +
       ```txt

     

       358
       358
       +
       # systemctl stop hello.service

     

       359
       359
       +
       Warning: Stopping hello.service, but it can still be activated by:

     

       360
       360
       +
         hello-http.socket hello-https.socket

     

       361
       361
       +
       ```

     

       362
       362
       +
       

     

       363
       363
       +
       That means, that systemd is still listening on the sockets that we defined, even

     

       364
       364
       +
       when our application is down, and will start our application again as soon as

     

       365
       365
       +
       there are any incoming requests.

     

       366
       366
       +
       

     

       367
       367
       +
       Let test that out again:

     

       368
       368
       +
       

     

       369
       369
       +
       ```txt

     

       370
       370
       +
       $ curl http://localhost/

     

       371
       371
       +
       Hello World!

     

       372
       372
       +
       $ systemctl status hello.service

     

       373
       373
       +
       ● hello.service - Hello

     

       374
       374
       +
            Loaded: loaded (/usr/local/lib/systemd/system/hello.service; static; vendor preset: enabled)

     

       375
       375
       +
            Active: active (running) since Thu 2022-02-03 13:22:27 CET; 4s ago

     

       376
       376
       +
       TriggeredBy: ● hello-http.socket ● hello-https.socket

     

       377
       377
       +
          Main PID: 3452 (beam.smp)

     

       378
       378
       +
             Tasks: 19 (limit: 1136)

     

       379
       379
       +
            Memory: 116.7M

     

       380
       380
       +
            CGroup: /system.slice/hello.service

     

       381
       381
       +
                    ├─3452 /opt/hello/erts-12.2/bin/beam.smp -- -root /opt/hello -progname erl -- -home /run/hello -- -noshell -s elixir start_cli -mode embedded -setcookie CR63SVI6L5JAMJSDL3H4XPNMOPHEWSV2FPHCHCAN65CY6ASHMXBA==== -sname hello -c>

     

       382
       382
       +
                    └─3453 erl_child_setup 1024

     

       383
       383
       +
       ```

     

       384
       384
       +
       

     

       385
       385
       +
       Our application got launched again, automatically, just by the fact that

     

       386
       386
       +
       there was incoming TCP connection.

     

       387
       387
       +
       

     

       388
       388
       +
       Does it work for HTTPS connection as well?

     

       389
       389
       +
       

     

       390
       390
       +
       ```txt

     

       391
       391
       +
       # systemctl stop hello.service

     

       392
       392
       +
       $ curl -k https://localhost/

     

       393
       393
       +
       Hello World!

     

       394
       394
       +
       ```

     

       395
       395
       +
       

     

       396
       396
       +
       It seems so. Independently of which port we try to reach our application on, it

     

       397
       397
       +
       will be automatically launched for us and the connection will be properly

     

       398
       398
       +
       handled. Do note that systemd will not shut down our process after serving the

     

       399
       399
       +
       request. It will continue to run from that point forward.

     

       400
       400
       +
       

     

       401
       401
       +
       ## Summary

     

       402
       402
       +
       

     

       403
       403
       +
       I know that it took quite while since the last post (ca. 1.5 years), but I hope

     

       404
       404
       +
       that I will be able to write the final part much sooner than this.

     

       405
       405
       +
       

     

       406
       406
       +
       - [Part 1 - Basics, security, and FD passing][part-i]

     

       407
       407
       +
       - [Part 2 - Socket activation (this one)](./#top)

     

       408
       408
       +
       - Part 3 - Logging

     

       409
       409
       +
       

     

       410
       410
       +
       [part-i]: @/post/who-watches-watchmen-i.md

     

       411
       411
       +
       [systemd.socket]: https://www.freedesktop.org/software/systemd/man/systemd.socket.html

     

       412
       412
       +
       [`ssh`]: https://erlang.org/doc/man/ssh.html

+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

+25 -9

flake.lock

···

       1
       1
        
       {

     

       2
       2
        
         "nodes": {

     

       3
       3
        
           "flake-utils": {

     

       4
       4
       +
             "inputs": {

     

       5
       5
       +
               "systems": "systems"

     

       6
       6
       +
             },

     

       4
       7
        
             "locked": {

     

       5
       5
       -
               "lastModified": 1656928814,

     

       6
       6
       -
               "narHash": "sha256-RIFfgBuKz6Hp89yRr7+NR5tzIAbn52h8vT6vXkYjZoM=",

     

       8
       8
       +
               "lastModified": 1731533236,

     

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

     

       7
       10
        
               "owner": "numtide",

     

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

     

       9
       9
       -
               "rev": "7e2a3b3dfd9af950a856d66b0a7d01e3c18aa249",

     

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

     

       10
       13
        
               "type": "github"

     

       11
       14
        
             },

     

       12
       15
        
             "original": {

     
···

       17
       20
        
           },

     

       18
       21
        
           "nixpkgs": {

     

       19
       22
        
             "locked": {

     

       20
       20
       -
               "lastModified": 1658430343,

     

       21
       21
       -
               "narHash": "sha256-cZ7dw+dyHELMnnMQvCE9HTJ4liqwpsIt2VFbnC+GNNk=",

     

       22
       22
       -
               "owner": "NixOS",

     

       23
       23
       -
               "repo": "nixpkgs",

     

       24
       24
       -
               "rev": "e2b34f0f11ed8ad83d9ec9c14260192c3bcccb0d",

     

       25
       25
       -
               "type": "github"

     

       23
       23
       +
               "lastModified": 0,

     

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

     

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

     

       26
       26
       +
               "type": "path"

     

       26
       27
        
             },

     

       27
       28
        
             "original": {

     

       28
       29
        
               "id": "nixpkgs",

     
···

       33
       34
        
             "inputs": {

     

       34
       35
        
               "flake-utils": "flake-utils",

     

       35
       36
        
               "nixpkgs": "nixpkgs"

     

       37
       37
       +
             }

     

       38
       38
       +
           },

     

       39
       39
       +
           "systems": {

     

       40
       40
       +
             "locked": {

     

       41
       41
       +
               "lastModified": 1681028828,

     

       42
       42
       +
               "narHash": "sha256-Vy1rq5AaRuLzOxct8nz4T6wlgyUR7zLU309k9mBC768=",

     

       43
       43
       +
               "owner": "nix-systems",

     

       44
       44
       +
               "repo": "default",

     

       45
       45
       +
               "rev": "da67096a3b9bf56a91d16901293e51ba5b49a27e",

     

       46
       46
       +
               "type": "github"

     

       47
       47
       +
             },

     

       48
       48
       +
             "original": {

     

       49
       49
       +
               "owner": "nix-systems",

     

       50
       50
       +
               "repo": "default",

     

       51
       51
       +
               "type": "github"

     

       36
       52
        
             }

     

       37
       53
        
           }

     

       38
       54
        
         },

+20 -16

flake.nix

···

       6
       6
        
         outputs = { self, nixpkgs, flake-utils }:

     

       7
       7
        
           flake-utils.lib.eachDefaultSystem (system:

     

       8
       8
        
             let

     

       9
       9
       -
               pkgs = nixpkgs.legacyPackages.${system};

     

       10
       10
       -
               blog = pkgs.stdenv.mkDerivation {

     

       9
       9
       +
               pkgs = import nixpkgs { inherit system; };

     

       10
       10
       +
               blog = pkgs.stdenvNoCC.mkDerivation {

     

       11
       11
        
                 name = "hauleth-blog";

     

       12
       12
        
                 src = ./.;

     

       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

     

       22
       22
       -
                   '';

     

       19
       19
       +
                   zola --version

     

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

     

       21
       21
       +
                 '';

     

       23
       22
        
       

     

       24
       23
        
                 dontInstall = true;

     

       25
       25
       -
       

     

       26
       26
       -
                 passthru = {

     

       27
       27
       -
                   inherit (pkgs) zola;

     

       28
       28
       -
                 };

     

       29
       24
        
               };

     

       30
       30
       -
             in rec {

     

       31
       31
       -
               packages = flake-utils.lib.flattenTree {

     

       25
       25
       +
             in

     

       26
       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
       +
               };

     

       35
       35
       +
               packages = {

     

       32
       36
        
                 inherit blog;

     

       33
       37
        
               };

     

       34
       38
        
               defaultPackage = blog;

     

       35
       35
       -
               /* apps.hello = flake-utils.lib.mkApp { drv = packages.hello; }; */

     

       36
       36
       -
               /* defaultApp = apps.hello; */

     

       37
       39
        
       

     

       38
       40
        
               devShells.default = pkgs.mkShell {

     

       39
       39
       -
                 nativeBuildInputs = [

     

       40
       40
       -
                   blog.zola

     

       41
       41
       +
                 inputsFrom = [ blog ];

     

       42
       42
       +
       

     

       43
       43
       +
                 packages = [

     

       44
       44
       +
                   # pkgs.netlify-cli

     

       41
       45
        
                   pkgs.vale

     

       42
       46
        
                   pkgs.mdl

     

       43
       47
        
                 ];

+26 -5

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
       6
       -
         command = "zola build --drafts"

     

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

     

       7
       10
        
       

     

       8
       11
        
       [[headers]]

     

       9
       12
        
         for = "/*"

     
···

       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
        
       

     

       25
       25
       +
       [[headers]]

     

       26
       26
       +
         for = "/.well-known/webfinger"

     

       27
       27
       +
         [headers.values]

     

       28
       28
       +
           Content-Type = "application/jrd+json; charset=utf-8"

     

       29
       29
       +
       

     

       21
       30
        
       [[redirects]]

     

       22
       31
        
         from = "/post"

     

       23
       32
        
         to = "/"

     

       24
       33
        
         force = true

     

       25
       34
        
       

     

       35
       35
       +
       [[redirects]]

     

       36
       36
       +
         from = "/.well-known/webfinger"

     

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

     

       38
       38
       +
         status = 200

     

       39
       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
       +
       

     

       26
       50
        
       [[plugins]]

     

       27
       51
        
         package = "netlify-plugin-webmentions"

     

       28
       52
        
       

     

       29
       53
        
         [plugins.inputs]

     

       30
       54
        
         feedPath = "atom.xml"

     

       31
       31
       -
       

     

       32
       32
       -
       [[plugins]]

     

       33
       33
       -
         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;

+32 -37

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);

     

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

     

       21
       31
        
         text-rendering: optimizeLegibility;

     

       22
       32
        
         -webkit-font-smoothing: antialiased;

     

       23
       33
        
         -webkit-overflow-scrolling: touch;

     

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

     

       25
       25
       -
       

     

       26
       26
       -
         @media print {

     

       27
       27
       -
           color: #000;

     

       28
       28
       -
           line-height: 1.2;

     

       29
       29
       -
           font-size: 10pt;

     

       30
       30
       -
         }

     

       31
       35
        
       }

     

       32
       36
        
       

     

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

     
···

       78
       82
        
       

     

       79
       83
        
       a {

     

       80
       84
        
         color: inherit;

     

       85
       85
       +
       

     

       86
       86
       +
         &:hover {

     

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

     

       88
       88
       +
           text-shadow: 0 0 .25em currentcolor;

     

       89
       89
       +
         };

     

       81
       90
        
       }

     

       82
       91
        
       

     

       83
       92
        
       img {

     
···

       96
       105
        
         padding: 1px 6px;

     

       97
       106
        
         margin: 0 2px;

     

       98
       107
        
         font-size: .95rem;

     

       108
       108
       +
         hyphens: none;

     

       99
       109
        
       }

     

       100
       110
        
       

     

       101
       111
        
       pre {

     
···

       149
       159
        
           padding-right: 0;

     

       150
       160
        
         }

     

       151
       161
        
       

     

       152
       152
       -
         &:before {

     

       153
       153
       -
           content: '”';

     

       154
       154
       -
           font-family: Georgia, serif;

     

       155
       155
       -
           font-size: 3.875rem;

     

       156
       156
       -
           position: absolute;

     

       157
       157
       -
           left: -40px;

     

       158
       158
       -
           top: -20px;

     

       159
       159
       -
         }

     

       162
       162
       +
         > :first-child {

     

       163
       163
       +
           margin-top: 0;

     

       164
       164
       +
           position: relative;

     

       160
       165
        
       

     

       161
       161
       -
         p:first-of-type {

     

       162
       162
       -
           margin-top: 0;

     

       166
       166
       +
           &:before {

     

       167
       167
       +
             content: '>';

     

       168
       168
       +
             display: block;

     

       169
       169
       +
             position: absolute;

     

       170
       170
       +
             left: -25px;

     

       171
       171
       +
             top: .1em;

     

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

     

       173
       173
       +
           }

     

       163
       174
        
         }

     

       164
       175
        
       

     

       165
       165
       -
         p:last-of-type {

     

       176
       176
       +
         > :last-child {

     

       166
       177
        
           margin-bottom: 0;

     

       167
       167
       -
         }

     

       168
       168
       -
       

     

       169
       169
       -
         p {

     

       170
       170
       -
           position: relative;

     

       171
       171
       -
         }

     

       172
       172
       -
       

     

       173
       173
       -
         p:before {

     

       174
       174
       -
           content: '>';

     

       175
       175
       -
           display: block;

     

       176
       176
       -
           position: absolute;

     

       177
       177
       -
           left: -25px;

     

       178
       178
       -
           color: var(--accent);

     

       179
       178
        
         }

     

       180
       179
        
       }

     

       181
       180
        
       

     
···

       259
       258
        
       

     

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

     

       261
       260
        
           &::before {

     

       261
       261
       +
             margin-left: -2rem;

     

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

     

       263
       263
        
           }

     

       264
       264
        
         }

     

       265
       265
        
       }

     

       266
       266
       -
       

     

       267
       267
       -
       .halmos {

     

       268
       268
       -
         text-align: right;

     

       269
       269
       -
         font-size: 1.5em;

     

       270
       270
       -
       }

+35 -1

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;

     
···

       162
       166
        
       .webmentions .url-only {

     

       163
       167
        
         line-break: anywhere;

     

       164
       168
        
       }

     

       169
       169
       +
       

     

       170
       170
       +
       .halmos {

     

       171
       171
       +
         text-align: right;

     

       172
       172
       +
         font-size: 1.5em;

     

       173
       173
       +
       }

     

       174
       174
       +
       

     

       175
       175
       +
       .footnote-definition {

     

       176
       176
       +
         @media (min-width: #{$tablet-max-width + 1px}) {

     

       177
       177
       +
           position: absolute;

     

       178
       178
       +
           left: 105%;

     

       179
       179
       +
       

     

       180
       180
       +
           width: 10vw;

     

       181
       181
       +
       

     

       182
       182
       +
           margin-top: -7rem;

     

       183
       183
       +
         }

     

       184
       184
       +
       

     

       185
       185
       +
         margin-top: 1rem;

     

       186
       186
       +
       

     

       187
       187
       +
         font-size: .8em;

     

       188
       188
       +
       

     

       189
       189
       +
         p {

     

       190
       190
       +
           padding-left: .5rem;

     

       191
       191
       +
           display: inline;

     

       192
       192
       +
         }

     

       193
       193
       +
       

     

       194
       194
       +
         // For some reason `:last-of-type` doesn't work

     

       195
       195
       +
         &:has(+ .halmos) {

     

       196
       196
       +
           margin-bottom: -.5rem;

     

       197
       197
       +
         }

     

       198
       198
       +
       }

+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 -1

sass/_variables.scss

···

       1
       1
        
       $phone-max-width: 683px;

     

       2
       2
       -
       $tablet-max-width: 899px;

     

       2
       2
       +
       $tablet-max-width: 1199px;

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});

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

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

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

styles/markdown.rb

···

       1
       1
        
       all

     

       2
       2
        
       exclude_rule 'MD002'

     

       3
       3
        
       exclude_rule 'MD041'

     

       4
       4
       +
       

     

       5
       5
       +
       rule 'MD013', ignore_code_blocks: true

+46 -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 %}

     
···

       46
       56
        
         {%- else -%}

     

       47
       57
        
           <link rel="stylesheet" type="text/css" href="/color/orange.css" />

     

       48
       58
        
         {% endif %}

     

       59
       59
       +
         <meta name="theme-color" content="#1d1e28" />

     

       49
       60
        
       {% endblock css %}

     

       50
       61
        
       

     

       51
       62
        
       {% block header %}

     
···

       66
       77
        
             </ul>

     

       67
       78
        
           </nav>

     

       68
       79
        
         </header>

     

       69
       69
       -
       {% 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 %}

+10 -4

templates/macros/posts.html

···

       19
       19
        
                     [Updated: <time class="dt-updated" datetime="{{ page.updated }}">{{ page.updated | date(format="%Y.%m.%d") }}</time>]

     

       20
       20
        
                   {%- endif -%}

     

       21
       21
        
               </span>

     

       22
       22
       +
               ::

     

       23
       23
       +
               <time datetime="P{{ page.reading_time }}M">{{ page.reading_time }} min</time>

     

       22
       24
        
       

     

       23
       25
        
               {{ posts::taxonomies(taxonomy=page.taxonomies,

     

       24
       26
        
                  disp_cat=config.extra.show_categories,

     
···

       54
       56
        
       {% endmacro tags %}

     

       55
       57
        
       

     

       56
       58
        
       {% macro thanks(who) %}

     

       57
       57
       -
         {%- if who.why -%}

     

       58
       58
       -
           {{ who.name }} - {{ who.why }}

     

       59
       59
       +
         {%- if who is object -%}

     

       60
       60
       +
           {%- if who.url -%}

     

       61
       61
       +
             <a class="u-url p-name" href="{{ who.url }}">{{ who.name }}</a>

     

       62
       62
       +
           {%- else -%}

     

       63
       63
       +
             <span class="p-name">{{ who.name }}</span>

     

       64
       64
       +
           {%- endif -%}

     

       65
       65
       +
           {%- if who.why %} for {{ who.why }}{%- endif -%}

     

       59
       66
        
         {%- else -%}

     

       60
       60
       -
           {{ who.name }}

     

       67
       67
       +
           <span class="p-name">{{ who }}</span>

     

       61
       68
        
         {%- endif -%}

     

       62
       69
        
       {% endmacro %}

     

       63
       63
       -

+2 -12

templates/page.html

···

       34
       34
        
           {%- if page.extra.thanks -%}

     

       35
       35
        
           <hr />

     

       36
       36
        
           <p>

     

       37
       37
       -
             <b>Special thanks</b>:

     

       37
       37
       +
             <b>Special thanks to</b>:

     

       38
       38
        
             <ul>

     

       39
       39
        
               {%- for person in page.extra.thanks -%}

     

       40
       40
       -
               <li class="h-card">

     

       41
       41
       -
                 {%- if person is object -%}

     

       42
       42
       -
                   {%- if person.url -%}

     

       43
       43
       -
                     <a class="u-url p-name" href="{{ person.url }}">{{ posts::thanks(who=person) }}</a>

     

       44
       44
       -
                   {%- else -%}

     

       45
       45
       -
                     <span class="p-name">{{ posts::thanks(who=person) }}</span>

     

       46
       46
       -
                   {%- endif -%}

     

       47
       47
       -
                 {%- else -%}

     

       48
       48
       -
                   <span class="p-name">{{ person }}</span>

     

       49
       49
       -
                 {%- endif -%}

     

       50
       50
       -
               </li>

     

       40
       40
       +
               <li class="h-card">{{ posts::thanks(who=person) }}</li>

     

       51
       41
        
               {%- endfor -%}

     

       52
       42
        
             </ul>

     

       53
       43
        
           </p>

templates/robots.txt

···

       1
       1
       +
       User-agent: *

     

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

     

       3
       3
       +
       Allow: /

     

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

+89 -48

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

     

       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

     

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

     

       72
       72
       +
           + JaFolders/AlleFolders

     

       73
       73
       +
               * 2x performance improvement by optimising PostgreSQL usage

     

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

     

       75
       75
       +
                 materialised views usage

     

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

     

       77
       77
       +
           + OneMedical/Helium Health

     

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

     

       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

     

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

     

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

     

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

     

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

     

       26
       26
       -
       - Hauleth.dev - Consultant - 2021+

     

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

     

       28
       28
       -
       - Eiger - Senior Backend Engineer - 2022+

     

       83
       83
       +
       - Prograils - Junior Developer - 2013

     

       29
       84
        
       

     

       30
       85
        
       ### Organisations

     

       31
       86
        
       

     
···

       40
       95
        
               * Organizer - 2015

     

       41
       96
        
           + UEFA Championship 2012 - Poland-Ukraine

     

       42
       97
        
               * ICT Accreditation support

     

       98
       98
       +
       - Times Person of the Year - 2006

     

       43
       99
        
       

     

       44
       100
        
       ### Languages

     

       45
       101
        
       

     
···

       50
       106
        
       

     

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

     

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

     

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

     

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

     

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

     

       54
       111
        
       

     

       55
       112
        
       ### Notable contributions

     

       56
       113
        
       

     

       57
       114
        
       - Elixir language:

     

       58
       58
       -
         + Logger reimplementation on top of Erlang's `logger` module

     

       59
       59
       -
         + `mix test --cover` CLI output

     

       60
       60
       -
         + Support for `NO_COLOR` environment variable

     

       61
       61
       -
         + `is_struct/1`

     

       62
       62
       -
         + Fixing module inspection on case-insensitive file systems

     

       115
       115
       +
           + Logger reimplementation on top of Erlang's `logger` module

     

       116
       116
       +
           + `mix test --cover` CLI output

     

       117
       117
       +
           + Support for `NO_COLOR` environment variable

     

       118
       118
       +
           + `is_struct/1`

     

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

     

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

     

       121
       121
       +
             release

     

       63
       122
        
       - Erlang OTP:

     

       64
       64
       -
         + Support for custom devices in `logger_std_h`

     

       65
       65
       -
         + Fixing `socket` module to support broader set of protocols (for example

     

       66
       66
       -
           ICMP)

     

       67
       67
       -
         + Support for global metadata in `logger`

     

       68
       68
       -
         + Support for reconfiguration of `logger` (needed for better Mix and Rebar3

     

       69
       69
       -
           integration)

     

       70
       70
       -
         + Several fixes to `logger` and `socket` modules

     

       123
       123
       +
           + Support for custom devices in `logger_std_h`

     

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

     

       125
       125
       +
             ICMP)

     

       126
       126
       +
           + Support for global metadata in `logger`

     

       127
       127
       +
           + Support for reconfiguration of `logger` (needed for better Mix and Rebar3

     

       128
       128
       +
             integration)

     

       129
       129
       +
           + Several fixes to `logger` and `socket` modules

     

       130
       130
       +
           + Add support for τ constant in `math`

     

       71
       131
        
       - Git:

     

       72
       72
       -
         + Add support for Elixir in diff

     

       132
       132
       +
           + Add support for Elixir in diff

     

       73
       133
        
       - Ecto:

     

       74
       74
       -
         + Support aggregations over `*`

     

       75
       75
       -
         + Better error on duplicated `schema` block

     

       134
       134
       +
           + Support aggregations over `*`

     

       135
       135
       +
           + Better error on duplicated `schema` block

     

       76
       136
        
       - Elixir MongoDB driver

     

       77
       77
       -
         + Support for transactions

     

       137
       137
       +
           + Support for transactions

     

       78
       138
        
       

     

       79
       139
        
       ### Notable projects

     

       80
       140
        
       

     
···

       82
       142
        
         projects

     

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

     

       84
       144
        
         code

     

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

     

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

     

       87
       146
        
         the Erlang's OpenTelemetry implementation

     

       88
       147
        
       - Vim plugins:

     
···

       92
       151
        
       

     

       93
       152
        
       ### Languages and Frameworks

     

       94
       153
        
       

     

       95
       95
       -
       Expert:

     

       96
       96
       -
       

     

       97
       154
        
       - Elixir

     

       98
       155
        
           + Phoenix

     

       99
       156
        
           + Ecto

     
···

       101
       158
        
           + OpenTelemetry collaborator

     

       102
       159
        
           + EEF Member

     

       103
       160
        
           + OTP contributor

     

       104
       104
       -
       

     

       105
       105
       -
       Advanced:

     

       106
       106
       -
       

     

       161
       161
       +
       - Nix/NixOS

     

       107
       162
        
       - Rust

     

       108
       108
       -
       - C

     

       109
       109
       -
       - SQL (pg/SQL)

     

       163
       163
       +
       - PostgreSQL

     

       110
       164
        
       - sh/Bash

     

       111
       165
        
       - Ruby

     

       112
       166
        
           + Ruby on Rails

     

       113
       167
        
       

     

       114
       114
       -
       Fluent:

     

       115
       115
       -
       

     

       116
       116
       -
       - C++

     

       117
       117
       -
       - JavaScript

     

       118
       118
       -
       

     

       119
       168
        
       ### Technologies

     

       120
       169
        
       

     

       121
       121
       -
       Expert:

     

       122
       122
       -
       

     

       123
       170
        
       - Git

     

       124
       171
        
       - Vim

     

       125
       125
       -
       

     

       126
       126
       -
       Advanced:

     

       127
       127
       -
       

     

       128
       172
        
       - HashiStack

     

       129
       173
        
           + Terraform

     

       130
       174
        
           + Consul

     
···

       133
       177
        
       - TDD/BDD methodologies

     

       134
       178
        
       - Property testing

     

       135
       179
        
       

     

       136
       136
       -
       Fluent:

     

       137
       137
       -
       

     

       138
       138
       -
       - SaltStack

     

       139
       139
       -
       - Puppet

     

       140
       140
       -
       

     

       141
       180
        
       ## Other

     

       142
       181
        
       

     

       143
       182
        
       - Viking reenactor

     

       144
       183
        
       - Keyboard fan

     

       145
       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

+3 -3

templates/shortcodes/readme.md

···

       10
       10
        
       Observability WG</a></span> where we are trying to improve observability

     

       11
       11
        
       features in Erlang ecosystem.

     

       12
       12
        
       

     

       13
       13
       -
       <!-- I am open for hire. If you want to inquiry me about my services then -->

     

       14
       14
       -
       <!-- contact me at <a class="u-email" -->

     

       15
       15
       -
       <!-- href="mailto:lukasz@niemier.pl">lukasz@niemier.pl</a>. -->

     

       13
       13
       +
       I am open for hire. If you want to inquiry me about my services then

     

       14
       14
       +
       contact me at <a class="u-email"

     

       15
       15
       +
       href="mailto:lukasz@niemier.pl">lukasz@niemier.pl</a>.

     

       16
       16
        
       

     

       17
       17
        
       </div>

+13

templates/sitemap.xml

···

       1
       1
       +
       <?xml version="1.0" encoding="UTF-8"?>

     

       2
       2
       +
       <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">

     

       3
       3
       +
           {%- for sitemap_entry in entries %}

     

       4
       4
       +
           {%- if sitemap_entry.extra | get(key="sitemap", default=true) %}

     

       5
       5
       +
           <url>

     

       6
       6
       +
               <loc>{{ sitemap_entry.permalink | escape_xml | safe }}</loc>

     

       7
       7
       +
               {%- if sitemap_entry.updated %}

     

       8
       8
       +
               <lastmod>{{ sitemap_entry.updated }}</lastmod>

     

       9
       9
       +
               {%- endif %}

     

       10
       10
       +
           </url>

     

       11
       11
       +
           {%- endif %}

     

       12
       12
       +
           {%- endfor %}

     

       13
       13
       +
       </urlset>

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

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?

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

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

themes/zerm/sass/_semantic.scss

···

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

     

       2
       2
       +
           display: block;

     

       3
       3
       +
       }

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;

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

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

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

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.

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)})}]);

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 -%}

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 %}

themes/zerm/templates/macros/extended_footer.html

···

       1
       1
       +
       {% macro extended_footer() %}

     

       2
       2
       +
       {% endmacro extended_footer %}

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 %}

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 %}

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

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