RSS Guard – poradniki, instrukcje

RSS Guard

RSS Guard to prosty czytnik kanałów obsługujący internetowe usługi informacyjne.

To agregator kanałów RSS/RDF/ATOM/JSON opracowany przy użyciu frameworka Qt, który obsługuje synchronizację kanałów online z następującymi usługami: Tiny Tiny RSS, Inoreader, Nextcloud News, Gmail API, FreshRSS, The Old Reader, Bazqux, Reedah.

Info: aby wyświetlać pełny rozmiar zrzutów ekranu, klikajcie prawym przyciskiem myszy i wybierzcie „Otwórz obraz”

Filozofia numeracji wersji RSS Guard

RSS Guard używa wersjonowania semantycznego. Schemat wersji to X.Y.Z, gdzie:

  • X – oznacza główną wersję wydania. Liczba ta zmienia się bardzo rzadko i wskazuje na nowe krytyczne zmiany, które naruszają wsteczną zgodność
    -Y – oznacza, że dostępna jest nowa główna funkcja
    -Z – oznacza, że zostały wprowadzone nowo naprawione błędy lub małe funkcje.
RSS Guard jest dystrybuowany w dwóch wariantach
  • Standardowy pakiet z dołączoną przeglądarką wiadomości opartą na WebEngine: ten wariant wyświetla wiadomości z ich pełnym formatowaniem i układem we wbudowanej przeglądarce internetowej opartej na Chromium. Ten wariant RSS Guard powinien być przyjemny dla każdego, kto nie dba o zużycie pamięci. Ponadto pakiety instalacyjne są stosunkowo duże.
  • Pakiet Lite z prostą przeglądarką wiadomości tekstowych: ten wariant wyświetla wiadomość w znacznie prostszym i lżejszym komponencie tekstowym. Wszystkie pakiety tego wariantu mają w nazwie słowo kluczowe nowebengine. Układ i formatowanie wyświetlanej wiadomości jest uproszczone, nie używa się dużych zewnętrznych przeglądarek internetowych, co skutkuje znacznie mniejszymi pakietami instalacyjnymi, znacznie mniejszym zużyciem pamięci i zwiększoną prywatnością użytkownika, ponieważ wiele zasobów internetowych nie jest domyślnie pobieranych, takich jak zdjęcia, JavaScript i wkrótce. Ten wariant RSS Guard jest przeznaczony dla zaawansowanych użytkowników i oferuje szybszą odpowiedź GUI w niektórych przypadkach użycia.

Jeśli nie masz pewności, której wersji użyć, użyj funkcji RSS Guard opartej na WebEngine.

Back-endy baz danych

RSS Guard oferuje przełączalne bazy danych, które przechowują Twoje dane. W tym momencie dostępne są dwa back-endy:

  • MariaDB,
  • SQLite (domyślnie).
    Back-end SQLite jest bardzo prosty w użyciu, nie wymaga dalszej konfiguracji, a wszystkie dane są przechowywane w jednym pliku
<user-data-root-path>\database\local\database.ini

Sprawdź Informacje o RSS Guard -> okno dialogowe Zasoby, aby znaleźć więcej informacji na temat najważniejszych używanych ścieżek. Ten back-end oferuje opcję bazy danych „w pamięci”, która automatycznie kopiuje wszystkie dane do pamięci RAM po uruchomieniu aplikacji, a następnie działa wyłącznie z tymi danymi w pamięci RAM, co sprawia, że funkcja RSS Guard jest niesamowicie szybka. Dane są również zapisywane z powrotem do pliku bazy danych po zamknięciu aplikacji. Zauważ, że ta opcja powinna być używana bardzo rzadko, ponieważ funkcja RSS Guard powinna być wystarczająco szybka w przypadku klasycznych trwałych plików DB SQLite. Więc używaj tego tylko wtedy, gdy wiesz, co robisz.

Back-end MariaDB (MySQL) jest przeznaczony dla użytkowników, którzy chcą przechowywać swoje dane w sposób scentralizowany. Możesz mieć jeden serwer w swojej sieci i korzystać z wielu instancji RSS Guard w celu uzyskania dostępu do danych. MySQL będzie również działać znacznie lepiej, jeśli wolisz przechowywać miliony źródeł i wiadomości.

