From 1abeb4bc95b705494ce32d096d6e3e8fd8b31917 Mon Sep 17 00:00:00 2001 From: Hericium VEVO Date: Sat, 15 Apr 2023 18:41:23 +0000 Subject: [PATCH 1/3] Update template.md, README.md --- README.md | 113 +++++++++++++++++++++++++--------------------------- template.md | 65 ++++++++++++++++++++++++++++++ 2 files changed, 120 insertions(+), 58 deletions(-) create mode 100644 template.md diff --git a/README.md b/README.md index 7a6b75a..a43e29f 100755 --- a/README.md +++ b/README.md @@ -1,123 +1,119 @@ -

- - Logo - -

-

Jade

-

- License - Gitlab issues - Gitlab merge requests
- Discord - The - Mastodon Follow - Twitter Follow -

- -

Jade is an installer backend for crystal linux.

+ +# Jade + +Jade is an installer backend for crystal linux. ## Backend usage -### autopartition the drive +### Autopartition the drive ```sh # autopartition /dev/sda with efi enabled -jade partition auto /dev/sda --efi +$ crystal-jade partition auto /dev/sda --efi # autopartition /dev/nvmen0 with efi disabled -jade partition auto /dev/nvmen0 +$ crystal-jade partition auto /dev/nvmen0 ``` -### install base packages +### Install base packages ```sh -jade install-base +$ crystal-jade install-base ``` -### install bootloader +### Install bootloader ```sh # install as efi with esp being /boot/efi -jade bootloader grub-efi /boot/efi +$ crystal-jade bootloader grub-efi /boot/efi # install as legacy on /dev/sda -jade bootloader grub-legacy /dev/sda +$ crystal-jade bootloader grub-legacy /dev/sda ``` -### generate fstab +### Generate fstab ```sh -jade genfstab +$ crystal-jade genfstab ``` -### configuring locale settings +### Configuring locale settings ```sh # set the keyboard layout to colemak, the timezone to Europe/Berlin and set en_US.UTF-8 as the locale -jade locale colemak Europe/Berlin en_US.UTF-8 UTF-8 +$ crystal-jade locale colemak Europe/Berlin en_US.UTF-8 UTF-8 ``` -### configure network settings +### Configure network settings ```sh # set the hostname to getcryst.al with ipv6 disabled -jade networking getcryst.al +$ crystal-jade networking getcryst.al # set the hostname to getcryst.al with ipv6 enabled -jade networking getcryst.al --ipv6 +$ crystal-jade networking getcryst.al --ipv6 ``` -### setup zramd +### Setup zramd ```sh # install and enable zramd -jade zramd +$ crystal-jade zramd ``` -### configure users +### Configure users ```sh # make a new user called nonRootHaver, without sudo, easytohack as the password and bash as the default shell -jade users new-user nonRootHaver easytohack bash +$ crystal-jade users new-user nonRootHaver easytohack bash # make a user called rootHaver, with sudo, omgsosuperhardtohack as the password and fish as the default shell -jade users new-user rootHaver omgsuperhardtohack fish --hasroot +$ crystal-jade users new-user rootHaver omgsuperhardtohack fish --hasroot ``` -### set root password +### Set root password ```sh # set the root password to 'muchSecurity,veryHardToHack' -jade users root-password muchSecurity,veryHardToHack +$ crystal-jade users root-password muchSecurity,veryHardToHack ``` -### install a desktop environment +### Install a desktop environment ```sh # install onyx -jade desktops onyx +$ crystal-jade desktops onyx # install gnome -jade desktops gnome +$ crystal-jade desktops gnome ``` -### setup timeshift +### Setup timeshift ```sh -jade setup-timeshift +$ crystal-jade setup-timeshift ``` -### setup flatpak +### Setup flatpak ```sh -jade flatpak +$ crystal-jade flatpak ``` -### debug logging +### Debug logging debug messages: ```sh -jade -v +$ crystal-jade -v ``` traces: ```sh -jade -vv +$ crystal-jade -vv ``` -## How to build: - -Tested on latest Cargo (1.60.0-nightly) +## Non-secret Secret +echo "$ crystal-jade_UWU=true" >> ~/.zshrc
+echo "$ crystal-jade_UWU=true" >> ~/.bashrc
+set -Ux $ crystal-jade_UWU true

