initial commit

author: Cem Keylan <cem@ckyln.com> 2020-04-06 12:06:20 +0300
committer: Cem Keylan <cem@ckyln.com> 2020-04-06 12:06:20 +0300
commit: 979a10c2a68746565f330e871da2a0a112fa1604 (patch)
tree: edc502252ef282c7f67f40251300130aa4b094c1 /docs/wiki
download: website-979a10c2a68746565f330e871da2a0a112fa1604.tar.gz
14 files changed, 1102 insertions, 0 deletions
diff --git a/docs/wiki/boot/module-management.html b/docs/wiki/boot/module-management.html
new file mode 100644
index 0000000..a77685d
--- /dev/null
+++ b/docs/wiki/boot/module-management.html
@@ -0,0 +1,34 @@
+<!DOCTYPE HTML>
+<html lan="en">
+<head>
+<title>Module Management | Carbs Linux</title>
+<link rel="stylesheet" href="/assets/style.css">
+<meta charset="utf-8">
+<meta name="Description" content="Carbs Linux - a simple busybox linux distribution">
+<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
+</head>
+<p class=header><strong>Carbs Linux - a simple busybox linux distribution</strong></p>
+<div class="header"><nav>
+<a href='/'>index</a>
+<a href='https://github.com/CarbsLinux'>github</a>
+<a href='//dl.carbslinux.org'>downloads</a>
+<a href='/blog'>blog</a>
+<a href='/wiki'>wiki</a>
+<a href='/wiki/install.html'>installation</a>
+</nav></div><div class="border"></div>
+<h1>Module Management</h1>
+
+<p>With <strong>busybox-init</strong>, a module can be loaded at boot by adding such a line to your <code>inittab</code></p>
+
+<pre><code>::once:/bin/modprobe module-name
+</code></pre>
+
+<p>With <strong>sinit</strong>, a module can be loaded from your <code>/etc/rc.local</code> file. Add this to your file</p>
+
+<pre><code>/bin/modprobe module-name
+</code></pre>
+<a href="/wiki/boot/module-management.txt">View Page Source</a><div class=border></div>
+<p class=footer>Linux® is a registered trademark of Linus Torvalds</p>
+<p class=footer>Copyright © 2019-2020 Cem Keylan</p>
+</body>
+</html>
diff --git a/docs/wiki/boot/module-management.txt b/docs/wiki/boot/module-management.txt
new file mode 100644
index 0000000..96256c1
--- /dev/null
+++ b/docs/wiki/boot/module-management.txt
@@ -0,0 +1,14 @@
+
+Module Management
+=================
+
+With **busybox-init**, a module can be loaded at boot by adding such a line to your `inittab`
+
+    ::once:/bin/modprobe module-name
+
+
+With **sinit**, a module can be loaded from your `/etc/rc.local` file. Add this to your file
+
+    /bin/modprobe module-name
+
+
diff --git a/docs/wiki/index.html b/docs/wiki/index.html
new file mode 100644
index 0000000..b787450
--- /dev/null
+++ b/docs/wiki/index.html
@@ -0,0 +1,41 @@
+<!DOCTYPE HTML>
+<html lan="en">
+<head>
+<title>index | Carbs Linux</title>
+<link rel="stylesheet" href="/assets/style.css">
+<meta charset="utf-8">
+<meta name="Description" content="Carbs Linux - a simple busybox linux distribution">
+<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
+</head>
+<p class=header><strong>Carbs Linux - a simple busybox linux distribution</strong></p>
+<div class="header"><nav>
+<a href='/'>index</a>
+<a href='https://github.com/CarbsLinux'>github</a>
+<a href='//dl.carbslinux.org'>downloads</a>
+<a href='/blog'>blog</a>
+<a href='/wiki'>wiki</a>
+<a href='/wiki/install.html'>installation</a>
+</nav></div><div class="border"></div>
+<h1>Wiki</h1>
+
+<p>Welcome to the Carbs Linux wiki! This wiki is open for access,
+and can be edited freely by anyone who wants to contribute.</p>
+
+<p>If you want to make a contribution, go to <a href="https://github.com/CarbsLinux/wiki">https://github.com/CarbsLinux/wiki</a></p>
+
+<h2>Content</h2>
+
+<ul>
+<li><a href="boot/module-management.html">Module Management</a></li>
+<li><a href="init/switching-to-sinit.html">Switching to Sinit</a></li>
+<li><a href="install.html">Install</a></li>
+<li><a href="keymaps/X-keymaps.html">X-keymaps</a></li>
+<li><a href="keymaps/keymaps.html">Keymaps in TTY</a></li>
+<li><a href="system/service-management.html">Service Management</a></li>
+</ul>
+
+<a href="/wiki/index.txt">View Page Source</a><div class=border></div>
+<p class=footer>Linux® is a registered trademark of Linus Torvalds</p>
+<p class=footer>Copyright © 2019-2020 Cem Keylan</p>
+</body>
+</html>
diff --git a/docs/wiki/index.txt b/docs/wiki/index.txt
new file mode 100644
index 0000000..dd27004
--- /dev/null
+++ b/docs/wiki/index.txt
@@ -0,0 +1,17 @@
+Wiki
+====
+
+Welcome to the Carbs Linux wiki! This wiki is open for access,
+and can be edited freely by anyone who wants to contribute.
+
+If you want to make a contribution, go to <https://github.com/CarbsLinux/wiki>
+
+Content
+-------
+
+* [Module Management](boot/module-management.html)
+* [Switching to Sinit](init/switching-to-sinit.html)
+* [Install](install.html)
+* [X-keymaps](keymaps/X-keymaps.html)
+* [Keymaps in TTY](keymaps/keymaps.html)
+* [Service Management](system/service-management.html)
diff --git a/docs/wiki/init/switching-to-sinit.html b/docs/wiki/init/switching-to-sinit.html
new file mode 100644
index 0000000..775e01c
--- /dev/null
+++ b/docs/wiki/init/switching-to-sinit.html
@@ -0,0 +1,68 @@
+<!DOCTYPE HTML>
+<html lan="en">
+<head>
+<title>Switching to Sinit | Carbs Linux</title>
+<link rel="stylesheet" href="/assets/style.css">
+<meta charset="utf-8">
+<meta name="Description" content="Carbs Linux - a simple busybox linux distribution">
+<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
+</head>
+<p class=header><strong>Carbs Linux - a simple busybox linux distribution</strong></p>
+<div class="header"><nav>
+<a href='/'>index</a>
+<a href='https://github.com/CarbsLinux'>github</a>
+<a href='//dl.carbslinux.org'>downloads</a>
+<a href='/blog'>blog</a>
+<a href='/wiki'>wiki</a>
+<a href='/wiki/install.html'>installation</a>
+</nav></div><div class="border"></div>
+<h1>Switching to Sinit</h1>
+
+<p>Carbs Linux runs <code>busybox-init</code> by default. You can switch to
+anything else you desire, but only busybox-init and sinit are
+officially supported. Switching to sinit is extremely easy, you
+can be up and running within minutes. The only &ldquo;hard&rdquo; requirement
+is an environment you will be chrooting in. So, let&rsquo;s begin!</p>
+
+<h2>Preparing your environment</h2>
+
+<p>From your other environment, download the kiss-chroot utility
+and make it executable.</p>
+
+<pre><code>$ wget https://dl.getkiss.org/kiss-chroot
+$ chmod +x kiss-chroot
+
+# From your environment start the chroot
+$ kiss-chroot /mnt
+</code></pre>
+
+<h2>Removing busybox-init</h2>
+
+<p>Now that we are in chroot environment, let&rsquo;s remove busybox-init.</p>
+
+<pre><code>$ kiss r busybox-init
+</code></pre>
+
+<h2>Installing and configuring sinit</h2>
+
+<p>Build and install sinit</p>
+
+<pre><code>$ kiss b sinit
+$ kiss i sinit
+</code></pre>
+
+<p>Open up your <code>/etc/init/rc.conf</code> now and uncomment
+the variables regarding SINIT. You are ready now.</p>
+
+<p>If you edited your inittab, make sure you reflect your changes
+on the <code>/etc/init/sinit-launch-services.boot</code> file.</p>
+
+<h2>Finishing up</h2>
+
+<p>If all of the above is done, simply exit the chroot and reboot.
+Sinit should be functioning without any issues.</p>
+<a href="/wiki/init/switching-to-sinit.txt">View Page Source</a><div class=border></div>
+<p class=footer>Linux® is a registered trademark of Linus Torvalds</p>
+<p class=footer>Copyright © 2019-2020 Cem Keylan</p>
+</body>
+</html>
diff --git a/docs/wiki/init/switching-to-sinit.txt b/docs/wiki/init/switching-to-sinit.txt
new file mode 100644
index 0000000..3bee312
--- /dev/null
+++ b/docs/wiki/init/switching-to-sinit.txt
@@ -0,0 +1,51 @@
+
+Switching to Sinit
+==================
+
+Carbs Linux runs `busybox-init` by default. You can switch to
+anything else you desire, but only busybox-init and sinit are
+officially supported. Switching to sinit is extremely easy, you
+can be up and running within minutes. The only "hard" requirement
+is an environment you will be chrooting in. So, let's begin!
+
+
+Preparing your environment
+--------------------------
+
+From your other environment, download the kiss-chroot utility 
+and make it executable.
+
+    $ wget https://dl.getkiss.org/kiss-chroot
+    $ chmod +x kiss-chroot
+    
+    # From your environment start the chroot
+    $ kiss-chroot /mnt
+
+Removing busybox-init
+---------------------
+
+Now that we are in chroot environment, let's remove busybox-init.
+
+    $ kiss r busybox-init
+
+
+Installing and configuring sinit
+--------------------------------
+
+Build and install sinit
+
+    $ kiss b sinit
+    $ kiss i sinit
+
+Open up your `/etc/init/rc.conf` now and uncomment
+the variables regarding SINIT. You are ready now.
+
+If you edited your inittab, make sure you reflect your changes
+on the `/etc/init/sinit-launch-services.boot` file.
+
+
+Finishing up
+------------
+
+If all of the above is done, simply exit the chroot and reboot.
+Sinit should be functioning without any issues.
diff --git a/docs/wiki/install.html b/docs/wiki/install.html
new file mode 100644
index 0000000..4c391a1
--- /dev/null
+++ b/docs/wiki/install.html
@@ -0,0 +1,333 @@
+<!DOCTYPE HTML>
+<html lan="en">
+<head>
+<title>Install | Carbs Linux</title>
+<link rel="stylesheet" href="/assets/style.css">
+<meta charset="utf-8">
+<meta name="Description" content="Carbs Linux - a simple busybox linux distribution">
+<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
+</head>
+<p class=header><strong>Carbs Linux - a simple busybox linux distribution</strong></p>
+<div class="header"><nav>
+<a href='/'>index</a>
+<a href='https://github.com/CarbsLinux'>github</a>
+<a href='//dl.carbslinux.org'>downloads</a>
+<a href='/blog'>blog</a>
+<a href='/wiki'>wiki</a>
+<a href='/wiki/install.html'>installation</a>
+</nav></div><div class="border"></div>
+<h1>Installation Instructions</h1>
+
+<p>This post will guide you step-by-step in order to install
+Carbs Linux. It is not complete yet.</p>
+
+<h2>Downloading and Getting Ready to Chroot</h2>
+
+<p>Installing Carbs Linux is the same as installing most
+rootfs distributions, such as Gentoo, or Void Linux.</p>
+
+<h3>Requirements</h3>
+
+<p>You simply need a Live Linux ISO. Gentoo would be the best
+as programs you will require will be already there. Get the
+ISO, boot it and set up your network.</p>
+
+<p><strong>Required Programs:</strong></p>
+
+<ul>
+<li>tar</li>
+<li>wget</li>
+<li>xz</li>
+</ul>
+
+
+<p>Rest of the instructions assume that you have set all of these
+up, and will continue on.</p>
+
+<h3>Download</h3>
+
+<p>First, we need to download the rootfs tarball. In your terminal
+type</p>
+
+<pre><code>$ wget https://carbslinux.org/releases/carbs-rootfs-20191210.tar.xz
+</code></pre>
+
+<h3>Check the integrity of the tarball</h3>
+
+<p>While optional, it is highly recommended to check the integrity
+of the tarball.</p>
+
+<pre><code>$ wget https://carbslinux.org/releases/carbs-rootfs-20191210.tar.xz.sha256sum
+$ sha256sum -c carbs-rootfs-20191210.tar.xz.sha256sum
+</code></pre>
+
+<h3>Check the signatures</h3>
+
+<p>While optional, it is highly recommended to check the signature
+of the tarball</p>
+
+<pre><code>$ wget https://carbslinux.org/releases/carbs-rootfs-20191210.tar.xz.sig
+
+Import the public key of release@carbslinux.org
+
+$ gpg --recv-keys FF484BDFEFCEF8FF
+
+$ gpg --verify carbs-rootfs-20191210.tar.xz.sig
+</code></pre>
+
+<h3>Download Kiss Linux Chroot Helper</h3>
+
+<pre><code>$ wget https://dl.getkiss.org/kiss-chroot
+
+Make the script executable
+
+$ chmod +x kiss-chroot
+</code></pre>
+
+<h3>Extract the rootfs tarball</h3>
+
+<p>You need to extract the tarball to your mounted partition</p>
+
+<pre><code>$ tar xvpf carbs-rootfs-20191210.tar.xz -C /mnt
+</code></pre>
+
+<h2>Chroot</h2>
+
+<p>Chroot into Carbs Linux</p>
+
+<pre><code>$ ./kiss-chroot /mnt
+</code></pre>
+
+<h3>Enable repository signing (Highly Recommended)</h3>
+
+<p>This step is optional, but very highly recommended
+(I cannot stress out the amount I am recommending this).
+This ensures you are receiving updates from Carbs Linux
+and not some other source.</p>
+
+<p><strong>Install GnuPG</strong></p>
+
+<p>It is also a great time to learn how to use your new
+package manager, KISS! You simply build and install
+the package</p>
+
+<pre><code>$ kiss build gnupg1
+$ kiss install gnupg1
+</code></pre>
+
+<p><strong>Import my key</strong></p>
+
+<pre><code>Import my public key (cem@ckyln.com)
+
+$ gpg --recv-key 4356EE08A364CE09
+
+Create a .gnupg directory if it doesn't exist
+
+$ mkdir -p /root/.gnupg
+
+Trust my public key
+
+$ echo trusted-key 0x4356ee08a364ce09 &gt;&gt; /root/.gnupg/gpg.conf
+</code></pre>
+
+<p><strong>Enable signature verification</strong></p>
+
+<p>Git has a built in signature verification feature.
+You can go to the repository directory and enable it</p>
+
+<pre><code>$ cd /var/db/kiss/repo
+$ git config merge.verifySignatures true
+</code></pre>
+
+<h3>Installing Important Tools</h3>
+
+<p>Since Carbs gives you one of the most minimal base,
+you might need to apply some add-ons to your system.</p>
+
+<p><strong>Update packages</strong></p>
+
+<p>It might be a good idea to update your packages before
+installing new packages. This ensure compatibility.</p>
+
+<pre><code>$ kiss update
+</code></pre>
+
+<p><strong>Filesystems</strong></p>
+
+<p>Currently, e2fsprogs and dosfstools are supported,
+as they are the most-used filesystems.</p>
+
+<pre><code>Support for ext2, ext3, and ex4
+
+$ kiss build e2fsprogs
+$ kiss install e2fsprogs
+
+Support for dosfstools
+
+$ kiss build dosfstools
+$ kiss install dosfstools
+</code></pre>
+
+<p><strong>Device management</strong></p>
+
+<pre><code>$ kiss build eudev
+$ kiss install eudev
+</code></pre>
+
+<p><strong>Wireless</strong></p>
+
+<p><strong>wpa_supplicant</strong></p>
+
+<pre><code>$ kiss build wpa_supplicant
+$ kiss install wpa_supplicant
+</code></pre>
+
+<p><strong>eiwd (WIP)</strong></p>
+
+<pre><code>$ kiss build eiwd
+$ kiss install eiwd
+</code></pre>
+
+<p><strong>dhcpcd</strong></p>
+
+<pre><code>$ kiss build dhcpcd
+$ kiss install dhcpcd
+</code></pre>
+
+<p><strong>Shells</strong></p>
+
+<p>Carbs Linux comes preinstalled with busybox ash, but other shells
+can be found on the repository</p>
+
+<pre><code>Install bash
+
+$ kiss build bash
+$ kiss install bash
+
+Install zsh
+
+$ kiss build zsh
+$ kiss install zsh
+
+Install Plan9 rc-shell
+
+$ kiss build 9base
+$ kiss install 9base
+</code></pre>
+
+<h3>Install the Kernel</h3>
+
+<p>Next step is installing the kernel, which might sound as a challenge
+you should download and extract the kernel tarball first.</p>
+
+<pre><code>$ wget https://cdn.kernel.org/pub/linux/kernel/v5.x/linux-5.5.tar.xz
+
+Let's move the sources to /usr/src
+
+$ mv linux-5.5.tar.xz /usr/src
+$ tar xf linux-5.5.tar.xz
+$ cd linux-5.5
+</code></pre>
+
+<p><strong>Configure the Kernel</strong></p>
+
+<p>You can check <a href="https://wiki.gentoo.org/wiki/Kernel/Configuration">https://wiki.gentoo.org/wiki/Kernel/Configuration</a>
+to learn more about kernel configuration. Overall, <a href="https://wiki.gentoo.org">Gentoo Wiki</a>
+is a good place to learn about kernel configuration related to
+your hardware.</p>
+
+<p><strong>Build and install the kernel</strong></p>
+
+<p>The rest of it is simple, build the kernel with
+<code>make</code> and install it with <code>make install</code></p>
+
+<h3>Bootloader</h3>
+
+<p>The default bootloader is GRUB (GRand Unified Bootloader).</p>
+
+<p>Build and install GRUB</p>
+
+<pre><code>$ kiss b grub
+$ kiss i grub
+
+Install efibootmgr as well if your
+system requires it
+
+$ kiss b efibootmgr
+$ kiss i efibootmgr
+</code></pre>
+
+<p><strong>Setup GRUB</strong></p>
+
+<pre><code>For BIOS:
+$ grub-install --target=i386-pc /dev/sdX
+
+For UEFI:
+$ grub-install --target=x86_64-efi --efi-directory=esp --bootloader-id=CarbsLinux
+
+$ grub-mkconfig -o /boot/grub/grub.cfg
+</code></pre>
+
+<h3>Install init</h3>
+
+<p>Currently, default init for Carbs Linux is <code>sinit</code>, but
+busybox-init is also supported. You can also change this yourself.</p>
+
+<p>To install init, you have to</p>
+
+<pre><code>$ kiss b sinit
+$ kiss i sinit
+</code></pre>
+
+<p>This will also fetch busybox-init as its dependency.</p>
+
+<h3>Enabling other repositories</h3>
+
+<p>There are other repositories out there that might be of your
+interest. The Official Repositories come with community and testing
+repositories that are not enabled by default. You could also want to
+add the Kiss Linux community repository, or someone&rsquo;s personal kiss
+repository.</p>
+
+<p><strong>Obtaining repositories</strong></p>
+
+<p>Obtaining a repository is as simple as a git clone. You can do it
+with Cem&rsquo;s personal repository as an example, but any other repository
+will be the same.</p>
+
+<pre><code># Clone the repository to your desired location
+# Optionally add "--depth 1" to save precious disk space
+
+$ git clone --depth 1 git://git.ckyln.com/kiss-repository /var/db/kiss/cem-repository
+</code></pre>
+
+<p>That&rsquo;s it, you have obtained a new repository!</p>
+
+<p><strong>Adding a repository to your KISS_PATH</strong></p>
+
+<p>Now that we have obtained Cem&rsquo;s repository, we can add it to our KISS_PATH!</p>
+
+<p>We need to edit <code>/etc/profile.d/kiss_path.sh</code> for this, but you
+can also change your KISS_PATH from your shellrc.</p>
+
+<p>Add the full path to the repository, in this case
+<code>/var/db/kiss/cem-repository/cem</code> to the variable
+and add a <code>:</code> before/after it.</p>
+
+<p>It must be looking like this.</p>
+
+<pre><code>export KISS_PATH=/var/db/kiss/repo/core:/var/db/kiss/repo/extra:/var/db/kiss/repo/xorg:/var/db/kiss/cem-repository/cem
+</code></pre>
+
+<p>Update your shell variables by doing <code>. /etc/profile.d/kiss_path.sh</code> so you can
+immediately access the repository packages</p>
+
+<h2>More</h2>
+
+<p>You should now be able to boot into you Carbs Linux installation.
+To learn more, you can visit the <a href="//carbslinux.org/wiki">wiki</a></p>
+<a href="/wiki/install.txt">View Page Source</a><div class=border></div>
+<p class=footer>Linux® is a registered trademark of Linus Torvalds</p>
+<p class=footer>Copyright © 2019-2020 Cem Keylan</p>
+</body>
+</html>
diff --git a/docs/wiki/install.txt b/docs/wiki/install.txt
new file mode 100644
index 0000000..2f86b76
--- /dev/null
+++ b/docs/wiki/install.txt
@@ -0,0 +1,303 @@
+
+Installation Instructions
+=========================
+
+This post will guide you step-by-step in order to install
+Carbs Linux. It is not complete yet.
+
+
+Downloading and Getting Ready to Chroot
+---------------------------------------
+
+Installing Carbs Linux is the same as installing most 
+rootfs distributions, such as Gentoo, or Void Linux.
+
+
+### Requirements
+
+You simply need a Live Linux ISO. Gentoo would be the best
+as programs you will require will be already there. Get the
+ISO, boot it and set up your network.
+
+**Required Programs:**
+
+* tar
+* wget
+* xz
+
+Rest of the instructions assume that you have set all of these
+up, and will continue on.
+
+
+### Download
+
+
+First, we need to download the rootfs tarball. In your terminal
+type
+
+    $ wget https://carbslinux.org/releases/carbs-rootfs-20191210.tar.xz
+
+
+### Check the integrity of the tarball
+
+While optional, it is highly recommended to check the integrity
+of the tarball.
+
+    $ wget https://carbslinux.org/releases/carbs-rootfs-20191210.tar.xz.sha256sum
+    $ sha256sum -c carbs-rootfs-20191210.tar.xz.sha256sum
+
+
+### Check the signatures
+
+While optional, it is highly recommended to check the signature 
+of the tarball
+
+    $ wget https://carbslinux.org/releases/carbs-rootfs-20191210.tar.xz.sig
+    
+    Import the public key of release@carbslinux.org
+    
+    $ gpg --recv-keys FF484BDFEFCEF8FF
+    
+    $ gpg --verify carbs-rootfs-20191210.tar.xz.sig
+
+### Download Kiss Linux Chroot Helper
+
+    $ wget https://dl.getkiss.org/kiss-chroot
+    
+    Make the script executable
+    
+    $ chmod +x kiss-chroot
+
+### Extract the rootfs tarball
+
+You need to extract the tarball to your mounted partition
+
+    $ tar xvpf carbs-rootfs-20191210.tar.xz -C /mnt
+
+Chroot
+------
+Chroot into Carbs Linux
+
+    $ ./kiss-chroot /mnt
+
+### Enable repository signing (Highly Recommended)
+
+This step is optional, but very highly recommended 
+(I cannot stress out the amount I am recommending this). 
+This ensures you are receiving updates from Carbs Linux 
+and not some other source.
+
+**Install GnuPG**
+
+It is also a great time to learn how to use your new 
+package manager, KISS! You simply build and install
+the package
+
+    $ kiss build gnupg1
+    $ kiss install gnupg1
+
+**Import my key**
+
+
+    Import my public key (cem@ckyln.com)
+    
+    $ gpg --recv-key 4356EE08A364CE09
+    
+    Create a .gnupg directory if it doesn't exist
+    
+    $ mkdir -p /root/.gnupg
+    
+    Trust my public key
+    
+    $ echo trusted-key 0x4356ee08a364ce09 >> /root/.gnupg/gpg.conf
+
+**Enable signature verification**
+
+
+Git has a built in signature verification feature.
+You can go to the repository directory and enable it
+
+    $ cd /var/db/kiss/repo
+    $ git config merge.verifySignatures true
+
+### Installing Important Tools
+
+Since Carbs gives you one of the most minimal base,
+you might need to apply some add-ons to your system.
+
+**Update packages**
+
+It might be a good idea to update your packages before
+installing new packages. This ensure compatibility.
+
+    $ kiss update
+
+**Filesystems**
+
+
+Currently, e2fsprogs and dosfstools are supported,
+as they are the most-used filesystems.
+
+    Support for ext2, ext3, and ex4
+    
+    $ kiss build e2fsprogs
+    $ kiss install e2fsprogs
+    
+    Support for dosfstools
+    
+    $ kiss build dosfstools
+    $ kiss install dosfstools
+
+**Device management**
+
+    $ kiss build eudev
+    $ kiss install eudev
+
+**Wireless**
+
+**wpa_supplicant**
+
+    $ kiss build wpa_supplicant
+    $ kiss install wpa_supplicant
+
+**eiwd (WIP)**
+
+    $ kiss build eiwd
+    $ kiss install eiwd
+
+**dhcpcd**
+
+    $ kiss build dhcpcd
+    $ kiss install dhcpcd
+
+**Shells**
+
+Carbs Linux comes preinstalled with busybox ash, but other shells
+can be found on the repository
+
+    Install bash
+    
+    $ kiss build bash
+    $ kiss install bash
+    
+    Install zsh
+    
+    $ kiss build zsh
+    $ kiss install zsh
+
+    Install Plan9 rc-shell
+
+    $ kiss build 9base
+    $ kiss install 9base
+
+### Install the Kernel
+
+
+Next step is installing the kernel, which might sound as a challenge
+you should download and extract the kernel tarball first.
+
+    $ wget https://cdn.kernel.org/pub/linux/kernel/v5.x/linux-5.5.tar.xz
+    
+    Let's move the sources to /usr/src
+    
+    $ mv linux-5.5.tar.xz /usr/src
+    $ tar xf linux-5.5.tar.xz
+    $ cd linux-5.5
+
+**Configure the Kernel**
+
+You can check <https://wiki.gentoo.org/wiki/Kernel/Configuration>
+to learn more about kernel configuration. Overall, [Gentoo Wiki](https://wiki.gentoo.org)
+is a good place to learn about kernel configuration related to
+your hardware.
+
+**Build and install the kernel**
+
+The rest of it is simple, build the kernel with
+`make` and install it with `make install`
+
+### Bootloader
+
+The default bootloader is GRUB (GRand Unified Bootloader).
+
+Build and install GRUB
+
+    $ kiss b grub
+    $ kiss i grub
+    
+    Install efibootmgr as well if your
+    system requires it
+    
+    $ kiss b efibootmgr
+    $ kiss i efibootmgr
+
+
+**Setup GRUB**
+
+    For BIOS:
+    $ grub-install --target=i386-pc /dev/sdX
+    
+    For UEFI:
+    $ grub-install --target=x86_64-efi --efi-directory=esp --bootloader-id=CarbsLinux
+    
+    $ grub-mkconfig -o /boot/grub/grub.cfg
+
+
+### Install init
+
+Currently, default init for Carbs Linux is `sinit`, but
+busybox-init is also supported. You can also change this yourself.
+
+To install init, you have to
+
+    $ kiss b sinit
+    $ kiss i sinit
+
+This will also fetch busybox-init as its dependency.
+
+
+### Enabling other repositories
+
+There are other repositories out there that might be of your
+interest. The Official Repositories come with community and testing
+repositories that are not enabled by default. You could also want to
+add the Kiss Linux community repository, or someone's personal kiss
+repository.
+
+**Obtaining repositories**
+
+Obtaining a repository is as simple as a git clone. You can do it
+with Cem's personal repository as an example, but any other repository
+will be the same.
+
+    # Clone the repository to your desired location
+    # Optionally add "--depth 1" to save precious disk space
+    
+    $ git clone --depth 1 git://git.ckyln.com/kiss-repository /var/db/kiss/cem-repository
+
+That's it, you have obtained a new repository!
+
+<strong>Adding a repository to your KISS_PATH</strong>
+
+Now that we have obtained Cem's repository, we can add it to our KISS\_PATH!
+
+We need to edit `/etc/profile.d/kiss_path.sh` for this, but you
+can also change your KISS\_PATH from your shellrc.
+
+Add the full path to the repository, in this case
+`/var/db/kiss/cem-repository/cem` to the variable
+and add a `:` before/after it.
+
+It must be looking like this.
+
+    export KISS_PATH=/var/db/kiss/repo/core:/var/db/kiss/repo/extra:/var/db/kiss/repo/xorg:/var/db/kiss/cem-repository/cem
+
+Update your shell variables by doing `. /etc/profile.d/kiss_path.sh` so you can
+immediately access the repository packages
+
+
+More
+----
+
+You should now be able to boot into you Carbs Linux installation. 
+To learn more, you can visit the [wiki](//carbslinux.org/wiki)
diff --git a/docs/wiki/keymaps/X-keymaps.html b/docs/wiki/keymaps/X-keymaps.html
new file mode 100644
index 0000000..960ba5c
--- /dev/null
+++ b/docs/wiki/keymaps/X-keymaps.html
@@ -0,0 +1,23 @@
+<!DOCTYPE HTML>
+<html lan="en">
+<head>
+<title>X-keymaps | Carbs Linux</title>
+<link rel="stylesheet" href="/assets/style.css">
+<meta charset="utf-8">
+<meta name="Description" content="Carbs Linux - a simple busybox linux distribution">
+<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
+</head>
+<p class=header><strong>Carbs Linux - a simple busybox linux distribution</strong></p>
+<div class="header"><nav>
+<a href='/'>index</a>
+<a href='https://github.com/CarbsLinux'>github</a>
+<a href='//dl.carbslinux.org'>downloads</a>
+<a href='/blog'>blog</a>
+<a href='/wiki'>wiki</a>
+<a href='/wiki/install.html'>installation</a>
+</nav></div><div class="border"></div>
+<a href="/wiki/keymaps/X-keymaps.txt">View Page Source</a><div class=border></div>
+<p class=footer>Linux® is a registered trademark of Linus Torvalds</p>
+<p class=footer>Copyright © 2019-2020 Cem Keylan</p>
+</body>
+</html>
diff --git a/docs/wiki/keymaps/X-keymaps.txt b/docs/wiki/keymaps/X-keymaps.txt
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/docs/wiki/keymaps/X-keymaps.txt
diff --git a/docs/wiki/keymaps/keymaps.html b/docs/wiki/keymaps/keymaps.html
new file mode 100644
index 0000000..15a24e5
--- /dev/null
+++ b/docs/wiki/keymaps/keymaps.html
@@ -0,0 +1,74 @@
+<!DOCTYPE HTML>
+<html lan="en">
+<head>
+<title>Keymaps in TTY | Carbs Linux</title>
+<link rel="stylesheet" href="/assets/style.css">
+<meta charset="utf-8">
+<meta name="Description" content="Carbs Linux - a simple busybox linux distribution">
+<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
+</head>
+<p class=header><strong>Carbs Linux - a simple busybox linux distribution</strong></p>
+<div class="header"><nav>
+<a href='/'>index</a>
+<a href='https://github.com/CarbsLinux'>github</a>
+<a href='//dl.carbslinux.org'>downloads</a>
+<a href='/blog'>blog</a>
+<a href='/wiki'>wiki</a>
+<a href='/wiki/install.html'>installation</a>
+</nav></div><div class="border"></div>
+<h1>Installing and Using Keymaps</h1>
+
+<p>Unlike most other distributions out there
+Carbs Linux does not come preinstalled with console
+keys. You probably won&rsquo;t be using more than
+two either. There are two ways of using keymaps</p>
+
+<h2>Installing the &ldquo;bkeymaps&rdquo; package</h2>
+
+<p>You can get the <code>bkeymaps</code> package from the
+<a href="https://github.com/kisslinux/community">KISS community repository</a>.</p>
+
+<p>Build and install <code>bkeymaps</code>.</p>
+
+<pre><code>-&gt; kiss b bkeymaps
+-&gt; kiss i bkeymaps
+</code></pre>
+
+<p>Now you can find the keymaps in <code>/usr/share/bkeymaps</code>.</p>
+
+<h2>Downloading the keymaps you require</h2>
+
+<p><em>This will assume that you are using the us keyboard layout</em></p>
+
+<p>You firstly will need to go to <a href="https://dev.alpinelinux.org/bkeymaps/">https://dev.alpinelinux.org/bkeymaps/</a>
+and download the keymap you need</p>
+
+<h2>Loading keymap, doing it on login/boot</h2>
+
+<ul>
+<li>Run <code>loadkmap &lt; file</code> to load the keymap.</li>
+</ul>
+
+
+<p><strong>Load keymap at login</strong></p>
+
+<p>If you want to load a keymap at login, you can
+add the command above to your <code>.profile</code> file.</p>
+
+<p><strong>Load keymap at boot</strong></p>
+
+<p>You can also load keymap during boot. You should edit
+<code>/lib/init/rc.boot</code> file and add something like</p>
+
+<pre><code># assuming you are using trq as your keymap
+log "Setting keymap to trq..."; {
+    loadkmap &lt; /path/to/trq.bmap
+}
+</code></pre>
+
+<p>to your main function.</p>
+<a href="/wiki/keymaps/keymaps.txt">View Page Source</a><div class=border></div>
+<p class=footer>Linux® is a registered trademark of Linus Torvalds</p>
+<p class=footer>Copyright © 2019-2020 Cem Keylan</p>
+</body>
+</html>
diff --git a/docs/wiki/keymaps/keymaps.txt b/docs/wiki/keymaps/keymaps.txt
new file mode 100644
index 0000000..89a7e8c
--- /dev/null
+++ b/docs/wiki/keymaps/keymaps.txt
@@ -0,0 +1,52 @@
+
+Installing and Using Keymaps
+============================
+
+Unlike most other distributions out there
+Carbs Linux does not come preinstalled with console 
+keys. You probably won't be using more than 
+two either. There are two ways of using keymaps
+
+Installing the "bkeymaps" package
+---------------------------------
+
+You can get the `bkeymaps` package from the
+[KISS community repository](https://github.com/kisslinux/community).
+
+Build and install `bkeymaps`.
+
+    -> kiss b bkeymaps
+    -> kiss i bkeymaps
+
+Now you can find the keymaps in `/usr/share/bkeymaps`.
+
+
+Downloading the keymaps you require
+-----------------------------------
+
+*This will assume that you are using the us keyboard layout*
+
+You firstly will need to go to <https://dev.alpinelinux.org/bkeymaps/>
+and download the keymap you need
+
+Loading keymap, doing it on login/boot
+--------------------------------------
+
+- Run `loadkmap < file` to load the keymap.
+
+**Load keymap at login**
+
+If you want to load a keymap at login, you can
+add the command above to your `.profile` file.
+
+**Load keymap at boot**
+
+You can also load keymap during boot. You should edit
+`/lib/init/rc.boot` file and add something like
+
+    # assuming you are using trq as your keymap
+    log "Setting keymap to trq..."; {
+        loadkmap < /path/to/trq.bmap
+    }
+
+to your main function.
diff --git a/docs/wiki/system/service-management.html b/docs/wiki/system/service-management.html
new file mode 100644
index 0000000..40d9c54
--- /dev/null
+++ b/docs/wiki/system/service-management.html
@@ -0,0 +1,53 @@
+<!DOCTYPE HTML>
+<html lan="en">
+<head>
+<title>Service Management | Carbs Linux</title>
+<link rel="stylesheet" href="/assets/style.css">
+<meta charset="utf-8">
+<meta name="Description" content="Carbs Linux - a simple busybox linux distribution">
+<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
+</head>
+<p class=header><strong>Carbs Linux - a simple busybox linux distribution</strong></p>
+<div class="header"><nav>
+<a href='/'>index</a>
+<a href='https://github.com/CarbsLinux'>github</a>
+<a href='//dl.carbslinux.org'>downloads</a>
+<a href='/blog'>blog</a>
+<a href='/wiki'>wiki</a>
+<a href='/wiki/install.html'>installation</a>
+</nav></div><div class="border"></div>
+<h1>Service Management</h1>
+
+<p>Carbs Linux uses busybox-runit as the default system supervisor.</p>
+
+<h2>Enabling Services</h2>
+
+<p>Services start immediately when you enable them, and run by default on boot.</p>
+
+<pre><code>$ ln -s /etc/sv/acpid /var/service
+</code></pre>
+
+<h2>Disabling a service</h2>
+
+<pre><code>$ unlink /var/service/acpid
+</code></pre>
+
+<h2>Starting a service</h2>
+
+<pre><code>$ sv start acpid
+</code></pre>
+
+<h2>Stopping a service</h2>
+
+<pre><code>$ sv stop acpid
+</code></pre>
+
+<h2>More</h2>
+
+<p>Runit is extremely flexible and simple. Refer to <code>sv</code>, <code>runsv</code>, <code>svc</code>, <code>runsvdir</code>
+help outputs for more information.</p>
+<a href="/wiki/system/service-management.txt">View Page Source</a><div class=border></div>
+<p class=footer>Linux® is a registered trademark of Linus Torvalds</p>
+<p class=footer>Copyright © 2019-2020 Cem Keylan</p>
+</body>
+</html>
diff --git a/docs/wiki/system/service-management.txt b/docs/wiki/system/service-management.txt
new file mode 100644
index 0000000..fc49f60
--- /dev/null
+++ b/docs/wiki/system/service-management.txt
@@ -0,0 +1,39 @@
+
+Service Management
+==================
+
+Carbs Linux uses busybox-runit as the default system supervisor.
+
+
+Enabling Services
+-----------------
+
+Services start immediately when you enable them, and run by default on boot.
+
+
+    $ ln -s /etc/sv/acpid /var/service
+
+
+Disabling a service
+-------------------
+
+    $ unlink /var/service/acpid
+
+
+Starting a service
+------------------
+
+    $ sv start acpid
+
+
+Stopping a service
+------------------
+
+    $ sv stop acpid
+
+
+More
+----
+
+Runit is extremely flexible and simple. Refer to `sv`, `runsv`, `svc`, `runsvdir`
+help outputs for more information.
author	Cem Keylan <cem@ckyln.com>	2020-04-06 12:06:20 +0300
committer	Cem Keylan <cem@ckyln.com>	2020-04-06 12:06:20 +0300
commit	979a10c2a68746565f330e871da2a0a112fa1604 (patch)
tree	edc502252ef282c7f67f40251300130aa4b094c1 /docs/wiki
download	website-979a10c2a68746565f330e871da2a0a112fa1604.tar.gz