Aby zapoznać się z konfiguracją związaną z bazą danych, zobacz Ustawienia -> Okno dialogowe przechowywania danych.

Google Reader API

Począwszy od RSS Guard 3.9.0 pojawiła się nowa wtyczka, która oferuje synchronizację z usługami za pomocą Google Reader API. Wtyczka była do tej pory testowana z FreshRSS, The Old Reader i Bazqux. Wszystkie usługi obsługujące interfejs API czytnika Google powinny działać. Zwróć uwagę, że Inoreader ma własną, oddzielną wtyczkę, ponieważ używa OAuth, jako metody uwierzytelniania, dlatego lepiej jest mieć oddzielną wtyczkę. Integracja Google Reader API z RSS Guard umożliwia ustawienie niestandardowego punktu końcowego usługi, nawet jeśli wybierzesz usługę, która nie jest hostowana samodzielnie, na przykład Bazqux, zapewniając wszystkim użytkownikom większą elastyczność i swobodę.

Należy pamiętać, że nawet jeśli wszystkie usługi obsługujące interfejs API Czytnika Google powinny być zgodne z interfejsem API, nadal istnieją pewne drobne różnice, głównie dlatego, że interfejs API czytnika Google nie ma ścisłej dokumentacji, a niektóre usługi nie oferują niektórych funkcji.

Na przykład, wydaje się, że stary czytnik nie oferuje funkcji tagów/etykiet, dlatego tagi/etykiety w usłudze RSS Guard nie są synchronizowane, ale nadal możesz używać etykiet offline.

Gmail

RSS Guard zawiera wtyczkę do Gmaila, która umożliwia użytkownikom odbieranie i wysyłanie (!!!) wiadomości e-mail. Wtyczka korzysta z interfejsu Gmail API i oferuje kilka funkcji podobnych do klienta poczty e-mail:

  • Wysyłanie wiadomości e-mail.
  • Możesz także odpowiadać na istniejące wiadomości.
  • Wtyczka jest w stanie zasugerować adres e-mail odbiorcy. Sugerowane adresy są odczytywane z wiadomości e-mail, które są już zapisane w bazie danych RSS Guard. Dlatego musisz mieć pobrane wiadomości e-mail, aby ta funkcja działała.
Pobieranie plików

RSS Guard oferuje prosty wbudowany program do pobierania plików.

Możesz kliknąć prawym przyciskiem myszy dowolny element we wbudowanej przeglądarce internetowej i nacisnąć przycisk Zapisz jako. RSS Guard automatycznie wyświetli narzędzie do pobierania i pobierze plik. Ta funkcja działa w obu wariantach RSS Guard.

Możesz pobrać do 6 plików jednocześnie.

AdBlock

Wersja internetowa (z przeglądarką internetową) RSS Guard oferuje funkcję blokowania reklam. AdBlock wykorzystuje standardowe skrypty podobne do AdBlock-Plus, umożliwiając w ten sposób korzystanie z EasyList, itp. AdBlock obsługuje wszystkie podstawowe funkcje formatu AdBlock-Plus, w tym reguły ukrywania elementów i blokowanie całej witryny.

GUI RSS Guard

Interfejs GUI RSS Guard jest bardzo konfigurowalny. Możesz, na przykład, ukryć wiele elementów GUI. Są nawet ludzie, którzy używają funkcji RSS Guard na urządzeniach mobilnych z systemem Linux, takich jak urządzenia PinePhone czy Librem.

Na przykład możesz ukryć menu, różne paski narzędzi, pasek stanu, a nawet nagłówki list, aby uzyskać bardzo minimalny układ okna głównego.

Jeśli ukryjesz menu główne, w lewym górnym rogu głównego okna aplikacji pojawi się mała ikona „Domu”.

Wiele osób ma obecnie bardzo szerokoekranowe monitory, a RSS Guard oferuje poziomy układ dla tego przypadku, umieszczając podgląd wiadomości po prawej stronie listy wiadomości.

Przydatne informacje na temat sposobu działania RSS Guard:

CLI (interfejs wiersza poleceń)

RSS Guard oferuje CLI (interfejs wiersza poleceń). Aby zapoznać się z jego funkcjami, uruchom rssguard --help w swoim terminalu. Zobaczysz przegląd interfejsu.

