Plasma Wiki

docs/plasma.md

@@ -10,16 +10,156 @@ tags:
 
 !!! note
 
-    This does not require a Wiki page, it's here for reference as it has a full in-depth guide with a video included, on our [**Official Site**](https://xerolinux.xyz/news/xerolinux-plasma/){:target="_blank"} where we go over each step in detail. Follow it closely for best experience. I might port back to here in the future.
+    **Distro is Back** : If you want to skip all this, you can just *Donate* and grab the **XeroLinux** pre-built ISO from 👉 [**Re-Release Post**](https://xerolinux.xyz/iso/){:target="_blank"}
 
-### What it is
+### What this script is
 
-With the help of this script, you will be able to install **Plasma** in one of 4 methods as you can see in the image below. Not only that, but it will also fix **PipeWire** and **Bluetooth**.
+The intention of the **PlasmaInstall** script is *not* to replace **ArchInstall** but to fix its **KDE Plasma** profile while extending it further nothing more. The Toolkit can be used on any DE or WM it's agnostic.
+
+![type:video](https://www.youtube.com/embed/v0UPif52i5A)
+
+This script has an option to include my repo, **Chaotic-AUR**'s & Toolkit. Toolkit also includes the option to apply my rice. So if you opt to include it, you do not need to get other projects/tools separately. It’s meant as an All-in-One solution.
 
 <p align="center">
     <img src="https://i.imgur.com/TOZNp4j.png" alt="shot">
 </p>
 
-This script has an option to include my repo, **Chaotic-AUR**'s & Toolkit. Toolkit also includes the option to apply my rice. So if you opt to include it, you do not need to get other projects/tools separately. It’s meant as an All-in-One solution.
-
 ---
+
+<h1 align="center">.// The Wiki \\.</h1>
+
+In this super detailed guide I will be showing off how we can easily replicate the **XeroLinux** setup using **ArchInstall**.
+
+### The Guide
+
+#### System Preparation
+
+Let's start off by knowing what we need to get started. First off, we will need the latest version of the >> [**ArchLinux ISO**](https://archlinux.org/download/){:target="_blank"}, a USB stick to burn ISO onto, we can either use >> [**Balena Etcher**](https://etcher.balena.io/#download-etcher){:target="_blank"} or the highly recommended >> [**Ventoy**](https://xerolinux.xyz/posts/ventoy-multi-boot/){:target="_blank"}.
+
+Those are the essentials. As to my **Plasma Install** script will get to that a bit later down the line. Once we got everything, we shall begin...
+
+#### Installing ArchLinux
+
+Ok, so now that we have burned the ISO to the USB using either tools, boot the system we want to install it on using it. Am not gonna go through showing you how, you should know that by now lol.
+
+<p align="center">
+    <img src="https://i.imgur.com/RO64NWD.png" alt="shot">
+</p>
+
+**Note :**
+
+!!! warning
+
+    This guide expects you to be connected to the internet via ethernet. If you aren't and need to connect over WiFi, you can follow guide on the [**ArchWiki**](https://wiki.archlinux.org/title/Installation_guide#Connect_to_the_internet){:target="_blank"}
+
+- **Remote Install via SSH**
+
+Now, unlike other guides out there, I will be showing how we can use **SSH** to do the installation remotely, which will make things much easier. All we need is a secondary PC running **Linux**. If none is available, this part can be skipped.
+
+Ok, first things first, we need to set a password to the *root* user. We do it by typing the following command in the TTY, like this :
+
+```Bash
+passwd
+```
+
+Now we type our temporary password & confirm it. Once that's done, we need to get the machine's **IP Address**, we do that by running this command :
+
+```Bash
+ip a
+```
+
+Once we have it, all we need to do to connect to the machine is the following command :
+
+```Bash
+ssh root@ipaddress
+```
+
+We confirm by typing `yes`. That's it, now we are connected to the machine remotely, so we can now easily copy paste comands for a much simpler install...
+
+- **ArchInstall Script**
+
+Once connected, first thing we will have to do is, make sure we have latest version of **ArchInstall**. We do that by running the following command :
+
+```Bash
+pacman -Syy archinstall && archinstall --advanced
+```
+
+Now some of you might be asking me, "why the `--advanced` flag ?", to which I answer, simply because devs still hide the *parallel downloads* behind it for whatever reason. It's fine at least now you know.
+
+<p align="center">
+    <img src="https://i.imgur.com/OVzwVYt.png" alt="shot">
+</p>
+
+Ok, now that we have the installer running, am not going to go through each and every option one by one, just the important ones. Those are explained in the video. Am also not gonna bother with *manual partitioning* since the guide is intended for single OS easy install.
+
+That's why we will be using the **Best Guess** option, carefully selecting the correct drive we want install **ArchLinux** onto.
+
+!!! warning
+
+    **User Data** : I will not be held responsible for any data loss resulting from selection of the wrong drive. **BE VERY CAREFUL HERE**.
+
+Anyway, let's make sure we skip the parts I mentioned in the video, since everything will now be done **Post-Install** via my Toolkit. Don't forget to set parallel downloads to as many as you like for faster downloads. Also as mentioned, we do not need to enable any extra repos like *multilib* since my script will do that for us later on.
+
+Now once everything is configured and set, hit install, sit back, grab a cup of Tea/Coffee and watch it do its thing. Might take a while it all depends on Internet connection...
+
+#### Installing KDE Plasma
+
+Once that's all done, we will be prompted if we want to `chroot` into our new install, we answer with yes of course since we still have no DE yet.
+
+!!! tip
+
+    **Inspection**. We do not recommend to blindly execute scripts without inspecting them first. Check out the code >> [**Here**](https://tinyurl.com/PlasmaInstall){:target="_blank"}
+
+Once you trust it, you can move on. Now, depending on the method that was used, `ssh` or not, we either copy paste the command below or type it manually :
+
+```Bash
+bash -c "$(curl -fsSL https://tinyurl.com/PlasmaInstall)"
+```
+
+This will execute the script. Just go through the prompts. I would **Highly** recommend option **3) Xero's Curated Set Of Plasma Packages** to avoid any future headaches. I went through all groups with a fine tooth comb as the saying goes making sure we get the best experience. But that's not to say we cannot select any of the other options, it's all up to you in the end.
+
+<p align="center">
+    <img src="https://i.imgur.com/TOZNp4j.png" alt="shot">
+</p>
+
+At the end, script will prompt us if we want to enable the **XeroLinux** as wells as the **Chaotic-AUR** repos and install the Toolkit, to which we answer with yes, since we will be using it to set everything up later on.
+
+You will notice that, the *multilib* repo was enabled as well. I made sure of that since most newcomers forget to do it. It's an essential repo required for the likes of **Steam**, and various drivers.
+
+Finally, for now at least, once script is done, we will be prompted to exit and reboot the system. We do that by typing `exit` then `reboot`, and that's it for this part anyway...
+
+#### Setting up the system
+
+If all went smoothly, we should now be greeted with `SDDM`, **KDE**'s login page. Once logged in, there are a few things we need to take care of first. Open Terminal, as shown in video, and update the system
+
+```Bash
+sudo pacman -Syyu
+```
+
+Then we launch the **XeroLinux Post Installation Toolkit** from the AppMenu, under **System**. That's what we will be using from here on in.
+
+<p align="center">
+    <img src="https://i.imgur.com/JuWceYE.png" alt="shot">
+</p>
+
+It's up to you to discover all the options, that's why I did not mention them all in video, nor will I here. The whole point of this guide is how to get **XeroLinux** back not to set up the system from A to Z. For more info, check out the [**Toolkit Wiki**](https://wiki.xerolinux.xyz/xlapit/)
+
+- **1 : System Setup**
+
+There's nothing to do here except select **Install 3rd-Party GUI Package Manager(s)** or **Add & Enable the ChaoticAUR Repository**, since my **Plasma Script** took care of the rest for us. Neat eh ?
+
+- **2 : System Drivers**
+
+This is the part where you select drivers you need for our hardware. Am not going to help you here. All you need to know was mentioned in the video. Just know that selecting the wrong ones will break the system, so that's where you need to understand what works for you.
+
+- **4 : System Customization**
+
+Now we jump to Customization section. Just select option **x. XeroLinux's Layan Plasma 6 Rice**, enter your `sudo` password, and watch it do its thing.. Once it's done, we will be prompted to reboot. Use the AppMenu to do that..
+
+### Final words
+
+That's it boys n girls. We just got **XeroLinux** back ! The rest is up to you. Go through the toolkit see if you find anything useful. If you encounter any issues or have any questions, feel free to contact me on either **Fosstodon** or **Discord**, all links in the footer.
+
+I will do my best to answer. Keep in mind that I might not have all the answers, simply because I only have the hardware I have, might be different than yours, so can't know what works on something I do not own. Though I am and always will open to suggestions...
+
+Best of luck !!!!