RSCC-Page/public/Articles/duckquill2ametrine/index.html

214 lines
12 KiB
HTML
Raw Normal View History

2025-03-04 04:23:12 +01:00
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" >
<head>
<meta charset="UTF-8" />
<meta name="description" content="Well, get on this site and find out." />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<meta name="base" content="https://rootsource.cc" />
<title>Transition from Duckquill to Ametrine - RSCC</title>
<link rel="canonical" href="https://rootsource.cc/Articles/duckquill2ametrine/" />
<meta content="Zola" name="generator">
<link rel="icon" type="image/png" href="https://rootsource.cc/favicon.png?h=4b8b8481f5ac84986183" />
<link rel="preload" href="https://rootsource.cc/fonts/geist.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="https://rootsource.cc/fonts/geist-mono.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="https://rootsource.cc/fonts/phosphor-bold.woff2" as="font" type="font/woff2" crossorigin><style type="text/css">
:root {
--accent-color: hsl(324 2% 43%);
--accent-h: 324;
--accent-s: 2%;
--accent-l: 43%;
}[data-theme="dark"] {
--accent-color: hsl(0 1% 75%);
--accent-h: 0;
--accent-s: 1%;
--accent-l: 75%;
}
@media (prefers-color-scheme: dark) {
:root:not([data-theme="light"]) {
--accent-color: hsl(0 1% 75%);
--accent-h: 0;
--accent-s: 1%;
--accent-l: 75%;
}
}</style>
<link type="text/css" rel="stylesheet" href="https://rootsource.cc/style.css?h=fd31cab16611d9654aa0" />
<link type="text/css" rel="stylesheet" href="https://rootsource.cc/phosphor-bold.css?h=64fb8156a3a3f0de62c5" />
<script type="text/javascript" defer src="https://rootsource.cc/closable.js"></script>
<script type="text/javascript" defer src="https://rootsource.cc/search_index.en.js"></script>
<script type="text/javascript" defer src="https://rootsource.cc/elasticlunr.min.js"></script>
<script type="text/javascript" defer src="https://rootsource.cc/search.js"></script>
<meta property="og:site_name" content="RSCC" />
<meta property="og:title" content="Transition from Duckquill to Ametrine - RSCC" />
<meta property="og:url" content="https://rootsource.cc/Articles/duckquill2ametrine/" />
<meta property="og:description" content="In this guide, we will show you how to transition from Daudix&#x27;s Duckquill to its successor, Ametrine!" />
<meta property="og:locale" content="en_US" />
<meta name="twitter:card" content="summary_large_image" />
<meta name="twitter:title" content="Transition from Duckquill to Ametrine - RSCC" />
<meta name="twitter:url" content="https://rootsource.cc/Articles/duckquill2ametrine/" />
<meta name="twitter:description" content="In this guide, we will show you how to transition from Daudix&#x27;s Duckquill to its successor, Ametrine!" />
</head>
<body >
<a id="skip-to-content" href="#main-content" tabindex="0">Skip to Main Content</a>
<div id="site-navbar" class="sidebar">
<a id="navbar-header" href="#top"><i class="ph-bold ph-arrow-line-up"></i><div>
<span>Transition from Duckquill to Ametrine</span>
<span>Back to Top</span>
</div>
</a>
<nav class="overshoot">
<ul><li>
<a
href="https:&#x2F;&#x2F;rootsource.cc&#x2F;">
<i class="ph-bold ph-house"></i>RSCC</a>
</li>
<li>
<a href="https://rootsource.cc/Articles" class="
">
<i class="ph-bold ph-newspaper"></i>Articles</a>
</li>
<li>
<a href="https:&#x2F;&#x2F;git.rootsource.cc&#x2F;" rel="" class="external">
<i class="ph-bold ph-git-merge"></i>Alpsource</a>
</li>
<li>
<a href="https:&#x2F;&#x2F;haj.rootsource.cc&#x2F;" rel="" class="external">
<i class="ph-bold ph-fediverse-logo"></i>Hajiku&#x2F;Costkey</a>
</li>
<li>
<a href="https:&#x2F;&#x2F;bin.rootsource.cc&#x2F;" rel="" class="external">
<i class="ph-bold ph-lock-laminated"></i>Estellabin</a>
</li></ul>
</nav>
<div id="navbar-buttons">
<input class="visually-hidden" id="toggle-navbar" type="checkbox" name="toggle-navbar" autocomplete="off" />
<label for="toggle-navbar"><i class="ph-bold ph-sidebar"></i>Toggle Sidebar</label><button id="search">
<i class="ph-bold ph-magnifying-glass"></i>Search</button></div>
</div>
<main id="main-content" class="has-navbar"><div class="container">
<article>
<h1 id="heading">Transition from Duckquill to Ametrine</h1><div class="article-details"><div class="item">
<i class="ph-bold ph-calendar"></i>
<time datetime="2025-03-04T00:00:00+00:00" pubdate>March 04, 2025</time>
</div>
</div>
<aside id="toc">
<strong class="title">Table of Contents</strong>
<div class="overshoot">
<ul><li>
<a href="https://rootsource.cc/Articles/duckquill2ametrine/#wip">WIP!</a></li><li>
<a href="https://rootsource.cc/Articles/duckquill2ametrine/#step-1-getting-ametrine">Step 1: Getting Ametrine</a><ul><li>
<a href="https://rootsource.cc/Articles/duckquill2ametrine/#don-t-clone-as-submodule">Don&#x27;t clone as submodule</a>
</li><li>
<a href="https://rootsource.cc/Articles/duckquill2ametrine/#clone-as-submodule-recommended">Clone as submodule (recommended!)</a>
</li></ul></li><li>
<a href="https://rootsource.cc/Articles/duckquill2ametrine/#step-2-applying-ametrine">Step 2: Applying Ametrine</a><ul><li>
<a href="https://rootsource.cc/Articles/duckquill2ametrine/#editing-the-file-manually">Editing the file manually</a>
</li><li>
<a href="https://rootsource.cc/Articles/duckquill2ametrine/#using-sed-like-a-pro-haxx0r">Using sed like a pro haxx0r</a>
</li></ul></li><li>
<a href="https://rootsource.cc/Articles/duckquill2ametrine/#building-and-praying">Building and praying</a></li></ul>
</div>
</aside><h1 id="wip">WIP!</h1>
<p>(daudix will have less work writing this fr)</p>
<h1 id="step-1-getting-ametrine">Step 1: Getting Ametrine</h1>
<p>First, you're going to navigate to the themes folder of your Zola installation. Example:</p>
<pre data-lang="bash" style="background-color:#2b303b;color:#c0c5ce;" class="language-bash "><code class="language-bash" data-lang="bash"><span style="color:#bf616a;">user@hostname:/#</span><span> cd /var/www/zola/themes/
</span><span style="color:#bf616a;">user@hostname:/var/www/zola/themes#
</span></code></pre>
<h2 id="don-t-clone-as-submodule">Don't clone as submodule</h2>
<p>If Git is installed, you're going to clone Ametrine into the themes directory:</p>
<pre data-lang="bash" style="background-color:#2b303b;color:#c0c5ce;" class="language-bash "><code class="language-bash" data-lang="bash"><span style="color:#bf616a;">user@hostname:/var/www/zola/themes#</span><span> git clone https://codeberg.org/daudix/ametrine
</span><span style="color:#96b5b4;">cd</span><span> ametrine
</span></code></pre>
<h2 id="clone-as-submodule-recommended">Clone as submodule (recommended!)</h2>
<p>Or, if you use Submodules:</p>
<pre data-lang="bash" style="background-color:#2b303b;color:#c0c5ce;" class="language-bash "><code class="language-bash" data-lang="bash"><span style="color:#bf616a;">user@hostname:/var/www/zola/themes#</span><span> git submodule init
</span><span style="color:#bf616a;">user@hostname:/var/www/zola/themes#</span><span> git submodule add https://codeberg.org/daudix/ametrine.git ametrine
</span></code></pre>
<h1 id="step-2-applying-ametrine">Step 2: Applying Ametrine</h1>
<p>Next step is to change the config to use Ametrine instead of Duckquill</p>
<p>For this, go back to the root directory of the Zola installation:</p>
<pre data-lang="bash" style="background-color:#2b303b;color:#c0c5ce;" class="language-bash "><code class="language-bash" data-lang="bash"><span style="color:#bf616a;">user@hostname:/var/www/zola/themes#</span><span> cd ..
</span><span style="color:#bf616a;">user@hostname:/var/www/zola#</span><span> ls
</span><span style="color:#bf616a;">config.toml</span><span> content public static templates themes zola
</span><span style="color:#bf616a;">user@hostname:/var/www/zola#
</span></code></pre>
<h2 id="editing-the-file-manually">Editing the file manually</h2>
<p>Open the file in your favourite editor:</p>
<pre data-lang="bash" style="background-color:#2b303b;color:#c0c5ce;" class="language-bash "><code class="language-bash" data-lang="bash"><span style="color:#bf616a;">user@hostname:/var/www/zola#</span><span> micro config.toml
</span></code></pre>
<p>Find the line that says</p>
<pre data-lang="toml" style="background-color:#2b303b;color:#c0c5ce;" class="language-toml "><code class="language-toml" data-lang="toml"><span style="color:#bf616a;">theme </span><span>= &quot;</span><span style="color:#a3be8c;">duckquill</span><span>&quot;
</span></code></pre>
<p>and replace it with</p>
<pre data-lang="toml" style="background-color:#2b303b;color:#c0c5ce;" class="language-toml "><code class="language-toml" data-lang="toml"><span style="color:#bf616a;">theme </span><span>= &quot;</span><span style="color:#a3be8c;">ametrine</span><span>&quot;
</span></code></pre>
<h2 id="using-sed-like-a-pro-haxx0r">Using <code>sed</code> like a pro haxx0r</h2>
<p>Feeling skid today? Use the following command to replace the line manually using sed:</p>
<pre data-lang="bash" style="background-color:#2b303b;color:#c0c5ce;" class="language-bash "><code class="language-bash" data-lang="bash"><span style="color:#bf616a;">user@hostname:/var/www/zola#</span><span> sed</span><span style="color:#bf616a;"> -i </span><span>&#39;</span><span style="color:#a3be8c;">s/theme = \&quot;duckquill\&quot;/theme = \&quot;ametrine\&quot;/g</span><span>&#39; config.toml
</span></code></pre>
<h1 id="building-and-praying">Building and praying</h1>
<p>Well, time to build!</p>
<pre data-lang="bash" style="background-color:#2b303b;color:#c0c5ce;" class="language-bash "><code class="language-bash" data-lang="bash"><span style="color:#bf616a;">user@hostname:/var/www/zola#</span><span> ./zola build
</span><span style="color:#bf616a;">Building</span><span> site...
</span><span style="color:#bf616a;">Checking</span><span> all internal links with anchors.
</span><span>&gt; Successfully </span><span style="color:#bf616a;">checked</span><span> 0 internal link(s) </span><span style="color:#bf616a;">with</span><span> anchors.
</span><span style="color:#bf616a;">-</span><span>&gt; Creating 3 pages (0 orphan) </span><span style="color:#bf616a;">and</span><span> 1 sections
</span><span style="color:#bf616a;">Done</span><span> in 341ms.
</span></code></pre>
<ul>
<li>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.</li>
</ul>
<p>We have done it!</p>
<p>You have transitioned from Duckquill to Ametrine, and so did we, joining <a href="https://aeronook.tech">AeroNook (#1)</a> and <a href="https://mambuco.dev/">Mambuco (#2)</a> in the transition, making us the third!</p>
<p>Ametrine is still experimental, but we are happy to see it grow so fast! Thank you <a href="https://daudix.one">Daudix</a> for blessing us with this fr. Go check him out, he's a great and very talented person!</p>
<p>Thank you for reading!</p>
<p>Sincerely, RootsourceCC.</p>
</article><hr />
<nav id="post-nav"><a class="post-nav-item post-nav-prev" href="https:&#x2F;&#x2F;rootsource.cc&#x2F;Articles&#x2F;set-up-costmiku-ffsync&#x2F;">
<div class="nav-arrow">Previous</div>
<span class="post-title">Set up costmiku ffsync on Firefox</span>
</a></nav>
</div>
</main>
<footer id="site-footer">
<div class="container">
<div><p id="site-footer-copyright">raiz1.noho.st owns this website
</p>
<p>Powered by <a class="link external" href="https://www.getzola.org" rel="">Zola</a> and <a class="link external" href="https://ametrine.daudix.one" rel="">Ametrine</a>
</p>
</div></div>
</footer>
<div id="search-modal">
<div id="search-modal-content">
<label for="search-input" class="visually-hidden">Search</label>
<div>
<input id="search-input" placeholder="Search for…" autocomplete="off" type="search">
<i class="ph-bold ph-keyboard" title="Press “&#x2F;” to Open Search Bar"></i>
</div>
<div id="search-results" class="overshoot"></div>
</div>
</div>
</body>
</html>