適用於 PWA、Windows 和 Linux（Electron、NWJS、UWP）的 Kiwix JS

示範： [ 在桌面上安裝PWA ] [ 安裝與使用：Android ] [ 安裝與使用： Firefox Android ] [ 選擇存檔資料夾] [ 檔案處理（桌面） ] [ 示範所有OPFS 功能] [ 將應用程式新增至Edge側邊欄 ]

Kiwix 是 Wikipedia、Project Gutenberg、TED Talks、Wikivoyage、Stackexchange 以及許多其他網站和資源的離線瀏覽器。它以多種不同的語言向互聯網訪問受限或無法訪問的人提供知識。該軟體和內容可供任何人免費使用。取得應用程式並下載您選擇的離線內容（ZIM 檔案，可在應用程式內免費下載）。有數百個多語言檔案可供選擇，涉及許多不同的主題和主題。打造全線下知識數位圖書館！

作為Kiwix 系列的一部分，該應用程式既可以作為支援離線、可安裝的漸進式Web 應用程式(PWA) 提供，適用於幾乎所有現代瀏覽器和設備，也可以作為適用於各種Windows 和Linux 作業系統的應用程式套件提供：請參閱Kiwix JS Windows 和 Linux 。對於Mac 和 iOS ，請使用離線 PWA。

我們還提供了Kiwix 的 WikiMed （完整的醫學百科全書）和Kiwix 的 Wikivoyage （完整的旅遊指南）的英文版應用程式 - 無需額外下載！（但是，您可以在這些應用程式中下載其他語言。）

如果您使用的是Windows 10 或 11 ，那麼這三個應用程式都可以在 Microsoft Store 中方便地獲得： Kiwix JS UWP 、 WikiMed by Kiwix和Wikivoyage by Kiwix 。當有新的軟體包可用時，它們會自動更新。如果您使用的是Linux ，那麼 Kiwix JS 的 Electron AppImage 套件也會（可選）自我更新，就像可安裝的 Windows Electron 套件一樣。當有更新可用時，其他應用程式會通知您。

通用漸進式網頁應用程式

不喜歡商店或套餐？我們為您服務！立即在瀏覽器中開啟可安裝、可離線使用的 PWA（漸進式 Web 應用程式），網址為pwa.kiwix.org ，即可立即啟動此應用程式。這適用於任何支援Service Workers 的瀏覽器：現代Chrome、Edge、Firefox 和Safari（請注意，在iOS 裝置上，您必須使用Safari，因為Apple 禁止在i 裝置上的任何其他瀏覽器中使用Service Workers）。

從應用程式的設定頁面取得可與 PWA 一起使用的免費 ZIM 存檔，或者您可以在下載 ZIM 之前在library.kiwix.org 上預覽 ZIM。安裝、新增書籤或新增至主畫面後，即使您的裝置完全離線，PWA 也能正常運作！看看我們的演示，它展示了安裝 PWA 是多麼快速和簡單。

如何讓所有維基百科離線？

如果您想要帶有圖像的版本，請注意，下載量很大：英文版約為 97 GB！我們建議您先嘗試使用較小的主題檔案之一，例如天文學、化學、數學、物理等。存檔將在您的瀏覽器中下載。

如果您確實想要帶有圖像的完整英文維基百科，那麼我們強烈建議您使用開源應用程式 qBittorrent 將其下載到具有足夠磁碟空間的 PC 上。首先安裝qBittorrent。然後，當您在應用程式中選擇要下載的大型檔案時，它將為您提供 torrent 連結。點擊該連結並允許您的瀏覽器下載並開啟 torrent 檔案。這個小檔案將在 qBittorrent 中打開，系統會詢問您要下載的檔案保存在哪裡。這比聽起來容易得多！

Zimit（網頁檔案）格式怎麼樣？

Zimit 是一項允許將任何網站存檔為 ZIM 的服務，儘管有許多令人興奮的基於 Zimit 的預爬網 ZIM 供您使用（見下文）。如果您想自己製作，請在 https://youzim.it/ 上嘗試。 Kiwix JS PWA 和 Electron 應用程式從 v.2.8.5 開始，使用開源 Replay Web Archive 閱讀器完全支援基於 Zimit 的存檔，並且已經支援即將推出的 Zimit v2 格式。請注意，大多數 Zimit 檔案由於其高度動態的內容而需要 ServiceWorker 模式。

Kiwix 下載庫（在應用程式內提供）以 Zimit 檔案格式發布了許多非常有用的參考網站，例如Ready.Gov 災難準備網站、引人入勝的Low-Tech 雜誌、 CIA World Factbook 、 Harmony Project庫樂譜、網絡哲學百科全書等等。只需開啟應用程式內庫中的 Zimit 目錄即可。

瀏覽器支援