RSS Guard

Options:
  -l, --log <log-file>           Write application debug log to file. Note that logging to file may slow application down (Zapisz dziennik debugowania aplikacji do pliku. Zwróć na to uwagę, logowanie do pliku może spowolnić działanie aplikacji).
  -d, --data <user-data-folder>  Use custom folder for user data and disable single instance application mode (Użyj folderu niestandardowego dla danych użytkownika i wyłącz tryb aplikacji pojedynczej instancji).
  -s, --no-single-instance       Allow running of multiple application instances (Zezwalaj na uruchamianie wielu instancji aplikacji).
  -?, -h, --help                 Displays help on commandline options (Wyświetla pomoc dotyczącą opcji wiersza polecenia).
  --help-all                     Displays help including Qt specific options (Wyświetla pomoc, w tym opcje specyficzne dla Qt).
  -v, --version                  Displays version information (Wyświetla informacje o wersji).

Czyszczenie bazy danych

Baza danych Twojego RSS Guard może z czasem bardzo się rozrosnąć, dlatego może być konieczne regularne jej czyszczenie. W menu Narzędzia znajduje się okno dialogowe Oczyszczanie bazy danych, aby zrobić to za Ciebie, ale pamiętaj, że funkcja RSS Guard powinna działać dobrze nawet z dziesiątkami tysięcy wiadomości.

Przenośne dane użytkownika

Funkcja RSS Guard sprawdza „katalog konfiguracyjny” (jest to katalog C:\Users\ <user>\ AppData\Local w systemie Windows) pod kątem istnienia pliku:

RSS Guard\data\config\config.ini

Jeśli taki plik istnieje, funkcja RSS Guard będzie go używać (jest to nazywane nieprzenośnymi ustawieniami FALLBACK). Jeśli ten plik nie zostanie znaleziony, aplikacja sprawdzi, czy jej ścieżka główna (folder, w którym jest zainstalowany plik wykonywalny RSS Guard) jest zapisywalna, a jeśli tak, to zapisze w nim ustawienia w podfolderze:

data\config\config.ini

To jest tryb w pełni przenośny. Sprawdź Informacje o RSS Guard -> Okno dialogowe Zasoby, aby znaleźć więcej informacji na temat ważnych używanych ścieżek. RSS Guard w systemach Linux, Android lub Mac OS automatycznie wykorzystuje nieprzenośną lokalizację danych użytkownika, dzięki czemu jest ona zgodna ze standardem XDG.

Pobieranie nowych wiadomości

Oto przybliżony przepływ pracy, który jest wykonywany po naciśnięciu Źródła i kategorie -> Aktualizuj wszystkie elementy lub Kanały i kategorie -> Aktualizuj wybrane elementy. W tym momencie dzieje się tak:

  1. RSS Guard tworzy listę wszystkich lub wybranych kanałów.
  2. Po kolei, dla każdego kanału zrób:
    a) Pobierz wszystkie dostępne wiadomości ze źródła online.
    b) Po kolei, zrób to dla każdej pobranej wiadomości:
    -oczyść tytuł wiadomości. Obejmuje to zastąpienie wszystkich nierozdzielających spacji zwykłymi spacjami, usunięcie wszystkich wiodących spacji, zastąpienie wszystkich wielu następujących po sobie spacji, pojedynczą spacją. Treść wiadomości jest konwertowana z kodowania procentowego
    -uruchom wszystkie filtry wiadomości, jeden po drugim, jeden po drugim. Buforuj odczytane lub ważne atrybuty wiadomości (lub zmiany etykiet) zmienione przez filtry na kolejkę, która jest później synchronizowana z powrotem do usługi dostarczania online
    -zapisz wiadomość w bazie danych RSS Guard, tworząc dla niej zupełnie nowy wpis DB lub zastępując istniejącą wiadomość. Zauważ, że dwie wiadomości są uważane za tę samą wiadomość, jeśli mają identyczny adres URL, autora i tytuł oraz należą do tego samego źródła. Nie dotyczy to zsynchronizowanych źródeł (TT-RSS, Inoreader i inne), w których każda wiadomość ma przypisany specjalny identyfikator, który jednoznacznie identyfikuje wiadomość.

© Martin Rotter