Kiwix JS para PWA, Windows y Linux (Electron, NWJS, UWP)

Demostraciones: [Instalar PWA en el escritorio] [Instalar y usar: Android] [Instalar y usar: Firefox Android] [Elegir una carpeta de archivos] [Manejo de archivos (escritorio)] [Demostración de todas las funciones de OPFS] [Agregar aplicación a la barra lateral de Edge]

Kiwix es un navegador sin conexión para Wikipedia, Proyecto Gutenberg, TED Talks, Wikivoyage, Stackexchange y muchos otros sitios y recursos. Pone el conocimiento a disposición, en muchos idiomas diferentes, de personas con acceso limitado o nulo a Internet. El software y el contenido son gratuitos para que cualquiera los utilice. Obtenga la aplicación y descargue el contenido sin conexión que elija (archivos ZIM, que se pueden descargar de forma gratuita desde la aplicación). Hay cientos de archivos multilingües para elegir, sobre muchos temas y materias diferentes. ¡Construya una biblioteca digital completa de conocimientos fuera de línea!

Como parte de la familia Kiwix, esta aplicación está disponible como una aplicación web progresiva (PWA) instalable y sin conexión, para casi todos los navegadores y dispositivos modernos, o como paquetes de aplicaciones para varios sistemas operativos Windows y Linux: consulte Kiwix JS para Windows y Linux . Para Mac e iOS , utilice la PWA sin conexión.

También tenemos aplicaciones empaquetadas de WikiMed de Kiwix (una enciclopedia médica completa) y Wikivoyage de Kiwix (una guía de viaje completa) en inglés, ¡no se necesita descarga adicional! (Sin embargo, puedes descargar otros idiomas en estas aplicaciones).

Si está utilizando Windows 10 u 11 , las tres aplicaciones están convenientemente disponibles en Microsoft Store: Kiwix JS UWP , WikiMed de Kiwix y Wikivoyage de Kiwix . Se actualizarán automáticamente cuando haya un nuevo paquete disponible. Si está utilizando Linux , el paquete Electron AppImage de Kiwix JS también (opcionalmente) se actualiza automáticamente, al igual que el paquete Electron instalable de Windows. Otras aplicaciones te notificarán cuando haya una actualización disponible.

Aplicación web progresiva universal

¿No te gustan las tiendas o los paquetes? ¡Lo tenemos cubierto! Inicie esta aplicación al instante abriendo la PWA (aplicación web progresiva) instalable y sin conexión en su navegador ahora mismo en pwa.kiwix.org . Esto funciona en cualquier navegador que admita Service Workers: Chrome, Edge, Firefox y Safari modernos (tenga en cuenta que en dispositivos iOS, debe usar Safari porque Apple prohíbe el uso de Service Workers en cualquier otro navegador en i-devices).

Obtenga un archivo ZIM gratuito para usar con la PWA desde la página de Configuración de la aplicación, o puede obtener una vista previa de un ZIM en biblioteca.kiwix.org antes de descargar uno. Una vez instalada, marcada o agregada a su pantalla de inicio, la PWA funciona incluso cuando su dispositivo está completamente desconectado. Eche un vistazo a nuestra demostración que muestra lo rápido y fácil que es instalar la PWA.

¿Cómo puedo desconectar toda Wikipedia?

Si lo quieres con imágenes, ten en cuenta que es una descarga grande: ¡la versión en inglés pesa alrededor de 97 Gigabytes! Le recomendamos que lo pruebe primero con uno de los archivos temáticos, mucho más pequeños, como Astronomía, Química, Matemáticas, Física, etc. En la aplicación, encontrará un práctico menú desplegable que le permitirá elegir su idioma y su tema. y luego descárgalo. El archivo se descargará en su navegador.

Si realmente desea una Wikipedia completa en inglés con imágenes, le recomendamos encarecidamente que utilice la aplicación de código abierto qBittorrent para descargarla en una PC con mucho espacio en disco. Primero instale qBittorrent. Luego, cuando seleccione un archivo grande para descargar en la aplicación, le proporcionará un enlace de torrent. Haga clic en el enlace y permita que su navegador descargue y abra el archivo torrent. Este pequeño archivo se abrirá en qBittorrent y se le preguntará dónde desea guardar el archivo que desea descargar. ¡Es mucho más fácil de lo que parece!

¿Qué pasa con el formato Zimit (archivo web)?

Zimit es un servicio que permite archivar cualquier sitio web como ZIM, aunque existen muchos interesantes ZIM basados en Zimit prerastreados que puedes usar (ver más abajo). Si quieres hacer el tuyo propio, pruébalo en https://youzim.it/. Las aplicaciones Kiwix JS PWA y Electron son totalmente compatibles con archivos basados en Zimit a partir de la versión 2.8.5 utilizando el lector de código abierto Replay Web Archive y ya son compatibles con el próximo formato Zimit v2. Tenga en cuenta que la mayoría de los archivos Zimit requerirán el modo ServiceWorker, debido a su contenido altamente dinámico.

La biblioteca de descargas Kiwix (disponible en la aplicación) publica una serie de sitios de referencia increíblemente útiles en el formato de archivo Zimit, como el sitio de preparación para desastres Ready.Gov , la fascinante revista Low-Tech , el CIA World Factbook , la biblioteca Harmony Project de partituras y la Enciclopedia de Filosofía de Internet , entre muchos otros. Simplemente abra el directorio Zimit en la biblioteca de la aplicación.

Soporte del navegador

Nos enorgullecemos de mantener la compatibilidad con navegadores y plataformas antiguos, dado que un público objetivo importante para esta aplicación está formado por usuarios del mundo en desarrollo que tal vez solo tengan acceso a dispositivos antiguos con software obsoleto. Probamos la aplicación con frecuencia en navegadores y sistemas operativos más antiguos. La aplicación normalmente detectará qué funciones no funcionan en un navegador determinado y las desactivará o solucionará. Sin embargo, en algunos casos (por ejemplo, Firefox <= 59), la aplicación se configurará en modo Service Worker, pero este modo fallará silenciosamente. Si se ve afectado, intente cambiar la aplicación al modo restringido (consulte Modo de inyección de contenido en Configuración).

Apoyado oficialmente

Como aplicación web progresiva (PWA) en Linux, Windows, Android, iOS, macOS:

Google Chrome/Chromium >= 59 (y muchos navegadores basados en Chromium, por ejemplo Opera, Samsung Internet)
Microsoft Edge (cromo) >= 79
Mozilla Firefox >= 68 (pero ver nota sobre Android * )
Apple Safari >= 11.3 para iOS y macOS (la búsqueda de texto completo solo funciona en iOS 15+)
Microsoft Edge Legacy 18 (solo Windows)

Como una aplicación implementada con los siguientes frameworks:

Electron >= 1.8.0 (Ubuntu, Debian, Fedora, OpenSUSE, AppImage, Windows): lanzamiento de GitHub
Plataforma universal de Windows (UWP) >=10.0.10240: aplicación Microsoft Store o versión de GitHub: Windows 10/11 (Electron), Windows en ARM, Xbox, Windows 10 Mobile
NWJS >= 0.23.0 (Windows 7/8/10/11): versión de GitHub
NWJS 0.14.7 (solo Windows XP/Vista): versión de GitHub

* Con Firefox en Android , la aplicación solo se puede utilizar con archivos almacenados en el sistema de archivos privado de Origin. Hay un error en Firefox por el cual el navegador intenta leer el archivo ZIM completo en la memoria si lo abre desde el sistema de archivos visible para el usuario.

En desuso

Aunque está obsoleto, mantendremos el soporte mientras sea práctico:

Internet Explorer 11 (solo modo restringido, no se permite el uso sin conexión de PWA)
Edge Legacy <= 17 (solo modo restringido, sin uso de PWA sin conexión)
Firefox 45-67 (algunas versiones requieren que el usuario cambie manualmente al modo restringido y algunas no pueden mostrar imágenes WebP)
Chromium 49-58 (algunas versiones solo se ejecutan en modo restringido)

Reportar errores y soporte técnico

Utilice el rastreador de problemas de este repositorio para informar cualquier error que haya encontrado en el software. Abra un nuevo ticket (después de verificar que el problema que identificó no tenga ya un ticket). Indique claramente el número de versión que está utilizando (en la parte superior de la página de Configuración de la aplicación) y qué navegador o plataforma está utilizando.

Si tiene dificultades con el software o le gustaría ver una nueva función, abra también un ticket. Alternativamente, consulte la sección Comentarios en la página Acerca de de la aplicación para conocer otras formas de obtener soporte técnico para su problema. No dude en ponerse en contacto (consulte la página Acerca de de la aplicación) si simplemente desea enviar comentarios o dejar una reseña si obtuvo la aplicación en una tienda. Si te gusta la aplicación, ¡destaque este repositorio (ver arriba)!

Información técnica

Este repositorio es para el desarrollo de la aplicación Kiwix JS para PWA, Electron, NWJS y Windows 10/11 Universal Windows Platform (UWP). El código más reciente suele estar en la rama principal, pero se utiliza para el desarrollo activo y puede haber varias confirmaciones antes de los lanzamientos. Las versiones instalables y portátiles para Windows (XP/Vista/7/8/10/11) y Linux (32 bits y 64 bits) están disponibles a partir de las versiones. Las compilaciones nocturnas inestables de las aplicaciones Electron y NWJS están disponibles junto con una implementación de desarrollo, pero el código puede tener errores y cambiar rápidamente. Además, los archivos binarios nocturnos de Windows no están firmados .

