Euri-Linux/euri-iso
2
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 4 Wiki Activity

docs: rework all pages to Artix Wiki quality

Browse Source 
- index.md: add download link + stable release announcement
- building.md: add troubleshooting section (cache, squashfs, compression)
- ci.md: IA upload enabled, push trigger removed (manual dispatch only)
- development.md: add all gotchas from AGENTS.md (SDDM theme ordering,
  pipewire launcher, antergos-release in basestrap, CI changes)
- installer.md: document fixed issues (audio, SDDM, os-release)
- packages.md: add pipewire fork, antergos-sddm-theme, antergos-release
- launcher.md: expand with module configs
- init-systems.md: Chimera uses dinit, OpenRC marked as broken
- openrc.md: add broken warning banner
- wallpapers.md: default is antergos-wallpaper.png (not Adwaita Morning)
- overlays: clean up explanations and symlink behavior
- desktop-environments.md: add Discover note, clean up GNOME entry
- dinit.md, runit.md, s6.md: polish and add troubleshooting sections
This commit is contained in:
c-ludenberg
2026-07-11 23:33:17 +02:00
parent e54b35a1d4
commit d0213a7a46
17 changed files with 514 additions and 237 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/launcher.md
+34 -17
View File
@@ -6,17 +6,13 @@ nav_order: 10
# Calamares Launcher
The `calamares-next` script (`calamares-next.sh`) handles the installer boot flow.
The `calamares-next` script (`calamares-next.sh`) handles the installer boot flow. It's installed by `calamares-branding-antergos-next` to `/usr/bin/calamares-next`.
## Flow
## Boot flow
1. **Mode picker** — Dialog asking Offline or Online install
2. **Configuration** — Copies the appropriate `settings.conf` (offline or online) to `/etc/calamares/settings.conf`
3. **Launch** — Runs `calamares` with the selected config
## Launcher location
Installed by `calamares-branding-antergos-next` to `/usr/bin/calamares-next`.
1. **Mode picker** — `kdialog` or `zenity` dialog asking Offline or Online install
2. **Configuration** — copies the appropriate `settings.conf` (offline or online) to `/etc/calamares/settings.conf`
3. **Launch** — runs `calamares` with the selected config
## Desktop entry
@@ -26,21 +22,42 @@ Installed by `calamares-branding-antergos-next` to `/usr/bin/calamares-next`.
Exec=sudo -E calamares-next
```
Note: `sudo -E` preserves environment variables (required for `WAYLAND_DISPLAY`, `XDG_CURRENT_DESKTOP`, etc. when launched from the SDDM session).
`sudo -E` preserves environment variables (`WAYLAND_DISPLAY`, `XDG_CURRENT_DESKTOP`, etc.) when launched from the SDDM session. Without it, Calamares may not detect the display server correctly.
## Mode picker (dialog)
## Mode picker
A simple `kdialog` or `zenity` dialog:
- **Offline** — No internet required, installs KDE Plasma from squashfs
- **Online** — Init system selector + DE selector via packagechooser, downloads packages from the internet
A simple dialog with two options:
- **Offline** — no internet required, installs KDE Plasma from a pre-built squashfs. Fast and deterministic.
- **Online** — internet required, shows an init system selector (Dinit/OpenRC/Runit/S6) and a desktop selector. Downloads packages from the repos.
## Config switching
`SetConfig()` in `calamares-next.sh`:
1. Removes existing symlink at `/etc/calamares/settings.conf` (must `rm -f` first, not overwrite, or `cp` follows the symlink)
2. Copies the selected settings file
1. `rm -f` the existing symlink at `/etc/calamares/settings.conf` (must remove first — `cp` follows symlinks and would overwrite the wrong file)
2. `cp` the selected settings file (offline or online) to `/etc/calamares/settings.conf`
3. Calamares reads the config on launch
## Hiding "Install Artix"
The live-overlay includes `calamares-config-switcher.desktop` with `NoDisplay=true` — this hides the upstream Artix launcher while keeping the binary available.
The live-overlay includes `calamares-config-switcher.desktop` with `NoDisplay=true`. This hides the upstream Artix "Install Artix Linux" desktop entry while keeping the binary available for other uses.
## Module configs
### Online modules
Configs live in `live-overlay/etc/calamares-online/modules/`:
- `packagechooser_init.conf` — init system selector using `method: netinstall-add`
- `packagechooser_desktop.conf` — DE selector using `method: legacy`
- `initcpiocfg.conf` — mkinitcpio configuration
- `services-openrc.conf` — service enablement (works across all inits via init-specific wrappers)
### Offline modules
Configs live in `live-overlay/etc/calamares-offline/modules/`:
- `unpackfs.conf` — unpack the pre-built squashfs
- `initcpiocfg.conf` — mkinitcpio configuration
- `services-openrc.conf` — service enablement