kiwix js pwa
Kiwix
Démos : [ Installer PWA sur le bureau ] [ Installer et utiliser : Android ] [ Installer et utiliser : Firefox Android ] [ Choisir un dossier d'archives ] [ Gestion des fichiers (bureau) ] [ Démo de toutes les fonctionnalités OPFS ] [ Ajout d'une application à la barre latérale Edge ]
Kiwix est un navigateur hors ligne pour Wikipedia, Project Gutenberg, TED Talks, Wikivoyage, Stackexchange et de nombreux autres sites et ressources. Il met les connaissances à la disposition, dans de nombreuses langues différentes, des personnes ayant un accès limité ou inexistant à Internet. Le logiciel et le contenu sont gratuits pour tous. Téléchargez l'application et téléchargez le contenu hors ligne de votre choix (archives ZIM, téléchargeables gratuitement dans l'application). Il existe des centaines d’archives multilingues parmi lesquelles choisir, sur de nombreux sujets et sujets différents. Construisez toute une bibliothèque numérique de connaissances hors ligne !
Faisant partie de la famille Kiwix, cette application est disponible soit sous forme d'application Web progressive (PWA) installable hors ligne, pour presque tous les navigateurs et appareils modernes, soit sous forme de packages d'applications pour divers systèmes d'exploitation Windows et Linux : voir Kiwix JS pour Windows et Linux . Pour Mac et iOS , utilisez la PWA hors ligne.
Nous proposons également des applications packagées de WikiMed de Kiwix (une encyclopédie médicale complète) et Wikivoyage de Kiwix (un guide de voyage complet) en anglais - aucun téléchargement supplémentaire n'est nécessaire ! (Vous pouvez cependant télécharger d'autres langues dans ces applications.)
Si vous utilisez Windows 10 ou 11 , les trois applications sont facilement disponibles dans le Microsoft Store : Kiwix JS UWP , WikiMed de Kiwix et Wikivoyage de Kiwix . Ils seront automatiquement mis à jour lorsqu'un nouveau package est disponible. Si vous utilisez Linux , le package Electron AppImage de Kiwix JS se met également (éventuellement) à jour automatiquement, tout comme le package Windows Electron installable. D'autres applications vous avertiront lorsqu'une mise à jour sera disponible.
Vous n'aimez pas les magasins ou les forfaits ? Nous avons ce qu'il vous faut ! Lancez cette application instantanément en ouvrant dès maintenant la PWA (Progressive Web App) installable et compatible hors ligne dans votre navigateur sur pwa.kiwix.org . Cela fonctionne dans n'importe quel navigateur prenant en charge les Service Workers : Chrome, Edge, Firefox et Safari modernes (notez que sur les appareils iOS, vous devez utiliser Safari car Apple interdit l'utilisation de Service Workers dans tout autre navigateur sur les i-devices).
Obtenez une archive ZIM gratuite à utiliser avec la PWA à partir de la page de configuration de l'application, ou vous pouvez prévisualiser un ZIM sur library.kiwix.org avant d'en télécharger un. Une fois installée, ajoutée à vos favoris ou ajoutée à votre écran d'accueil, la PWA fonctionne même lorsque votre appareil est complètement hors ligne ! Jetez un œil à notre démo qui montre à quel point il est rapide et facile d’installer la PWA.
Si vous le souhaitez avec des images, sachez qu'il s'agit d'un gros téléchargement : la version anglaise fait environ 97 Go ! Nous vous recommandons de l'essayer d'abord avec l'une des archives thématiques, beaucoup plus petites, comme l'astronomie, la chimie, les mathématiques, la physique, etc. Dans l'application, vous trouverez une liste déroulante pratique qui vous permet de choisir votre langue et votre thème. , puis téléchargez-le. L'archive sera téléchargée dans votre navigateur.
Si vous voulez vraiment un Wikipédia complet en anglais avec des images, nous vous recommandons fortement d'utiliser l'application open source qBittorrent pour le télécharger sur un PC disposant de beaucoup d'espace disque. Installez d’abord qBittorrent. Ensuite, lorsque vous sélectionnez une archive volumineuse à télécharger dans l'application, celle-ci vous fournira un lien torrent. Cliquez sur le lien et autorisez votre navigateur à télécharger et ouvrir le fichier torrent. Ce petit fichier s'ouvrira dans qBittorrent et il vous sera demandé où vous souhaitez enregistrer l'archive que vous souhaitez télécharger. C'est beaucoup plus facile qu'il n'y paraît !
Zimit est un service qui permet à n'importe quel site Web d'être archivé en tant que ZIM, bien qu'il existe de nombreux ZIM passionnants basés sur Zimit pré-explorés que vous pouvez utiliser (voir ci-dessous). Si vous souhaitez créer le vôtre, essayez-le sur https://youzim.it/. Les applications Kiwix JS PWA et Electron prennent entièrement en charge les archives basées sur Zimit à partir de la version 2.8.5 à l'aide du lecteur open source Replay Web Archive et prennent déjà en charge le prochain format Zimit v2. Veuillez noter que la plupart des archives Zimit nécessiteront le mode ServiceWorker, en raison de leur contenu hautement dynamique.
La bibliothèque de téléchargement Kiwix (disponible dans l'application) publie un certain nombre de sites de référence incroyablement utiles au format de fichier Zimit, tels que le site de préparation aux catastrophes Ready.Gov , le fascinant magazine Low-Tech , le CIA World Factbook , la bibliothèque Harmony Project. de partitions musicales et l' Encyclopédie Internet de la philosophie - parmi tant d'autres. Ouvrez simplement le répertoire Zimit dans la bibliothèque intégrée à l'application.
Nous sommes fiers de maintenir la prise en charge des anciens navigateurs et plates-formes, étant donné qu'un public cible important de cette application est constitué d'utilisateurs des pays en développement qui ne peuvent avoir accès qu'à d'anciens appareils dotés de logiciels obsolètes. Nous testons fréquemment l'application sur les anciens navigateurs et systèmes d'exploitation. L'application détectera généralement les fonctionnalités qui ne fonctionnent pas sur un navigateur donné, et les désactivera ou les contournera. Cependant, dans certains cas (par exemple Firefox <= 59), l'application se mettra en mode Service Worker, mais ce mode échouera silencieusement. Si cela est concerné, essayez de passer l'application en mode restreint (voir Mode d'injection de contenu dans Configuration).
En tant que Progressive Web App (PWA) sur Linux, Windows, Android, iOS, macOS :
Google Chrome / Chromium >= 59 (et de nombreux navigateurs basés sur Chromium, par exemple Opera, Samsung Internet)
Microsoft Edge (Chrome) >= 79
Mozilla Firefox >= 68 (mais voir la note sur Android * )
Apple Safari >= 11.3 pour iOS et macOS (la recherche en texte intégral ne fonctionne que sur iOS 15+)
Microsoft Edge hérité 18 (Windows uniquement)
En tant qu'application implémentée avec les frameworks suivants :
Electron >= 1.8.0 (Ubuntu, Debian, Fedora, OpenSUSE, AppImage, Windows) : version GitHub
Plateforme Windows universelle (UWP) >=10.0.10240 : application Microsoft Store ou version GitHub - Windows 10/11 (Electron), Windows sur ARM, Xbox, Windows 10 Mobile
NWJS >= 0.23.0 (Windows 7/8/10/11) : version GitHub
NWJS 0.14.7 (Windows XP/Vista uniquement) : version GitHub
* Avec Firefox sur Android , l'application n'est utilisable qu'avec les fichiers stockés dans le système de fichiers privés Origin. Il existe un bug dans Firefox selon lequel le navigateur tente de lire l'intégralité de l'archive ZIM en mémoire s'il l'ouvre à partir du système de fichiers visible par l'utilisateur.
Bien que obsolète, nous conserverons le support aussi longtemps que cela sera possible :
Internet Explorer 11 (mode restreint uniquement, pas d'utilisation hors ligne de PWA)
Edge Legacy <= 17 (mode restreint uniquement, pas d'utilisation hors ligne de PWA)
Firefox 45-67 (certaines versions nécessitent que l'utilisateur passe manuellement en mode restreint, et certaines ne peuvent pas afficher les images WebP)
Chromium 49-58 (certaines versions ne fonctionnent qu'en mode restreint)
Veuillez utiliser le suivi des problèmes de ce référentiel pour signaler tout bug que vous avez trouvé avec le logiciel. Ouvrez un nouveau ticket (après avoir vérifié que le problème que vous avez identifié n'a pas déjà de ticket). Veuillez indiquer clairement le numéro de version que vous utilisez (en haut de la page de configuration de l'application) et le navigateur ou la plateforme que vous utilisez.
Si vous rencontrez des difficultés avec le logiciel ou souhaitez voir une nouvelle fonctionnalité, veuillez également ouvrir un ticket. Vous pouvez également consulter la section Commentaires sur la page À propos de l'application pour découvrir d'autres moyens d'obtenir une assistance technique pour votre problème. N'hésitez pas à nous contacter (voir la page À propos de l'application) si vous souhaitez simplement nous faire part de vos commentaires, ou laisser un avis si vous avez obtenu l'application dans un Store. Si vous aimez l'application, veuillez mettre ce référentiel en vedette (voir en haut) !
Ce référentiel est destiné au développement de l'application Kiwix JS pour PWA, Electron, NWJS et Windows 10/11 Universal Windows Platform (UWP). Le dernier code se trouve généralement sur la branche principale, mais il est utilisé pour le développement actif et peut nécessiter plusieurs validations avant les versions. Des versions installables et portables pour Windows (XP/Vista/7/8/10/11) et Linux (32 bits et 64 bits) sont disponibles à partir des versions. Des versions nocturnes instables des applications Electron et NWJS sont disponibles avec un déploiement de développement, mais le code peut être bogué et changer rapidement. De plus, les binaires Windows nocturnes ne sont pas signés .
Le code est basé sur Kiwix JS, un portage HTML/JavaScript léger du lecteur Kiwix Offline. Un développement important a été réalisé pour empaqueter cette application pour divers frameworks et pour ajouter certaines fonctionnalités qui sont souvent rétroportées en amont. La PWA peut être installée en tant qu'application système entièrement intégrée si elle est ouverte dans un navigateur Chromium moderne, et elle utilise l'API d'accès au système de fichiers et l'API de gestion des fichiers pour une expérience de type natif dans les navigateurs prenant en charge ces API. Pour plus d'informations sur ces API, consultez le bas de cette page : API d'accès au système de fichiers et gestion des fichiers.
Les applications sont également disponibles dans le gestionnaire de packages WinGet. Vous pouvez télécharger la version UWP (sous Windows 10/11) en ouvrant une invite de commande ou un terminal PowerShell et en tapant winget install kiwix.kiwixjs (cette version ne se mettra pas à jour automatiquement, mais elle vous indiquera quand une nouvelle mise à jour est prête à être mise à jour). installer). Des instructions alternatives de chargement latéral sont disponibles dans les notes de version. La version Electron peut être installée avec winget install kiwix.kiwixjs.electron , ou bien en téléchargeant un package depuis Releases. Pour les tests, les versions Store, Electron et NWJS sont livrées avec une mini-archive des 100 meilleurs articles Wikipédia (sans images et avec seulement le paragraphe lede).
Certaines archives ZIM sont en effet très volumineuses, les limites sous-jacentes du système de fichiers peuvent donc être prises en compte. Pour la plupart des types de stockage (y compris les cartes microSD) formatés en exFAT ou NTFS, vous pouvez stocker sans problème même ces fichiers très volumineux dans le stockage. Cependant, si vous envisagez de stocker votre fichier ZIM sur une carte SD formatée en FAT32 et que vous souhaitez utiliser une archive de plus de 4 Go, vous devrez alors diviser le ZIM : voir les instructions de fractionnement de fichier.
Une grande partie du développement de cette application se déroule en amont dans le référentiel Kiwix JS auquel je contribue activement. Sans Kiwix JS, cette application serait impossible, et un grand merci aux développeurs originaux de l'application Evopedia, puis de Kiwix HTML5, qui est finalement devenu Kiwix JS. Le portage et le développement ultérieur de Kiwix JS PWA et d'autres applications sont réalisés par Geoffrey Kantaris. Je peux être contacté par email : egk10 at cam ac uk.
Si vous avez de l'expérience en codage et souhaitez contribuer à ce projet, nous vous suggérons de commencer par contribuer au référentiel Kiwix JS en amont, car une grande partie du code qui y est contribué est ensuite portée vers ce référentiel. Veuillez consulter CONTRIBUTING.md pour plus de détails. Si vous souhaitez contribuer à une fonctionnalité Kiwix JS PWA spécifique, veuillez ouvrir un numéro sur ce référentiel expliquant la fonctionnalité ou tout autre code que vous souhaitez contribuer et comment vous proposez que cela soit fait. Vous devez être à l'aise dans la création de PR et avoir une bonne connaissance de JavaScript. Suivez les mêmes directives de contribution que pour Kiwix JS.
Nous avons maintenant migré cette application vers le code ES6, qui est transpilé par rollup.js et Babel en code compatible avec les anciens navigateurs. Brèves instructions :
Clonez ce dépôt et exécutez npm install pour obtenir les dépendances du nœud ;
Pour servir l'application avec Vite.js, qui inclut le remplacement de module à chaud, exécutez npm run serve ;
Vous DEVEZ activer l'option Contourner le cache de l'application dans Configuration sous Dépannage et développement. Si l'application se charge de manière désordonnée, vous devriez toujours pouvoir accéder à ce paramètre tant que l'application est en mode ServiceWorker (si elle ne l'est pas, activez-la en mode d'injection de contenu). Actualisez l'application avec Ctrl-R ;
Vite surveillera les modifications et actualisera l'application lorsque vous en apporterez et les enregistrerez ;
Pour prévisualiser la version groupée de l'application, exécutez npm run preview , et Vite créera l'application et ouvrira une fenêtre de navigateur pour afficher la version groupée ;
Pour créer entièrement l'application, exécutez npm run build . L'application construite sera enregistrée dans un répertoire appelé dist dans votre dépôt cloné ;
Pour exécuter l'application dans le framework Electron, vous pouvez utiliser npm start . Cela exécutera l'application dégroupée dans la version Electron spécifiée dans package.json . Consultez divers scripts pour créer la version groupée de l'application pour Electron dans package.json (vous ne pouvez la créer que pour le système d'exploitation que vous utilisez actuellement, bien que l'application Linux puisse être créée sur Windows avec WSL).
Si vous aimez ce projet et souhaitez contribuer financièrement à son fonctionnement, vous pouvez faire des dons ponctuels ou réguliers sur la page Support Kiwix. Les dons aident à payer les serveurs, les certificats de codage, la maintenance, etc. Si vous souhaitez apporter votre temps et votre expertise plutôt que de l'argent et que vous avez une bonne connaissance d'une langue étrangère, vous pouvez aider avec les traductions des projets Kiwix. Alternativement, vous pouvez contribuer à améliorer les projets Wikimédia en apportant des modifications ou des corrections aux articles Wikipédia ou Wikivoyage.
Cette politique de confidentialité s'applique à l'application Web progressive Kiwix JS et à ses versions packagées pour les frameworks Electron, NWJS et UWP qui sont publiées sur les serveurs Kiwix, et par les comptes Kiwix officiels sur GitHub et d'autres magasins de fournisseurs tiers (« magasins d'applications »). ).
Une fois installée, cette application est capable de fonctionner entièrement hors ligne. Il ne collecte ni n'enregistre aucune de vos données personnelles, mais si vous l'avez installé à partir d'un magasin, l'opérateur du magasin peut collecter des données d'utilisation anonymes (voir ci-dessous). L'application ne mémorise votre historique de navigation que pendant la durée d'une session (dans le but de revenir aux pages précédemment consultées). Cet historique est perdu à la sortie de l'application à l'exception facultative de la dernière page visitée.
Si vous accédez à cette application depuis un serveur web sécurisé (par exemple le serveur PWA), elle ne fonctionnera hors ligne que si votre navigateur est capable d'installer un Service Worker. Si vous installez ou ajoutez la version PWA à vos favoris en mode Service Worker, elle fonctionnera hors ligne, mais notez que, de par sa conception, toute PWA vérifiera périodiquement le serveur PWA (dans ce cas, https://pwa.kiwix.org/), si il est disponible, pour rechercher un Service Worker mis à jour.
Les versions de l'application qui ne sont pas installées via un Store ou qui ne sont pas des PWA proposeront de vérifier l'API GitHub Releases pour les mises à jour au démarrage, mais cette fonctionnalité est facultative et peut être désactivée. Certaines applications Electron se mettront également éventuellement à jour automatiquement (via la même API), si vous leur permettez de vérifier les mises à jour. Cela s'applique à la version du programme d'installation (installation) pour Windows et à la version AppImage pour Linux. La version Store et la PWA se mettent également à jour automatiquement, mais cela n'est pas contrôlable depuis l'application.
Par défaut, cette application se souviendra de votre dernière page visitée entre les sessions en utilisant le stockage local ou un cookie accessible uniquement sur cet appareil. Si vous accédez à des informations sensibles que vous ne souhaitez pas voir affichées la prochaine fois que vous ouvrirez cette application, nous vous recommandons de désactiver cette option dans les options de configuration.
Cette application lit uniquement les fichiers d'archives que vous sélectionnez explicitement sur votre appareil et les fichiers inclus dans son propre package : elle n'est capable de lire aucun autre fichier. Il n'accédera au serveur de téléchargement d'archives Kiwix que si vous lui demandez spécifiquement d'accéder à la bibliothèque de téléchargement des archives ZIM sur la page de configuration. Si vous exécutez l'application en tant que PWA, elle mettra en cache son propre code à partir du serveur PWA sécurisé et pourra ensuite être utilisée hors ligne. Certaines archives ZIM contiennent du contenu actif (scripts) qui peut, dans de rares circonstances, tenter de contacter des serveurs externes pour des fichiers accessoires tels que des polices. Nous les bloquons avec une politique de sécurité du contenu injectée dans les articles, mais dans certains cas, si l'article dispose déjà d'un CSP, le nôtre peut être écrasé. Notez que les scripts ne s'exécutent que si vous activez le mode Service Worker dans la configuration.
Si vous pensez que votre accès Internet n'est pas sécurisé, ou est observé ou censuré, nous vous recommandons de couper complètement votre accès Internet (Data ou WiFi) avant d'utiliser l'application.
De plus, si vous avez obtenu cette application auprès d'un magasin de fournisseur (y compris les extensions), l'opérateur du magasin peut alors suivre votre utilisation de l'application (par exemple, téléchargement, installation, désinstallation, date et nombre/durée des sessions) dans le but de fournir des informations anonymes, agréger les statistiques d'utilisation aux développeurs. Si cela vous concerne, vous devez consulter la politique de confidentialité du magasin concernée pour plus d'informations.
Des versions de cette application sont disponibles et n'utilisent pas de magasin ni de Service Worker en ligne. Veuillez consulter :
Sorties
Version NWJS - cette version est complètement autonome et n'accédera jamais aux serveurs sauf si vous l'autorisez.