El código está basado en Kiwix JS, un puerto ligero de HTML/JavaScript del lector Kiwix Offline. Se ha realizado un desarrollo significativo en el empaquetado de esta aplicación para varios marcos y en la adición de algunas funciones que a menudo cuentan con soporte previo. La PWA se puede instalar como una aplicación de sistema totalmente integrada si se abre en un navegador Chromium moderno y utiliza la API de acceso al sistema de archivos y la API de manejo de archivos para una experiencia similar a la nativa en los navegadores que admiten esas API. Para obtener más información sobre estas API, consulte la parte inferior de esta página: API de acceso al sistema de archivos y manejo de archivos.

Las aplicaciones también están disponibles en el Administrador de paquetes WinGet. Puede descargar la versión para UWP (en Windows 10/11) abriendo un símbolo del sistema o terminal PowerShell y escribiendo winget install kiwix.kiwixjs (esta versión no se actualizará automáticamente, pero le avisará cuando esté lista una nueva actualización). instalar). Las instrucciones de descarga alternativas están disponibles en las notas de la versión. La versión Electron se puede instalar con winget install kiwix.kiwixjs.electron o descargando un paquete desde Releases. Para realizar pruebas, las versiones Store, Electron y NWJS vienen con un mini archivo de los 100 artículos principales de Wikipedia (sin imágenes y solo con el párrafo inicial).

Algunos archivos ZIM son muy grandes, por lo que se pueden considerar los límites subyacentes del sistema de archivos. Para la mayoría de los tipos de almacenamiento (incluidas las tarjetas microSD) formateados como exFAT o NTFS, puedes almacenar incluso estos archivos muy grandes en el almacenamiento sin problemas. Sin embargo, si planea almacenar su archivo ZIM en una tarjeta SD formateada como FAT32 y desea utilizar un archivo de más de 4 GB, deberá dividir el ZIM: consulte las instrucciones de división de archivos.

Gran parte del desarrollo de esta aplicación ocurre en el repositorio Kiwix JS al que contribuyo activamente. Sin Kiwix JS, esta aplicación sería imposible, y muchas gracias a los desarrolladores originales de la aplicación Evopedia primero y luego de Kiwix HTML5, que finalmente se convirtió en Kiwix JS. La adaptación y el desarrollo posterior de Kiwix JS PWA y otras aplicaciones son obra de Geoffrey Kantaris. Me pueden contactar por correo electrónico: egk10 en cam ac uk.

Código contribuyente

Si tiene experiencia en codificación y está interesado en contribuir a este proyecto, le sugerimos que comience contribuyendo al repositorio Kiwix JS, ya que gran parte del código aportado allí se traslada posteriormente a este repositorio. Consulte CONTRIBUTING.md para obtener más detalles. Si desea contribuir a una función específica de Kiwix JS PWA, abra un número en este repositorio que explique la función u otro código con el que desea contribuir y cómo propone que se haga. Debe sentirse cómodo creando relaciones públicas y tener buenos conocimientos de JavaScript. Siga las mismas pautas de contribución que para Kiwix JS.

Ahora hemos realizado la transición de esta aplicación al código ES6, que rollup.js y Babel transpilan a un código que es compatible con navegadores más antiguos. Breves instrucciones:

Clone este repositorio y ejecute npm install para obtener las dependencias del nodo;
Para servir la aplicación con Vite.js, que incluye Reemplazo de módulo en caliente, ejecute npm run serve ;
DEBE activar la opción para omitir el caché de la aplicación en Configuración en Solución de problemas y desarrollo. Si la aplicación se carga de forma desordenada, aún debería poder acceder a esta configuración siempre que la aplicación esté en modo ServiceWorker (si no está, actívela en el modo de inyección de contenido). Actualiza la aplicación con Ctrl-R;
Vite estará atento a los cambios y actualizará la aplicación cuando realice alguno y los guarde;
Para obtener una vista previa de la versión incluida de la aplicación, ejecute npm run preview y Vite creará la aplicación y abrirá una ventana del navegador para ver la versión incluida;
Para compilar completamente la aplicación, ejecute npm run build . La aplicación creada se guardará en un directorio llamado dist en su repositorio clonado;
Para ejecutar la aplicación en el marco de Electron, puede usar npm start . Esto ejecutará la aplicación desagregada en la versión de Electron especificada en package.json . Vea varios scripts para compilar la versión incluida de la aplicación para Electron en package.json (solo puede compilarla para el sistema operativo en el que se encuentra actualmente, aunque la aplicación de Linux se puede compilar en Windows con WSL).

