3.7 KiB
+++ +++
{% crt() %}
_ _ _ _ _
>(')____, >(')____, >(')____, >(')____, >(') ___,
(` =~~/ (` =~~/ (` =~~/ (` =~~/ (` =~~/
jgs~^~^`---'~^~^~^`---'~^~^~^`---'~^~^~^`---'~^~^~^`---'~^~^~
{% end %}
Duckquill
Duckquill is a modern, pretty, and clean (and very 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.
- For a very pleasant look, the colors are tinted with the primary color.
- Proper favicon for modern browsers and Apple device icons.
- Mastodon, Lemmy and other social media meta cards for easy sharing. Try Share Preview to test.
- Mobile friendly, with proper dark variant.
- 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
To update the submodule, use the following command:
git submodule update --remote --merge
and 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
Contribute
If you want to improve Duckquill in any way, feel free to open an issue, or better yet, a pull request! I appreciate every contribution!
Credits
Thanks to ♥
- Jakub Steiner for the OS Component Website, on top of which this whole thing is built
- Carl Schwan for the Mastodon-powered Comments
- Everyone who supported me and said good stuff <3