Switch to Ametrine
This commit is contained in:
parent
8d2b031b5a
commit
53353f0a94
76 changed files with 6164 additions and 2645 deletions
91
content/Articles/Duckquill2Ametrine/index.md
Normal file
91
content/Articles/Duckquill2Ametrine/index.md
Normal 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.
|
37
content/Articles/Set-up-Costmiku-FFSync/index.md
Normal file
37
content/Articles/Set-up-Costmiku-FFSync/index.md
Normal 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.
|
|
@ -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
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue