David Lapshin
99fc09f75d
All checks were successful
ci/woodpecker/push/woodpecker Pipeline was successful
|
||
---|---|---|
content | ||
sass | ||
static | ||
templates | ||
.woodpecker.yml | ||
config.toml | ||
LICENSE.txt | ||
README.md | ||
theme.toml |
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.
Installation
First, fork it and download this theme to your themes
directory:
git clone YOUR_FORK.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 YOUR_FORK.git themes/duckquill
and then enable it in your config.toml
:
theme = "duckquill"
Options
Duckquill offers some configuration options to make it fit you better (but that doesn't make it less opinionated).
Custom CSS
You can add your own or override existing styles in the themes/duckquill/sass/_custom.scss
, if for some reason overridden class are not respected, try using !important
. This file is empty by default so you should not have issues with doing the git pull
later.
Accent color
Duckquill respects chosen accent color everywhere, you can use any HEX color code you want
First, change the accent color in config.toml
:
[extra]
accent_color = "#HEX_COLOR_CODE"
Then, also change it in themes/duckquill/sass/_variables.scss
:
$accent-color: #HEX_COLOR_CODE;
[extra]
variables:
accent_color
: Accent color used in some browsers set in metadata, for actual accent color seethemes/duckquill/sass/_variables.scss
animated_favicon
: Specify if the favicon are animated GIF (true, false)blog_title
: The title of the blog, used in/blog
blog_description
: The description of the blog, displayed right under the blog titledate_format
: Allows setting custom date format in Tera format, all available variables are listed here. Does not apply to commentshosting
: Where the website source are located, used on 404 pageissues_url
: Link to site bug tracker, if presentsource_url
: Link to site source (not built site)nav_links
: Links used in navigation bar
The nav_links
are set like so:
[extra]
nav_links = [
{url = "https://example.org", name = "Example"},
{url = "https://mstdn.social", name = "Mastodon"},
]
[extra.footer]
variables:
johnvert_ref
: Site URL withouthttps://
part or trailing slashes, e.gexample.org
. Works only ifshow_johnvert
are set totrue
show_copyright
: Whether to display© Duckquill, 2023
. (true, false)show_johnvert
: Whether to display Johnvertisement. (true, false)show_powered_by
: Whether to displayPowered by Zola and Duckquill
. (true, false)show_source
: Whether to displayWebsite source
link. (true, false)
[extra.comments]
variables:
host
: Mastodon home server, e.gmstdn.social
user
: Mastodon username, e.gDaudix
token
: Mastodon app token, e.gjTNX9pAV8XEPBby0cPWF6CmGY60kkIy4vidggfxXmoQ
. Can be left empty, but in this case only first 60 comments will be loaded, instructions on how to get one are available here
Test pages
Special thanks ♥
- Jakub Steiner for an awesome OS Component Website, on top of which this whole thing is built
- Cassidy James for an awesome Mastodon-powered Comments
- Mehdi for an awesome CSS Scanlines
- dwb, ejm and jgs for awesome ASCII art