Add crystal(1) and shards(1)

5 files changed, 294 insertions, 14 deletions

diff --git a/website.7 b/axtlos.7
index fbbee16..f545d26 100644
--- a/website.7
+++ b/axtlos.7
@@ -6,7 +6,6 @@ axtlos - programmer, furry, transfem, aromantic genderless being
 .Sh SYNOPSIS
 .Nm axtlos
 .Op she/they
-.Ar amy
 .Ar xenia
 .Sh DESCRIPTION
 .Nm
@@ -39,22 +38,27 @@ mainly develops for
 Specifically the following projects:
 
 -
-.Lk https://getcryst.al/project-shard Project-Shards
+.Lk https://git.getcryst.al/project-shards Project-Shards
 A custom macOS style immutable linux distro
 
 -
-.Lk https://getcryst.al/crystal/software/jade Jade
+.Lk https://git.getcryst.al/crystal/software/jade Jade
 The installer backend
 
 -
-.Lk https://getcryst.al/crystal/software/jade-gui Jade GUI
+.Lk https://git.getcryst.al/crystal/software/jade-gui Jade GUI
 The libadwaita installer frontend
 
 -
-.Lk https://getcryst.al/crystal/software/first-setup First Setup
+.Lk https://git.getcryst.al/crystal/software/first-setup First Setup
 A libadwaita first setup helper
 
 More random Projects can be found on
 .Lk https://codeberg.org/axtlos Codeberg
 and
 .Lk https://github.com/axtloss GitHub
+
+.Sh See also
+\fBProject Shards\fP(1),
+\fBCrystal Linux\fP(1)
+
diff --git a/crystal.1 b/crystal.1
new file mode 100644
index 0000000..1fa637e
--- /dev/null
+++ b/crystal.1
@@ -0,0 +1,54 @@
+.Dd $Mdocdate$
+.Dt CrystalLinux 1
+.Os
+.Sh SYNOPSIS
+.Nm Crystal Linux
+.Op crystal
+.Ar arch based
+.Ar easy to use
+.Ar linux distro
+.Sh DESCRIPTION
+.Nm
+is an arch based linux distro with it's own installer and package manager
+.Sh Goals
+.Nm
+tries to bring modern linux technologies to the average users while still being
+easy to use
+
+.Sh Package Management
+.Nm
+uses a pacman wrapper called \fBame\fP to install, remove, updated and search
+packages, however users are still able to use pacman directly.
+
+
+\fBame\fP is written in rust and is particularly fast with aur packages since it
+builds multiple aur packages at once.
+
+
+.Nm
+also comes preinstalled with flatpak.
+
+.Sh Installing
+.Nm
+installs like any other Distribution, you boot the live iso and launch the Installer.
+
+The installer, \fBJade\fR \fBGUI\fR is a custom written installer that uses
+libadwaita and gtk4 for the frontend, and the \fBjade\fR as the backend.
+
+
+Once the user boots into crystal for the first time, they are greeted with a
+first setup application that allows them to set up Flatpak, install nvidia drivers
+and change the color scheme.
+
+.Sh Desktop
+.Nm
+by defaul tuses \fBOnyx\fR, a custom gnome session with extra extensions to make
+the experience more familiar with other desktops or operating systems.
+
+If the User does not want to use \fBOnyx\fR, they can simly select a different 
+Desktop or Window Manager in \fBJade\fR \fBGUI\fR.
+These Desktops and Window Managers include vanilla GNOME, KDE, i3 and sway.
+
+.Sh See Also
+\fBaxtlos\fP(7),
+\fBProject Shards\fP(1)
diff --git a/generate.sh b/generate.sh
index 8fba86b..c376e56 100755
--- a/generate.sh
+++ b/generate.sh
@@ -1,14 +1,49 @@
 #!/usr/bin/env sh
 
-echo "Generate html"
-mandoc -T html -O style=./style.css website.7 > website.7.html
+echo "Generate axtlos(7)"
+mandoc -T html -O style=./style.css axtlos.7 > axtlos.7.html
+echo "Change OS"
+sed 's|Linux 6.2.6-arch1-1|FreeBSD 13.1-RELEASE-p6|g' axtlos.7.html > axtlos.7.html.tmp
+mv axtlos.7.html.tmp axtlos.7.html
 echo "Change fedi hyperlink style"
