hak8or/blog
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
8b7a70374e1ac02910acd2a6a44bdfaf4c0de440
blog/content/_index.md

7.6 KiB
Raw Blame History

+++ insert_anchor_links = "right" +++

{% crt() %}

      _          _          _          _          _
    >(')____,  >(')____,  >(')____,  >(')____,  >(') ___,
      (` =~~/    (` =~~/    (` =~~/    (` =~~/    (` =~~/
jgs~^~^`---'~^~^~^`---'~^~^~^`---'~^~^~^`---'~^~^~^`---'~^~^~

{% end %}

Duckquill

Duckquill is a modern, pretty, and clean (and opinionated) Zola theme that has the purpose of greatly simplifying the process of rolling up your blog. It aims to provide all the needed options for comfortable writing, keeping the balance of it being simple.

Edit a bit of metadata and tweak some of the included graphics and have a blog up in minutes!

  • Pretty, yet lightweight. No JavaScript is used (except for comments, heh).
  • Colors are tinted with the user-selected primary color for a pleasent look.
  • ~90kB in size; take that, 12MB Medium!
  • Uses system fonts for blazingly fast loading.
  • Mobile friendly, with a proper dark variant.
  • Proper favicon for modern browsers and Apple device icons.
  • Twitter, Mastodon and other social media meta cards for easy sharing. Try Share Preview to test.
  • Mastodon-powered comments; comment using compatible ActivityPub server by replying to a Mastodon post.

Duckquill is made based on needs of my website, if you need some feature/configuration that doesn't exist feel free to open an issue or better yet, pull request!

Installation

First, download this theme to your themes directory:

git clone https://codeberg.org/daudix/duckquill.git themes/duckquill

...or add as submodule for easy updating (recommended if you already have git setup on site):

git submodule init
git submodule add https://codeberg.org/daudix/duckquill.git themes/duckquill

It is highly recommended to switch from the main branch to the lates release:

cd themes/duckquill
git checkout tags/v2.1.0

To update the submodule, simply switch to a new tag:

Note: Check the changelog for all versions that came after the one you are using, there may be some breaking changes that need manual involvement.

git submodule update --remote --merge
git tag --list
git checkout tags/v2.1.0

Then, enable it in your config.toml:

theme = "duckquill"

Options

Duckquill offers some configuration options to make it fit you better; most options have pretty descriptive comments, so it should be easy to understand what they do.

Custom Stylesheets

You can add your own or override existing styles by creating custom stylesheet and adding it in the config.toml:

[extra]
stylesheets = [
  "YOUR_STYLE.css"
]

Additional stylesheets; expects it to be in the static directory. If you are using Sass it will be compiled there anyway.

If for some reason overridden class are not respected, try using !important. You can import styles from Duckquill using:

@use "../themes/duckquill/sass/NEEDED_FILE.scss";

Primary Color

Duckquill respects chosen primary color everywhere, simply change the primary color in config.toml:

[extra]
primary_color = "COLOR_CODE"
primary_color_alpha = "COLOR_CODE"

Test Pages

In the Wild

It starts to get long, so click to expand.

In Credits

Assets Sources

All sources for Duckquill's assets are available here and licensed under CC BY-SA 4.0. The reason for not putting the sources in the same repo as Duckquill itself is simple: I want it to be as small as possible, so that repo cloning is fast and doesn't make the site significantly heavier; this is also why the demo uses remote images instead of local copies.

Credits

Tools Used

As for the code formatter I use built-in VSCodium one. Prettier is good but I don't like how it tries to make code fit in a very narrow column, this can be changed of course, but built-in formatter does it's job so I don't bother doing so.

Thanks To