Skip to Main Content

# Transition from Duckquill to Ametrine

March 04, 2025
2 minutes

# WIP!

(daudix will have less work writing this fr)

# Step 1: Getting Ametrine

First, you're going to navigate to the themes folder of your Zola installation. Example:

    user@hostname:/# cd /var/www/zola/themes/
    user@hostname:/var/www/zola/themes#

## Don't clone as submodule

If Git is installed, you're going to clone Ametrine into the themes directory:

    user@hostname:/var/www/zola/themes# git clone https://codeberg.org/daudix/ametrine
    cd ametrine

## Clone as submodule (recommended!)

Or, if you use Submodules:

    user@hostname:/var/www/zola/themes# git submodule init
    user@hostname:/var/www/zola/themes# git submodule add https://codeberg.org/daudix/ametrine.git ametrine

# Step 2: Applying Ametrine

Next step is to change the config to use Ametrine instead of Duckquill

For this, go back to the root directory of the Zola installation:

    user@hostname:/var/www/zola/themes# cd ..
    user@hostname:/var/www/zola# ls
    config.toml  content  public  static  templates  themes  zola
    user@hostname:/var/www/zola#

## Editing the file manually

Open the file in your favourite editor:

    user@hostname:/var/www/zola# micro config.toml

Find the line that says

    theme = "duckquill"

and replace it with

    theme = "ametrine"

## Using `sed` like a pro haxx0r

Feeling skid today? Use the following command to replace the line manually using sed:

    user@hostname:/var/www/zola# sed -i 's/theme = \"duckquill\"/theme = \"ametrine\"/g' config.toml

# Building and praying

Well, time to build!

    user@hostname:/var/www/zola# ./zola build
    Building site...
    Checking all internal links with anchors.
    > Successfully checked 0 internal link(s) with anchors.
    -> Creating 3 pages (0 orphan) and 1 sections
    Done in 341ms.

- Note: The zola command may either only be available in the site's directory, or as a widely-available command, depending on your installation method of Zola.

We have done it!

You have transitioned from Duckquill to Ametrine, and so did we, joining AeroNook (#1) and Mambuco (#2) in the transition, making us the third!

Ametrine is still experimental, but we are happy to see it grow so fast! Thank you Daudix for blessing us with this fr. Go check him out, he's a great and very talented person!

Thank you for reading!

Sincerely, RootsourceCC.

Search