-sed 's|<p class="Pp">- <a class="Lk" href="https://snowdin.town/axtlos">Fedi</a></p>|<p class="Pp">- <i class="Em">Fedi:</i> <a class="Lk" rel="me" href="https://snowdin.town/axtlos">https://snowdin.town/axtlos</a></p>|g' website.7.html > website.7.html.tmp
-mv website.7.html.tmp website.7.html
+sed 's|<p class="Pp">- <a class="Lk" href="https://snowdin.town/axtlos">Fedi</a></p>|<p class="Pp">- <i class="Em">Fedi:</i> <a class="Lk" rel="me" href="https://snowdin.town/axtlos">https://snowdin.town/axtlos</a></p>|g' axtlos.7.html > axtlos.7.html.tmp
+mv axtlos.7.html.tmp axtlos.7.html
 echo "Adding Gifs"
-sed 's|</body>|<img src="https://cyber.dabamos.de/88x31/delete-twitter.gif" alt="delete twitter, make a neocities!"/>\n<img src="https://cyber.dabamos.de/88x31/antinazi.gif" alt="No nazis! No fascists! No racism!"/>\n<img src="https://cyber.dabamos.de/88x31/rainbow_bev.gif" alt="Pride flag"/>\n</body>|g' website.7.html > website.7.html.tmp
-mv website.7.html.tmp website.7.html
+sed 's|</body>|<img src="https://cyber.dabamos.de/88x31/delete-twitter.gif" alt="delete twitter, make a neocities!"/>\n<img src="https://cyber.dabamos.de/88x31/antinazi.gif" alt="No nazis! No fascists! No racism!"/>\n</body>|g' axtlos.7.html > axtlos.7.html.tmp
+mv axtlos.7.html.tmp axtlos.7.html
 echo "Replace date with license"
