selfoss

selfoss 2.20-SNAPSHOT

selfoss ist eine vielseitige RSS-Reader- und Feed-Aggregations-Webanwendung. Damit können Sie Updates von verschiedenen Websites, sozialen Netzwerken und anderen Plattformen ganz einfach an einem Ort verfolgen. Es ist in PHP geschrieben, sodass Sie es praktisch überall ausführen können.

Weitere Informationen finden Sie auf unserer Website.

Status

selfoss wird derzeit von Jan Tojnar in seiner Freizeit betreut. Aufgrund der begrenzten Kapazität hat die Wartung Vorrang vor neuen Funktionen. Pull-Anfragen sind willkommen, siehe Beitragsleitfaden.

Herunterladen

• Stabile Releases – wenn Sie nur Selfoss verwenden möchten.
• Entwicklungs-Builds – wenn Sie unveröffentlichte Funktionen oder Fehlerbehebungen ausprobieren oder beim Testen helfen möchten. Gastgeber: Cloudsmith
• Git-verfolgter Quellcode – wenn Sie an der Selfoss-Entwicklung teilnehmen möchten. Etwas Montage erforderlich.

Installation

1. Laden Sie alle Dateien dieses Verzeichnisses hoch (WICHTIG: Laden Sie auch die unsichtbaren .htaccess Dateien hoch).
2. Machen Sie die Verzeichnisse data/cache , data/favicons , data/logs , data/thumbnails und data/sqlite beschreibbar.
3. Datenbank-Zugangsdaten in config.ini einfügen (siehe unten). Sie müssen nichts ändern, wenn Sie SQLite verwenden möchten.
4. Sie müssen die Datenbanktabellen nicht erstellen, sie werden automatisch erstellt (stellen Sie sicher, dass Ihr Datenbankbenutzer berechtigt ist, Trigger zu erstellen).
5. Erstellen Sie einen Cronjob oder einen Systemd-Timer zum Aktualisieren von Feeds und verweisen Sie ihn über wget oder curl auf https://yourselfossurl.com/update. Sie können cliupdate.php auch über die Befehlszeile ausführen.

Wenn Sie Selfoss mit Git erhalten haben, sind einige weitere Schritte erforderlich. Siehe Abschnitt „Entwicklung“.

Bei weiteren Fragen oder Problemen nutzen Sie unser Support-Forum: https://forum.selfoss.aditu.de/

Konfiguration

Für die Verwendung von selfoss ist keine Konfiguration erforderlich, Sie können die Einstellungen jedoch wie folgt anpassen:

1. Benennen Sie config-example.ini in config.ini .
2. Bearbeiten Sie config.ini und löschen Sie alle Zeilen, die Sie nicht überschreiben möchten.
3. Beispiele finden Sie unter https://selfoss.aditu.de/.

Aktualisieren

1. Sichern Sie Ihre Datenbank und Ihr data/ Verzeichnis.
2. (WICHTIG: Löschen Sie NICHT das Verzeichnis data/ .) Löschen Sie alle alten Dateien und Verzeichnisse mit Ausnahme des Verzeichnisses data/ und der Datei config.ini
3. Laden Sie alle neuen Dateien und Verzeichnisse mit Ausnahme des data/ -Verzeichnisses hoch (WICHTIG: Laden Sie auch die unsichtbaren .htaccess Dateien hoch).
4. Konsultieren Sie die NEWS-Datei, um mehr über abwärtsinkompatible Änderungen zu erfahren.
5. Bereinigen Sie Ihren Browser-Cache.
6. Fügen Sie Ihre aktuelle Datenbankverbindung und Ihre individuelle Konfiguration in config.ini ein. Wichtig: Wir ändern die config.ini und fügen in neueren Versionen neue Optionen hinzu. Sie müssen auch die config.ini aktualisieren.
7. Die Datenbank wird automatisch aktualisiert (stellen Sie sicher, dass Ihr Datenbankbenutzer berechtigt ist, Trigger zu erstellen).

