refactor(kb): give linux-specific articles their own section

.vscode/settings.json

@@ -61,6 +61,7 @@
         "aclinherit",
         "aclmode",
         "acltype",
+        "addgroup",
         "adduser",
         "airgap",
         "airgapped",

knowledge base/apk.md

@@ -3,7 +3,8 @@
 ## Table of contents <!-- omit in toc -->
 
 1. [TL;DR](#tldr)
-1. [Sources](#sources)
+1. [Further readings](#further-readings)
+   1. [Sources](#sources)
 
 ## TL;DR
 
@@ -62,13 +63,21 @@ apk info -s 'top'
 apk info -d 'parallel'
 ```
 
-## Sources
+## Further readings
 
-- [10 alpine linux apk command examples]
+- [Alpine] Linux
+
+### Sources
+
+- [10 Alpine Linux apk command examples]
 
 <!--
-  References
+  Reference
+  ═╬═Time══
   -->
 
+<!-- Knowledge base -->
+[alpine]: linux/alpine.md
+
 <!-- Others -->
 [10 alpine linux apk command examples]: https://www.cyberciti.biz/faq/10-alpine-linux-apk-command-examples/

knowledge base/linux/alpine.md

@@ -0,0 +1,30 @@
+# Alpine
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+
+## TL;DR
+
+```sh
+# Create users.
+adduser 'somebody'
+adduser -DHS -G 'docker' 'docker'
+
+# Create groups.
+addgroup 'new-group'
+
+# Add users to groups.
+addgroup 'nobody' 'docker'
+```
+
+## Further readings
+
+- [APK]
+
+<!--
+  Reference
+  ═╬═Time══
+  -->
+
+<!-- Knowledge base -->
+[apk]: ../apk.md

knowledge base/linux/arch.md

@@ -1,7 +1,5 @@
 # Arch linux
 
-## Table of contents <!-- omit in toc -->
-
 1. [TL;DR](#tldr)
 1. [Further readings](#further-readings)
 
@@ -21,7 +19,8 @@ git clone https://aur.archlinux.org/jdupes.git \
 - [Arch User Repository]
 
 <!--
-  References
+  Reference
+  ═╬═Time══
   -->
 
 <!-- Upstream -->

knowledge base/linux/armbian.md

@@ -3,11 +3,9 @@
 Ultralight Linux distribution optimized for custom ARM, RISC-V or Intel hardware.<br/>
 Based on Debian.
 
-## Table of contents <!-- omit in toc -->
-
 1. [TL;DR](#tldr)
 1. [Further readings](#further-readings)
-1. [Sources](#sources)
+   1. [Sources](#sources)
 
 ## TL;DR
 
@@ -41,14 +39,19 @@ sudo usermod -aG 'docker' "$USER"
 - [Debian] GNU/Linux
 - [Raspberry Pi OS]
 
-## Sources
+### Sources
 
 - [How to run Docker]
 
 <!--
-  References
+  Reference
+  ═╬═Time══
   -->
 
+<!-- Knowledge base -->
+[debian]: debian.md
+[raspberry pi os]: ../raspberry%20pi%20os.md
+
 <!-- Upstream -->
 [documentation]: https://docs.armbian.com/
 [github]: https://github.com/armbian
@@ -56,12 +59,5 @@ sudo usermod -aG 'docker' "$USER"
 [pi4b image]: https://www.armbian.com/rpi4b/
 [website]: https://www.armbian.com/
 
-<!-- In-article sections -->
-[further readings]: #further-readings
-
-<!-- Knowledge base -->
-[debian]: debian.md
-[raspberry pi os]: raspberry%20pi%20os.md
-
 <!-- Others -->
 [balenaetcher]: https://etcher.balena.io/

knowledge base/linux/debian.md

@@ -1,12 +1,7 @@
 # Debian GNU/Linux
 
-## Table of contents <!-- omit in toc -->
-
-1. [TL;DR](#tldr)
 1. [Further readings](#further-readings)
-1. [Sources](#sources)
+   1. [Sources](#sources)
-
-## TL;DR
 
 ## Further readings
 
@@ -14,23 +9,19 @@
 - [`dpkg`][dpkg]
 - [Armbian]
 
-## Sources
+### Sources
-
-All the references in the [further readings] section, plus the following:
 
 - [Advice for new users on not breaking their Debian system]
 
 <!--
-  References
+  Reference
+  ═╬═Time══
   -->
 
-<!-- Upstream -->
-[advice for new users on not breaking their debian system]: https://wiki.debian.org/DontBreakDebian
-
-<!-- In-article sections -->
-[further readings]: #further-readings
-
 <!-- Knowledge base -->
 [armbian]: armbian.md
-[apt]: apt.md
+[apt]: ../apt.md
-[dpkg]: dpkg.md
+[dpkg]: ../dpkg.md
+
+<!-- Upstream -->
+[advice for new users on not breaking their debian system]: https://wiki.debian.org/DontBreakDebian

knowledge base/linux/fedora.md

@@ -1,6 +1,4 @@
-# Fedora GNU/Linux
+# Fedora
-
-## Table of contents <!-- omit in toc -->
 
 1. [Enable the RPM Fusion repositories](#enable-the-rpm-fusion-repositories)
 1. [Broadcom Wi-Fi drivers](#broadcom-wi-fi-drivers)
@@ -55,7 +53,8 @@ Either:
 - [DNF update from behind SSL inspection proxy]
 
 <!--
-  References
+  Reference
+  ═╬═Time══
   -->
 
 <!-- Others -->

knowledge base/linux/funtoo.md

@@ -1,7 +1,5 @@
 # Funtoo GNU/Linux
 
-## Table of contents <!-- omit in toc -->
-
 1. [TL;DR](#tldr)
 1. [Further readings](#further-readings)
 
@@ -21,13 +19,14 @@ sudo emerge --sync
 - [Profiles]
 
 <!--
-  References
+  Reference
+  ═╬═Time══
   -->
 
+<!-- Knowledge base -->
+[gentoo linux]: gentoo.md
+[portage]: ../portage.md
+
 <!-- Upstream -->
 [installation]: https://www.funtoo.org/Install
 [profiles]: https://www.funtoo.org/Funtoo_Profiles
-
-<!-- Knowledge base -->
-[gentoo linux]: gentoo%20linux.md
-[portage]: portage.md

knowledge base/linux/gentoo.md

@@ -6,9 +6,10 @@
 - [Funtoo Linux]
 
 <!--
-  References
+  Reference
+  ═╬═Time══
   -->
 
 <!-- Knowledge base -->
-[funtoo linux]: funtoo%20linux.md
+[funtoo linux]: funtoo.md
-[portage]: portage.md
+[portage]: ../portage.md

knowledge base/linux/kernel modules.md

@@ -1,10 +1,8 @@
 # Linux kernel modules
 
-## Table of contents <!-- omit in toc -->
-
 1. [TL;DR](#tldr)
 1. [Permanent modules configuration](#permanent-modules-configuration)
-1. [Sources](#sources)
+1. [Further readings](#further-readings)
 
 ## TL;DR
 
@@ -54,13 +52,14 @@ Write the options in a `.conf` file in `/etc/modprobe.d/`:
 options brcmfmac roamoff=1 feature_disable=0x82000
 ```
 
-## Sources
+## Further readings
 
 - The [Kernel module][arch wiki kernel module] page in the [Arch wiki]
-- The [Kernel modules][gentoo wiki kernel modules]
+- The [Kernel modules][gentoo wiki kernel modules] page in the [Gentoo wiki]
 
 <!--
-  References
+  Reference
+  ═╬═Time══
   -->
 
 <!-- Others -->

knowledge base/linux/lower the power consumption.md

@@ -1,6 +1,4 @@
-# Lower the power consumption on Linux
+# Lower the power consumption
-
-## Table of contents <!-- omit in toc -->
 
 1. [TL;DR](#tldr)
 1. [Sources](#sources)
@@ -23,7 +21,8 @@ sudo sysctl vm.dirty_writeback_centisecs=6000
 - Arch Wiki's [power management][arch wiki power management] page
 
 <!--
-  References
+  Reference
+  ═╬═Time══
   -->
 
 <!-- Others -->

knowledge base/linux/manjaro.md

@@ -1,11 +1,9 @@
-# Manjaro GNU/Linux
+# Manjaro
-
-## Table of contents <!-- omit in toc -->
 
 1. [Repositories](#repositories)
 1. [Printing](#printing)
 1. [Further readings](#further-readings)
-1. [Sources](#sources)
+   1. [Sources](#sources)
 
 ## Repositories
 
@@ -35,26 +33,22 @@ pamac install system-config-printer
 - [Switching branches]
 - [Printing]
 
-## Sources
+### Sources
-
-All the references in the [further readings] section, plus the following:
 
 - [Kde Plasma 5.23 not updating]
 
 <!--
-  References
+  Reference
+  ═╬═Time══
   -->
 
+<!-- Knowledge base -->
+[arch linux]: arch.md
+
 <!-- Upstream -->
 [branch comparison]: https://manjaro.org/branch-compare
 [printing]: https://wiki.manjaro.org/index.php/Printing
 [switching branches]: https://wiki.manjaro.org/index.php/Switching_Branches
 
-<!-- In-article sections -->
-[further readings]: #further-readings
-
-<!-- Knowledge base -->
-[arch linux]: arch%20linux.md
-
 <!-- Others -->
 [kde plasma 5.23 not updating]: https://forum.manjaro.org/t/kde-plasma-5-23-not-updating/88297/4

knowledge base/linux/opensuse.md

@@ -1,7 +1,5 @@
 # OpenSUSE
 
-## Table of contents <!-- omit in toc -->
-
 1. [Enable Bluetooth pairing on boot](#enable-bluetooth-pairing-on-boot)
 1. [Enable SSH access from outside after installation](#enable-ssh-access-from-outside-after-installation)
 1. [Raspberry Pi](#raspberry-pi)
@@ -10,7 +8,7 @@
 1. [Firefox MP4/H.264 video support](#firefox-mp4h264-video-support)
 1. [Docker images](#docker-images)
 1. [Further readings](#further-readings)
-1. [Sources](#sources)
+   1. [Sources](#sources)
 
 ## Enable Bluetooth pairing on boot
 
@@ -58,7 +56,8 @@ xzcat opensuse.raw.xz \
  && sync
 ```
 
-Insert the SD card in the Raspberry Pi and power it on. The network is configured to get an IP address on `eth0` using DHCP.
+Insert the SD card in the Raspberry Pi and power it on. The network is configured to get an IP address on `eth0` using
+DHCP.
 
 Connect using SSH and login using `root:linux`.
 
@@ -78,15 +77,18 @@ Do as follows:
 
 1. boot the system
 1. in GRUB's boot menu, choose _Bootable snapshots_
-1. select the snapshot you want to boot into; the list of snapshots is listed by date, the most recent snapshot being listed first
+1. select the snapshot you want to boot into; the list of snapshots is listed by date, the most recent snapshot being
+   listed first
 1. log in to the system
 1. carefully check whether everything works as expected
 
-   > You cannot write to any directory that is part of the snapshot. Data you write to other directories will not get lost, regardless of what you do next.
+   > You cannot write to any directory that is part of the snapshot. Data you write to other directories will not get
+   > lost, regardless of what you do next.
 
 Depending on whether you want to perform the rollback or not, choose your next step:
 
-- if the system is in a state where you do **not** want to do a rollback, reboot and boot again into a different snapshot, or start the rescue system.
+- if the system is in a state where you do **not** want to do a rollback, reboot and boot again into a different
+  snapshot, or start the rescue system.
 - to perform the rollback, run
 
   ```sh
@@ -97,24 +99,30 @@ Depending on whether you want to perform the rollback or not, choose your next s
 
 On the boot screen, choose the **default** boot entry to reboot into the reinstated system.
 
-A snapshot of the file system status before the rollback is created, and the default subvolume for root will be replaced with a fresh read-write snapshot.
+A snapshot of the file system status before the rollback is created, and the default subvolume for root will be replaced
+with a fresh read-write snapshot.
 
 ## Firefox MP4/H.264 video support
 
-To deal with [patent problems][information about the h.264 patent license], neither Firefox nor openSUSE provides the H264 codec required by fresh new openSUSE installation to play some video formats on the web.<br/>
+To deal with [patent problems][information about the h.264 patent license], neither Firefox nor openSUSE provides the
-The Packman and VLC repositories provide the needed `libav` packages. Install those libraries to let Firefox use them to decode MP4/H.264 video.
+H264 codec required by fresh new openSUSE installation to play some video formats on the web.<br/>
+The Packman and VLC repositories provide the needed `libav` packages. Install those libraries to let Firefox use them to
+decode MP4/H.264 video.
 
 ```sh
 zypper install 'libavcodec60' 'libavdevice60' 'libavformat60'
 ```
 
-openSUSE provides `ffmpeg` and `libav` packages like `libavcodec56`, but in them all patent related codecs were removed making them unable to play MP4/H.264 video. That is why one needs to upgrade these packages with their version in the Packman or VLC repositories.
+openSUSE provides `ffmpeg` and `libav` packages like `libavcodec56`, but in them all patent related codecs were removed
+making them unable to play MP4/H.264 video. That is why one needs to upgrade these packages with their version in the
+Packman or VLC repositories.
 
 Go to this [Simple WebRTC H264 check page] to check if Firefox can play H.264 videos after installation.
 
 ## Docker images
 
-OpenSUSE's official container images are created and stored in [SUSE's container registry][container images built by the open build service]:
+OpenSUSE's official container images are created and stored in
+[SUSE's container registry][container images built by the open build service]:
 
 ```sh
 docker run -ti --rm --name 'tw' 'registry.opensuse.org/opensuse/tumbleweed'
@@ -129,9 +137,7 @@ docker run -ti --rm --name 'tw' 'registry.opensuse.org/opensuse/tumbleweed'
 - [System Recovery and Snapshot Management with Snapper]
 - [Container Images built by the Open Build Service]
 
-## Sources
+### Sources
-
-All the references in the [further readings] section, plus the following:
 
 - [OpenSSH basics]
 - [Bluetooth on boot]
@@ -141,9 +147,16 @@ All the references in the [further readings] section, plus the following:
 - [Simple WebRTC H264 check page]
 
 <!--
-  References
+  Reference
+  ═╬═Time══
   -->
 
+<!-- Knowledge base -->
+[bluetooth]: ../bluetooth.md#bluetooth-devices-cannot-be-used-at-login
+[firewalld]: ../firewalld.md
+[systemd]: ../systemd.md
+[zypper]: ../zypper.md
+
 <!-- Upstream -->
 [container images built by the open build service]: https://registry.opensuse.org/cgi-bin/cooverview
 [firefox mp4/h.264 video support]: https://en.opensuse.org/SDB:Firefox_MP4/H.264_Video_Support
@@ -151,12 +164,6 @@ All the references in the [further readings] section, plus the following:
 [raspberry pi4]: https://en.opensuse.org/openSUSE:Raspberry_Pi
 [system recovery and snapshot management with snapper]: https://documentation.suse.com/sles/12-SP4/html/SLES-all/cha-snapper.html
 
-<!-- Knowledge base -->
-[bluetooth]: bluetooth.md#bluetooth-devices-cannot-be-used-at-login
-[firewalld]: firewalld.md
-[systemd]: systemd.md
-[zypper]: zypper.md
-
 <!-- Others -->
 [bluetooth on boot]: https://www.reddit.com/r/openSUSE/comments/eoozm2/comment/feetqpn/
 [information about the h.264 patent license]: https://www.fsf.org/licensing/h264-patent-license

knowledge base/linux/optimize battery.md

@@ -1,6 +1,4 @@
-# Optimize battery on a linux system
+# Optimize battery
-
-## Table of contents <!-- omit in toc -->
 
 1. [TL;DR](#tldr)
 1. [Disable unused services](#disable-unused-services)
@@ -64,7 +62,8 @@ sudo 'powertop'
 - [laptop-mode-tools in the Arch Wiki]
 
 <!--
-  References
+  Reference
+  ═╬═Time══
   -->
 
 <!-- Others -->

knowledge base/linux/scan documents.md

@@ -1,11 +1,9 @@
-# Scan a document on Linux
+# Scan documents
-
-## Table of contents <!-- omit in toc -->
 
 1. [TL;DR](#tldr)
 1. [Procedure](#procedure)
 1. [Further readings](#further-readings)
-1. [Sources](#sources)
+   1. [Sources](#sources)
 
 ## TL;DR
 
@@ -21,15 +19,18 @@ Install:
 - the `sane-airscan` package, if the scanner is known to work in driverless mode;
 - the `sane` package to use old driver-based scanning.
 
-If the scanner is using a USB connection, make sure to also install the `ipp-usb` package and start/enable the `ipp-usb` service to allow using IPP protocol over USB connection.
+If the scanner is using a USB connection, make sure to also install the `ipp-usb` package and start/enable the `ipp-usb`
+service to allow using IPP protocol over USB connection.
 
 Many modern scanners will immediately work over the network as long as you have `sane-airscan` installed.
 
 SANE has lots of front ends, a non-exhaustive list of which can be found on the [sane project website][sane frontends]:
 
-- [Simple Scan]: a simplified GUI intended to be easier to use and better integrated into the GNOME desktop than `XSane` is;
+- [Simple Scan]: a simplified GUI intended to be easier to use and better integrated into the GNOME desktop than `XSane`
-- [Skanlite]: a simple image scanning application; it does nothing more than scan and save images, and is based on the KSane backend;
+  is;
-- [XSane]: a full-featured GTK-based frontend; looks a bit old but provides extended functionalities.
+- [Skanlite]: a simple image scanning application; it does nothing more than scan and save images, and is based on the
+  KSane backend;
+- XSane: a full-featured GTK-based frontend; looks a bit old but provides extended functionalities.
 
 Some OCR software are able to scan images using SANE, like gImageReader, [gscan2pdf], Linux-Intelligent-Ocr-Solution, [OCRFeeder] and [Paperwork].
 
@@ -42,23 +43,19 @@ Some OCR software are able to scan images using SANE, like gImageReader, [gscan2
 - [simple scan]
 - [skanlite]
 
-## Sources
+### Sources
-
-All the references in the [further readings] section, plus the following:
 
 - [SANE frontends]
 
 <!--
-  References
+  Reference
+  ═╬═Time══
   -->
 
 <!-- Upstream -->
 [sane frontends]: http://www.sane-project.org/sane-frontends.html
 [sane]: https://wiki.archlinux.org/title/SANE
 
-<!-- In-article sections -->
-[further readings]: #further-readings
-
 <!-- Others -->
 [gscan2pdf]: https://en.wikipedia.org/wiki/Scanner_Access_Now_Easy#gscan2pdf
 [ocrfeeder]: https://en.wikipedia.org/wiki/OCRFeeder

knowledge base/openmediavault.md

@@ -208,7 +208,7 @@ Just enable property in the pool or dataset.
 [omv extras]: #omv-extras
 
 <!-- Knowledge base -->
-[debian]: debian.md
+[debian]: linux/debian.md
 [disks maintenance]: disks%20maintenance.md
 [proxmox]: proxmox.md
 [zfs]: zfs.md