From 365b8aff3a82a90f50cce5f0204941c64d865514 Mon Sep 17 00:00:00 2001
From: axtlos - Fedi - Fedi: https://snowdin.town/axtlos - Fedi - Fedi: https://snowdin.town/axtlos
axtlos(7) | +Miscellaneous Information Manual | +axtlos(7) | +
axtlos - programmer, furry, transfem, aromantic genderless + being
+axtlos |
+ [she/they] amy xenia | +
axtlos
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.
axtlos
can be contacted via:
- Fedi: https://snowdin.town/axtlos
+- + Matrix: + @xenia:the-apothecary.club
+- + XMPP: + axtlos@getcryst.al
+- + E-Mail: + axtlos@tar.black & axtlos@getcryst.al
+ +axtlos
mainly develops for
Specifically the following projects:
+- + Project-Shards A + custom macOS style immutable linux distro
+- + Jade The + installer backend
+- + Jade + GUI The libadwaita installer frontend
+- + First + Setup A libadwaita first setup helper
+More random Projects can be found on + Codeberg and + GitHub
+CC BY-SA 4.0 | +Linux 6.2.6-arch1-1 | +
|\n
\n
\n|g' website.7.html > website.7.html.tmp
-mv website.7.html.tmp website.7.html
+sed 's||
\n
\n|g' axtlos.7.html > axtlos.7.html.tmp
+mv axtlos.7.html.tmp axtlos.7.html
echo "Replace date with license"
-sed 's|
|
|g' website.7.html > website.7.html.tmp -mv website.7.html.tmp website.7.html -echo "Succesfully generated website" +sed '/
' axtlos.7.html > axtlos.7.html.tmp +mv axtlos.7.html.tmp axtlos.7.html +echo "Change See also to hyperlinks" +sed 's|
Project Shards(1), Crystal Linux(1)
|Project Shards(1), Crystal Linux(1)|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 '/
' shards.1.html > shards.1.html.tmp +mv shards.1.html.tmp shards.1.html +echo "Change See also to hyperlinks" +sed 's|
axtlos(7), Crystal Linux(1)
|axtlos(7), Crystal Linux(1)|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 '
' > 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 '/
' crystal.1.html > crystal.1.html.tmp +mv crystal.1.html.tmp crystal.1.html +echo "Change See also to hyperlinks" +sed 's|
axtlos(7), Project Shards(1)
|axtlos(7), Project Shards(1)|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 b/website.7 deleted file mode 100644 index fbbee16..0000000 --- a/website.7 +++ /dev/null @@ -1,60 +0,0 @@ -.Dd $Mdocdate$ -.Dt axtlos 7 -.Os -.Sh Name -axtlos - programmer, furry, transfem, aromantic genderless being -.Sh SYNOPSIS -.Nm axtlos -.Op she/they -.Ar amy -.Ar xenia -.Sh DESCRIPTION -.Nm -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. -.Sh Contact -.Nm -can be contacted via: - -- -.Lk https://snowdin.town/axtlos Fedi - -- -.Em Matrix: -@xenia:the-apothecary.club - -- -.Em XMPP: -axtlos@getcryst.al - -- -.Em E-Mail: -axtlos@tar.black & axtlos@getcryst.al - -.Sh Projects -.Nm -mainly develops for - -.Lk https://getcryst.al Crystal Linux - -Specifically the following projects: - -- -.Lk https://getcryst.al/project-shard Project-Shards -A custom macOS style immutable linux distro - -- -.Lk https://getcryst.al/crystal/software/jade Jade -The installer backend - -- -.Lk https://getcryst.al/crystal/software/jade-gui Jade GUI -The libadwaita installer frontend - -- -.Lk https://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 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 @@ + + +
+ + + +
+ +
+