+if you want to have your log and crash output be β€œcute” + +## πŸ™Œ Contributing + +If you'd like to contribute to **Jade**, please follow the [Crystal Linux contributing guidelines](https://git.getcryst.al/crystal/info/-/blob/main/CONTRIBUTING.md)! + +This project uses `rustup`, to set up `cargo` for **Jade** development, please follow the guidelines below: + #### Debug/development builds @@ -127,9 +123,10 @@ Tested on latest Cargo (1.60.0-nightly) - `cargo build --release` -## Non-secret Secret -echo "JADE_UWU=true" >> ~/.zshrc
-echo "JADE_UWU=true" >> ~/.bashrc
-set -Ux JADE_UWU true
-
-if you want to have your log and crash output be β€œcute” + + +## πŸ“œ License + +[GPLv3-only](https://choosealicense.com/licenses/gpl-3.0/) + +![](https://git.getcryst.al/crystal/misc/branding/-/raw/main/banners/README-banner.png) diff --git a/template.md b/template.md new file mode 100644 index 0000000..5cfbb45 --- /dev/null +++ b/template.md @@ -0,0 +1,65 @@ + +# {{name}} + +{{desc}} + + +## πŸ’‘ Features + +- {{feature_list}} + +## πŸ“š Documentation + +Documentation for this project is available [here](https://docs.getcryst.al)! + +**Support** is also available in our [Discord](https://getcryst.al/discord) and the [Matrix](https://matrix.to/#/#space:getcryst.al). If you face any issues with the software, feel free to open an issue on this repository. + + +## πŸ‘₯ Contributors + +A list of all **{{name}}** contributors is available in [CONTRIBUTORS.md](CONTRIBUTORS.md) + +For a list of **{{name}}** maintainers specifically, see [.gitlab/CODEOWNERS](.gitlab/CODEOWNERS) + + +## πŸ’Ύ Installation + +### πŸ’½ From Binary + +**Install {{name}} using `{{toolkit}}`** +```bash + $ {{toolkit}} install {{name}} + $ {{name}} +``` + + +### πŸ— From Source + +**Install {{name}} from source using `cargo`** +```bash +$ git clone https://git.getcryst.al/{{path}} && cd {{name}} +$ cargo install --path . +``` +## πŸ“Έ Screenshots + +![App Screenshot](https://via.placeholder.com/468x300?text=App+Screenshot+Here) + + +## πŸ™Œ Contributing + +If you'd like to contribute to **{{name}}**, please follow the [Crystal Linux contributing guidelines](https://git.getcryst.al/crystal/info/-/blob/main/CONTRIBUTING.md)! + +This project uses `{{toolkit}}`, to set up `{{toolkit}}` for **{{name}}** development, please follow the guidelines below: + +{{instructions}} + +We are also constantly looking for translators for our i18n-enabled projects! If you speak more than one language, consider helping out on our [Weblate](https://i18n.getcryst.al)! + +![https://i18n.getcryst.al/engage/crystal-linux/](https://i18n.getcryst.al/widgets/crystal-linux/-/287x66-black.png) + + +## πŸ“œ License + +[GPLv3-only](https://choosealicense.com/licenses/gpl-3.0/) + +![](https://git.getcryst.al/crystal/misc/branding/-/raw/main/banners/README-banner.png) From 33b9baa4775d5ad52a6c869904facbf631bd2e0c Mon Sep 17 00:00:00 2001 From: Hericium VEVO Date: Sat, 15 Apr 2023 18:41:45 +0000 Subject: [PATCH 2/3] Deleted template.md --- template.md | 65 ----------------------------------------------------- 1 file changed, 65 deletions(-) delete mode 100644 template.md diff --git a/template.md b/template.md deleted file mode 100644 index 5cfbb45..0000000 --- a/template.md +++ /dev/null @@ -1,65 +0,0 @@ - -# {{name}} - -{{desc}} - - -## πŸ’‘ Features - -- {{feature_list}} - -## πŸ“š Documentation - -Documentation for this project is available [here](https://docs.getcryst.al)! - -**Support** is also available in our [Discord](https://getcryst.al/discord) and the [Matrix](https://matrix.to/#/#space:getcryst.al). If you face any issues with the software, feel free to open an issue on this repository. - - -## πŸ‘₯ Contributors - -A list of all **{{name}}** contributors is available in [CONTRIBUTORS.md](CONTRIBUTORS.md) - -For a list of **{{name}}** maintainers specifically, see [.gitlab/CODEOWNERS](.gitlab/CODEOWNERS) - - -## πŸ’Ύ Installation - -### πŸ’½ From Binary - -**Install {{name}} using `{{toolkit}}`** -```bash - $ {{toolkit}} install {{name}} - $ {{name}} -``` - - -### πŸ— From Source - -**Install {{name}} from source using `cargo`** -```bash -$ git clone https://git.getcryst.al/{{path}} && cd {{name}} -$ cargo install --path . -``` -## πŸ“Έ Screenshots - -![App Screenshot](https://via.placeholder.com/468x300?text=App+Screenshot+Here) - - -## πŸ™Œ Contributing - -If you'd like to contribute to **{{name}}**, please follow the [Crystal Linux contributing guidelines](https://git.getcryst.al/crystal/info/-/blob/main/CONTRIBUTING.md)! - -This project uses `{{toolkit}}`, to set up `{{toolkit}}` for **{{name}}** development, please follow the guidelines below: - -{{instructions}} - -We are also constantly looking for translators for our i18n-enabled projects! If you speak more than one language, consider helping out on our [Weblate](https://i18n.getcryst.al)! - -![https://i18n.getcryst.al/engage/crystal-linux/](https://i18n.getcryst.al/widgets/crystal-linux/-/287x66-black.png) - - -## πŸ“œ License - -[GPLv3-only](https://choosealicense.com/licenses/gpl-3.0/) - -![](https://git.getcryst.al/crystal/misc/branding/-/raw/main/banners/README-banner.png) From 0d05e783c81b340e0719874c2fcf6ab36d9081eb Mon Sep 17 00:00:00 2001 From: Hericium VEVO Date: Sat, 15 Apr 2023 22:05:14 +0000 Subject: [PATCH 3/3] Update README.md --- README.md | 49 ++++++++++++++++++++++++++----------------------- 1 file changed, 26 insertions(+), 23 deletions(-) diff --git a/README.md b/README.md index a43e29f..0b7addf 100755 --- a/README.md +++ b/README.md @@ -8,104 +8,107 @@ Jade is an installer backend for crystal linux. ### Autopartition the drive ```sh # autopartition /dev/sda with efi enabled -$ crystal-jade partition auto /dev/sda --efi +# crystal-jade partition auto /dev/sda --efi # autopartition /dev/nvmen0 with efi disabled -$ crystal-jade partition auto /dev/nvmen0 +# crystal-jade partition auto /dev/nvmen0 ``` ### Install base packages ```sh -$ crystal-jade install-base +# crystal-jade install-base ``` ### Install bootloader ```sh # install as efi with esp being /boot/efi -$ crystal-jade bootloader grub-efi /boot/efi +# crystal-jade bootloader grub-efi /boot/efi # install as legacy on /dev/sda -$ crystal-jade bootloader grub-legacy /dev/sda +# crystal-jade bootloader grub-legacy /dev/sda ``` ### Generate fstab ```sh -$ crystal-jade genfstab +# crystal-jade genfstab ``` ### Configuring locale settings ```sh # set the keyboard layout to colemak, the timezone to Europe/Berlin and set en_US.UTF-8 as the locale -$ crystal-jade locale colemak Europe/Berlin en_US.UTF-8 UTF-8 +# crystal-jade locale colemak Europe/Berlin en_US.UTF-8 UTF-8 ``` ### Configure network settings ```sh # set the hostname to getcryst.al with ipv6 disabled -$ crystal-jade networking getcryst.al +# crystal-jade networking getcryst.al # set the hostname to getcryst.al with ipv6 enabled -$ crystal-jade networking getcryst.al --ipv6 +# crystal-jade networking getcryst.al --ipv6 ``` ### Setup zramd ```sh # install and enable zramd -$ crystal-jade zramd +# crystal-jade zramd ``` ### Configure users ```sh # make a new user called nonRootHaver, without sudo, easytohack as the password and bash as the default shell -$ crystal-jade users new-user nonRootHaver easytohack bash +# crystal-jade users new-user nonRootHaver easytohack bash # make a user called rootHaver, with sudo, omgsosuperhardtohack as the password and fish as the default shell -$ crystal-jade users new-user rootHaver omgsuperhardtohack fish --hasroot +# crystal-jade users new-user rootHaver omgsuperhardtohack fish --hasroot ``` ### Set root password ```sh # set the root password to 'muchSecurity,veryHardToHack' -$ crystal-jade users root-password muchSecurity,veryHardToHack +# crystal-jade users root-password muchSecurity,veryHardToHack ``` ### Install a desktop environment ```sh # install onyx -$ crystal-jade desktops onyx +# crystal-jade desktops onyx # install gnome -$ crystal-jade desktops gnome +# crystal-jade desktops gnome ``` ### Setup timeshift ```sh -$ crystal-jade setup-timeshift +# crystal-jade setup-timeshift ``` ### Setup flatpak ```sh -$ crystal-jade flatpak +# crystal-jade flatpak ``` ### Debug logging debug messages: ```sh -$ crystal-jade -v +# crystal-jade -v ``` traces: ```sh -$ crystal-jade -vv +# crystal-jade -vv ``` ## Non-secret Secret -echo "$ crystal-jade_UWU=true" >> ~/.zshrc
-echo "$ crystal-jade_UWU=true" >> ~/.bashrc
-set -Ux $ crystal-jade_UWU true
-
+$ echo "crystal-jade_UWU=true" >> ~/.zshrc + +$ echo "crystal-jade_UWU=true" >> ~/.bashrc + +$ set -Ux crystal-jade_UWU true + + if you want to have your log and crash output be β€œcute” ## πŸ™Œ Contributing