feat: Banner
This commit is contained in:
David Lapshin
204
README.md
204
README.md
@ -1,101 +1,103 @@
|
|||||||
# Duckquill
|
# Duckquill
|
||||||
|
|
||||||
[](https://nogithub.codeberg.page)
|
[](https://nogithub.codeberg.page)
|
||||||
[](https://ci.exozy.me/repos/159)
|
[](https://ci.exozy.me/repos/159)
|
||||||
|
|
||||||
[Duckquill](https://git.exozy.me/daudix/duckquill) is a modern, pretty, and clean (and very opinionated) [Zola](https://www.getzola.org) 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.
|
[Duckquill](https://git.exozy.me/daudix/duckquill) is a modern, pretty, and clean (and very opinionated) [Zola](https://www.getzola.org) 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
|
[](https://i.imgur.com/1fCi1sF.png)
|
||||||
|
|
||||||
First, fork it and download this theme to your `themes` directory:
|
## Installation
|
||||||
|
|
||||||
```sh
|
First, fork it and download this theme to your `themes` directory:
|
||||||
git clone YOUR_FORK.git themes/duckquill
|
|
||||||
```
|
```sh
|
||||||
|
git clone YOUR_FORK.git themes/duckquill
|
||||||
...or add as submodule for easy updating (recommended if you already have git setup on site):
|
```
|
||||||
|
|
||||||
```sh
|
...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
|
```sh
|
||||||
```
|
git submodule init
|
||||||
|
git submodule add YOUR_FORK.git themes/duckquill
|
||||||
and then enable it in your `config.toml`:
|
```
|
||||||
|
|
||||||
```
|
and then enable it in your `config.toml`:
|
||||||
theme = "duckquill"
|
|
||||||
```
|
```
|
||||||
|
theme = "duckquill"
|
||||||
## Options
|
```
|
||||||
|
|
||||||
Duckquill offers some configuration options to make it fit you better (but that doesn't make it less opinionated).
|
## Options
|
||||||
|
|
||||||
### Custom CSS
|
Duckquill offers some configuration options to make it fit you better (but that doesn't make it less opinionated).
|
||||||
|
|
||||||
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.
|
### Custom CSS
|
||||||
|
|
||||||
### Accent color
|
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.
|
||||||
|
|
||||||
Duckquill respects chosen accent color everywhere, you can use any HEX color code you want
|
### Accent color
|
||||||
|
|
||||||
First, change the accent color in `config.toml`:
|
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"
|
```
|
||||||
```
|
[extra]
|
||||||
|
accent_color = "#HEX_COLOR_CODE"
|
||||||
Then, also change it in `themes/duckquill/sass/_variables.scss`:
|
```
|
||||||
|
|
||||||
```
|
Then, also change it in `themes/duckquill/sass/_variables.scss`:
|
||||||
$accent-color: #HEX_COLOR_CODE;
|
|
||||||
```
|
```
|
||||||
|
$accent-color: #HEX_COLOR_CODE;
|
||||||
### `[extra]` variables:
|
```
|
||||||
|
|
||||||
- `accent_color`: Accent color used in some browsers set in metadata, for actual accent color see `themes/duckquill/sass/_variables.scss`
|
### `[extra]` variables:
|
||||||
- `animated_favicon`: Specify if the favicon are animated GIF (true, false)
|
|
||||||
- `blog_title`: The title of the blog, used in `/blog`
|
- `accent_color`: Accent color used in some browsers set in metadata, for actual accent color see `themes/duckquill/sass/_variables.scss`
|
||||||
- `blog_description`: The description of the blog, displayed right under the blog title
|
- `animated_favicon`: Specify if the favicon are animated GIF (true, false)
|
||||||
- `date_format`: Allows setting custom date format in [Tera](https://keats.github.io/tera) format, all available variables are listed [here](https://docs.rs/chrono/0.4.31/chrono/format/strftime/index.html). Does not apply to comments
|
- `blog_title`: The title of the blog, used in `/blog`
|
||||||
- `hosting`: Where the website source are located, used on 404 page
|
- `blog_description`: The description of the blog, displayed right under the blog title
|
||||||
- `issues_url`: Link to site bug tracker, if present
|
- `date_format`: Allows setting custom date format in [Tera](https://keats.github.io/tera) format, all available variables are listed [here](https://docs.rs/chrono/0.4.31/chrono/format/strftime/index.html). Does not apply to comments
|
||||||
- `source_url`: Link to site source (not built site)
|
- `hosting`: Where the website source are located, used on 404 page
|
||||||
- `nav_links`: Links used in navigation bar
|
- `issues_url`: Link to site bug tracker, if present
|
||||||
|
- `source_url`: Link to site source (not built site)
|
||||||
The `nav_links` are set like so:
|
- `nav_links`: Links used in navigation bar
|
||||||
|
|
||||||
```
|
The `nav_links` are set like so:
|
||||||
[extra]
|
|
||||||
nav_links = [
|
```
|
||||||
{url = "https://example.org", name = "Example"},
|
[extra]
|
||||||
{url = "https://mstdn.social", name = "Mastodon"},
|
nav_links = [
|
||||||
]
|
{url = "https://example.org", name = "Example"},
|
||||||
```
|
{url = "https://mstdn.social", name = "Mastodon"},
|
||||||
|
]
|
||||||
### `[extra.footer]` variables:
|
```
|
||||||
|
|
||||||
- `johnvert_ref`: Site URL without `https://` part or trailing slashes, e.g `example.org`. Works only if `show_johnvert` are set to `true`
|
### `[extra.footer]` variables:
|
||||||
- `show_copyright`: Whether to display `© Duckquill, 2023`. (true, false)
|
|
||||||
- `show_johnvert`: Whether to display [Johnvertisement](https://john.citrons.xyz). (true, false)
|
- `johnvert_ref`: Site URL without `https://` part or trailing slashes, e.g `example.org`. Works only if `show_johnvert` are set to `true`
|
||||||
- `show_powered_by`: Whether to display `Powered by Zola and Duckquill`. (true, false)
|
- `show_copyright`: Whether to display `© Duckquill, 2023`. (true, false)
|
||||||
- `show_source`: Whether to display `Website source` link. (true, false)
|
- `show_johnvert`: Whether to display [Johnvertisement](https://john.citrons.xyz). (true, false)
|
||||||
|
- `show_powered_by`: Whether to display `Powered by Zola and Duckquill`. (true, false)
|
||||||
### `[extra.comments]` variables:
|
- `show_source`: Whether to display `Website source` link. (true, false)
|
||||||
|
|
||||||
- `host`: Mastodon home server, e.g `mstdn.social`
|
### `[extra.comments]` variables:
|
||||||
- `user`: Mastodon username, e.g `Daudix`
|
|
||||||
- `token`: Mastodon app token, e.g `jTNX9pAV8XEPBby0cPWF6CmGY60kkIy4vidggfxXmoQ`. Can be left empty, but in this case only first 60 comments will be loaded, instructions on how to get one are available [here](https://github.com/cassidyjames/cassidyjames.github.io/blob/47c449a0083113ea5be8d215beb6650ac64929e4/_config.yaml#L48-L52)
|
- `host`: Mastodon home server, e.g `mstdn.social`
|
||||||
|
- `user`: Mastodon username, e.g `Daudix`
|
||||||
## Test pages
|
- `token`: Mastodon app token, e.g `jTNX9pAV8XEPBby0cPWF6CmGY60kkIy4vidggfxXmoQ`. Can be left empty, but in this case only first 60 comments will be loaded, instructions on how to get one are available [here](https://github.com/cassidyjames/cassidyjames.github.io/blob/47c449a0083113ea5be8d215beb6650ac64929e4/_config.yaml#L48-L52)
|
||||||
|
|
||||||
- [Demo page](https://duckquill.exozy.me/demo)
|
## Test pages
|
||||||
- [Cake Party!](https://duckquill.exozy.me/demo/page)
|
|
||||||
- [ActivityPub/Fediverse comments demo](https://duckquill.exozy.me/demo/comments)
|
- [Demo page](https://duckquill.exozy.me/demo)
|
||||||
|
- [Cake Party!](https://duckquill.exozy.me/demo/page)
|
||||||
## Special thanks ♥
|
- [ActivityPub/Fediverse comments demo](https://duckquill.exozy.me/demo/comments)
|
||||||
|
|
||||||
- [Jakub Steiner](https://jimmac.eu) for an awesome [OS Component Website](https://jimmac.github.io/os-component-website), on top of which this whole thing is built
|
## Special thanks ♥
|
||||||
- [Cassidy James](https://cassidyjames.com) for an awesome [Mastodon-powered Comments](https://cassidyjames.com/blog/fediverse-blog-comments-mastodon)
|
|
||||||
- [Mehdi](https://codepen.io/meduzen) for an awesome [CSS Scanlines](https://codepen.io/meduzen/pen/zxbwRV)
|
- [Jakub Steiner](https://jimmac.eu) for an awesome [OS Component Website](https://jimmac.github.io/os-component-website), on top of which this whole thing is built
|
||||||
- dwb, ejm and jgs for awesome ASCII art
|
- [Cassidy James](https://cassidyjames.com) for an awesome [Mastodon-powered Comments](https://cassidyjames.com/blog/fediverse-blog-comments-mastodon)
|
||||||
|
- [Mehdi](https://codepen.io/meduzen) for an awesome [CSS Scanlines](https://codepen.io/meduzen/pen/zxbwRV)
|
||||||
|
- dwb, ejm and jgs for awesome ASCII art
|
||||||
|
|||||||
Reference in New Issue
Block a user