c-ludenberg
9fe5174cc7
- 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/
77 lines
3.9 KiB
Markdown
77 lines
3.9 KiB
Markdown
# Papal Decree for All Agents Working Upon These Hallowed Files
|
|
|
|
## Git Confession (Required Before Every Act)
|
|
Lest thy soul be marked with the sigil of a false prophet, thou shalt kneel and recite:
|
|
|
|
```bash
|
|
git config user.name "Celestia Ludenberg"
|
|
git config user.email "ash8820@proton.me"
|
|
```
|
|
|
|
**This commandment shalt be obeyed in every session before committing or pushing.** Suffer not the default identity to live. The OpenHands heresy shall not be permitted again.
|
|
|
|
## The Crusade
|
|
- **Artix Linux** ISO (OpenRC init), forked from EndeavourOS-ISO, then migrated to artools after 15 days in a vent shaft
|
|
- **KDE Plasma** live environment with Calamares installer (offline + online modes)
|
|
- **Build command**: `export WORKSPACE_DIR="$PWD" && sudo ./buildiso -p antergos` — **use `./buildiso`**, NOT `buildiso`; the system Artix `/usr/bin/buildiso` lacks `--overwrite='*'` and will fail with file conflicts
|
|
- ISO appears in `/var/lib/artools/buildiso/iso/antergos/` (assuming the build gods are pleased)
|
|
|
|
## Antergos NeXT Repos
|
|
- **antergos-iso**: `https://github.com/Antergos-NeXT/antergos-iso`
|
|
- **antergos-packages**: `https://github.com/Antergos-NeXT/antergos-packages`
|
|
- **calamares**: `https://codeberg.org/calamares/calamares` (upstream installer framework)
|
|
|
|
## Critical Gotchas (Read Before Editing)
|
|
|
|
### CMAKE_DISTRIBUTION_NAME is a no-op
|
|
Calamares completely ignores `-DCMAKE_DISTRIBUTION_NAME`. The "for <distro>" text in the about dialog comes from `versionedName` in the **active branding component** at runtime. Do NOT add this flag to the calamares PKGBUILD.
|
|
|
|
### brandind.desc componentName must match directory
|
|
Calamares `Branding.cpp` has this check:
|
|
```cpp
|
|
if (m_componentName != componentDir.dirName()) { bail(...); }
|
|
```
|
|
So `componentName: antergos-next` can only live in directory `antergos-next/`. If copying to `default/`, you MUST `sed` the componentName to `default`.
|
|
|
|
### Package order matters in profile.yaml
|
|
Build uses `basestrap --overwrite='*'`. The **last** package to claim a file wins. Package order in `profile.yaml` should list `calamares` BEFORE `calamares-branding-antergos-next`, so branding files overwrite Calamares defaults, not the other way around.
|
|
|
|
### Repo order in iso-x86_64.conf
|
|
`[antergos-pkgs]` must be listed FIRST in `iso-x86_64.conf` so our custom packages (calamares, branding) take priority over Artix's.
|
|
|
|
### Pacman.conf must be user-overridden
|
|
`buildiso` uses `/usr/share/artools/pacman.conf.d/iso-x86_64.conf` (from artools package) unless there's one at `~/.config/artools/pacman.conf.d/iso-x86_64.conf`. But we need `[antergos-pkgs]` in it. Before building locally:
|
|
|
|
```bash
|
|
mkdir -p ~/.config/artools/pacman.conf.d
|
|
cp pacman.conf.d/iso-x86_64.conf ~/.config/artools/pacman.conf.d/iso-x86_64.conf
|
|
```
|
|
|
|
CI does this automatically. Forget this step and buildiso will try to fetch our custom packages from Artix repos and fail.
|
|
|
|
### WORKSPACE_DIR
|
|
`buildiso` looks for profiles at `$WORKSPACE_DIR/iso-profiles/<profile>/` if `WORKSPACE_DIR` is set. Always set it to the repo root when building locally.
|
|
|
|
## Repo Structure
|
|
|
|
```
|
|
antergos-iso/
|
|
├── buildiso # Modified buildiso with Antergos branding
|
|
├── iso-profiles/
|
|
│ ├── antergos/
|
|
│ │ ├── profile.yaml # Packages, services (rootfs + livefs)
|
|
│ │ ├── root-overlay/ # Merged into squashfs rootfs
|
|
│ │ └── live-overlay/ # Merged into live environment
|
|
│ └── common/
|
|
│ └── common.yaml # Shared base packages
|
|
├── pacman.conf.d/
|
|
│ └── iso-x86_64.conf # Pacman config for ISO build
|
|
├── .github/workflows/build.yml # CI: builds ISO, uploads to Internet Archive
|
|
└── AGENTS.md # You are here
|
|
```
|
|
|
|
## ISO Upload
|
|
Pushed to **Internet Archive** with `collection: open_source_software` (Community Software, NOT Community Texts). CI uses `IA_ACCESS_KEY` and `IA_SECRET_KEY` secrets.
|
|
|
|
**DEUS VULT**
|