Files
euri-iso/docs/packages.md
T
c-ludenberg 9fe5174cc7 feat: add GitHub Pages docs site (Just the Docs), split packagechooser, disable IA upload
- docs/: new 13-page Jekyll site with Just the Docs theme
  - Home, Building, Installer, Packages, CI/CD, Development
  - Desktop Environments (with GNOME joke), Wallpapers, Launcher
  - Overlays, Root Overlay, Live Overlay
- .github/workflows/pages.yml: build & deploy docs from docs/ on
  push to master (only when docs/ changes)
- .github/workflows/build.yml: temporarily disable Internet Archive
  upload (if: false) until ISO is stable
- live-overlay/settings.conf: add instances section for init + desktop
  packagechooser instances
- live-overlay/modules/packagechooser_init.conf: init system selector
  (OpenRC, Runit, S6, Dinit) via netinstall-add method
- live-overlay/modules/packagechooser_desktop.conf: DE selector
  (Plasma, Xfce, Cinnamon, MATE, LXQt, i3, Sway, Hyprland + No Desktop)
  via legacy method
- README.md, AGENTS.md: fix sudo buildiso -> sudo ./buildiso, add note
  about system buildiso lacking --overwrite='*'
- .gitignore: add docs/_site/
2026-06-29 21:27:46 +02:00

59 lines
2.4 KiB
Markdown

---
title: Packages
layout: default
nav_order: 4
---
# Custom Packages
Custom PKGBUILDs live in the [antergos-packages](https://github.com/Antergos-NeXT/antergos-packages) repo.
## Package list
| Package | Purpose |
|---------|---------|
| `calamares` | Built with `packagechooser` module enabled, `dracut`/`initramfs` modules skipped |
| `calamares-branding-antergos-next` | Branding files: `branding.desc`, `show.qml`, `settings.conf`, `packagechooser.conf`, `initcpiocfg.conf`, `initcpio.conf`, `calamares-next.sh` |
| `antergos-wallpapers` | Default wallpapers installed to `/usr/share/wallpapers/` (KDE) and `/usr/share/backgrounds/` (other DEs) |
| `linux-next` | Custom kernel based on `linux-artix` |
| `winver` | "About Antergos NeXT" dialog built with KF6 + Qt6 |
## Repo setup
```ini
[antergos-pkgs]
SigLevel = Optional TrustAll
Server = https://antergos-next.github.io/antergos-packages
```
## Build system
Packages are built and published via CI. The build order is defined in `packages.yaml`. AUR packages (`yay`, `downgrade`) are included with retry logic for transient clone failures.
## Index
The package index (`index.db`, `index.files`) is generated with timestamps in **Europe/Berlin** timezone. See `generate-index.py`.
## PKGBUILD notes
### calamares
- `_skip_modules` includes `dracut`, `initramfs`, `initramfscfg` — these are Artix/systemd-holdovers not needed on OpenRC/mkinitcpio
- `-DCMAKE_DISTRIBUTION_NAME` is a **no-op** — Calamares ignores it. The "for <distro>" text comes from `versionedName` in the active branding component at runtime
### calamares-branding-antergos-next
- `packagechooser.conf` provides a DE-only fallback for standalone use
- `settings_offline.conf` / `settings_online.conf` override live-overlay settings at install time
- `calamares-next.sh` `SetConfig()` must remove the symlink before copying config, or it follows the link and overwrites the wrong file
### antergos-wallpapers
- Installs to `/usr/share/wallpapers/antergos-wallpaper/` with `metadata.desktop` for KDE picker support
- Also available at `/usr/share/backgrounds/antergos/` for other DEs
- Current wallpaper: GNOME Adwaita Morning (`adwaita-morning.webp`, CC BY-SA 3.0 by Jakub Steiner)
## File conflict notes
`calamares` and `calamares-branding-antergos-next` both claim `/usr/share/calamares/branding/default/branding.desc` and `show.qml`. Resolved at ISO build time via `--overwrite='*'` in repo's `./buildiso`.