From 365b8aff3a82a90f50cce5f0204941c64d865514 Mon Sep 17 00:00:00 2001 From: axtlos Date: Sat, 18 Mar 2023 23:21:42 +0100 Subject: Add crystal(1) and shards(1) --- axtlos.7 | 64 ++++++++++++++++++++++++++++++++++++ crystal.1 | 54 ++++++++++++++++++++++++++++++ generate.sh | 53 +++++++++++++++++++++++++----- shards.1 | 102 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++ website.7 | 60 --------------------------------- website.7.html | 85 +++++++++++++++++++++++++++++++++++++++++++++++ 6 files changed, 349 insertions(+), 69 deletions(-) create mode 100644 axtlos.7 create mode 100644 crystal.1 create mode 100644 shards.1 delete mode 100644 website.7 create mode 100644 website.7.html diff --git a/axtlos.7 b/axtlos.7 new file mode 100644 index 0000000..f545d26 --- /dev/null +++ b/axtlos.7 @@ -0,0 +1,64 @@ +.Dd $Mdocdate$ +.Dt axtlos 7 +.Os +.Sh Name +axtlos - programmer, furry, transfem, aromantic genderless being +.Sh SYNOPSIS +.Nm axtlos +.Op she/they +.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://git.getcryst.al/project-shards Project-Shards +A custom macOS style immutable linux distro + +- +.Lk https://git.getcryst.al/crystal/software/jade Jade +The installer backend + +- +.Lk https://git.getcryst.al/crystal/software/jade-gui Jade GUI +The libadwaita installer frontend + +- +.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|

- Fedi

|

- Fedi: https://snowdin.town/axtlos

|g' website.7.html > website.7.html.tmp -mv website.7.html.tmp website.7.html +sed 's|

- Fedi

|

- Fedi: https://snowdin.town/axtlos

|g' axtlos.7.html > axtlos.7.html.tmp +mv axtlos.7.html.tmp axtlos.7.html echo "Adding Gifs" -sed 's||delete twitter, make a neocities!\nNo nazis! No fascists! No racism!\nPride flag\n|g' website.7.html > website.7.html.tmp -mv website.7.html.tmp website.7.html +sed 's||delete twitter, make a neocities!\nNo nazis! No fascists! No racism!\n|g' axtlos.7.html > axtlos.7.html.tmp +mv axtlos.7.html.tmp axtlos.7.html echo "Replace date with license" -sed 's|January 15, 2023|CC BY-SA 4.0|g' website.7.html > website.7.html.tmp -mv website.7.html.tmp website.7.html -echo "Succesfully generated website" +sed '//c\ CC BY-SA 4.0' 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 '//c\ CC BY-SA 4.0' 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 '//c\ CC BY-SA 4.0' 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 @@ + + + + + + + axtlos(7) + + + + + + + + +
axtlos(7)Miscellaneous Information Manualaxtlos(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

+

- + + @xenia:the-apothecary.club

+

- + + axtlos@getcryst.al

+

- + + axtlos@tar.black & axtlos@getcryst.al

+

+
+
+

+

axtlos mainly develops for

+

Crystal Linux

+

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.0Linux 6.2.6-arch1-1
+delete twitter, make a neocities! +No nazis! No fascists! No racism! +Pride flag + + -- cgit v1.2.3