blog/index.md

layout

layout
default

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

Duckquill

Duckquill is a modern, pretty, and clean Jekyll template that has the purpose of greatly simplifying the process of rolling up your blog. It aims to let you write simple markdown pages and deploy them to Codeberg or GitLab Pages.

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

• Proper favicon for modern browsers and Apple device icons.
• Mastodon, Facebook and other social media meta cards for easy sharing. Try Share Preview to test.
• Local copy of the amazing Inter font. No slowdowns pulling from external hosting.
• Mobile friendly, dark variant included.

Make yourself a cup of your favorite drink and let's start!

Preparation

This template needs a CI to be built and deployed, I recommend using either Codeberg or GitLab Pages. For Codeberg Pages I've written a blog post on step-by-step guide how to get the CI working.

There is an included .woodpecker.yml and .gitlab-ci.yml that should be easy to adjust to your situation. For additional info see Codeberg Pages and GitLab Pages docs.

Getting started

This template includes some useful utilities to make your life easier and keep you sane (looking at you, ruby stuff).

The process of setting up the site locally consists of:

• Install Podman. On Fedora Silverblue it's already installed

• Run local.sh build to create a Podman container that uses official Jekyll image, download and install all needed Gems and build the site locally.

• Edit the Jekyll config file -- _config.yml.

• Replace all mentions and links of Daudix and Duckquill with yours.

• Replace or edit all the graphics. Using Inkscape are recommended. If you want to reduce the SVGs size, use svgo.

• Test the site locally. Run local.sh serve.

• git commit your changes and push to your remote repo for automatic deployment.