sonj (考え, idea or thought)

sonj is a lightweight microblog theme for zola.

sonj is a soft fork of kangae in which I've added multiple changes that were useful for me.

sonj is licensed under the NCSA license, which is quite similar to the BSD-3-Clause license. Unlike BSD-3-Clause, NCSA also covers documentation of a project.

Install

using git subtree

$ git subtree add -P themes/sonj/ --squash https://co.delire.party/bnjbvr/sonj.git main

using git submodule

$ git submodule add https://co.delire.party/bnjbvr/sonj.git themes/sonj

download sonj in themes directory

If you want to keep things simple and figure out version control later, you can

$ git clone https://co.delire.party/bnjbvr/sonj.git themes/sonj

Configuration

To begin using sonj after installing it,

$ cp themes/sonj/config.toml ./
$ sed -i 's;# theme =\(.*\);theme =\1;' config.toml

The config.toml file of sonj shows the configuration options that are specific to this theme, most inherited from kangae. If you have any questions about configuring sonj which haven't been answered in the config.toml file itself, please raise an issue.

Quotes

You can add quotes in your microblog posts using

{% quote(author="Nara Shikamaru") %}
You would think just this once, when it was life or death, I could pull through.
{% end %}

This is the most basic form of improvement in writing quotes over simply using > in markdown.

If you want to mention the name of the source from where the quote has been taken, such as the name of the book or a movie, you can use

{% quote(citation="Mass Effect 3", author="Javik") %}
Stand in the ashes of a trillion dead souls, and ask the ghosts if honor matters. The silence is your answer.
{% end %}

A citeurl can also be given as an argument to this shortcode to provide the actual URL from where the source is borrowed.

{% quote(author="Edward Snowden", citeurl="https://old.reddit.com/r/IAmA/comments/36ru89/just_days_left_to_kill_mass_surveillance_under/crglgh2/") %}
Arguing that you don't care about the right to privacy because you have nothing to hide is no different than saying you don't care about free speech because you have nothing to say.
{% end %}

A live preview of these how these shortcodes look like can be found on this blog post.

Optional Features

sonj includes some optional features that aren't enabled by default

• style external links using a ↗ unicode symbol

Donate

If you found sonj helpful in creating your own microblog website, please consider supporting his original author and buy them coffee ☕

Or if you insist, go to my liberapay :P