キウィックスjs pwa
Kiwix
デモ: [ デスクトップに 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を使用している場合は、 Kiwix JS UWP 、 WikiMed by Kiwix 、およびWikivoyage by Kiwix の3 つのアプリはすべて Microsoft Store で簡単に入手できます。新しいパッケージが利用可能になると、自動的に更新されます。 Linux を使用している場合は、インストール可能な Windows Electron パッケージと同様に、Kiwix JS の Electron AppImage パッケージも (オプションで) 自己更新されます。他のアプリは、アップデートが利用可能になると通知します。
ストアやパッケージが気に入らないですか?ご対応させていただきます！ pwa.kiwix.orgにあるインストール可能なオフライン対応 PWA (プログレッシブ Web アプリ) をブラウザーで今すぐ開くことで、このアプリを即座に起動できます。これは、最新の Chrome、Edge、Firefox、Safari など、Service Worker をサポートする任意のブラウザで機能します (Apple が i デバイス上の他のブラウザで Service Worker を使用することを禁止しているため、iOS デバイスでは Safari を使用する必要があることに注意してください)。
アプリの設定ページから PWA で使用する無料の ZIM アーカイブを取得するか、ダウンロードする前に library.kiwix.org で ZIM をプレビューすることができます。 PWA をインストール、ブックマーク、またはホーム画面に追加すると、デバイスが完全にオフラインの場合でも機能します。 PWA のインストールがいかに迅速かつ簡単であるかを示すデモをご覧ください。
画像付きの場合は、ダウンロードが膨大になることに注意してください。英語版は約 97 GB あります。まずは、天文学、化学、数学、物理学など、テーマ別のはるかに小さいアーカイブの 1 つで試してみることをお勧めします。アプリ内には、言語とテーマを選択できる便利なドロップダウンがあります。をクリックしてダウンロードします。アーカイブがブラウザにダウンロードされます。
画像付きの完全な英語版 Wikipedia が本当に必要な場合は、オープンソース アプリ qBittorrent を使用して、十分なディスク容量のある PC にダウンロードすることを強くお勧めします。まずはqBittorrentをインストールします。次に、アプリでダウンロードする大きなアーカイブを選択すると、トレント リンクが提供されます。リンクをクリックし、ブラウザで torrent ファイルをダウンロードして開きます。この小さなファイルは qBittorrent で開き、ダウンロードするアーカイブをどこに保存するかを尋ねられます。思っているよりもずっと簡単です!
Zimit は、あらゆる Web サイトを ZIM としてアーカイブできるサービスですが、使用できる、事前にクロールされた Zimit ベースの ZIM が多数あります (下記を参照)。独自に作成したい場合は、https://youzim.it/ で試してみてください。 Kiwix JS PWA および Electron アプリは、v.2.8.5 以降、オープンソースの Replay Web Archive リーダーを使用して Zimit ベースのアーカイブを完全にサポートしており、今後の Zimit v2 形式もすでにサポートしています。ほとんどの Zimit アーカイブは、コンテンツが非常に動的なため、ServiceWorker モードが必要であることに注意してください。
Kiwix ダウンロード ライブラリ (アプリ内で利用可能) は、 Ready.Gov 災害対策サイト、魅力的なローテク雑誌、 CIA ワールド ファクトブック、ハーモニー プロジェクトライブラリなど、数多くの非常に便利な参考サイトを Zimit ファイル形式で公開しています。楽譜、インターネット哲学百科事典など、数多くの書籍が含まれています。アプリ内ライブラリで Zimit ディレクトリを開くだけです。
このアプリの重要な対象ユーザーは、古いソフトウェアを搭載した古いデバイスにしかアクセスできない発展途上国のユーザーで構成されているため、私たちは古いブラウザーとプラットフォームのサポートを維持することに誇りを持っています。私たちは古いブラウザーやオペレーティング システムでアプリを頻繁にテストします。通常、アプリは特定のブラウザーで動作しない機能を検出し、それらの機能を無効にするか回避します。ただし、場合によっては (Firefox <= 59 など)、アプリはサービス ワーカー モードに設定されますが、このモードは通知なく失敗します。影響を受ける場合は、アプリを制限モードに切り替えてみてください (「構成」の「コンテンツ挿入モード」を参照)。
Linux、Windows、Android、iOS、macOS 上のプログレッシブ Web アプリ (PWA) として:
Google Chrome / Chromium >= 59 (および Chromium ベースの多くのブラウザ (Opera、Samsung Internet など))
Microsoft Edge (Chromium) >= 79
Mozilla Firefox >= 68 (ただし、Android *に関する注記を参照)
Apple Safari >= 11.3 for iOS および macOS (全文検索は iOS 15 以降でのみ機能します)
Microsoft Edge レガシー 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 on ARM、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 Offline リーダーの軽量 HTML/JavaScript ポートである Kiwix JS に基づいています。このアプリをさまざまなフレームワーク向けにパッケージ化し、アップストリームにバックポートされることが多いいくつかの機能を追加するために、大幅な開発が行われました。 PWA は、最新の Chromium ブラウザーで開いた場合、完全に統合されたシステム アプリとしてインストールでき、ファイル システム アクセス API とファイル処理 API を使用して、これらの API をサポートするブラウザーでネイティブのようなエクスペリエンスを実現します。これらの API の詳細については、このページの下部「ファイル システム アクセス API とファイル処理」を参照してください。
アプリは WinGet パッケージ マネージャーでも利用できます。コマンド プロンプトまたは PowerShell ターミナルを開いてwinget install kiwix.kiwixjsと入力することで、UWP バージョン (Windows 10/11) をサイドロードできます (このバージョンは自動更新されませんが、新しい更新の準備ができたときに通知されます)インストール）。代替のサイドローディング手順については、リリース ノートを参照してください。 Electron バージョンは、 winget install kiwix.kiwixjs.electronを使用してインストールするか、リリースからパッケージをダウンロードすることによってインストールできます。テスト用に、Store、Electron、および NWJS バージョンには、Wikipedia 記事のトップ 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実行してノードの依存関係を取得します。
ホット モジュール交換を含む 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 用のアプリのバンドル バージョンをビルドするためのさまざまなスクリプトを参照してください (ビルドできるのは現在使用している OS に対してのみですが、Linux アプリは WSL を使用して Windows 上にビルドできます)。
このプロジェクトが気に入って、プロジェクトの継続に財政的に貢献したい場合は、Kiwix サポート ページで 1 回限りまたは定期的に寄付を行うことができます。寄付は、サーバー、コーディング証明書、メンテナンスなどの支払いに役立ちます。お金ではなく時間と専門知識を提供したい場合、および外国語の十分な知識がある場合は、Kiwix プロジェクトの翻訳を手伝うことができます。あるいは、Wikipedia または Wikivoyage の記事を編集または修正して、Wikimedia プロジェクトの改善に役立てることもできます。
このプライバシー ポリシーは、Kiwix JS Progressive Web App と、Kiwix サーバー上で公開され、GitHub およびその他のサードパーティ ベンダー ストア (「アプリ ストア」) の公式 Kiwix アカウントによって公開される、Electron、NWJS、および UWP フレームワーク用にパッケージ化されたそのバージョンに適用されます。 ）。
このアプリケーションをインストールすると、完全にオフラインで動作できます。ストアからインストールした場合、ストアの運営者が匿名の使用データを収集する場合がありますが、個人データは収集または記録されません (下記を参照)。アプリは、(以前に表示したページに戻る目的で) セッション中にのみ閲覧履歴を記憶します。この履歴は、最後にアクセスしたページを除き、アプリを終了すると失われます。
安全な Web サーバー (PWA サーバーなど) からこのアプリケーションにアクセスする場合、ブラウザーが Service Worker をインストールできる場合にのみオフラインで動作します。 PWA バージョンを Service Worker モードでインストールまたはブックマークすると、オフラインで動作しますが、設計上、 PWA は定期的に PWA サーバー (この場合は https://pwa.kiwix.org/) をチェックすることに注意してください。更新された Service Worker を確認するために利用できます。
ストア経由でインストールされない、または PWA ではないアプリのバージョンでは、起動時に GitHub リリース API の更新を確認するよう提案されますが、この機能はオプションであり、オフにしておくことができます。一部の Electron アプリは、更新の確認を許可した場合、オプションで (同じ API 経由で) 自己更新も行います。これは、Windows の場合はインストーラー (セットアップ) バージョン、Linux の場合は AppImage バージョンに適用されます。ストア版とPWAも自動更新されますが、これはアプリ内で制御できません。
デフォルトでは、このアプリケーションは、ローカル ストレージまたはこのデバイスでのみアクセス可能な Cookie を使用して、セッション間で最後にアクセスしたページを記憶します。次回このアプリを開いたときに表示されたくない機密情報にアクセスしている場合は、構成オプションでこのオプションをオフにすることをお勧めします。
このアプリケーションは、デバイス上で明示的に選択したアーカイブ ファイルおよび独自のパッケージに含まれるファイルのみを読み取ります。他のファイルを読み取ることはできません。 「設定」ページで ZIM アーカイブのダウンロード ライブラリへのアクセスを特に要求した場合にのみ、Kiwix アーカイブ ダウンロード サーバーにアクセスします。アプリを PWA として実行すると、アプリ自体のコードが安全な PWA サーバーからキャッシュされ、オフラインで使用できるようになります。一部の ZIM アーカイブにはアクティブ コンテンツ (スクリプト) が含まれており、まれに、フォントなどの付随ファイルを求めて外部サーバーに接続しようとする場合があります。これらは記事に挿入されたコンテンツ セキュリティ ポリシーでブロックされますが、記事にすでに CSP がある場合、場合によっては CSP が上書きされる可能性があります。スクリプトは、構成で Service Worker モードを有効にした場合にのみ実行されることに注意してください。
インターネット アクセスが安全でない、または監視または検閲されていると思われる場合は、アプリケーションを使用する前にインターネット アクセス (データまたは WiFi) を完全にシャットダウンすることをお勧めします。
さらに、このアプリをベンダー ストア (拡張機能を含む) から入手した場合、ストア オペレーターは、匿名で提供する目的で、アプリの使用状況 (ダウンロード、インストール、アンインストール、日付とセッションの数/期間など) を追跡する場合があります。使用状況統計を開発者に集約します。これが気になる場合は、関連するストアのプライバシー ポリシーで詳細を確認してください。
ストアまたはオンライン Service Worker を使用しないこのアプリのビルドは利用可能です。ご覧ください:
リリース
NWJS バージョン - このバージョンは完全にスタンドアロンであり、許可しない限りサーバーにアクセスすることはありません。