我們為能夠維持對舊瀏覽器和平台的支援而感到自豪，因為該應用程式的重要目標受眾是發展中國家的用戶，他們可能只能訪問具有過時軟體的舊設備。我們經常在較舊的瀏覽器和作業系統上測試該應用程式。該應用程式通常會檢測哪些功能在給定瀏覽器上不起作用，並停用它們或解決它們。但是，在某些情況下（例如 Firefox <= 59），應用程式會將自身設定為 Service Worker 模式，但此模式會默默失敗。如果受影響，請嘗試將應用程式切換到受限模式（請參閱配置中的內容注入模式）。

官方支持

作為 Linux、Windows、Android、iOS、macOS 上的漸進式 Web 應用程式 (PWA)：

Google Chrome / Chromium >= 59（以及許多基於 Chromium 的瀏覽器，例如 Opera、Samsung Internet）
Microsoft Edge（鉻）> = 79
Mozilla Firefox >= 68（但請參閱有關 Android 的註釋* ）
適用於 iOS 和 macOS 的 Apple Safari >= 11.3（全文搜尋僅適用於 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)、ARM 上的 Windows、Xbox、Windows 10 Mobile
NWJS >= 0.23.0 (Windows 7/8/10/11)：GitHub 發布
NWJS 0.14.7（僅限 Windows XP/Vista）：GitHub 發布

*對於Android 版 Firefox ，該應用程式僅可用於儲存在 Origin 私有檔案系統中的檔案。 Firefox 有一個錯誤，如果從使用者可見的檔案系統開啟 ZIM 存檔，瀏覽器會嘗試將整個 ZIM 檔案讀入記憶體。

已棄用

儘管已棄用，但只要可行，我們將繼續提供支援：

Internet Explorer 11（僅限受限模式，不能離線使用 PWA）
Edge Legacy <= 17（僅限受限模式，無法離線使用 PWA）
Firefox 45-67（部分版本需要使用者手動切換到受限模式，部分版本無法顯示WebP圖片）
Chromium 49-58（某些版本僅在受限模式下運作）

報告錯誤和技術支持

請使用此儲存庫的問題追蹤器來報告您在該軟體中發現的任何錯誤。開啟新的票證（在檢查您發現的問題是否還沒有票證後）。請清楚說明您正在使用的版本號（在應用程式的設定頁面頂部）以及您正在使用的瀏覽器或平台。

如果您在使用軟體時遇到困難，或想查看新功能，也請開立票證。或者，請參閱應用程式「關於」頁面上的「回饋」部分，以了解針對您的問題取得技術支援的其他方法。如果您只是想提供反饋，請隨時聯繫（請參閱應用程式的「關於」頁面）；如果您是從商店獲得該應用程序，請留下評論。如果您喜歡該應用程序，請為此存儲庫加註星標（請參閱頂部）！

技術資料

此儲存庫用於開發適用於 PWA、Electron、NWJS 和 Windows 10/11 通用 Windows 平台 (UWP) 的 Kiwix JS 應用程式。最新的程式碼通常位於主分支上，但這用於主動開發，並且可能在發布之前進行多次提交。適用於 Windows (XP/Vista/7/8/10/11) 和 Linux（32 位元和 64 位元）的可安裝和可攜式版本可從發行版取得。 Electron 和 NWJS 應用程式的不穩定夜間建置可與開發部署一起使用，但程式碼可能有錯誤且變化很快。此外，夜間 Windows 二進位檔案是未簽署的。

程式碼基於 Kiwix JS，Kiwix 離線閱讀器的輕量級 HTML/JavaScript 連接埠。為各種框架打包此應用程式並添加一些通常向後移植到上游的功能已進行了大量開發。如果在現代 Chromium 瀏覽器中打開，PWA 可以作為完全整合的系統應用程式安裝，並且它使用檔案系統存取 API 和檔案處理 API 在支援這些 API 的瀏覽器中提供類似本機的體驗。有關這些 API 的更多信息，請參閱本頁底部：文件系統存取 API 和文件處理。

這些應用程式也可以在 WinGet 套件管理器中找到。您可以透過開啟命令提示字元或 PowerShell 終端機並輸入winget install kiwix.kiwixjs來旁載入 UWP 版本（在 Windows 10/11 中）（此版本不會自動更新，但它會在新更新準備就緒時通知您）安裝）。發行說明中提供了替代側載說明。 Electron 版本可以使用winget install kiwix.kiwixjs.electron Electron 來安裝，或從 Releases 下載軟體包來安裝。為了進行測試，Store、Electron 和 NWJS 版本附帶了前 100 篇維基百科文章的迷你檔案（沒有圖像，只有 lede 段落）。

一些 ZIM 檔案確實非常大，因此可以考慮文件系統的潛在限制。對於大多數格式化為 exFAT 或 NTFS 的儲存類型（包括 microSD 卡），您甚至可以毫無問題地將這些非常大的檔案儲存在儲存中。但是，如果您打算將 ZIM 檔案儲存在格式化為FAT32 的SD 卡上，並且希望使用大於 4GB 的存檔，那麼您將需要分割 ZIM：請參閱檔案分割說明。

這個應用程式的許多開發都發生在 Kiwix JS 儲存庫的上游，我積極參與了該儲存庫的開發。如果沒有 Kiwix JS，這個應用程式就不可能實現，非常感謝 Evopedia 應用程式和 Kiwix HTML5（最終成為 Kiwix JS）的原始開發人員。 Kiwix JS PWA 和其他應用程式的移植和進一步開發由 Geoffrey Kantaris 完成。您可以透過電子郵件聯絡我：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 。這將在package.json中指定的 Electron 版本中執行未捆綁的應用程式。請參閱package.json中的各種腳本來建立 Electron 應用程式的捆綁版本（您只能為目前使用的作業系統建立它，儘管 Linux 應用程式可以使用 WSL 在 Windows 上建置）。

其他捐款/捐贈

如果您喜歡這個專案並願意為維持其運作提供經濟捐助，您可以在 Kiwix 支援頁面上進行一次性或定期捐款。捐款有助於支付伺服器、編碼證書、維護等費用。或者，您可以透過編輯或更正維基百科或維基導遊文章來幫助改善維基媒體計畫。

隱私權政策

本隱私權政策適用於Kiwix JS Progressive Web App 及其為Electron、NWJS 和UWP 框架打包的版本，這些版本在Kiwix 伺服器上發布，並由GitHub 和其他第三方供應商商店（「應用程式商店」）上的官方Kiwix 帳戶發布。

安裝後，該應用程式能夠完全離線工作。它不會收集或記錄您的任何個人數據，但如果您從商店安裝它，商店運營商可能會收集匿名使用數據（見下文）。該應用程式僅記住您在會話期間的瀏覽記錄（以便返回之前查看的頁面）。退出應用程式時，此歷史記錄將會遺失，最後造訪的頁面除外。

如果您從安全的 Web 伺服器（例如 PWA 伺服器）存取此應用程序，則只有您的瀏覽器能夠安裝 Service Worker，它才會離線工作。如果您在 Service Worker 模式下安裝 PWA 版本或為 PWA 版本添加書籤，那麼它將離線工作，但請注意，根據設計，任何PWA 都會定期檢查PWA 伺服器（在本例中為https://pwa.kiwix .org/），如果它可以用來檢查更新的 Service Worker。

未透過 Store 安裝或不是 PWA 的應用程式版本將在啟動時檢查 GitHub Releases API 是否有更新，但此功能是可選的，可以關閉。如果您允許某些 Electron 應用程式檢查更新，它們也可以選擇自行更新（透過相同的 API）。這適用於 Windows 的安裝程式（設定）版本和 Linux 的 AppImage 版本。 Store版本和PWA也會自我更新，但這在應用程式內是無法控制的。

預設情況下，此應用程式將使用本機儲存或只能在此裝置上存取的 cookie 來記住您在會話之間上次造訪的頁面。如果您正在訪問不希望下次打開此應用程式時顯示的敏感信息，我們建議您在配置選項中關閉此選項。

此應用程式僅讀取您在裝置上明確選擇的存檔檔案以及其自身包中包含的檔案：它無法讀取任何其他檔案。如果您在設定頁面上特別要求它存取 ZIM 檔案的下載庫，它只會存取 Kiwix 存檔下載伺服器。如果您將應用程式作為 PWA 運行，它將從安全 PWA 伺服器快取自己的程式碼，然後可以離線使用。某些 ZIM 檔案包含活動內容（腳本），在極少數情況下，這些內容可能會嘗試聯絡外部伺服器以取得字體等附帶檔案。我們透過注入文章中的內容安全策略來阻止這些內容，但在某些情況下，如果文章已經有 CSP，我們的可能會被覆蓋。請注意，只有在配置中啟用 Service Worker 模式時，腳本才會執行。

如果您認為您的網路存取不安全，或正在被觀察或審查，我們建議您在使用應用程式之前完全關閉您的網路存取（資料或 WiFi）。

此外，如果您從供應商商店（包括擴充功能）獲得此應用程序，則商店運營商可能會追蹤您對該應用程式的使用情況（例如下載、安裝、卸載、日期和會話次數/持續時間），以便提供匿名、向開發人員匯總使用統計資料。如果您對此感到擔憂，您應該查看相關的商店隱私權政策以獲取更多資訊。

此應用程式的建置版本不使用 Store 或線上 Service Worker。請參閱：