-sed 's|<td class="foot-date">January 15, 2023</td>|<td class="foot-date">CC BY-SA 4.0</td>|g' website.7.html > website.7.html.tmp
-mv website.7.html.tmp website.7.html
-echo "Succesfully generated website"
+sed '/<td class="foot-date">/c\    <td class="foot-date">CC BY-SA 4.0</td>' axtlos.7.html > axtlos.7.html.tmp
+mv axtlos.7.html.tmp axtlos.7.html
+echo "Change See also to hyperlinks"
+sed 's|<p class="Pp"><b>Project Shards</b>(1), <b>Crystal Linux</b>(1)</p>|<a class="Lk" href="https://axtlos.neocities.org/shards.1.html"><b>Project Shards<b>(1)</a>, <a class="Lk" href="https://axtlos.neocities.org/crystal.1.html/"><b>Crystal Linux</b>(1)</a>|g' axtlos.7.html > axtlos.7.html.tmp
+mv axtlos.7.html.tmp axtlos.7.html
+echo "Succesfully generated axtlos(7)"
+
+echo "Generate shards(1)"
+mandoc -T html -O style=./style.css shards.1 > shards.1.html
+echo "Change OS"
+sed 's|Linux 6.2.6-arch1-1|FreeBSD 13.1-RELEASE-p6|g' shards.1.html > shards.1.html.tmp
+mv shards.1.html.tmp shards.1.html
+echo "Replace date with license"
+sed '/<td class="foot-date">/c\    <td class="foot-date">CC BY-SA 4.0</td>' shards.1.html > shards.1.html.tmp
+mv shards.1.html.tmp shards.1.html
+echo "Change See also to hyperlinks"
+sed 's|<p class="Pp"><b>axtlos</b>(7), <b>Crystal Linux</b>(1)</p>|<a class="Lk" href="https://axtlos.neocities.org"><b>axtlos<b>(7)</a>, <a class="Lk" href="https://axtlos.neocities.org/crystal.1.html/"><b>Crystal Linux</b>(1)</a>|g' shards.1.html > shards.1.html.tmp
+mv shards.1.html.tmp shards.1.html
+echo "Remove one specific newline"
+cat shards.1.html | grep -v '  <br/>' > shards.1.html.tmp
+mv shards.1.html.tmp shards.1.html
+echo "Succesfully generated shards(1)"
+
+echo "Generate crystal(1)"
+mandoc -T html -O style=./style.css crystal.1 > crystal.1.html
+echo "Change OS"
+sed 's|Linux 6.2.6-arch1-1|FreeBSD 13.1-RELEASE-p6|g' crystal.1.html > crystal.1.html.tmp
+mv crystal.1.html.tmp crystal.1.html
+echo "Replace date with license"
+sed '/<td class="foot-date">/c\    <td class="foot-date">CC BY-SA 4.0</td>' crystal.1.html > crystal.1.html.tmp
+mv crystal.1.html.tmp crystal.1.html
+echo "Change See also to hyperlinks"
+sed 's|<p class="Pp"><b>axtlos</b>(7), <b>Project Shards</b>(1)</p>|<a class="Lk" href="https://axtlos.neocities.org"><b>axtlos<b>(7)</a>, <a class="Lk" href="https://axtlos.neocities.org/shards.1.html/"><b>Project Shards</b>(1)</a>|g' crystal.1.html > crystal.1.html.tmp
+mv crystal.1.html.tmp crystal.1.html
+echo "Succesfully generated crystal(1)"
diff --git a/shards.1 b/shards.1
new file mode 100644
index 0000000..3207ba4
--- /dev/null
+++ b/shards.1
@@ -0,0 +1,102 @@
+.Dd $Mdocdate$
+.Dt Shards 1
+.Os
+.Sh SYNOPSIS
+.Nm Project Shards
+.Op shards
+.Ar MacOS inspired
+.Ar Immutable
+.Ar Crystal Spin
+.Sh DESCRIPTION
+.Nm
+is an immutable Crystal Linux spin using multiple Volumes to create one system
+.Sh How it works
+.Nm
+utilizes multiple Volumes (called Shards) to create one root using bind and overlay mounts
+
+.Sh The different Shards
+.Nm
+Consists of 6 Shards:
+
+.IP \fBRoot\fP
+\- The Root shard acts like a preloader, it provides the special root directories
+like /run or /dev and the initial tools for mounting the other Shards and creating
+the proper root system
+
+
+.IP \fBSystem\fP
+\- The System shard is the main root, it contains everything required to boot
+the system and cannot be modified unless booted into the recovery
+
+
+.IP \fBDesktop\fP
+\- The Desktop shard contains all packages related to the Desktop, which by
+default is GNOME, just like the System shard it cannot be modified unless booted
+into the recovery
+
+
+.IP \fBData\fP
+\- Data Contains everything the user installs themselves or changes on the root
+filesystem, it is mounted read-write and contains /etc
+
+
+.IP \fBUsers\fP
+\- Users contains the home directories of all users, it is simply bind mounted
+to /home on boot as read-write
+
+
+.IP \fBRecovery\fP
+\- The Recovery shard is a seperate system from the other shards, it can be
+booted by itself. It contains the Graphical and Terminal based recovery for
+updating, troubleshooting or reinstalling Project Shards
+
+
+.Sh Package Management
+.Nm
+uses a pacman wrapper called shardctl to install and remove packages, however
+users can also enter a special mode to use \fBpacman\fR(1)
+directly.
+
+\fBshardctl\fP also allows installing aur packages and wraps around \fBapx\fR(1)
+to allow installing packages into containers.
+
+
+.Nm
+comes preinstalled with flatpak and allows installing them by simply dragging
+the flatpakref files into ~/Applications.
+This is achieved using \fBappD\fP.
+
+
+\fBappD\fP also allows installing pacman packages by dragging the .pkg.tar.xz
+files into ~/Applications.
+
+.Sh Updating
+.Nm
+uses the Recovery to perform updates. When a user decides to update their
+.Nm
+Installation, they get rebooted into the Recovery which automatically starts the Update.
+
+
+If the Update is succesfull the Recovery either turns the computer off or reboots
+it, depending on what the user chose when starting the update.
+
+If the Update fails, then the recovery rolls back to a snapshot it took before
+starting the update and warns the user next time it boots into the main Project
+Shards installation.
+
+.Sh Installing
+.Nm
+installs similiarly to MacOS, the ISO offered for download is actually the recovery,
+when booting into the iso the user is immediately presented with the Recovery 
+screen and can Install
+.Nm.
+
+
+The installation process only asks the user for the disk to install onto, any
+postinstall configurations usually set in the Installer, like user creation,
+setting the timezone or choosing locales are done post install in a first-setup
+application.
+
+.Sh See Also
+\fBaxtlos\fP(7),
+\fBCrystal Linux\fP(1)
diff --git a/website.7.html b/website.7.html
new file mode 100644
index 0000000..ba28e22
--- /dev/null
+++ b/website.7.html
@@ -0,0 +1,85 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8"/>
+  <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
+  <link rel="stylesheet" href="./style.css" type="text/css" media="all"/>
+  <title>axtlos(7)</title>
+</head>
+<body>
+<table class="head">
+  <tr>
+    <td class="head-ltitle">axtlos(7)</td>
+    <td class="head-vol">Miscellaneous Information Manual</td>
+    <td class="head-rtitle">axtlos(7)</td>
+  </tr>
+</table>
+<div class="manual-text">
+<section class="Sh">
+<h1 class="Sh" id="Name"><a class="permalink" href="#Name">Name</a></h1>
+<p class="Pp">axtlos - programmer, furry, transfem, aromantic genderless
+  being</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<table class="Nm">
+  <tr>
+    <td><code class="Nm">axtlos</code></td>
+    <td>[she/they] <var class="Ar">amy</var> <var class="Ar">xenia</var></td>
+  </tr>
+</table>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+<p class="Pp"><code class="Nm">axtlos</code> is a programmer mainly using
+    python, rust and awk. Very interested in *nix operating systems (currently
+    using FreeBSD), open source software and other Tech things.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="Contact"><a class="permalink" href="#Contact">Contact</a></h1>
+<p class="Pp"><code class="Nm">axtlos</code> can be contacted via:</p>
+<p class="Pp">- <i class="Em">Fedi:</i> <a class="Lk" rel="me" href="https://snowdin.town/axtlos">https://snowdin.town/axtlos</a></p>
+<p class="Pp">-
+    <a class="permalink" href="#Matrix:"><i class="Em" id="Matrix:">Matrix:</i></a>
+    @xenia:the-apothecary.club</p>
+<p class="Pp">-
+    <a class="permalink" href="#XMPP:"><i class="Em" id="XMPP:">XMPP:</i></a>
+    axtlos@getcryst.al</p>
+<p class="Pp">-
+    <a class="permalink" href="#E-Mail:"><i class="Em" id="E-Mail:">E-Mail:</i></a>
+    axtlos@tar.black &amp; axtlos@getcryst.al</p>
+<p class="Pp"></p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="Projects"><a class="permalink" href="#Projects">Projects</a></h1>
+<p class="Pp"><code class="Nm">axtlos</code> mainly develops for</p>
+<p class="Pp"><a class="Lk" href="https://getcryst.al">Crystal Linux</a></p>
+<p class="Pp">Specifically the following projects:</p>
+<p class="Pp">-
+    <a class="Lk" href="https://getcryst.al/project-shard">Project-Shards</a> A
+    custom macOS style immutable linux distro</p>
+<p class="Pp">-
+    <a class="Lk" href="https://getcryst.al/crystal/software/jade">Jade</a> The
+    installer backend</p>
+<p class="Pp">-
+    <a class="Lk" href="https://getcryst.al/crystal/software/jade-gui">Jade
+    GUI</a> The libadwaita installer frontend</p>
+<p class="Pp">-
+    <a class="Lk" href="https://getcryst.al/crystal/software/first-setup">First
+    Setup</a> A libadwaita first setup helper</p>
+<p class="Pp">More random Projects can be found on
+    <a class="Lk" href="https://codeberg.org/axtlos">Codeberg</a> and
+    <a class="Lk" href="https://github.com/axtloss">GitHub</a></p>
+</section>
+</div>
+<table class="foot">
+  <tr>
+    <td class="foot-date">CC BY-SA 4.0</td>
+    <td class="foot-os">Linux 6.2.6-arch1-1</td>
+  </tr>
+</table>
+<img src="https://cyber.dabamos.de/88x31/delete-twitter.gif" alt="delete twitter, make a neocities!"/>
+<img src="https://cyber.dabamos.de/88x31/antinazi.gif" alt="No nazis! No fascists! No racism!"/>
+<img src="https://cyber.dabamos.de/88x31/rainbow_bev.gif" alt="Pride flag"/>
+</body>
+</html>