Otras contribuciones/donaciones

Si te gusta este proyecto y te gustaría contribuir financieramente para que siga funcionando, puedes hacer donaciones únicas o periódicas en la página de soporte de Kiwix. Las donaciones ayudan a pagar servidores, certificados de codificación, mantenimiento, etc. Si desea contribuir con tiempo y experiencia en lugar de dinero, y tiene buenos conocimientos de un idioma extranjero, puede ayudar con las traducciones de los proyectos de Kiwix. Alternativamente, puedes ayudar a mejorar los proyectos de Wikimedia realizando ediciones o correcciones en los artículos de Wikipedia o Wikivoyage.

política de privacidad

Esta Política de privacidad se aplica a la aplicación web progresiva Kiwix JS y a sus versiones empaquetadas para los marcos Electron, NWJS y UWP que se publican en los servidores Kiwix y en las cuentas oficiales de Kiwix en GitHub y otras tiendas de proveedores externos ("tiendas de aplicaciones"). ).

Cuando se instala, esta aplicación es capaz de funcionar completamente sin conexión. No recopila ni registra ninguno de sus datos personales, aunque si lo instaló desde una Tienda, el operador de la Tienda puede recopilar datos de uso anónimos (ver más abajo). La aplicación solo recuerda su historial de navegación durante la duración de una sesión (con el fin de regresar a páginas vistas anteriormente). Este historial se pierde al salir de la aplicación con la excepción opcional de la última página visitada.

Si accede a esta aplicación desde un servidor web seguro (por ejemplo, el servidor PWA), solo funcionará sin conexión si su navegador es capaz de instalar un Service Worker. Si instala o marca la versión de PWA en el modo Service Worker, funcionará sin conexión, pero tenga en cuenta que, por diseño, cualquier PWA comprobará periódicamente el servidor de PWA (en este caso, https://pwa.kiwix.org/), si está disponible para buscar un trabajador de servicio actualizado.

Las versiones de la aplicación que no se instalan a través de una Tienda o que no son PWA ofrecerán verificar la API de versiones de GitHub para obtener actualizaciones al inicio, pero esta funcionalidad es opcional y se puede mantener desactivada. Algunas aplicaciones de Electron también se actualizarán automáticamente (a través de la misma API), si les permites buscar actualizaciones. Esto se aplica a la versión del instalador (configuración) para Windows y a la versión de AppImage para Linux. La versión Store y la PWA también se actualizan automáticamente, pero esto no se puede controlar desde la aplicación.

De forma predeterminada, esta aplicación recordará su última página visitada entre sesiones utilizando almacenamiento local o una cookie a la que solo se puede acceder en este dispositivo. Si accede a información confidencial que no desea que se muestre la próxima vez que abra esta aplicación, le recomendamos que desactive esta opción en las opciones de Configuración.

Esta aplicación solo lee los archivos que usted selecciona explícitamente en su dispositivo y los archivos incluidos en su propio paquete: no es capaz de leer ningún otro archivo. Solo accederá al servidor de descarga de archivos Kiwix si usted solicita específicamente que acceda a la biblioteca de descarga de archivos ZIM en la página de Configuración. Si ejecuta la aplicación como PWA, almacenará en caché su propio código desde el servidor PWA seguro y luego podrá usarse sin conexión. Algunos archivos ZIM contienen contenido activo (scripts) que, en raras circunstancias, pueden intentar contactar servidores externos para archivos incidentales como fuentes. Los bloqueamos con una Política de seguridad de contenido inyectada en los artículos, pero en algunos casos, si el artículo ya tiene un CSP, es posible que se sobrescriba el nuestro. Tenga en cuenta que los scripts solo se ejecutan si habilita el modo Service Worker en Configuración.

Si cree que su acceso a Internet es inseguro o está siendo observado o censurado, le recomendamos que cierre completamente su acceso a Internet (Datos o WiFi) antes de utilizar la aplicación.

Además, si obtuvo esta aplicación de una tienda proveedora (incluidas las extensiones), entonces el operador de la tienda puede rastrear su uso de la aplicación (por ejemplo, descarga, instalación, desinstalación, fecha y número/duración de sesiones) con el fin de proporcionar información anónima, agregar estadísticas de uso a los desarrolladores. Si esto le preocupa, debe consultar la Política de privacidad de la tienda correspondiente para obtener más información.

Hay versiones de esta aplicación disponibles que no utilizan una tienda ni un trabajador de servicio en línea. Por favor vea: