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).
- f927fe23 Update recipe busybox
- 61a7ee5e build-essential: nowy metapakiet narzedzi buildowych
- 711613c3 neovim: dodaj libnsl do depends (nvim linkuje libnsl.so.3)
- 63f820c5 neovim: nowa receptura 0.12.6 (bundlowane zaleznosci)
- d2e99817 Update recipe pag
- 12131bb2 Update recipe pag
- 2c9cd49f chrome: symlinki relatywne zamiast absolutnych (pag pomija absolutne przy instalacji)
- a9cf897b chrome: usun opcjonalne shimy Qt (bez zaleznosci qtbase/qt6-base)
- b840cb42 qemu/libvirt/virt-manager/ovmf/chrome: naprawa KVM, modułów QEMU i sandboxa Chrome
- 4ccc6e43 auto-fix: SHA256 sums (8 recipes)
- 4c5dcab8 check-updates: pam, rsync, curl, bc, pkgconf, cmake, libpng, libgcrypt, gpm, shadow, util-linux, git, iana-etc, isl, meson, libarchive, groff, xz, gzip, hwdata, openssl, systemd, psmisc, freetype, glib, perl, automake, pcre2, coreutils, flatpak, terminator, libndi-bin, firefox, libnotify, graphicsmagick, gnupg, gnucash, font-adobe-100dpi, zathura, libwmf, poppler, libical, xed, fox, dbus-glib, nestopia, cups, cairomm, thunderbird, libvirt, font-bh-type1, telepathy-glib, xorgproto, kirigami-addons, youtube-dl, font-bh-lucidatypewriter-100dpi, vulkan-tools, opensubdiv, xfe, libportal, thunar, spice-gtk, mlt, cppcheck, qemu, gimp, foomatic-db-nonfree, plasma-wayland-protocols, ibus, bluez, umockdev, telepathy-idle, libpcap, flameshot, font-arabic-misc, font-adobe-utopia-100dpi, mesa, xfce4-elementary-icon-theme, font-ibm-type1, mutt, frei0r-plugins, nmap, font-bh-ttf, goffice, keepassxc, freetube, otto, font-xfree86-type1, font-bitstream-100dpi, xorg-server, pulseaudio-qt, font-adobe-utopia-type1, appstream, gnome-desktop, hyprland-protocols, vokoscreen, freerdp, font-misc-ethiopic, hwdata, telepathy-mission-control, imlib2, tcpdump, libsecret, libevdev, libheif, wireshark, conky, python-cairo, android-file-transfer, egl-wayland, feh, samba, layers, enchant, elementary-xfce-hidpi, worker, bleachbit, vulkan-icd-loader, codeblocks, pangomm, telegram-desktop, minidlna, hplip, vscodium, xreader, grisbi, art, noto-fonts-emoji, font-bh-100dpi, libayatana-appindicator, atril, shotcut, gvim, gstreamer, ffmpeg, gegl, xapp, pdfio, md4c, lame, kernel, libmikmod, tmux, b43-fwcutter, python-poetry-core, openexr, subversion, spirv-llvm-translator, libzip, openssh, sysklogd, squashfs-tools, powertop, gpgme, libnftnl, python-werkzeug, vulkan-headers, qpdf, discount, pybind11, fuse, polkit, re2c, libcap-ng, tor, astyle, libtorrent-rasterbar, patchelf, iw, python-codestyle, stunnel, apache-ant, alsa-ucm-conf, libmd, proftpd, python-parsing, socat, pavucontrol-qt, fast_float, sysstat, hunspell, mdp, bubblewrap, libtheora, ruby, fribidi, parted, rpcbind, protobuf, sysvinit, libfyaml, redis, cargo-c, ntfs-3g, man-pages, intel-gmmlib, yaml-cpp, benchmark, libjuice, cryptsetup, bogofilter, python-idna, libqalculate, python-installer, wireless-regdb, gdb, acpica, xfsprogs, libsigc++, rust-bindgen, dkms, jemalloc, vim, python-curl, openldap, nginx, nfs-utils, dos2unix, glslang, python-astroid, scons, cifs-utils, libsrtp, python-fonttools, libgit2, android-udev, libtirpc, catch2, gpgmepp, utf8cpp, snappy, exiv2, weechat, swig, fdk-aac, spirv-headers, opentimeline, libgsf, inotify-tools, python-charset-normalizer, containerd, libnfs, faad2, opensp
- 968a5fd4 darktable: usun #error dla lensfun 0.3.95 (kod LF_0395 juz jest)
- 623aeeac darktable: usun tez loop-nest-optimize z extra_optimizations.h (Graphite/ISL)
- c964080c darktable: usun flagi Graphite z #pragma GCC optimize (GCC bez ISL -> twardy blad)
- 12466821 darktable: -DUSE_GMIC=OFF (wymagane GMIC bez niego)