kiwix js pwa
Kiwix
Demonstrações: [Instalar PWA no desktop] [Instalar e usar: Android] [Instalar e usar: Firefox Android] [Escolhendo uma pasta de arquivos] [Manipulação de arquivos (desktop)] [Demonstração de todos os recursos OPFS] [Adicionando aplicativo à barra lateral do Edge]
Kiwix é um navegador offline para Wikipedia, Project Gutenberg, TED Talks, Wikivoyage, Stackexchange e muitos outros sites e recursos. Disponibiliza conhecimento, em diversos idiomas, para pessoas com acesso limitado ou inexistente à Internet. O software e o conteúdo são gratuitos para qualquer pessoa usar. Obtenha o aplicativo e baixe o conteúdo off-line de sua escolha (arquivos ZIM, que podem ser baixados gratuitamente no aplicativo). Existem centenas de arquivos multilíngues para você escolher, sobre diversos tópicos e assuntos. Construa uma biblioteca digital completa de conhecimento offline!
Parte da família Kiwix, este aplicativo está disponível como um Progressive Web App (PWA) instalável e com capacidade offline, para quase todos os navegadores e dispositivos modernos, ou então como pacotes de aplicativos para vários sistemas operacionais Windows e Linux: consulte Kiwix JS para Windows e Linux . Para Mac e iOS , use o PWA offline.
Também temos aplicativos empacotados do WikiMed by Kiwix (uma enciclopédia médica completa) e do Wikivoyage by Kiwix (um guia de viagem completo) em inglês - não é necessário nenhum download extra! (No entanto, você pode baixar outros idiomas nesses aplicativos.)
Se você estiver usando o Windows 10 ou 11 , todos os três aplicativos estarão convenientemente disponíveis na Microsoft Store: Kiwix JS UWP , WikiMed da Kiwix e Wikivoyage da Kiwix . Eles serão atualizados automaticamente quando um novo pacote estiver disponível. Se você estiver usando Linux , o pacote Electron AppImage do Kiwix JS também (opcionalmente) se atualiza automaticamente, assim como o pacote instalável do Windows Electron. Outros aplicativos irão notificá-lo quando uma atualização estiver disponível.
Não gosta de lojas ou pacotes? Nós ajudamos você! Inicie este aplicativo instantaneamente abrindo o PWA (Progressive Web App) instalável e com capacidade offline em seu navegador agora mesmo em pwa.kiwix.org . Isso funciona em qualquer navegador que suporte Service Workers: Chrome, Edge, Firefox e Safari modernos (observe que em dispositivos iOS, você deve usar o Safari porque a Apple proíbe o uso de Service Workers em qualquer outro navegador em dispositivos i).
Obtenha um arquivo ZIM gratuito para usar com o PWA na página de configuração do aplicativo ou você pode visualizar um ZIM em library.kiwix.org antes de baixar um. Depois de instalado, marcado ou adicionado à tela inicial, o PWA funciona mesmo quando o dispositivo está totalmente offline! Dê uma olhada em nossa demonstração que mostra como é rápido e fácil instalar o PWA.
Se você quiser com imagens, saiba que é um download grande: a versão em inglês tem cerca de 97 Gigabytes! Recomendamos que você experimente primeiro com um dos arquivos temáticos, muito menores, como Astronomia, Química, Matemática, Física, etc. No aplicativo, você encontrará um menu suspenso útil que permite escolher seu idioma e seu tema e faça o download. O arquivo será baixado em seu navegador.
Se você realmente deseja a Wikipédia em inglês completa com imagens, recomendamos fortemente que você use o aplicativo de código aberto qBittorrent para baixá-la em um PC com bastante espaço em disco. Primeiro instale o qBittorrent. Então, quando você selecionar um arquivo grande para download no aplicativo, ele fornecerá um link de torrent. Clique no link e permita que seu navegador baixe e abra o arquivo torrent. Este pequeno arquivo será aberto no qBittorrent e você será perguntado onde deseja salvar o arquivo que deseja baixar. É muito mais fácil do que parece!
Zimit é um serviço que permite que qualquer site seja arquivado como um ZIM, embora existam muitos ZIMs baseados em Zimit pré-rastreados para você usar (veja abaixo). Se você quiser fazer o seu próprio, experimente em https://youzim.it/. Os aplicativos Kiwix JS PWA e Electron têm suporte total para arquivos baseados em Zimit a partir da v.2.8.5 usando o leitor Replay Web Archive de código aberto e já suportam o futuro formato Zimit v2. Observe que a maioria dos arquivos Zimit exigirá o modo ServiceWorker, devido ao seu conteúdo altamente dinâmico.
A biblioteca de download Kiwix (disponível no aplicativo) publica uma série de sites de referência fantasticamente úteis no formato de arquivo Zimit, como o site de preparação para desastres Ready.Gov , a fascinante revista Low-Tech , o CIA World Factbook , a biblioteca Harmony Project de partituras e a Enciclopédia de Filosofia da Internet - entre muitos outros. Basta abrir o diretório Zimit na biblioteca do aplicativo.
Orgulhamo-nos de manter o suporte para navegadores e plataformas antigas, visto que um importante público-alvo deste aplicativo consiste em usuários do mundo em desenvolvimento que podem ter acesso apenas a dispositivos antigos com software desatualizado. Testamos o aplicativo frequentemente em navegadores e sistemas operacionais mais antigos. O aplicativo geralmente detecta quais recursos não funcionam em um determinado navegador e os desativa ou contorna. No entanto, em alguns casos (por exemplo, Firefox <= 59), o aplicativo irá definir-se para o modo Service Worker, mas este modo falhará silenciosamente. Se afetado, tente mudar o aplicativo para o modo restrito (consulte Modo de injeção de conteúdo em Configuração).
Como um Progressive Web App (PWA) em Linux, Windows, Android, iOS, macOS:
Google Chrome / Chromium >= 59 (e muitos navegadores baseados em Chromium, por exemplo, Opera, Samsung Internet)
Microsoft Edge (cromo) >= 79
Mozilla Firefox >= 68 (mas veja nota sobre Android * )
Apple Safari >= 11.3 para iOS e macOS (a pesquisa de texto completo funciona apenas no iOS 15+)
Microsoft Edge Legado 18 (somente Windows)
Como um aplicativo implementado com os seguintes frameworks:
Electron >= 1.8.0 (Ubuntu, Debian, Fedora, OpenSUSE, AppImage, Windows): lançamento do GitHub
Plataforma Universal do Windows (UWP) >=10.0.10240: aplicativo Microsoft Store ou lançamento do GitHub – Windows 10/11 (Electron), Windows em ARM, Xbox, Windows 10 Mobile
NWJS >= 0.23.0 (Windows 7/8/10/11): lançamento do GitHub
NWJS 0.14.7 (somente Windows XP/Vista): lançamento do GitHub
* Com o Firefox no Android , o aplicativo só pode ser usado com arquivos armazenados no Origin Private File System. Há um bug do Firefox em que o navegador tenta ler todo o arquivo ZIM na memória ao abri-lo a partir do sistema de arquivos visível ao usuário.
Embora obsoleto, manteremos o suporte enquanto for prático:
Internet Explorer 11 (somente modo restrito, sem uso offline de PWA)
Edge Legacy <= 17 (apenas modo restrito, sem uso offline de PWA)
Firefox 45-67 (algumas versões exigem que o usuário alterne manualmente para o modo restrito e algumas não conseguem exibir imagens WebP)
Chromium 49-58 (algumas versões funcionam apenas no modo restrito)
Use o rastreador de problemas deste repositório para relatar quaisquer bugs encontrados no software. Abra um novo ticket (depois de verificar se o problema identificado ainda não possui um ticket). Indique claramente o número da versão que você está usando (na parte superior da página de configuração do aplicativo) e qual navegador ou plataforma você está usando.
Se você estiver tendo dificuldades com o software ou quiser ver um novo recurso, abra também um ticket. Como alternativa, consulte a seção Feedback na página Sobre do aplicativo para outras maneiras de obter suporte técnico para o seu problema. Sinta-se à vontade para entrar em contato (consulte a página Sobre do aplicativo) se desejar apenas fornecer feedback ou deixar um comentário se você obteve o aplicativo em uma loja. Se você gosta do app, marque este Repositório com estrela (veja o topo)!
Este repositório é para o desenvolvimento do aplicativo Kiwix JS para PWA, Electron, NWJS e Windows 10/11 Universal Windows Platform (UWP). O código mais recente geralmente está no branch principal, mas é usado para desenvolvimento ativo e pode haver vários commits antes dos lançamentos. Versões instaláveis e portáteis para Windows (XP/Vista/7/8/10/11) e Linux (32 bits e 64 bits) estão disponíveis nos lançamentos. Compilações noturnas instáveis dos aplicativos Electron e NWJS estão disponíveis junto com uma implantação de desenvolvimento, mas o código pode apresentar erros e mudar rapidamente. Além disso, os binários noturnos do Windows são unsigned .
O código é baseado em Kiwix JS, uma porta HTML/JavaScript leve do leitor Kiwix Offline. Um desenvolvimento significativo foi feito no empacotamento deste aplicativo para várias estruturas e na adição de alguns recursos que geralmente são backportados no upstream. O PWA pode ser instalado como um aplicativo de sistema totalmente integrado se aberto em um navegador Chromium moderno e usa a API de acesso ao sistema de arquivos e a API de manipulação de arquivos para uma experiência nativa em navegadores que suportam essas APIs. Para obter mais informações sobre essas APIs, consulte o final desta página: API de acesso ao sistema de arquivos e manipulação de arquivos.
Os aplicativos também estão disponíveis no WinGet Package Manager. Você pode fazer o sideload da versão UWP (no Windows 10/11) abrindo um prompt de comando ou terminal do PowerShell e digitando winget install kiwix.kiwixjs (esta versão não será atualizada automaticamente, mas avisará quando uma nova atualização estiver pronta para instalar). Instruções alternativas de sideload estão disponíveis nas notas de versão. A versão Electron pode ser instalada com winget install kiwix.kiwixjs.electron , ou então baixando um pacote em Releases. Para teste, as versões Store, Electron e NWJS vêm com um miniarquivo dos 100 principais artigos da Wikipedia (sem imagens e apenas com o parágrafo lede).
Alguns arquivos ZIM são realmente muito grandes, portanto, os limites subjacentes do sistema de arquivos podem ser levados em consideração. Para a maioria dos tipos de armazenamento (incluindo cartões microSD) formatados como exFAT ou NTFS, você pode armazenar até mesmo esses arquivos muito grandes no armazenamento sem problemas. No entanto, se você planeja armazenar seu arquivo ZIM em um cartão SD formatado como FAT32 e deseja usar um arquivo maior que 4 GB, será necessário dividir o ZIM: consulte as instruções de divisão de arquivo.
Muito do desenvolvimento deste aplicativo acontece no repositório Kiwix JS, ao qual dou contribuição ativamente. Sem o Kiwix JS, este aplicativo seria impossível, e um grande agradecimento aos desenvolvedores originais, primeiro do aplicativo Evopedia e depois do Kiwix HTML5, que eventualmente se tornou o Kiwix JS. A portabilidade e o desenvolvimento do Kiwix JS PWA e outros aplicativos são de Geoffrey Kantaris. Posso ser contatado por e-mail: egk10 em cam ac uk.
Se você tem experiência em codificação e está interessado em contribuir para este projeto, sugerimos que você comece contribuindo para o repositório Kiwix JS upstream, já que grande parte do código contribuído é posteriormente portado para este repositório. Consulte CONTRIBUTING.md para obter detalhes. Se você deseja contribuir com um recurso específico do Kiwix JS PWA, abra um problema neste repositório explicando o recurso ou outro código com o qual pretende contribuir e como você propõe que isso seja feito. Você deve se sentir confortável criando PRs e ter bons conhecimentos de JavaScript. Siga as mesmas diretrizes de contribuição do Kiwix JS.
Agora fizemos a transição deste aplicativo para o código ES6, que é transpilado por rollup.js e Babel para um código compatível com navegadores mais antigos. Breves instruções:
Clone este repositório e execute npm install para obter as dependências do Node;
Para servir o aplicativo com Vite.js, que inclui Hot Module Replacement, execute npm run serve ;
Você DEVE ativar a opção Ignorar o cache do aplicativo em Configuração em Solução de problemas e desenvolvimento. Se o aplicativo carregar de maneira desordenada, você ainda poderá acessar essa configuração desde que o aplicativo esteja no modo ServiceWorker (se não estiver, ative-o no modo de injeção de conteúdo). Atualize o aplicativo com Ctrl-R;
Vite observará as alterações e atualizará o aplicativo quando você fizer alguma e as salvará;
Para visualizar a versão empacotada do aplicativo, execute npm run preview e o Vite criará o aplicativo e abrirá uma janela do navegador para visualizar a versão empacotada;
Para compilar totalmente o aplicativo, execute npm run build . O aplicativo criado será salvo em um diretório chamado dist em seu repositório clonado;
Para executar o aplicativo na estrutura Electron, você pode usar npm start . Isso executará o aplicativo desagregado na versão Electron especificada em package.json . Veja vários scripts para construir a versão empacotada do aplicativo para Electron em package.json (você só pode construí-lo para o sistema operacional em que está atualmente, embora o aplicativo Linux possa ser construído no Windows com WSL).
Se você gosta deste projeto e gostaria de contribuir financeiramente para mantê-lo funcionando, você pode fazer doações únicas ou regulares na página de suporte do Kiwix. As doações ajudam a pagar servidores, certificados de codificação, manutenção, etc. Se você quiser contribuir com tempo e experiência em vez de dinheiro, e tiver um bom conhecimento de um idioma estrangeiro, poderá ajudar com traduções de projetos Kiwix. Alternativamente, você pode ajudar a melhorar os projetos da Wikimedia fazendo edições ou correções nos artigos da Wikipedia ou do Wikivoyage.
Esta Política de Privacidade se aplica ao Kiwix JS Progressive Web App e às versões dele empacotadas para as estruturas Electron, NWJS e UWP que são publicadas em servidores Kiwix e por contas oficiais Kiwix no GitHub e outras lojas de fornecedores de terceiros ("lojas de aplicativos" ).
Quando instalado, este aplicativo é capaz de funcionar totalmente offline. Ele não coleta nem registra nenhum dos seus dados pessoais, mas se você o instalou a partir de uma Loja, o operador da Loja poderá coletar dados de uso anônimos (veja abaixo). O aplicativo lembra seu histórico de navegação apenas durante uma sessão (com a finalidade de retornar às páginas visualizadas anteriormente). Este histórico é perdido ao sair do aplicativo, com a exceção opcional da última página visitada.
Se você acessar este aplicativo a partir de um servidor web seguro (por exemplo, o servidor PWA), ele só funcionará offline se o seu navegador for capaz de instalar um Service Worker. Se você instalar ou marcar a versão do PWA no modo Service Worker, ele funcionará offline, mas observe que, por design, qualquer PWA verificará periodicamente o servidor PWA (neste caso, https://pwa.kiwix.org/), se ele está disponível para verificar se há um Service Worker atualizado.
Versões do aplicativo que não são instaladas por meio de uma Loja ou que não são PWAs oferecerão a verificação da API de lançamentos do GitHub para atualizações na inicialização, mas essa funcionalidade é opcional e pode ser mantida desativada. Alguns aplicativos Electron também serão opcionalmente atualizados automaticamente (por meio da mesma API), se você permitir que eles verifiquem se há atualizações. Isso se aplica à versão do instalador (configuração) para Windows e à versão AppImage para Linux. A versão Store e o PWA também se atualizam automaticamente, mas isso não pode ser controlado no aplicativo.
Por padrão, este aplicativo lembrará sua última página visitada entre sessões usando armazenamento local ou um cookie acessível apenas neste dispositivo. Se você estiver acessando informações confidenciais que não deseja que sejam exibidas na próxima vez que abrir este aplicativo, recomendamos que você desative esta opção nas opções de configuração.
Este aplicativo lê apenas os arquivos compactados que você seleciona explicitamente em seu dispositivo e os arquivos incluídos em seu próprio pacote: ele não é capaz de ler nenhum outro arquivo. Ele só acessará o servidor de download de arquivos Kiwix se você solicitar especificamente o acesso à biblioteca de download de arquivos ZIM na página Configuração. Se você executar o aplicativo como um PWA, ele armazenará em cache seu próprio código do servidor PWA seguro e poderá ser usado offline. Alguns arquivos ZIM contêm conteúdo ativo (scripts) que podem, em raras circunstâncias, tentar entrar em contato com servidores externos para obter arquivos incidentais, como fontes. Bloqueamos estes com uma Política de Segurança de Conteúdo injetada nos artigos, mas em alguns casos, se o artigo já tiver um CSP, o nosso poderá ser substituído. Observe que os scripts só serão executados se você ativar o modo Service Worker na configuração.
Se você acredita que seu acesso à Internet é inseguro, ou está sendo observado ou censurado, recomendamos que você desligue completamente o seu acesso à Internet (dados ou WiFi) antes de usar o aplicativo.
Além disso, se você obteve este aplicativo de uma loja de fornecedor (incluindo extensões), o operador da Loja poderá rastrear seu uso do aplicativo (por exemplo, download, instalação, desinstalação, data e número/duração das sessões) com a finalidade de fornecer dados anônimos, agregar estatísticas de uso aos desenvolvedores. Se isso lhe interessa, verifique a Política de Privacidade da Loja relevante para obter mais informações.
Estão disponíveis compilações deste aplicativo que não usam uma Loja ou um Service Worker online. Por favor veja:
Lançamentos
Versão NWJS - esta versão é completamente independente e nunca acessará servidores a menos que você permita.
