# 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 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 ```sh 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 ```sh 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): ```sh 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 # 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](LICENSE). Copyright (C) 2026 PaganLinux