Kiwix JS PWA
Kiwix
Демонстрации: [Установка PWA на рабочий стол] [Установка и использование: Android] [Установка и использование: Firefox Android] [Выбор папки с архивами] [Обработка файлов (рабочий стол)] [Демонстрация всех функций OPFS] [Добавление приложения на боковую панель Edge]
Kiwix — это автономный браузер для Википедии, Project Gutenberg, TED Talks, Wikivoyage, Stackexchange и многих других сайтов и ресурсов. Оно делает знания доступными на многих разных языках людям с ограниченным доступом к Интернету или без него. Программное обеспечение и контент бесплатны для использования всеми. Загрузите приложение и загрузите офлайн-контент по вашему выбору (архивы ZIM, которые можно бесплатно загрузить из приложения). На выбор предлагаются сотни многоязычных архивов по самым разным темам и предметам. Создайте целую цифровую библиотеку офлайн-знаний!
Это приложение, входящее в семейство Kiwix, доступно либо в виде устанавливаемого в автономном режиме прогрессивного веб-приложения (PWA) практически для всех современных браузеров и устройств, либо в виде пакетов приложений для различных операционных систем Windows и Linux: см. Kiwix JS для получения подробной информации. Винда и Линукс . Для Mac и iOS используйте автономный PWA.
У нас также есть упакованные приложения WikiMed от Kiwix (полная медицинская энциклопедия) и Wikivoyage от Kiwix (полный путеводитель) на английском языке — дополнительная загрузка не требуется! (Однако в этих приложениях вы можете загрузить другие языки.)
Если вы используете Windows 10 или 11 , то все три приложения легко доступны в Microsoft Store: Kiwix JS UWP , WikiMed от Kiwix и Wikivoyage от Kiwix . Они будут автоматически обновляться при появлении нового пакета. Если вы используете Linux , то пакет Electron AppImage Kiwix JS также (необязательно) обновляется самостоятельно, как и устанавливаемый пакет Windows Electron. Другие приложения уведомят вас, когда будет доступно обновление.
Не нравятся магазины или пакеты? Мы вас прикроем! Запустите это приложение мгновенно, открыв в браузере устанавливаемое PWA (Progressive Web App) с возможностью автономной работы на сайте pwa.kiwix.org . Это работает в любом браузере, поддерживающем Service Workers: современные Chrome, Edge, Firefox и Safari (обратите внимание, что на устройствах iOS необходимо использовать Safari, поскольку Apple запрещает использование Service Worker в любом другом браузере на i-устройствах).
Получите бесплатный ZIM-архив для использования с PWA на странице конфигурации приложения или вы можете предварительно просмотреть ZIM на сайте Library.kiwix.org, прежде чем загружать его. После установки, добавления в закладки или добавления на главный экран PWA работает, даже если ваше устройство полностью отключено от сети! Взгляните на нашу демонстрацию, которая показывает, насколько быстро и легко установить PWA.
Если вам нужна версия с изображениями, имейте в виду, что это большая загрузка: английская версия занимает около 97 гигабайт! Мы рекомендуем вам сначала попробовать его с одним из тематических, гораздо меньших архивов, таких как астрономия, химия, математика, физика и т. д. В приложении вы найдете удобный раскрывающийся список, который позволяет вам выбрать язык и тему. , а затем загрузите его. Архив загрузится в ваш браузер.
Если вам действительно нужна полная англоязычная Википедия с изображениями, мы настоятельно рекомендуем вам использовать приложение с открытым исходным кодом qBittorrent, чтобы загрузить ее на ПК с большим количеством дискового пространства. Сначала установите qBittorrent. Затем, когда вы выберете большой архив для скачивания в приложении, оно предоставит вам торрент-ссылку. Нажмите ссылку и разрешите браузеру загрузить и открыть торрент-файл. Этот небольшой файл откроется в qBittorrent, и вас спросят, где вы хотите сохранить архив, который хотите загрузить. Это намного проще, чем кажется!
Zimit — это служба, которая позволяет архивировать любой веб-сайт в виде ZIM, хотя существует множество интересных предварительно просканированных ZIM-файлов на основе Zimit, которые вы можете использовать (см. ниже). Если вы хотите создать свой собственный, попробуйте это на https://youzim.it/. Приложения Kiwix JS PWA и Electron полностью поддерживают архивы на основе Zimit, начиная с версии 2.8.5, с использованием программы чтения веб-архивов Replay с открытым исходным кодом, и уже поддерживают будущий формат Zimit v2. Обратите внимание, что для большинства архивов Zimit требуется режим ServiceWorker из-за их очень динамичного содержимого.
Библиотека загрузки Kiwix (доступная в приложении) публикует ряд фантастически полезных справочных сайтов в формате файлов Zimit, таких как сайт готовности к стихийным бедствиям Ready.Gov , увлекательный журнал Low-Tech , CIA World Factbook , библиотека Harmony Project . нот и Интернет-энциклопедия философии , среди многих других. Просто откройте каталог Zimit в библиотеке приложения.
Мы гордимся тем, что поддерживаем поддержку старых браузеров и платформ, учитывая, что важная целевая аудитория этого приложения состоит из пользователей в развивающихся странах, которые могут иметь доступ только к старым устройствам с устаревшим программным обеспечением. Мы часто тестируем приложение в старых браузерах и операционных системах. Приложение обычно определяет, какие функции не работают в конкретном браузере, и отключает их или обходит их. Однако в некоторых случаях (например, Firefox <= 59) приложение перейдет в режим Service Worker, но этот режим автоматически выйдет из строя. Если это повлияло, попробуйте переключить приложение в ограниченный режим (см. Режим внедрения контента в конфигурации).
В качестве прогрессивного веб-приложения (PWA) для Linux, Windows, Android, iOS, macOS:
Google Chrome / Chromium >= 59 (и многие браузеры на основе Chromium, например Opera, Samsung Internet)
Microsoft Edge (Chromium) >= 79
Mozilla Firefox >= 68 (но см. примечание об Android * )
Apple Safari >= 11.3 для iOS и macOS (полнотекстовый поиск работает только на iOS 15+)
Microsoft Edge Legacy 18 (только для Windows)
В виде приложения, реализованного с помощью следующих фреймворков:
Electron >= 1.8.0 (Ubuntu, Debian, Fedora, OpenSUSE, AppImage, Windows): выпуск GitHub
Универсальная платформа Windows (UWP) >=10.0.10240: приложение Microsoft Store или выпуск GitHub — Windows 10/11 (Electron), Windows на ARM, Xbox, Windows 10 Mobile
NWJS >= 0.23.0 (Windows 7/8/10/11): выпуск GitHub
NWJS 0.14.7 (только для Windows XP/Vista): выпуск GitHub
* При использовании Firefox на Android приложение можно использовать только с файлами, хранящимися в частной файловой системе Origin. Существует ошибка Firefox, из-за которой браузер пытается прочитать весь ZIM-архив в память, если он открывается из видимой пользователю файловой системы.
Несмотря на то, что поддержка устарела, мы будем поддерживать ее до тех пор, пока это практически возможно:
Internet Explorer 11 (только ограниченный режим, без использования PWA в автономном режиме)
Edge Legacy <= 17 (только ограниченный режим, без использования PWA в автономном режиме)
Firefox 45–67 (некоторые версии требуют, чтобы пользователь вручную переключился в ограниченный режим, а некоторые не могут отображать изображения WebP)
Chromium 49–58 (некоторые версии работают только в ограниченном режиме)
Пожалуйста, используйте систему отслеживания ошибок этого репозитория, чтобы сообщать о любых ошибках, обнаруженных вами в программном обеспечении. Откройте новую заявку (после проверки того, что обнаруженная вами проблема еще не имеет заявки). Пожалуйста, четко укажите номер версии, которую вы используете (вверху страницы конфигурации в приложении), а также какой браузер или платформу вы используете.
Если у вас возникли трудности с программным обеспечением или вы хотите увидеть новую функцию, пожалуйста, также откройте заявку. Кроме того, см. раздел «Отзывы» на странице «О программе» приложения, чтобы узнать о других способах получения технической поддержки по вашей проблеме. Не стесняйтесь обращаться к нам (см. страницу «О приложении»), если вы просто хотите оставить отзыв или оставить отзыв, если вы приобрели приложение из Магазина. Если вам нравится приложение, поставьте звездочку на этом репосте (см. вверху)!
Этот репозиторий предназначен для разработки приложения Kiwix JS для PWA, Electron, NWJS и универсальной платформы Windows (UWP) Windows 10/11. Последний код обычно находится в основной ветке, но он используется для активной разработки и может опережать выпуски на несколько коммитов. Устанавливаемые и переносимые версии для Windows (XP/Vista/7/8/10/11) и Linux (32- и 64-битные) доступны из выпусков. Нестабильные ночные сборки приложений Electron и NWJS доступны вместе с развертыванием для разработки, но код может содержать ошибки и быстро меняться. Кроме того, ночные двоичные файлы Windows не имеют подписи .
Код основан на Kiwix JS, облегченной версии HTML/JavaScript автономной программы чтения Kiwix. Значительная работа была проделана над упаковкой этого приложения для различных платформ и добавлением некоторых функций, которые часто передаются в исходную версию. PWA можно установить как полностью интегрированное системное приложение, если оно открыто в современном браузере Chromium, и оно использует API доступа к файловой системе и API обработки файлов для обеспечения естественного взаимодействия с браузерами, поддерживающими эти API. Дополнительную информацию об этих API см. внизу этой страницы: API доступа к файловой системе и обработка файлов.
Приложения также доступны в диспетчере пакетов WinGet. Вы можете загрузить версию UWP (в Windows 10/11), открыв командную строку или терминал PowerShell и набрав winget install kiwix.kiwixjs (эта версия не будет обновляться автоматически, но она сообщит вам, когда новое обновление будет готово). установить). Альтернативные инструкции по загрузке неопубликованных приложений доступны в примечаниях к выпуску. Версию Electron можно установить с помощью winget install kiwix.kiwixjs.electron или загрузив пакет из Releases. Для тестирования версии Store, Electron и NWJS поставляются с мини-архивом из 100 лучших статей Википедии (без изображений и только с абзацем).
Некоторые архивы ZIM действительно очень велики, поэтому следует учитывать основные ограничения файловой системы. Для большинства типов накопителей (включая карты microSD), отформатированных как exFAT или NTFS, вы можете без проблем хранить в хранилище даже очень большие файлы. Однако, если вы планируете хранить файл ZIM на SD-карте, отформатированной в формате FAT32 , и хотите использовать архив размером более 4 ГБ, вам необходимо разделить ZIM: см. инструкции по разделению файлов.
Большая часть разработки этого приложения ведется в репозитории Kiwix JS, в котором я активно участвую. Без Kiwix JS это приложение было бы невозможно, и огромная благодарность разработчикам сначала приложения Evopedia, а затем Kiwix HTML5, которое в конечном итоге стало Kiwix JS. Портом и дальнейшим развитием Kiwix JS PWA и других приложений занимается Джеффри Кантарис. Со мной можно связаться по электронной почте: egk10 at cam ac uk.
Если у вас есть опыт программирования и вы заинтересованы в участии в этом проекте, мы предлагаем вам начать с внесения вклада в исходный репозиторий Kiwix JS, поскольку большая часть кода, добавленного туда, впоследствии переносится в этот репозиторий. Подробности смотрите на CONTRIBUTING.md. Если вы хотите внести свой вклад в конкретную функцию Kiwix JS PWA, откройте вопрос в этом репозитории с объяснением функции или другого кода, который вы хотите внести, и того, как вы предлагаете это сделать. Вы должны уметь создавать PR и хорошо знать JavaScript. Следуйте тем же правилам участия, что и для Kiwix JS.
Сейчас мы перевели это приложение на код ES6, который с помощью Rollup.js и Babel транслируется в код, совместимый со старыми браузерами. Краткие инструкции:
Клонируйте этот репозиторий и запустите npm install чтобы получить зависимости Node;
Чтобы обслуживать приложение с помощью Vite.js, который включает горячую замену модулей, запустите npm run serve ;
Вы ДОЛЖНЫ включить опцию «Обход кеша приложения» в разделе «Конфигурация» в разделе «Устранение неполадок и разработка». Если приложение загружается беспорядочно, вы все равно сможете получить доступ к этому параметру, пока приложение находится в режиме ServiceWorker (если оно не включено в режиме внедрения контента). Обновите приложение, нажав Ctrl-R;
Vite будет следить за изменениями и обновлять приложение, когда вы их вносите, и сохраняете их;
Чтобы просмотреть связанную версию приложения, запустите npm run preview , и Vite создаст приложение и откроет окно браузера для просмотра связанной версии;
Чтобы полностью собрать приложение, запустите npm run build . Созданное приложение будет сохранено в каталоге dist в вашем клонированном репозитории;
Чтобы запустить приложение в среде Electron, вы можете использовать npm start . Это запустит отдельное приложение в версии Electron, указанной в package.json . См. различные сценарии для сборки встроенной версии приложения для Electron в package.json (вы можете собрать его только для той ОС, в которой вы сейчас работаете, хотя приложение для Linux можно собрать в Windows с помощью WSL).
Если вам нравится этот проект и вы хотите внести финансовый вклад в его поддержание, вы можете делать разовые или регулярные пожертвования на странице поддержки Kiwix. Пожертвования помогают оплачивать серверы, сертификаты кодирования, обслуживание и т. д. Если вы хотите вложить время и опыт, а не деньги, и у вас хорошее знание иностранного языка, вы можете помочь с переводами проектов Kiwix. Кроме того, вы можете помочь улучшить проекты Викимедиа, внося изменения или исправления в статьи Википедии или Викивояжа.
Настоящая Политика конфиденциальности применяется к Kiwix JS Progressive Web App и его версиям, упакованным для платформ Electron, NWJS и UWP, которые публикуются на серверах Kiwix, а также в официальных учетных записях Kiwix на GitHub и других магазинах сторонних поставщиков («магазины приложений»). ).
После установки это приложение способно работать полностью в автономном режиме. Он не собирает и не записывает какие-либо ваши личные данные, однако, если вы установили его из Магазина, оператор Магазина может собирать анонимные данные об использовании (см. ниже). Приложение запоминает вашу историю посещений только на время сеанса (с целью возврата к ранее просмотренным страницам). Эта история теряется при выходе из приложения, за исключением необязательной последней посещенной страницы.
Если вы получаете доступ к этому приложению с защищенного веб-сервера (например, сервера PWA), оно будет работать в автономном режиме только в том случае, если ваш браузер способен установить Service Worker. Если вы установите или сохраните версию PWA в режиме Service Worker, она будет работать в автономном режиме, но учтите, что по задумке любое PWA будет периодически проверять сервер PWA (в данном случае https://pwa.kiwix.org/), если он доступен для проверки наличия обновленного Service Worker.
Версии приложения, которые не установлены через Магазин или не являются PWA, будут предлагать проверить GitHub Releases API на наличие обновлений при запуске, но эта функция является необязательной и ее можно отключить. Некоторые приложения Electron также могут самостоятельно обновляться (через тот же API), если вы разрешите им проверять наличие обновлений. Это относится к версии установщика (установки) для Windows и к версии AppImage для Linux. Версия Store и PWA также обновляются самостоятельно, но этим нельзя управлять в приложении.
По умолчанию это приложение запомнит вашу последнюю посещенную страницу между сеансами, используя локальное хранилище или файл cookie, доступный только на этом устройстве. Если вы получаете доступ к конфиденциальной информации, которую вы не хотите отображать в следующий раз, когда вы откроете это приложение, мы рекомендуем вам отключить эту опцию в параметрах конфигурации.
Это приложение читает только файлы архива, которые вы явно выбрали на своем устройстве, и файлы, включенные в его собственный пакет: оно не может читать какие-либо другие файлы. Он получит доступ к серверу загрузки архивов Kiwix только в том случае, если вы специально запросите доступ к библиотеке загрузки для архивов ZIM на странице конфигурации. Если вы запустите приложение как PWA, оно кэширует собственный код с защищенного сервера PWA, а затем его можно будет использовать в автономном режиме. Некоторые архивы ZIM содержат активный контент (скрипты), который в редких случаях может пытаться связаться с внешними серверами для получения случайных файлов, таких как шрифты. Мы блокируем их с помощью политики безопасности контента, внедренной в статьи, но в некоторых случаях, если в статье уже есть CSP, наша политика может быть перезаписана. Обратите внимание, что сценарии запускаются только в том случае, если вы включили режим Service Worker в конфигурации.
Если вы считаете, что ваш доступ в Интернет небезопасен или за ним наблюдают или подвергают цензуре, мы рекомендуем вам полностью отключить доступ в Интернет (данные или Wi-Fi) перед использованием приложения.
Кроме того, если вы получили это приложение из магазина поставщика (включая расширения), оператор Магазина может отслеживать использование вами приложения (например, загрузку, установку, удаление, дату и количество/продолжительность сеансов) с целью предоставления анонимного, собирать статистику использования для разработчиков. Если это вас беспокоит, вам следует ознакомиться с Политикой конфиденциальности соответствующего магазина для получения дополнительной информации.
Доступны сборки этого приложения, которые не используют Store или онлайн-сервисного работника. Пожалуйста, посмотрите:
Релизы
Версия NWJS — эта версия полностью автономна и никогда не будет получать доступ к серверам, если вы не разрешите это.
