Kiwix js pwa
Kiwix
Demos: [ PWA auf dem Desktop installieren ] [ Installieren und verwenden: Android ] [ Installieren und verwenden: Firefox Android ] [ Ordner mit Archiven auswählen ] [ Dateiverwaltung (Desktop) ] [ Demo aller OPFS-Funktionen ] [ App zur Edge-Seitenleiste hinzufügen ]
Kiwix ist ein Offline-Browser für Wikipedia, Project Gutenberg, TED Talks, Wikivoyage, Stackexchange und viele andere Websites und Ressourcen. Es stellt Wissen in vielen verschiedenen Sprachen für Menschen mit eingeschränktem oder keinem Internetzugang zur Verfügung. Die Nutzung der Software und der Inhalte ist für jedermann kostenlos. Holen Sie sich die App und laden Sie Offline-Inhalte Ihrer Wahl herunter (ZIM-Archive, die kostenlos in der App heruntergeladen werden können). Es stehen Hunderte mehrsprachiger Archive zu vielen verschiedenen Themen und Themen zur Auswahl. Bauen Sie eine ganze digitale Bibliothek mit Offline-Wissen auf!
Als Teil der Kiwix-Familie ist diese App entweder als offlinefähige, installierbare Progressive Web App (PWA) für fast alle modernen Browser und Geräte oder als App-Pakete für verschiedene Windows- und Linux-Betriebssysteme verfügbar: siehe Kiwix JS für Windows und Linux . Verwenden Sie für Mac und iOS die Offline-PWA.
Wir haben auch verpackte Apps von WikiMed von Kiwix (eine vollständige medizinische Enzyklopädie) und Wikivoyage von Kiwix (ein vollständiger Reiseführer) auf Englisch – kein zusätzlicher Download erforderlich! (Sie können in diesen Apps jedoch auch andere Sprachen herunterladen.)
Wenn Sie Windows 10 oder 11 verwenden, sind alle drei Apps bequem im Microsoft Store verfügbar: Kiwix JS UWP , WikiMed von Kiwix und Wikivoyage von Kiwix . Sie werden automatisch aktualisiert, wenn ein neues Paket verfügbar ist. Wenn Sie Linux verwenden, aktualisiert sich auch das Electron AppImage-Paket von Kiwix JS (optional) selbst, ebenso wie das installierbare Windows Electron-Paket. Andere Apps benachrichtigen Sie, wenn ein Update verfügbar ist.
Mögen Sie keine Geschäfte oder Pakete? Wir sind für Sie da! Starten Sie diese App sofort, indem Sie die installierbare, offline-fähige PWA (Progressive Web App) jetzt in Ihrem Browser unter pwa.kiwix.org öffnen. Dies funktioniert in jedem Browser, der Service Workers unterstützt: modernes Chrome, Edge, Firefox und Safari (beachten Sie, dass Sie auf iOS-Geräten Safari verwenden müssen, da Apple die Verwendung von Service Workers in allen anderen Browsern auf i-Geräten verbietet).
Holen Sie sich ein kostenloses ZIM-Archiv zur Verwendung mit der PWA auf der Konfigurationsseite der App, oder Sie können eine Vorschau eines ZIM unter Library.kiwix.org anzeigen, bevor Sie eines herunterladen. Sobald die PWA installiert, mit einem Lesezeichen versehen oder zu Ihrem Startbildschirm hinzugefügt wurde, funktioniert sie auch dann, wenn Ihr Gerät vollständig offline ist! Schauen Sie sich unsere Demo an, die zeigt, wie schnell und einfach die Installation der PWA ist.
Wenn Sie es mit Bildern möchten, beachten Sie bitte, dass es sich um einen großen Download handelt: Die englische Version ist etwa 97 Gigabyte groß! Wir empfehlen Ihnen, es zunächst mit einem der viel kleineren Themenarchive wie Astronomie, Chemie, Mathematik, Physik usw. auszuprobieren. In der App finden Sie ein praktisches Dropdown-Menü, mit dem Sie Ihre Sprache und Ihr Thema auswählen können , und laden Sie es dann herunter. Das Archiv wird in Ihren Browser heruntergeladen.
Wenn Sie wirklich eine vollständige englische Wikipedia mit Bildern möchten, empfehlen wir Ihnen dringend, die Open-Source-App qBittorrent zu verwenden, um sie auf einen PC mit ausreichend Speicherplatz herunterzuladen. Installieren Sie zuerst qBittorrent. Wenn Sie dann in der App ein großes Archiv zum Herunterladen auswählen, wird Ihnen ein Torrent-Link angezeigt. Klicken Sie auf den Link und erlauben Sie Ihrem Browser, die Torrent-Datei herunterzuladen und zu öffnen. Diese kleine Datei wird in qBittorrent geöffnet und Sie werden gefragt, wo Sie das Archiv speichern möchten, das Sie herunterladen möchten. Es ist viel einfacher als es klingt!
Zimit ist ein Dienst, mit dem jede Website als ZIM archiviert werden kann. Es gibt jedoch viele spannende vorgecrawlte Zimit-basierte ZIMs, die Sie verwenden können (siehe unten). Wenn Sie Ihr eigenes machen möchten, probieren Sie es unter https://youzim.it/ aus. Die Kiwix JS PWA- und Electron-Apps bieten vollständige Unterstützung für Zimit-basierte Archive ab Version 2.8.5 unter Verwendung des Open-Source-Readers Replay Web Archive und unterstützen bereits das kommende Zimit v2-Format. Bitte beachten Sie, dass die meisten Zimit-Archive aufgrund ihres hochdynamischen Inhalts den ServiceWorker-Modus erfordern.
Die Kiwix-Download-Bibliothek (in der App verfügbar) veröffentlicht eine Reihe fantastisch nützlicher Referenzseiten im Zimit-Dateiformat, wie z. B. die Katastrophenvorsorge-Website Ready.Gov , das faszinierende Low-Tech-Magazin , das CIA World Factbook und die Harmony Project -Bibliothek von Notenblättern und der Internet Encyclopaedia of Philosophy – neben vielen anderen. Öffnen Sie einfach das Zimit-Verzeichnis in der In-App-Bibliothek.
Wir sind stolz darauf, die Unterstützung für alte Browser und Plattformen aufrechtzuerhalten, da eine wichtige Zielgruppe dieser App aus Benutzern in Entwicklungsländern besteht, die möglicherweise nur Zugriff auf alte Geräte mit veralteter Software haben. Wir testen die App regelmäßig auf älteren Browsern und Betriebssystemen. Die App erkennt normalerweise, welche Funktionen in einem bestimmten Browser nicht funktionieren, und deaktiviert sie oder umgeht sie. In einigen Fällen (z. B. Firefox <= 59) stellt sich die App jedoch selbst in den Service-Worker-Modus ein, dieser Modus schlägt jedoch stillschweigend fehl. Falls betroffen, versuchen Sie bitte, die App in den eingeschränkten Modus zu versetzen (siehe Content-Injection-Modus in der Konfiguration).
Als Progressive Web App (PWA) auf Linux, Windows, Android, iOS, macOS:
Google Chrome / Chromium >= 59 (und viele auf Chromium basierende Browser, z. B. Opera, Samsung Internet)
Microsoft Edge (Chromium) >= 79
Mozilla Firefox >= 68 (siehe aber Hinweis zu Android * )
Apple Safari >= 11.3 für iOS und macOS (Volltextsuche funktioniert nur auf iOS 15+)
Microsoft Edge Legacy 18 (nur Windows)
Als Anwendung implementiert mit den folgenden Frameworks:
Electron >= 1.8.0 (Ubuntu, Debian, Fedora, OpenSUSE, AppImage, Windows): GitHub-Veröffentlichung
Universelle Windows-Plattform (UWP) >=10.0.10240: Microsoft Store-App oder GitHub-Version – Windows 10/11 (Electron), Windows auf ARM, Xbox, Windows 10 Mobile
NWJS >= 0.23.0 (Windows 7/8/10/11): GitHub-Veröffentlichung
NWJS 0.14.7 (nur Windows XP/Vista): GitHub-Veröffentlichung
* Mit Firefox auf Android kann die App nur mit Dateien verwendet werden, die im Origin Private File System gespeichert sind. Es gibt einen Firefox-Fehler, bei dem der Browser versucht, das gesamte ZIM-Archiv in den Speicher einzulesen, wenn es aus dem für den Benutzer sichtbaren Dateisystem geöffnet wird.
Obwohl veraltet, werden wir den Support so lange wie möglich aufrechterhalten:
Internet Explorer 11 (nur eingeschränkter Modus, keine Offline-Nutzung von PWA)
Edge Legacy <= 17 (nur eingeschränkter Modus, keine Offline-Nutzung von PWA)
Firefox 45–67 (einige Versionen erfordern, dass der Benutzer manuell in den eingeschränkten Modus wechselt, und einige können keine WebP-Bilder anzeigen)
Chromium 49–58 (einige Versionen laufen nur im eingeschränkten Modus)
Bitte verwenden Sie den Issue-Tracker dieses Repositorys, um alle Fehler zu melden, die Sie in der Software gefunden haben. Öffnen Sie ein neues Ticket (nachdem Sie überprüft haben, dass für das von Ihnen identifizierte Problem noch kein Ticket besteht). Bitte geben Sie deutlich die von Ihnen verwendete Versionsnummer an (oben auf der Konfigurationsseite in der App) und welchen Browser oder welche Plattform Sie verwenden.
Wenn Sie Schwierigkeiten mit der Software haben oder eine neue Funktion sehen möchten, eröffnen Sie bitte ebenfalls ein Ticket. Alternativ finden Sie im Abschnitt „Feedback“ auf der Seite „Info“ der App weitere Möglichkeiten, technischen Support für Ihr Problem zu erhalten. Nehmen Sie Kontakt mit uns auf (siehe „Über“-Seite der App), wenn Sie einfach nur Feedback geben möchten, oder hinterlassen Sie eine Bewertung, wenn Sie die App in einem Store erworben haben. Wenn Ihnen die App gefällt, markieren Sie bitte dieses Repostiory (siehe oben)!
Dieses Repository dient der Entwicklung der Kiwix JS-App für PWA, Electron, NWJS und Windows 10/11 Universal Windows Platform (UWP). Der neueste Code befindet sich normalerweise im Hauptzweig, dieser wird jedoch für die aktive Entwicklung verwendet und kann mehrere Commits vor der Veröffentlichung erfolgen. Installierbare und portable Versionen für Windows (XP/Vista/7/8/10/11) und Linux (32bit und 64bit) sind ab Releases verfügbar. Zusammen mit einer Entwicklungsbereitstellung sind instabile Nightly-Builds der Electron- und NWJS-Apps verfügbar, der Code kann jedoch fehlerhaft sein und sich schnell ändern. Darüber hinaus sind nächtliche Windows-Binärdateien nicht signiert .
Der Code basiert auf Kiwix JS, einer leichten HTML/JavaScript-Portierung des Kiwix Offline-Readers. Es wurde erheblich weiterentwickelt, diese App für verschiedene Frameworks zu packen und einige Funktionen hinzuzufügen, die oft von den Originalautoren zurückportiert werden. Die PWA kann als vollständig integrierte System-App installiert werden, wenn sie in einem modernen Chromium-Browser geöffnet wird, und sie nutzt die File System Access API und die File Handling API für ein natives Erlebnis in Browsern, die diese APIs unterstützen. Weitere Informationen zu diesen APIs finden Sie unten auf dieser Seite: Dateisystemzugriffs-API und Dateiverwaltung.
Die Apps sind auch im WinGet Package Manager verfügbar. Sie können die UWP-Version (in Windows 10/11) seitlich laden, indem Sie eine Eingabeaufforderung oder ein PowerShell-Terminal öffnen und winget install kiwix.kiwixjs eingeben (diese Version wird nicht automatisch aktualisiert, informiert Sie jedoch, wenn ein neues Update bereit ist). installieren). Alternative Anweisungen zum Seitenladen finden Sie in den Versionshinweisen. Die Electron-Version kann mit winget install kiwix.kiwixjs.electron oder durch Herunterladen eines Pakets von Releases installiert werden. Zu Testzwecken werden die Store-, Electron- und NWJS-Versionen mit einem Miniarchiv der 100 besten Wikipedia-Artikel geliefert (ohne Bilder und nur mit dem Lede-Absatz).
Einige ZIM-Archive sind tatsächlich sehr groß, daher können die zugrunde liegenden Grenzen des Dateisystems eine Überlegung sein. Bei den meisten Speichertypen (einschließlich microSD-Karten), die als exFAT oder NTFS formatiert sind, können Sie selbst diese sehr großen Dateien problemlos im Speicher speichern. Wenn Sie jedoch planen, Ihre ZIM-Datei auf einer SD-Karte im FAT32- Format zu speichern und ein Archiv mit mehr als 4 GB verwenden möchten, müssen Sie das ZIM aufteilen: siehe Anweisungen zur Dateiaufteilung.
Ein großer Teil der Entwicklung dieser App findet vorgelagert im Kiwix JS-Repository statt, an dem ich aktiv mitarbeite. Ohne Kiwix JS wäre diese App unmöglich, und ein großer Dank geht an die ursprünglichen Entwickler der Evopedia-App und dann an Kiwix HTML5, aus dem schließlich Kiwix JS wurde. Die Portierung und Weiterentwicklung von Kiwix JS PWA und anderen Apps erfolgt durch Geoffrey Kantaris. Ich kann per E-Mail kontaktiert werden: egk10 at cam ac uk.
Wenn Sie über Programmiererfahrung verfügen und daran interessiert sind, zu diesem Projekt beizutragen, empfehlen wir Ihnen, zunächst einen Beitrag zum vorgelagerten Kiwix JS-Repository zu leisten, da ein Großteil des dort beigesteuerten Codes anschließend in dieses Repository portiert wird. Weitere Informationen finden Sie unter CONTRIBUTING.md. Wenn Sie zu einer bestimmten Kiwix JS PWA-Funktion beitragen möchten, öffnen Sie bitte ein Issue in diesem Repository, in dem Sie die Funktion oder den anderen Code erläutern, den Sie beisteuern möchten, und wie Sie dies vorschlagen. Sie sollten mit der Erstellung von PRs vertraut sein und über gute JavaScript-Kenntnisse verfügen. Befolgen Sie die gleichen Beitragsrichtlinien wie für Kiwix JS.
Wir haben diese App jetzt auf ES6-Code umgestellt, der von rollup.js und Babel in Code transpiliert wird, der mit älteren Browsern kompatibel ist. Kurzanleitung:
Klonen Sie dieses Repo und führen Sie npm install aus, um die Knotenabhängigkeiten abzurufen.
Um die App mit Vite.js bereitzustellen, einschließlich Hot Module Replacement, führen Sie npm run serve aus;
Sie MÜSSEN die Option „App-Cache umgehen“ in der Konfiguration unter „Fehlerbehebung und Entwicklung“ aktivieren. Wenn die App nicht ordnungsgemäß geladen wird, sollten Sie dennoch auf diese Einstellung zugreifen können, solange sich die App im ServiceWorker-Modus befindet (sofern dies nicht der Fall ist, schalten Sie sie im Content-Injection-Modus ein). Aktualisieren Sie die App mit Strg-R;
Vite überwacht die Änderungen und aktualisiert die App, wenn Sie Änderungen vornehmen und diese speichern.
Um eine Vorschau der gebündelten Version der App anzuzeigen, führen Sie npm run preview aus. Vite erstellt dann die App und öffnet ein Browserfenster, um die gebündelte Version anzuzeigen.
Um die App vollständig zu erstellen, führen Sie npm run build aus. Die erstellte App wird in einem Verzeichnis namens dist in Ihrem geklonten Repository gespeichert.
Um die App im Electron-Framework auszuführen, können Sie npm start verwenden. Dadurch wird die entbündelte App in der in package.json angegebenen Electron-Version ausgeführt. Sehen Sie sich verschiedene Skripte an, um die gebündelte Version der App für Electron in package.json zu erstellen (Sie können sie nur für das Betriebssystem erstellen, auf dem Sie sich gerade befinden, obwohl die Linux-App unter Windows mit WSL erstellt werden kann).
Wenn Ihnen dieses Projekt gefällt und Sie finanziell dazu beitragen möchten, dass es am Laufen bleibt, können Sie auf der Kiwix-Supportseite eine einmalige oder regelmäßige Spende tätigen. Spenden helfen dabei, Server, Coding-Zertifikate, Wartung usw. zu finanzieren. Wenn Sie Zeit und Fachwissen statt Geld beisteuern möchten und über gute Fremdsprachenkenntnisse verfügen, können Sie bei Übersetzungen von Kiwix-Projekten helfen. Alternativ können Sie zur Verbesserung von Wikimedia-Projekten beitragen, indem Sie Änderungen oder Korrekturen an Wikipedia- oder Wikivoyage-Artikeln vornehmen.
Diese Datenschutzrichtlinie gilt für die Kiwix JS Progressive Web App und Versionen davon, die für die Electron-, NWJS- und UWP-Frameworks gepackt sind und auf Kiwix-Servern sowie von offiziellen Kiwix-Konten auf GitHub und anderen Drittanbieter-Stores („App-Stores“) veröffentlicht werden. ).
Nach der Installation kann diese Anwendung vollständig offline ausgeführt werden. Es werden keine Ihrer persönlichen Daten erfasst oder aufgezeichnet. Wenn Sie es jedoch über einen Store installiert haben, kann der Store-Betreiber anonyme Nutzungsdaten sammeln (siehe unten). Die App speichert Ihren Browserverlauf nur für die Dauer einer Sitzung (um zu zuvor aufgerufenen Seiten zurückzukehren). Dieser Verlauf geht beim Beenden der App verloren, mit der optionalen Ausnahme der zuletzt besuchten Seite.
Wenn Sie von einem sicheren Webserver (z. B. dem PWA-Server) auf diese Anwendung zugreifen, funktioniert sie offline nur, wenn Ihr Browser in der Lage ist, einen Service Worker zu installieren. Wenn Sie die PWA-Version im Service Worker-Modus installieren oder mit einem Lesezeichen versehen, funktioniert sie offline. Beachten Sie jedoch, dass jede PWA konstruktionsbedingt regelmäßig den PWA-Server (in diesem Fall https://pwa.kiwix.org/) überprüft, wenn Es ist verfügbar, um nach einem aktualisierten Service Worker zu suchen.
Versionen der App, die nicht über einen Store installiert werden oder keine PWAs sind, bieten beim Start an, die GitHub Releases API auf Updates zu prüfen, diese Funktionalität ist jedoch optional und kann deaktiviert werden. Einige Electron-Apps aktualisieren sich optional auch selbst (über dieselbe API), wenn Sie ihnen erlauben, nach Updates zu suchen. Dies gilt für die Installer-(Setup-)Version für Windows und für die AppImage-Version für Linux. Die Store-Version und die PWA aktualisieren sich ebenfalls selbst, dies ist jedoch nicht innerhalb der App steuerbar.
Standardmäßig merkt sich diese Anwendung Ihre zuletzt besuchte Seite zwischen den Sitzungen mithilfe lokaler Speicherung oder eines Cookies, auf das nur auf diesem Gerät zugegriffen werden kann. Wenn Sie auf vertrauliche Informationen zugreifen, die beim nächsten Öffnen dieser App nicht angezeigt werden sollen, empfehlen wir Ihnen, diese Option in den Konfigurationsoptionen zu deaktivieren.
Diese Anwendung liest nur die Archivdateien, die Sie explizit auf Ihrem Gerät auswählen, und die Dateien, die in ihrem eigenen Paket enthalten sind. Andere Dateien können nicht gelesen werden. Der Zugriff auf den Kiwix-Archiv-Download-Server erfolgt nur, wenn Sie ihn auf der Konfigurationsseite ausdrücklich zum Zugriff auf die Download-Bibliothek für ZIM-Archive auffordern. Wenn Sie die App als PWA ausführen, speichert sie ihren eigenen Code vom sicheren PWA-Server zwischen und kann dann offline verwendet werden. Einige ZIM-Archive enthalten aktive Inhalte (Skripte), die in seltenen Fällen versuchen, externe Server für zufällige Dateien wie Schriftarten zu kontaktieren. Wir blockieren diese mit einer Inhaltssicherheitsrichtlinie, die in Artikel eingefügt wird. In einigen Fällen kann es jedoch sein, dass unsere CSP überschrieben wird, wenn der Artikel bereits über einen CSP verfügt. Beachten Sie, dass Skripte nur ausgeführt werden, wenn Sie den Service Worker-Modus in der Konfiguration aktivieren.
Wenn Sie der Meinung sind, dass Ihr Internetzugang unsicher ist oder beobachtet oder zensiert wird, empfehlen wir Ihnen, Ihren Internetzugang (Daten oder WLAN) vollständig abzuschalten, bevor Sie die Anwendung verwenden.
Wenn Sie diese App außerdem von einem Anbieter-Store (einschließlich Erweiterungen) erhalten haben, kann der Store-Betreiber Ihre Nutzung der App (z. B. Download, Installation, Deinstallation, Datum und Anzahl/Dauer der Sitzungen) verfolgen, um anonyme, Aggregierte Nutzungsstatistiken an Entwickler. Wenn Sie diesbezüglich Bedenken haben, sollten Sie für weitere Informationen die entsprechende Datenschutzrichtlinie des Stores prüfen.
Es sind Builds dieser App verfügbar, die weder einen Store noch einen Online-Servicemitarbeiter verwenden. Bitte sehen Sie:
Veröffentlichungen
NWJS-Version – diese Version ist vollständig eigenständig und greift niemals auf Server zu, es sei denn, Sie erlauben dies.
