Switch to Ametrine

content/Articles/Duckquill2Ametrine/index.md

@@ -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.

content/Articles/Set-up-Costmiku-FFSync/index.md

@@ -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.

content/Articles/TylkoLinux-Installation/index.md

@@ -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