Switch to Ametrine

This commit is contained in:
root 2025-03-04 04:23:12 +01:00
parent 8d2b031b5a
commit 53353f0a94
76 changed files with 6164 additions and 2645 deletions

View file

@ -0,0 +1,91 @@
+++
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.

View file

@ -0,0 +1,37 @@
+++
title = "Set up costmiku ffsync on Firefox"
description = "Shortest article demonstrating how to configure Firefox to synchronise to costmiku ffsync"
date = 2025-03-01
[extra]
toc = true
+++
This has not been written by the RootsourceCC team, but still describes it accurately.
Create a Mozilla account
Go to [https://accounts.firefox.com](https://accounts.firefox.com) and follow the "Sign up" steps to create an account.
**Configure Firefox Desktop**
Please open `about:config` in your Firefox and point `identity.sync.tokenserver.uri` to `https://ffsync.costmiku.space/1.0/sync/1.5`.
**Configure Firefox based browsers on Android**
These steps have to be followed in a strict order. Failing to do it would probably lead to issues. This should also work in Firefox based browsers like Mull (tested) and others.
- Open Firefox Browser -> Settings -> About Firefox -> tap 5 times in Firefox logo.
- Go back to Settings -> Account -> you should see a new option `Sync Debug`, tap on it.
- Select `Custom Sync server` and write there your endpoint. It should be https://ffsync.costmiku.space/1.0/sync/1.5.
- Exit Firefox completely, reopen and then follow the steps of "Connect a device" to your Firefox account.
- After a successful auth process the sync should start working.
Configure Firefox on iOS
Not tested.
- Open Firefox Browser -> Settings -> About Firefox -> tap on the field with Firefox and version number.
- Go back to Settings -> Account -> you should see a new option `Advanced Sync Settings`, tap on it.
- Toggle Use Custom Sync Token Server and write there your endpoint. It should be `https://ffsync.costmiku.space/`.
- You might also need to toggle the switch for custom FxA login server and set it to `https://accounts.firefox.com`
- Exit Firefox completely, reopen and then follow the steps of "Connect a device" to your Firefox account.
- After a successful auth process the sync should start working.

View file

@ -217,8 +217,19 @@ Run the following commands:
einrichter/eic> eic.dirs.create # Creates necessary directories
einrichter/eic> eic.essentials.create # Creates necessary tools
einrichter/eic> eic.essentials.install # Installs the tools
einrichter/eic> eic.essentials.verify # Verifies that the packages are installed
einrichter/eic> eic.clean # Clean up the environment
```
If after running eic.essentials.verify, the packages have not been installed, try to troubleshoot the actual package that failed to install and try again.
Or...re-extract package and reinstall
```bash
einrichter/eic> eic.bugfix.RrX
einrichter/eic> eic.essentials.install
```
BEFORE BUILDING THE ACTUAL SYSTEM!!!!
Run this command. It applies the RrX bugfix that removes and re-extracts affected packages.
```bash