PaganOS Luna 0.6.0
PL EN DE
🔒 Repository is read-only – file editing is disabled.

pagan-welcome/README.md main

137 lines Raw ← Back

Pagan-Welcome

Centrum startowe PaganLinux – jedno okno, z którego nowy użytkownik może poznać system, zainstalować go, zaktualizować i dobrać podstawowe ustawienia.

Interfejs zbudowany jest na GTK3 (natywnie dla tej dystrybucji, bez dodatkowych zależności w obrazie). Ciężkie zadania sieciowe i parsowanie (HTML dokumentacji, JSON repozytorium) wykonuje backend w Pythonie (pagan-welcome-backend), dzięki czemu warstwa GTK zajmuje się wyłącznie prezentacją.

Funkcje

Sekcja Co robi
Nowości Pobiera informacje o wydaniach z https://docs.paganlinux.eu/docs/paganlinux i pokazuje je jako listę zmian. Treść zmienia się razem z językiem interfejsu (backend wysyła nagłówek Accept-Language). Działa też offline (ostatnia pobrana wersja z pamięci podręcznej).
Instalator Uruchamia instalator Calamares – aktywny wyłącznie w sesji live (z pendrive'a/ISO).
Aktualizacja pag update + pag upgrade (system rolling) uruchamiane we wbudowanym terminalu (pseudotty). Widać pełny przebieg, można wpisać odpowiedź dla pag i przerwać przyciskiem Przerwij.
Sklep Przeglądanie i wyszukiwanie pakietów z repozytorium PAG. Dla niezainstalowanych – Zainstaluj; dla zainstalowanych – Usuń, a gdy pakiet ma aplikację graficzną – dodatkowo Otwórz.

Wi-Fi (pagan-wifi) uruchamiane z przycisku w nagłówku okna (oraz z apletu tray).

Interfejs jest dwujęzyczny (PL/EN). Język wybiera się w nagłówku i jest zapamiętywany w ~/.config/pagan-welcome/config.ini. Gdy język jest nieustawiony, domyślnie używany jest angielski.

Tryby uruchomienia

pagan-welcome                       # okno główne
pagan-welcome --page update         # od razu strona aktualizacji
pagan-welcome --page store          # od razu sklep
pagan-welcome --tray                # aplet tray + powiadomienia (autostart)
pagan-welcome --check               # wypisz liczbę dostępnych aktualizacji (CLI)
pagan-welcome --version

Aplet panelu (tray)

pagan-welcome --tray działa w tle jako aplet: pokazuje ikonę w tacce systemowej panelu (XFCE: wtyczka systray), cyklicznie (co 6 h) sprawdza aktualizacje przez pag update, a gdy są dostępne – wysyła powiadomienie (libnotify) i zmienia podpowiedź ikony. Menu apletu pozwala sprawdzić aktualizacje, uruchomić aktualizację, otworzyć Pagan-Welcome lub ustawienia.

Aplet startuje automatycznie przy logowaniu (/etc/xdg/autostart/pagan-welcome.desktop).

„Nie pokazuj tego okna przy logowaniu”

Pole wyboru w nagłówku zapisuje show_on_login=false w konfiguracji. Aplet nadal działa w tle – ukrywane jest tylko okno główne. Aby je przywrócić, odznacz pole (albo ustaw show_on_login=true).

Aktualizacja we wbudowanym terminalu

Aktualizacja nie musi już otwierać zewnętrznego emulatora terminala. pag uruchamiany jest pod pseudottty (PTY) wbudowanym w aplikację, dzięki czemu:

  • pag widzi prawdziwy terminal – nie „zawiesza się” na braku wejścia i nie blokuje menedżera pakietów;
  • przebieg widać na żywo (kolory ANSI są czyszczone, a strumień obsługuje końce linii tty);
  • pole Odpowiedź pozwala wpisać tekst, gdyby pag o coś spytał;
  • przycisk Przerwij kończy proces (SIGTERM na całą grupę).

pag uruchamiany jest z PAG_YES=1 (potwierdzenie automatyczne). Gdy trzeba hasła roota, aplikacja pyta o nie i podaje je na wejście procesu bez echa (echo na PTY jest wyłączane na czas podania hasła).

Uprawnienia

Operacje wymagające roota (aktualizacja, instalacja pakietów, zmiana locale) wykonuje warstwa uprawnień:

  1. jako root – bezpośrednio,
  2. pkexec – gdy w sesji działa agent polkit (graficzne okno autoryzacji),
  3. sudo -S – w przeciwnym razie (aplikacja prosi wtedy o hasło w okienku).

Budowa i instalacja

make                 # zbuduj pagan-welcome
sudo make install    # zainstaluj do systemu

Wymagania budowy: gtk+-3.0, libnotify (pkg-config), kompilator C11.

Instalowane pliki:

Plik Przeznaczenie
/usr/bin/pagan-welcome aplikacja (okno + tray)
/usr/bin/pagan-welcome-backend backend: nowości, repo, ustawienia (TSV)
/usr/share/applications/pagan-welcome.desktop wpis „Pagan-Welcome”
/usr/share/applications/pagan-welcome-updates.desktop wpis „Aktualizacje PaganLinux”
/etc/xdg/autostart/pagan-welcome.desktop aplet startujący przy logowaniu
/usr/share/pixmaps/pagan-welcome.png ikona (z branding/)

Backend CLI

Backend wypisuje dane w formacie TSV (jedna linia = jedno zdarzenie):

pagan-welcome-backend news pl    # UPDATED/CACHED/TITLE/REL/NOTE
pagan-welcome-backend repo       # PKG: nazwa, wersja, rozmiar, opis, zależności, licencja
pagan-welcome-backend installed  # INST: nazwa, wersja
pagan-welcome-backend updates    # UPDATES: liczba
pagan-welcome-backend pkgfiles <pakiet>  # GUI 1/0 + DESKTOP: nazwa, Exec
pagan-welcome-backend sysinfo    # LOCALE/KEYMAP/TIMEZONE/HOSTNAME/LIVE/CALAMARES/PAG
pagan-welcome-backend timezones  # TZ: lista stref

Dzięki temu backend da się testować i wywoływać niezależnie od GUI.

Dodawanie języka

  1. Dopisz kod i nazwę w pw-i18n.c (tablica TABLE) oraz – jeśli trzeba – locale w LOCALE_BY_LANG.
  2. Uzupełnij tłumaczenia nowych kluczy.

Brakujący klucz jest po cichu uzupełniany z polskiego, więc aplikacja nigdy nie pokaże surowego identyfikatora.

Tłumaczenia treści nowości

Treść nowości pochodzi ze strony dokumentacji. Język wybiera backend, wysyłając nagłówek Accept-Language (pl/en) – serwer (blueprints/docs.py, get_lang()) rozpoznaje go i zwraca wersję językową dokumentu. Gdy danej wersji brak, serwer zwraca dostępną (fallback) – to zachowanie serwera. Dzięki temu zmiana języka w nagłówku przeładowuje także treść pobieraną z sieci.

Licencja

GPL-3.0-or-later – pełny tekst w pliku LICENSE.

Copyright (C) 2026 PaganLinux