started documentation for system installation

_nav.qd

@@ -1,2 +1,5 @@
-###! [{.icon {house}} {.projectname}](main.qd)
+###! System Installation
+
+- [Download Arch Linux](system-installation/001-download-arch-linux.md)
+- [Basic System Installation](system-installation/002-basic-system-installation.md)
 

_setup.qd

@@ -12,7 +12,7 @@
 .doctype {docs}
 .theme {darko} layout:{hyperlegible}
 
-.var {assets} {assets/}
+.var {assets} {@/assets}
 .var {logo} {{.assets}/fz-stack-icon.svg}
 .var {banner} {{.assets}/fz-stack-transparent.svg}
 .var {projectname} {fz-stack}
@@ -32,8 +32,13 @@
 .htmloptions title:{.pagetitle}
 .ifnot {.docname::equals {.pagetitle}}
 	.htmloptions title:{.docname | .pagetitle}
-.ifnot {.docname::isnone}
+.if {.docname::equals {}}
 	.docname {.pagetitle}
 
 .numbering
 	- footnotes: i
+
+.function {example}
+	title? content:
+	.box {.title::otherwise {Example}} type:{tip}
+		.content

system-installation/001-download-arch-linux.md

@@ -0,0 +1,74 @@
+.docname {Download Arch Linux}
+.include {docs}
+
+Download [Arch Linx][arch-linux] from one of the [official sources][arch-linux-sources].
+
+> Warning: Always verify checksums. It is important to download Arch Linux from a trusted sources.
+> Always check the download against signatures and checksums published on the official
+> [Arch Linux][arch-linux-sources] website. Do not trust signatures published by download
+> mirrors or 3rd party websites, as they could be tampered with.
+
+## Checksum Verification
+
+### Using GnuPG
+
+To verify the PGP signature with GnuPG, first download the release signing key from
+[WKD (Web Key Discovery)][wkd] or any key service that you trust.
+
+```sh
+gpg --auto-key-locate clear,wkd -v \
+--locate-external-key pierre@archlinux.org
+```
+
+Then use the obtained key to verify the signature of the downloaded file
+
+```sh
+gpg --keyserver-options auto-key-retrieve \
+--verify archlinux-<version>.iso.sig
+```
+
+### Using an existing Arch Linux System
+
+On a system already running Arch Linux, `pacman` can be used to verify the Installation Medium.
+
+```sh
+pacman-key -v archlinux-<version>.iso.sig
+```
+
+## Create a Bootable Medium
+
+Create a bottable medium from the downloaded **and verified** Arch Linux ISO.
+For example, a bootable USB flash drive.
+
+Execute the following command to copy the downloaded ISO to the USB flash drive.
+
+> Important: The following command will permanently delete the data of the destination device.
+> Make sure to specify the correct destination device and to back up important data prior to executing
+> this command.
+
+```sh
+dd bs=4M \
+if=<path to archlinux iso> \
+of=/dev/disk/by-id/usb-<your flash drive> \
+conv=fsync oflag=direct status=progress
+```
+
+> Tip: After you are done using the USB flash drive for the Arch Linux installation, the following
+> command must be executed to delete the ISO 9660 filesystem signature from the device to use it
+> as a normal USB flash drive again.
+>
+> ```sh
+> wipefs --all /dev/disk/by-id/usb-<your flash drive>
+> ```
+
+For more details, see [Arch Linux Wiki: USB Flash Installation Medium][arch-wiki-usb-install].
+
+For other methods, see [Arch Linux Wiki: Burning an Optical Disc][arch-wiki-optical-disc] or
+[Arch Linux Wiki: PXE Network Boot][arch-wiki-pxe-boot].
+
+[arch-linux]: https://archlinux.org/
+[arch-linux-sources]: https://archlinux.org/download/
+[arch-wiki-usb-install]: https://wiki.archlinux.org/title/USB_flash_installation_medium
+[arch-wiki-optical-disc]: https://wiki.archlinux.org/title/Optical_disc_drive#Burning
+[arch-wiki-pxe-boot]: https://wiki.archlinux.org/title/Preboot_Execution_Environment
+[wkd]: https://keys.openpgp.org/about/usage-wkd/

system-installation/002-basic-system-installation.md

@@ -0,0 +1,71 @@
+.docname {Basic System Installation}
+.include {docs}
+
+This page explains the basic setup of Arch Linux. It was last updated July 2026.
+
+> Tip: Always cross check this page with the current version of the [Arch Linux Installation Guide][arch-wiki-install],
+> as the instructions on this page might be outdated or no longer complete.
+
+> Important: Commands in this guide will modify your hard disk, including partitions, encryption, and more.
+> Make sure to understand all commands before you execute them. You will lose data!
+> Consult the [Arch Wiki][arch-wiki] or the man pages of all commands and options you are unfamiliar with.
+>
+> Create a backup of all important data that you do not want to lose before you continue with the installation of
+> Arch Linux!
+
+## Preparation
+
+To install Arch Linux, boot from the installation medium. It might be necessary to change UEFI settings to do so.
+For example:
+
+- Disable Secure Boot
+- Delete existing Boot Sequences or Boot Entries
+- Enable USB Boot Support
+- Enabled External USB Ports
+
+.box {DELL XPS 13 9370} type:{note}
+    In the UEFI settings:
+
+    - Enable the support to boot from USB devices:
+      `System Configuration` -> `USB Configuration` -> `Enable USB Boot Support`
+    - Set `POST Behaviour` -> `Fastboot` to any value other than `Minimal`
+
+    Secure Boot can already be enabled and set to audit mode to facilitate Secure Boot installation later. This allows
+    the machine to boot without any valid secure boot keys with a warning message. As soon as we have set up valid
+    keys and signed our boot image, secure boot can then be enabled to fail on unsigned boot images.
+
+    In the UEFI settings:
+
+    - enable `Secure Boot` -> `Secure Boot Enable` -> `Secure Boot Enable`
+    - set `Secure Boot` -> `Secure Boot Mode` to `Audit Mode`
+    - enable `Secure Boot` -> `Expert Key Management` -> `Enable Custom Mode`
+
+    To access the boot menu or UEFI, press
+
+    - .keybinding {F2} to access UEFI settings
+    - .keybinding {F12} to access one-time boot menu
+
+## Setting Keyboard Layout and Console Font
+
+List available console key maps with `localectl list-keymaps`, then set the desired key map with
+`loadkeys <key map>`.
+
+Console fonts are located in `/usr/share/kbd/consolefonts` and can be set with `setfont <font>`.
+
+.example
+    ```sh
+    loadkeys de-latin1
+    setfont eurlatgr
+    ```
+
+> Note: These changes are temporary and will be lost during reboot. Should you need to reboot your machine before
+> the installation is finished and before the settings are persisted, repeat these commands after each boot.
+
+> Tip: On HiDPI screens, a larger font might be desirable. E.g. `ter-132b` (the largest font), or
+> `ter-118n`. If you need region-specific special characters, set the key map with the `-m` option,
+> e.g. `setfont ter-118n -m 88591`.
+
+## Verify Boot Mode
+
+[arch-wiki]: https://wiki.archlinux.org/
+[arch-wiki-install]: https://wiki.archlinux.org/title/Installation_guide