recipes
git clone https://git.paganlinux.eu/recipes.git PaganOS Recipes
Receptury pakietów dla PaganOS. Każdy plik PAGBUILD.yaml definiuje jak zbudować pojedynczy pakiet.
Struktura
recipes/
├── core/ # pakiety bazowe (binutils, gcc, glibc, ...)
├── drivers/ # sterowniki (libinput, mesa, ...)
├── net/ # sieć (curl, wget, NetworkManager, ...)
├── gui/ # pakiety GUI (gtk, qt, xfce, ...)
├── utils/ # narzędzia (bubblewrap, ripgrep, ...)
└── boot/ # bootloader (grub)
Format PAGBUILD.yaml
pkgname: acl
pkgver: '2.4.0'
pkgrel: 1
pkgdesc: Commands for Manipulating POSIX Access Control Lists.
url: http://savannah.nongnu.org/projects/acl
arch: x86_64
license:
- GPL-2.0-only
depends:
- attr
makedepends:
- gcc
source:
- http://download.savannah.gnu.org/releases/${pkgname}/${pkgname}-${pkgver}.tar.gz
sha256sums:
- SKIP
build: |
cd "${pkgname}-${pkgver}"
./configure --prefix=/usr
make -j$(nproc)
package: |
cd "${pkgname}-${pkgver}"
make DESTDIR="${PKGDIR}" install
Zmienne dostępne w fazach build/package
${PKGDIR}— katalog DESTDIR (instalacja pakietu)${pkgname},${pkgver},${pkgrel}— podstawiane też w adresachsource:
Model pakietu (jak Arch/Debian — bez footprintów)
Receptura nie deklaruje listy plików. Faza package: instaluje wszystko do ${PKGDIR} (DESTDIR) i z tego katalogu pagbuild tworzy jeden pakiet — dokładnie jak PKGBUILD w Archu czy reguły install w Debianie. Lista plików nie jest danymi wejściowymi, tylko pochodną pakietu: pag wylicza SHA256 dla każdego pliku przy instalacji i zapisuje je w /var/lib/pag/files.db (rola, którą w Debianie pełni md5sums/.list, a w Archu .MTREE).
Nie używamy już pól
footprint,footprint_devel,footprint_man,footprint_<lang>— to balast z formatu cards/NuTyX, któregopagbuildnigdy nie czytał. Podpakiety deweloperskie/dokumentacyjne/językowe są scalane z pakietem głównym (ich pliki i tak trafiają do DESTDIR). Do usuwania tych pól z istniejących receptur służystrip-recipes-footprints.py.
Pakiet wyjściowy
pagbuild buduje pakiety .pag (tar.xz z metadata.json + data.tar.xz), gotowe do instalacji przez pag install plik.pag. W repo trzymamy wyłącznie aktualną wersję każdego pakietu — starsze są usuwane przez pagsync.
Pakiet wydania (pagan-release) — wersja systemu przez repo
recipes/core/pagan-release to pakiet wydania („os-info”). Jego pkgver JEST wersją systemu, a depends opisuje, co to wydanie ma zawierać.
Dlaczego tak, a nie „wersja wpisana w obraz”:
- pliki
/etc/os-releasei/etc/pagan-releasenależą do PAKIETU, więcpag verifyje obejmuje, apag upgradepodmienia je przy nowszej wersji (z ochroną.pacnew, jeśli użytkownik je zmienił), - w obrazie pakiet jest instalowany od razu, więc
pag base registerzapamiętuje go z wersją obrazu, provides: pagan-system=<wersja>pozwala innym pakietom wymagaćpagan-system>=1.0.0bez wiązania się z nazwą pakietu wydania,- klucze dodatkowe
codename:idesktop:(pagbuild je ignoruje) czytabuild-pagan.sh— jedno miejsce z prawdą o kodename i środowisku.
Nowe wydanie — kolejność
- Podnieś
pkgver(i ewentualniecodename) wrecipes/core/pagan-release/PAGBUILD.yaml; dopisz nowe pozycje wdepends, jeśli wydanie ma dołożyć tapety/programy. - Podnieś
PAGAN_VERSIONwbuild-pagan.sh(builder ostrzeże w fazie weryfikacji obrazu, jeśli te dwie wartości się rozjadą). pagbuild pagan-release→ podpis →pagsync --gen-repo(albo GUI-Build).- Na maszynie użytkownika:
sudo pag upgrade→ nowa wersja systemu.
Uwagi
dependsmuszą istnieć w repozytorium.pagan-wallpapersbuduje sam builder (tapety leżą wbranding/, do którego repo receptur nie ma dostępu), więc jego.pag(zISO/packages/po buildzie) wysyła się do repozytorium razem zpagan-release.- Hooki: katalog
hooks/w.pagobsługujepre-install,post-install,pre-remove,post-remove(APIPKG_HOOK_API,PAG_NO_HOOKS=1wyłącza,PAG_HOOK_TIMEOUTogranicza czas).pagan-releaseużywapost-installdo odświeżenia baz pulpitu/ikon po dodaniu programów w wydaniu.
Receptury z własną konfiguracją (pagan-xfce-panel-layout)
Nie każdy pakiet jest kompilowany – niektóre wnoszą samą konfigurację. Wzorzec: pliki leżą w katalogu receptury i są wymienione w source: (pagbuild kopiuje je do katalogu budowy, więc w build: są dostępne po nazwie, bez ścieżek).
Przykład: recipes/gui/pagan-xfce-panel-layout wnosi domyślny układ panelu XFCE (/etc/xdg/xfce4/panel/default.xml) oraz skrypty widgetów genmon (/usr/libexec/pagan/panel/: CPU, RAM, sieć, bateria).
Jedno źródło prawdy dla repo i ISO
Układ panelu generuje gen-panel-xml.sh z tej samej receptury, której używa build-pagan.sh – nie ma drugiej kopii definicji układu do rozjechania:
- tutaj (pagbuild) generator jest wołany bez flag, bo
dependsgwarantuje obecność wtyczek (xfce4-panel,xfce4-whiskermenu-plugin,xfce4-genmon-plugin,xfce4-clipman-plugin), build-pagan.shbuduje te wtyczki „best-effort”, więc sam wykrywa braki w rootfs i przekazuje je flagami (--no-whiskermenu,--no-genmon,--no-clipman) – panel nigdy nie wskazuje na niezainstalowany moduł.
Zmieniając układ panelu (kolejność wtyczek, widgety, ulubione w menu) edytuje się tylko gen-panel-xml.sh i podnosi pkgver w tej recepturze.
Budowanie lokalnie
pagbuild recipes/core/acl/PAGBUILD.yaml
Narzędzia
migrate-recipes.py— konwertuje recepturycards(Pkgfile) naPAGBUILD.yaml(footprinty są celowo pomijane)strip-recipes-footprints.py— usuwa polafootprint*z istniejących receptur (idempotentne;--apply, aby zapisać, domyślnie dry-run)
Polityka forków
Fork-first w całym repo: ../../FORK-POLICY.md. Krótko: co możemy zrobić forkiem, robimy forkiem — źródła w repo, pakiet -pagan, lokalny tarball + wyliczony sha256 (build bez sieci) i adnotacja licencyjna o statusie forka (FORK.md + NOTICE).
- e4af330d depends: uzupelniono runtime zaleznosci z audytu ABI (892 receptury)
- 01a21cd2 Update recipe subversion
- a70fc7c8 depends: dopisano brakujace zaleznosci runtime (fala 17 pakietow; audyt ldd systemu)
- 9a9f99a1 flatpak: appstream/libostree/dconf jako depends; appstream: libxmlb/libfyaml; bump pkgrel
- ba43133f fix(python-docutils): dostarcz skrypt rst2man (docutils 0.23 pip go nie instaluje) - potrzebny m.in. dla libvirt
- dd72c9d0 fix(virt-viewer): source -> GitLab tag v11.0 (oficjalny 404), katalog virt-viewer-v11.0, meson setup, usun pozycyjny arg i18n.merge_file (meson>=1.x)
- 67f47dd5 Update recipe pagan-mkiso
- e549f4f8 fix(libvirt): usun -Dnetcf=disabled (pagbuild przepisywal disabled->false dla nieznanych feature opts); hardkod 12.6.0 -> ${pkgver}
- 872041a8 pagan-mkiso: domyslnie wykluczaj /home i /root (prywatnosc) + --include-home / MKISO_INCLUDE_HOME
- db439b8d fix(yajl): CMake>=4 - zastap GET_TARGET_PROPERTY LOCATION generator expression (CMP0026)
- 43f91a9a pagan-mkiso: uzywaj tylko live initramfs (/boot/initramfs.img); per-wersja sa diskowe; +libs busybox gdy dynamiczny
- e983312b pagan-mkiso: naprawa mksquashfs - wykluczenia wzgledne (bez wiodacego /) bo -wildcards ich nie akceptuje
- 753aa043 pagan-mkiso: track gui.py (recipes .gitignore ma *.py - wyjatek)
- e19edc32 pagan-mkiso: generator ISO z uruchomionego systemu (squashfs + hybrydowe BIOS/UEFI; autodetekcja initramfs per-wersja; wlasny live initramfs)
- 96e29e40 fix(glibmm-gtk-4): 2.89.0 (dev) -> 2.88.1 (stable) - 2.89 wymaga glib >=2.89, rootfs ma stabilne 2.88.3