From 5d60e6bbcf4e0f3f03e56544d14ed7090af5ac29 Mon Sep 17 00:00:00 2001 From: Frank Zechert Date: Mon, 15 Jun 2026 01:35:23 +0200 Subject: [PATCH] initial commit --- _nav.qd | 2 ++ _setup.qd | 39 +++++++++++++++++++++ assets/fz-stack-icon.svg | 59 +++++++++++++++++++++++++++++++ assets/fz-stack-transparent.svg | 62 +++++++++++++++++++++++++++++++++ main.qd | 44 +++++++++++++++++++++++ 5 files changed, 206 insertions(+) create mode 100644 _nav.qd create mode 100644 _setup.qd create mode 100644 assets/fz-stack-icon.svg create mode 100644 assets/fz-stack-transparent.svg create mode 100644 main.qd diff --git a/_nav.qd b/_nav.qd new file mode 100644 index 0000000..9b25ff3 --- /dev/null +++ b/_nav.qd @@ -0,0 +1,2 @@ +###! [{.icon {house}} {.projectname}](main.qd) + diff --git a/_setup.qd b/_setup.qd new file mode 100644 index 0000000..571fee8 --- /dev/null +++ b/_setup.qd @@ -0,0 +1,39 @@ +.doclang {en} +.docdescription {Extensive documentation and guide on the technology stack fz-stack} + +.docauthors + - Frank Zechert + - email: frank@zechert.net + +.dockeywords + - fz-stack + - documentation + +.doctype {docs} +.theme {darko} layout:{hyperlegible} + +.var {assets} {assets/} +.var {logo} {{.assets}/fz-stack-icon.svg} +.var {banner} {{.assets}/fz-stack-transparent.svg} +.var {projectname} {fz-stack} +.var {pagetitle} {fz-stack Documentation} + +.pagemargin {topleft} + .row gap:{20px} cross:{start} + [.logo::image label:{fz-stack Logo} figure:{false}](@) + + [.projectname::text size:{larger}](@) + + +.pagemargin {topright} + [.icon {git}](https://git.zechert.net/fz-stack) + +.htmloptions baseurl:{https://fz-stack.zechert.net} +.htmloptions title:{.pagetitle} +.ifnot {.docname::equals {.pagetitle}} + .htmloptions title:{.docname | .pagetitle} +.ifnot {.docname::isnone} + .docname {.pagetitle} + +.numbering + - footnotes: i diff --git a/assets/fz-stack-icon.svg b/assets/fz-stack-icon.svg new file mode 100644 index 0000000..4543ef4 --- /dev/null +++ b/assets/fz-stack-icon.svg @@ -0,0 +1,59 @@ + + + + + + + + fz-stack logo + + Logo for fz-stack showing three flat, stacked geometric layers + in Catppuccin Macchiato colors above the text “fz-stack”. + + + + + + + + + + + + + + + + + + + + diff --git a/assets/fz-stack-transparent.svg b/assets/fz-stack-transparent.svg new file mode 100644 index 0000000..59a4c17 --- /dev/null +++ b/assets/fz-stack-transparent.svg @@ -0,0 +1,62 @@ + + + + + + + + fz-stack logo + + Logo for fz-stack showing three flat, stacked geometric layers + in Catppuccin Macchiato colors above the text “fz-stack”. + + + + + + + + + + + + + + + + + + + + + fz-stack + + diff --git a/main.qd b/main.qd new file mode 100644 index 0000000..8e48ad2 --- /dev/null +++ b/main.qd @@ -0,0 +1,44 @@ +.include {docs} + +.css + h1 { opacity: 0; height: 0; margin: 0; padding:0; } + +.image {.banner} {fz-stack banner logo} + +## Welcome to the `fz-stack` Documentation + +`fz-stack` is a curated collection of system configurations, installation procedures, dotfiles, scripts, +and tooling that define how I build and maintain my [Arch Linux][arch-linux]-based environment. + +It is not a standalone distribution; rather, it is a structured, reproducible framework for assembling a secure, modern, +and highly customized Arch Linux system. + +This documentation describes the complete installation and configuration workflow used in my personal environment. +While the stack is openly available, it is intentionally opinionated and optimized for my workflow. +Users are encouraged to explore, adapt, and selectively integrate components that fit their own needs. + +A system deployed using fz-stack will: + +- use a single EFI partition and require UEFI +- boot via a unified kernel image without an external bootloader +- optionally enable Secure Boot for system integrity +- employ full-disk encryption +- use LVM2 for flexible volume management +- support system hibernation +- run a Wayland-based environment with [Hyprland][hyprland] +- and include additional custom tooling, scripts, and configurations + +A system deployed with fz-stack **will not**: + +- support dual-booting with other operating systems +- provide any warranty, guarantees, or assurances of fitness for purpose + +> Warning: This guide contains commands executed with and without elevated privileges. +> Do not run commands you do not understand. +> Always verify them against the relevant manual pages or the [Arch Linux Wiki][arch-linux-wiki]. +> +> .emoji {warning} Incorrectly executed commands can cause irreversible data loss. + +[arch-linux]: https://archlinux.org +[arch-linux-wiki]: https://wiki.archlinux.org/title/Main_page +[hyprland]: https://hypr.land