Wenn Sie Selfoss mit Git erhalten haben, sind möglicherweise einige weitere Schritte erforderlich. Siehe Abschnitt „Entwicklung“.

Bei weiteren Fragen oder Problemen nutzen Sie unser Support-Forum: https://selfoss.aditu.de/forum

Unterstützung

• Issue-Tracker zum Melden von Problemen und Anfordern neuer Funktionen
• Forum für allgemeine Fragen zur Nutzung
• Chatten Sie auf Gitter (oder #selfoss:matrix.org Mirror), um über die Selfoss-Entwicklung oder so ziemlich alles zu diskutieren

OPML-Import

Selfoss unterstützt den Import von OPML-Dateien. Suchen Sie den OPML-Export in der alten Anwendung. Er befindet sich normalerweise irgendwo in den Einstellungen. Dann besuchen Sie die Seite https://yourselfossurl.com/opml und laden Sie es dort hoch.

Apps von Drittanbietern

Wir empfehlen Reader For Selfoss für Android-Geräte.

Entwicklung

Selfoss verwendet Composer und NPM für die Installation externer Bibliotheken. Wenn Sie das Repository klonen, müssen Sie composer install ausführen, um die externen Quellen abzurufen.

Für die Client-Seite müssen Sie außerdem JavaScript-Abhängigkeiten installieren, indem Sie npm install im Verzeichnis client/ aufrufen. Sie können npm run install-dependencies als Verknüpfung zum Installieren beider Abhängigkeitssätze verwenden.

Wir verwenden Parcel (installiert mit dem obigen Befehl), um die Client-Seite von Selfoss zu erstellen. Jedes Mal, wenn sich etwas im Verzeichnis client/ “ ändert, müssen Sie npm run build ausführen, damit der Client erstellt und im public Verzeichnis installiert wird. Bei der Entwicklung können Sie auch npm run dev verwenden; Es überwacht Asset-Änderungen, erstellt die Bundles nach Bedarf neu und lädt Selfoss automatisch neu. Beim Wechsel zwischen npm run dev und npm run build müssen Sie möglicherweise client/.cache löschen.

Wenn Sie ein Paket mit allen gebündelten Abhängigkeiten erstellen möchten, können Sie den Befehl npm run dist ausführen, um einen Zipball zu erstellen.

Von jedem Patch wird erwartet, dass er unserem Codierungsstil entspricht, der von CI automatisch überprüft wird. Sie können die Prüfer lokal mit npm run install-dependencies installieren und die Prüfungen dann mit npm run check ausführen, bevor Sie eine Pull-Anfrage senden. Es gibt auch npm run fix , das versucht, die Formatierung zu korrigieren.

Credits

selfoss wurde von Tobias Zeising erstellt und der Quellcode ist unter der GNU General Public-Lizenz Version 3 oder (nach Ihrer Wahl) einer späteren Version lizenziert.

Einige Teile des Quellcodes können nur unter Version 3 lizenziert werden. Wir versuchen derzeit, das Problem zu beheben.

Das Paket mit gebündelten Abhängigkeiten wird möglicherweise nur unter Version 3 verteilt.

Ein ganz besonderer Dank geht an alle Mitwirkenden von Pull Requests hier auf GitHub sowie an die Übersetzer auf Weblate. Deine Verbesserungen sind großartig!

Besonderer Dank geht an die großartigen Programmierer dieser von selfoss verwendeten Bibliotheken:

• FatFree PHP Framework
• SimplePie
• WideImage
• htmLawed
• PHP Universal Feed Generator
• Elphin IcoFileLoader
• Graby
• FullTextRSS-Filter
• Noch ein React-Lightbox

Symbol erstellt von http://blackbooze.com/

Das Hosting des Paket-Repositorys wird freundlicherweise von Cloudsmith bereitgestellt. Cloudsmith ist die einzige vollständig gehostete, cloudnative, universelle Paketverwaltungslösung, die es Ihrem Unternehmen ermöglicht, Pakete in jedem Format und an jedem Ort mit völligem Vertrauen zu erstellen, zu speichern und zu teilen.