RSCC-Page/content/Articles/Duckquill2Ametrine/index.md

92 lines
2.6 KiB
Markdown
Raw Normal View History

2025-03-04 04:23:12 +01:00
+++
title = "Transition from Duckquill to Ametrine"
description = "In this guide, we will show you how to transition from Daudix's Duckquill to its successor, Ametrine!"
date = 2025-03-04
[extra]
toc = true
+++
# 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:
```bash
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:
```bash
user@hostname:/var/www/zola/themes# git clone https://codeberg.org/daudix/ametrine
cd ametrine
```
## Clone as submodule (recommended!)
Or, if you use Submodules:
```bash
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:
```bash
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:
```bash
user@hostname:/var/www/zola# micro config.toml
```
Find the line that says
```toml
theme = "duckquill"
```
and replace it with
```toml
theme = "ametrine"
```
## Using ``sed`` like a pro haxx0r
Feeling skid today? Use the following command to replace the line manually using sed:
```bash
user@hostname:/var/www/zola# sed -i 's/theme = \"duckquill\"/theme = \"ametrine\"/g' config.toml
```
# Building and praying
Well, time to build!
```bash
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)](https://aeronook.tech) and [Mambuco (#2)](https://mambuco.dev/) in the transition, making us the third!
Ametrine is still experimental, but we are happy to see it grow so fast! Thank you [Daudix](https://daudix.one) for blessing us with this fr. Go check him out, he's a great and very talented person!
Thank you for reading!
Sincerely, RootsourceCC.