# Pagan Linux – kanał rolling (od 1.0.0) Dokument opisuje model wydawniczy, który builder obsługuje od 1.0.0, oraz to, co trzeba zrobić, żeby opublikować snapshot. Powstał razem ze zmianami w `build-pagan.sh` (blok „KANAŁ WYDAWNICZY”) i skryptem `rolling-release.sh`. ## 1. Dwa kanały | | `release` (do 0.5.x) | `rolling` (1.0.0+) | |---|---|---| | Wersja | numer + kryptonim („0.5.3 Mokosza”) | numer to **BAZA**, każdy snapshot dostaje datę | | ISO | jest wydaniem | jest tylko **snapshotem** stanu repo | | Aktualizacje | poprawki | `pag upgrade` na zainstalowanym systemie **przewija całość** | | Nazwa artefaktu | `Pagan-…-0.5.3-Mokosza-xfce.iso` | `Pagan-…-1.0.0-Rolling-20260926-xfce.iso` | Etykieta woluminu w obu kanałach zostaje **`PAGANLIVE`** – zależy od niej boot (`search --label`). Zmienia się wyłącznie nazwa pliku i tekst pozycji menu. ## 2. Numeracja i dlaczego działa Wersja pakietów wydania (`pagan-release`, `pagan-wallpapers`): ``` release 0.5.3 → bez zmian rolling 1.0.0.20260926 → baza + snapshot (albo 1.0.0.20260926.2 dla REV=2) ``` `pag` porównuje wersje semver-owo (`_cmp_version` w `pag/pag`): brakujące komponenty traktuje jako 0, więc `1.0.0.20260926` **jest nowsze** niż `1.0.0` i niż `1.0.0.20260901`. To jest cały mechanizm rolling: publikujemy nowy `pagan-release` w repo, a `pag upgrade` u użytkownika podnosi wersję systemu – razem z `/etc/os-release`, bo te pliki są **własnością** pakietu wydania. ## 3. Co konkretnie zmienia builder w rollingu - `PAGAN_SLUG` dostaje znacznik snapshota → **wszystkie** nazwy artefaktów (ISO, IMG, raporty, banner) są z datą, bez łatania każdego miejsca osobno. - `/etc/os-release`: `VERSION="1.0.0 Rolling 2026.09.26"`, `VERSION_ID="1.0.0.20260926"`, `VERSION_CODENAME="rolling"`. - pozycja menu rozruchu zawiera datę (`_pag_version_label`) – koniec pomyłek „bootuję 0.5.2, a mam 0.5.0”. - `pagan-release` / `pagan-wallpapers` dostają numer snapshota. - Kanał `release`: **zero różnic** (sprawdzone: `pkgver=0.5.3`, `slug=0.5.3-Mokosza`). ## 4. Włączanie - **Automatycznie:** wersja główna ≥ 1 (czyli `PAGAN_VERSION="1.0.0 Rolling"`). - **Jawnie:** `PAGAN_CHANNEL=rolling` (środowisko albo `build.conf`). - Wymuszenie starego trybu: `PAGAN_CHANNEL=release`. - Znacznik snapshota: `PAGAN_SNAPSHOT=2026.09.26` (stała data), `PAGAN_SNAPSHOT_REV=2` (drugi snapshot tego samego dnia). ## 5. Publikacja snapshotu ``` sudo ./rolling-release.sh [de] [iso|img|both] [--publish] [--remote user@vps:/var/www/repo.paganlinux.eu/stable] ``` 1. respin ISO/IMG z istniejącego rootfs (bez przebudowy pakietów i jądra), 2. odświeżenie plików wydania i pakietu `pagan-release` → nowy numer snapshota, 3. świeże `.pag` lądują w `repo-out/`, 4. `--publish` wysyła **tylko paczki** (`*.pag*`) na VPS. **Indeksu `repo.json` nie generujemy lokalnie i nie wysyłamy.** Robi to `pagsync --gen-repo --sign` **na VPS**, gdzie leży kompletne repo. Indeks zbudowany z niepełnego katalogu podmieniłby `repo.json` i zepsuł `pag upgrade` wszystkim użytkownikom – ta sama zasada, co w `build-repo.sh`. ## 6. Receptury (`recipes/`, osobne repo git) `recipes/core/pagan-release/PAGBUILD.yaml`: **`pkgver` trzymaj jako wersję bazową** (`1.0.0`). Znacznik snapshota dokłada builder, więc nie ma potrzeby zmieniać receptury przy każdym snapshocie. Kontrola spójności w `finalize_build` porównuje recepturę z wersją **bazową** – dla rollinga to właściwe zachowanie. Pozostałe receptury bez zmian. ## 7. Co trzeba zgadzać ze sobą (VPS + strona) - **`VERSION_ID` niesie snapshot** (`1.0.0.20260926`). Jeśli strona publikuje „najnowszą wersję” do porównania, musi być to **ten sam string** – inaczej `pagan-welcome` (porównuje `VERSION_ID` z wersją z repo/strony) będzie twierdził coś innego niż `pag upgrade`. - Kategoria repo zostaje `stable` (`PAGAN_REPO_URL` w `build.conf`), chyba że zdecydujesz się rozdzielić kanały na `stable/` i `rolling/` – wtedy zmiana `PAGAN_REPO_URL` w obrazie, a stare systemy zostają na `stable/`. ## 8. Do dokończenia - Blok „KANAŁ WYDAWNICZY” w `build-pagan.sh` leży **przy `install_pagan_release`**, a nie w sekcji konfiguracji na początku pliku. Powód techniczny: zmiana w tamtej sekcji przesuwa offsety działającego builda (bash czyta skrypt przyrostowo). **Do przeniesienia**, gdy żaden build nie działa. - Wersja 1.0.0 to baza; przy kolejnej linii wydawniczej podnieś numer w `PAGAN_VERSION` (np. `1.1.0 Rolling`). - Edycja serwerowa: ten sam mechanizm – `./rolling-release.sh server`.