kiwix js pwa
Kiwix
Demo: [ Instal PWA di Desktop ] [ Instal dan gunakan: Android ] [ Instal dan gunakan: Firefox Android ] [ Memilih folder arsip ] [ Penanganan file (desktop) ] [ Demo semua fitur OPFS ] [ Menambahkan aplikasi ke sidebar Edge ]
Kiwix adalah browser offline untuk Wikipedia, Project Gutenberg, TED Talks, Wikivoyage, Stackexchange, dan banyak situs serta sumber lainnya. Hal ini membuat pengetahuan tersedia, dalam berbagai bahasa, bagi orang-orang dengan akses Internet terbatas atau tanpa akses sama sekali. Perangkat lunak dan kontennya gratis untuk digunakan siapa saja. Dapatkan aplikasinya dan unduh konten offline pilihan Anda (arsip ZIM, yang dapat diunduh gratis dalam aplikasi). Ada ratusan arsip multibahasa yang dapat dipilih, mengenai berbagai topik dan subjek. Bangun seluruh perpustakaan digital pengetahuan offline!
Sebagai bagian dari keluarga Kiwix, aplikasi ini tersedia sebagai Aplikasi Web Progresif (PWA) yang mampu offline dan dapat diinstal, untuk hampir semua browser dan perangkat modern, atau sebagai paket aplikasi untuk berbagai sistem operasi Windows dan Linux: lihat Kiwix JS untuk Windows dan Linux . Untuk Mac dan iOS , gunakan PWA offline.
Kami juga memiliki paket aplikasi WikiMed by Kiwix (ensiklopedia medis lengkap), dan Wikivoyage by Kiwix (panduan perjalanan lengkap) dalam bahasa Inggris -- tidak perlu download tambahan! (Namun, Anda dapat mengunduh bahasa lain di aplikasi ini.)
Jika Anda menggunakan Windows 10 atau 11 , ketiga aplikasi tersebut tersedia dengan mudah di Microsoft Store: Kiwix JS UWP , WikiMed oleh Kiwix , dan Wikivoyage oleh Kiwix . Mereka akan secara otomatis memperbarui ketika paket baru tersedia. Jika Anda menggunakan Linux , maka paket Electron AppImage dari Kiwix JS juga (opsional) melakukan pembaruan mandiri, seperti halnya paket Windows Electron yang dapat diinstal. Aplikasi lain akan memberi tahu Anda ketika pembaruan tersedia.
Tidak suka toko atau paket? Kami siap membantu Anda! Luncurkan aplikasi ini secara instan dengan membuka PWA (Aplikasi Web Progresif) yang dapat diinstal dan mampu offline di browser Anda sekarang di pwa.kiwix.org . Ini berfungsi di browser apa pun yang mendukung Service Worker: Chrome modern, Edge, Firefox, dan Safari (perhatikan bahwa di perangkat iOS, Anda harus menggunakan Safari karena Apple melarang penggunaan Service Worker di browser lain di perangkat i).
Dapatkan arsip ZIM gratis untuk digunakan dengan PWA dari halaman Konfigurasi aplikasi, atau Anda dapat melihat pratinjau ZIM di library.kiwix.org sebelum mengunduhnya. Setelah dipasang, ditandai, atau ditambahkan ke layar beranda Anda, PWA berfungsi bahkan saat perangkat Anda sepenuhnya offline! Lihatlah demo kami yang menunjukkan betapa cepat dan mudahnya menginstal PWA.
Jika Anda menginginkannya dengan gambar, perlu diketahui bahwa unduhannya besar: versi bahasa Inggrisnya sekitar 97 Gigabytes! Kami menyarankan Anda mencobanya terlebih dahulu dengan salah satu arsip bertema yang jauh lebih kecil, seperti Astronomi, Kimia, Matematika, Fisika, dll. Dalam aplikasi, Anda akan menemukan dropdown praktis yang memungkinkan Anda memilih bahasa dan tema Anda , lalu unduh. Arsip akan diunduh di browser Anda.
Jika Anda benar-benar menginginkan Wikipedia bahasa Inggris lengkap dengan gambar, kami sangat menyarankan Anda menggunakan aplikasi sumber terbuka qBittorrent untuk mengunduhnya ke PC dengan ruang disk yang besar. Instal terlebih dahulu qBittorrent. Kemudian, ketika Anda memilih arsip besar untuk diunduh di aplikasi, itu akan memberi Anda tautan torrent. Klik tautannya dan izinkan browser Anda mengunduh dan membuka file torrent. File kecil ini akan terbuka di qBittorrent dan Anda akan ditanya di mana Anda ingin menyimpan arsip yang ingin Anda unduh. Ini jauh lebih mudah daripada kedengarannya!
Zimit adalah layanan yang memungkinkan situs Web apa pun diarsipkan sebagai ZIM, meskipun ada banyak ZIM berbasis Zimit yang sudah dirayapi dan menarik untuk Anda gunakan (lihat di bawah). Jika Anda ingin membuatnya sendiri, cobalah di https://youzim.it/. Aplikasi Kiwix JS PWA dan Electron memiliki dukungan penuh untuk arsip berbasis Zimit mulai v.2.8.5 menggunakan pembaca Replay Web Archive sumber terbuka, dan sudah mendukung format Zimit v2 yang akan datang. Harap dicatat bahwa sebagian besar arsip Zimit memerlukan mode ServiceWorker, karena kontennya yang sangat dinamis.
Pustaka unduhan Kiwix (tersedia dalam aplikasi) menerbitkan sejumlah situs referensi yang sangat berguna dalam format file Zimit, seperti situs kesiapan bencana Ready.Gov , majalah Low-Tech yang menarik, CIA World Factbook , perpustakaan Harmony Project lembaran musik, dan Internet Encyclopaedia of Philosophy -- di antara banyak lainnya. Buka saja direktori Zimit di perpustakaan dalam aplikasi.
Kami bangga dapat mempertahankan dukungan untuk browser dan platform lama, mengingat target audiens penting untuk aplikasi ini terdiri dari pengguna di negara berkembang yang mungkin hanya memiliki akses ke perangkat lama dengan perangkat lunak yang sudah ketinggalan zaman. Kami sering menguji aplikasi pada browser dan sistem operasi lama. Aplikasi biasanya akan mendeteksi fitur mana yang tidak berfungsi pada browser tertentu, dan menonaktifkannya atau mengatasinya. Namun, dalam beberapa kasus (misalnya Firefox <= 59), aplikasi akan menyetel dirinya ke mode Service Worker, namun mode ini akan gagal secara diam-diam. Jika terpengaruh, coba alihkan aplikasi ke mode Terbatas (lihat mode injeksi konten di Konfigurasi).
Sebagai Aplikasi Web Progresif (PWA) di Linux, Windows, Android, iOS, macOS:
Google Chrome / Chromium >= 59 (dan banyak browser berbasis Chromium, misalnya Opera, Samsung Internet)
Microsoft Edge (Kromium) >= 79
Mozilla Firefox >= 68 (tetapi lihat catatan tentang Android * )
Apple Safari >= 11.3 untuk iOS dan macOS (pencarian teks lengkap hanya berfungsi di iOS 15+)
Microsoft Edge Lama 18 (hanya Windows)
Sebagai aplikasi yang diimplementasikan dengan framework sebagai berikut:
Electron >= 1.8.0 (Ubuntu, Debian, Fedora, OpenSUSE, AppImage, Windows): Rilis GitHub
Platform Windows Universal (UWP) >=10.0.10240: Aplikasi Microsoft Store atau rilis GitHub - Windows 10/11 (Electron), Windows di ARM, Xbox, Windows 10 Mobile
NWJS >= 0.23.0 (Windows 7/8/10/11): rilis GitHub
NWJS 0.14.7 (khusus Windows XP/Vista): Rilis GitHub
* Dengan Firefox di Android , aplikasi hanya dapat digunakan dengan file yang disimpan di Sistem File Pribadi Asal. Ada bug Firefox yang menyebabkan browser mencoba membaca seluruh arsip ZIM ke dalam memori jika membukanya dari sistem file yang terlihat oleh pengguna.
Meskipun tidak digunakan lagi, kami akan tetap memberikan dukungan selama masih memungkinkan:
Internet Explorer 11 (Hanya mode terbatas, tidak ada penggunaan PWA offline)
Edge Legacy <= 17 (Hanya mode terbatas, tidak ada penggunaan PWA offline)
Firefox 45-67 (beberapa versi mengharuskan pengguna untuk beralih secara manual ke mode Terbatas, dan beberapa tidak dapat menampilkan gambar WebP)
Chromium 49-58 (beberapa versi hanya berjalan dalam mode Terbatas)
Silakan gunakan pelacak masalah repositori ini untuk melaporkan bug apa pun yang Anda temukan pada perangkat lunak. Buka tiket baru (setelah memeriksa bahwa masalah yang Anda identifikasi belum memiliki tiket). Harap sebutkan dengan jelas nomor versi yang Anda gunakan (di bagian atas halaman Konfigurasi di aplikasi), dan browser atau platform apa yang Anda gunakan.
Jika Anda mengalami kesulitan dengan perangkat lunak, atau ingin melihat fitur baru, silakan buka juga tiket. Atau, lihat bagian Masukan di halaman Tentang di aplikasi untuk mengetahui cara lain mendapatkan dukungan teknis untuk masalah Anda. Jangan ragu untuk menghubungi (lihat halaman Tentang aplikasi) jika Anda hanya ingin memberikan umpan balik, atau tinggalkan ulasan jika Anda memperoleh aplikasi dari Toko. Jika Anda menyukai aplikasi ini, silakan bintangi Repostiori ini (lihat atas)!
Repositori ini untuk pengembangan aplikasi Kiwix JS untuk PWA, Electron, NWJS dan Windows 10/11 Universal Windows Platform (UWP). Kode terbaru biasanya ada di cabang utama, tetapi ini digunakan untuk pengembangan aktif dan mungkin memerlukan beberapa penerapan sebelum rilis. Versi yang dapat diinstal dan portabel untuk Windows (XP/Vista/7/8/10/11) dan Linux (32bit dan 64bit) tersedia dari rilis. Pembuatan aplikasi Electron dan NWJS setiap malam yang tidak stabil tersedia bersamaan dengan penerapan pengembangan, tetapi kode mungkin bermasalah dan berubah dengan cepat. Selain itu, binari Windows malam tidak ditandatangani .
Kode ini didasarkan pada Kiwix JS, port HTML/JavaScript ringan dari pembaca Kiwix Offline. Perkembangan signifikan telah dilakukan dalam mengemas aplikasi ini untuk berbagai kerangka kerja, dan menambahkan beberapa fitur yang sering di-backport ke hulu. PWA dapat diinstal sebagai aplikasi sistem yang terintegrasi penuh jika dibuka di browser Chromium modern, dan menggunakan API Akses Sistem File dan API Penanganan File untuk pengalaman seperti asli di browser yang mendukung API tersebut. Untuk informasi selengkapnya tentang API ini, lihat bagian bawah halaman ini: API Akses Sistem File dan Penanganan File.
Aplikasi ini juga tersedia di WinGet Package Manager. Anda dapat melakukan sideload versi UWP (di Windows 10/11) dengan membuka terminal Command Prompt atau PowerShell dan mengetik winget install kiwix.kiwixjs (versi ini tidak akan diperbarui secara otomatis, namun akan memberi tahu Anda ketika pembaruan baru siap untuk memasang). Petunjuk sideload alternatif tersedia di catatan rilis. Versi Electron dapat diinstal dengan winget install kiwix.kiwixjs.electron , atau dengan mengunduh paket dari Rilis. Untuk pengujian, versi Store, Electron, dan NWJS hadir dengan arsip mini berisi 100 artikel Wikipedia teratas (tanpa gambar dan hanya paragraf lede).
Beberapa arsip ZIM memang berukuran sangat besar, sehingga batasan yang mendasari Sistem File dapat menjadi pertimbangan. Untuk sebagian besar jenis penyimpanan (termasuk kartu microSD) yang diformat sebagai exFAT atau NTFS, Anda bahkan dapat menyimpan file yang sangat besar ini di penyimpanan tanpa masalah. Namun, jika Anda berencana untuk menyimpan file ZIM pada kartu SD yang diformat sebagai FAT32 , dan Anda ingin menggunakan arsip yang lebih besar dari 4GB, maka Anda perlu membagi ZIM: lihat petunjuk pemisahan file.
Banyak pengembangan untuk aplikasi ini terjadi di bagian hulu di repositori Kiwix JS tempat saya berkontribusi secara aktif. Tanpa Kiwix JS, aplikasi ini tidak mungkin ada, dan terima kasih yang sebesar-besarnya kami sampaikan kepada pengembang asli aplikasi Evopedia dan kemudian Kiwix HTML5, yang akhirnya menjadi Kiwix JS. Port dan pengembangan lebih lanjut Kiwix JS PWA dan aplikasi lainnya dilakukan oleh Geoffrey Kantaris. Saya dapat dihubungi melalui email: egk10 di cam ac uk.
Jika Anda memiliki pengalaman pengkodean dan tertarik untuk berkontribusi pada proyek ini, kami sarankan Anda mulai dengan berkontribusi ke repositori Kiwix JS upstream, karena sebagian besar kode yang dikontribusikan di sana kemudian di-porting ke repositori ini. Silakan lihat CONTRIBUTING.md untuk detailnya. Jika Anda ingin berkontribusi pada fitur Kiwix JS PWA tertentu, silakan buka terbitan di repositori ini yang menjelaskan fitur atau kode lain yang ingin Anda kontribusikan dan bagaimana Anda mengusulkan hal ini harus dilakukan. Anda harus merasa nyaman membuat PR dan memiliki pengetahuan yang baik tentang JavaScript. Ikuti pedoman kontribusi yang sama seperti untuk Kiwix JS.
Kami sekarang telah mentransisikan aplikasi ini ke kode ES6, yang diubah oleh rollup.js dan Babel menjadi kode yang kompatibel dengan browser lama. Instruksi singkat:
Kloning repo ini dan jalankan npm install untuk mendapatkan dependensi Node;
Untuk melayani aplikasi dengan Vite.js, yang mencakup Penggantian Modul Panas, jalankan npm run serve ;
Anda HARUS mengaktifkan opsi untuk Melewati cache aplikasi di Konfigurasi di bawah Pemecahan Masalah dan pengembangan. Jika aplikasi dimuat secara tidak teratur, Anda masih dapat mengakses pengaturan ini selama aplikasi berada dalam mode ServiceWorker (jika tidak diaktifkan dalam mode Injeksi konten). Segarkan aplikasi dengan Ctrl-R;
Vite akan memperhatikan perubahan dan akan menyegarkan aplikasi saat Anda membuat dan menyimpannya;
Untuk melihat pratinjau versi paket aplikasi, jalankan npm run preview , dan Vite akan membuat aplikasi dan membuka jendela browser untuk melihat versi paket;
Untuk membangun aplikasi sepenuhnya, jalankan npm run build . Aplikasi yang dibangun akan disimpan ke direktori bernama dist di repo kloning Anda;
Untuk menjalankan aplikasi dalam kerangka Electron, Anda dapat menggunakan npm start . Ini akan menjalankan aplikasi yang tidak dibundel dalam versi Electron yang ditentukan dalam package.json . Lihat berbagai skrip untuk membuat versi paket aplikasi untuk Electron di package.json (Anda hanya dapat membuatnya untuk OS yang Anda gunakan saat ini, meskipun aplikasi Linux dapat dibuat di Windows dengan WSL).
Jika Anda menyukai proyek ini dan ingin berkontribusi secara finansial agar proyek ini tetap berjalan, Anda dapat memberikan donasi satu kali atau donasi rutin di halaman Dukungan Kiwix. Donasi membantu membayar server, sertifikat pengkodean, pemeliharaan, dll. Jika Anda ingin menyumbangkan waktu dan keahlian daripada uang, dan Anda memiliki pengetahuan yang baik tentang bahasa asing, Anda dapat membantu penerjemahan proyek Kiwix. Alternatifnya, Anda dapat membantu meningkatkan proyek Wikimedia dengan melakukan penyuntingan atau koreksi pada artikel Wikipedia atau Wikivoyage.
Kebijakan Privasi ini berlaku untuk Aplikasi Web Progresif Kiwix JS dan versinya yang dikemas untuk kerangka kerja Electron, NWJS, dan UWP yang dipublikasikan di server Kiwix, dan oleh akun resmi Kiwix di GitHub dan toko vendor pihak ketiga lainnya ("toko aplikasi" ).
Saat dipasang, aplikasi ini mampu bekerja sepenuhnya secara offline. Itu tidak mengumpulkan atau mencatat data pribadi Anda, meskipun jika Anda menginstalnya dari Toko, operator Toko dapat mengumpulkan data penggunaan anonim (lihat di bawah). Aplikasi ini hanya mengingat riwayat penjelajahan Anda selama satu sesi (untuk tujuan kembali ke halaman yang dilihat sebelumnya). Riwayat ini hilang saat keluar dari aplikasi dengan pengecualian opsional pada halaman yang terakhir dikunjungi.
Jika Anda mengakses aplikasi ini dari server web yang aman (misalnya server PWA), aplikasi ini hanya akan bekerja secara offline jika browser Anda mampu menginstal Service Worker. Jika Anda menginstal atau mem-bookmark versi PWA dalam mode Service Worker, maka versi tersebut akan bekerja secara offline, namun perhatikan bahwa secara desain, PWA apa pun akan memeriksa server PWA secara berkala (dalam hal ini, https://pwa.kiwix.org/), jika itu tersedia, untuk memeriksa Service Worker yang diperbarui.
Versi aplikasi yang tidak diinstal melalui Store atau yang bukan PWA, akan menawarkan untuk memeriksa GitHub Releases API untuk mengetahui pembaruan saat startup, namun fungsi ini bersifat opsional dan dapat dinonaktifkan. Beberapa aplikasi Electron juga secara opsional akan memperbarui sendiri (melalui API yang sama), jika Anda mengizinkannya memeriksa pembaruan. Ini berlaku untuk versi penginstal (pengaturan) untuk Windows, dan versi AppImage untuk Linux. Versi Store dan PWA juga melakukan pembaruan sendiri, namun hal ini tidak dapat dikontrol dalam aplikasi.
Secara default, aplikasi ini akan mengingat halaman yang terakhir Anda kunjungi di antara sesi menggunakan penyimpanan lokal atau cookie yang hanya dapat diakses di perangkat ini. Jika Anda mengakses informasi sensitif yang tidak ingin ditampilkan saat berikutnya Anda membuka aplikasi ini, kami menyarankan Anda menonaktifkan opsi ini di opsi Konfigurasi.
Aplikasi ini hanya membaca file arsip yang Anda pilih secara eksplisit pada perangkat Anda dan file yang disertakan dalam paketnya sendiri: aplikasi ini tidak mampu membaca file lainnya. Ini hanya akan mengakses server pengunduhan arsip Kiwix jika Anda secara khusus memintanya untuk mengakses perpustakaan pengunduhan arsip ZIM di halaman Konfigurasi. Jika Anda menjalankan aplikasi sebagai PWA, aplikasi tersebut akan menyimpan kodenya sendiri dari server PWA yang aman dan kemudian dapat digunakan secara offline. Beberapa arsip ZIM berisi konten aktif (skrip) yang mungkin, dalam keadaan yang jarang terjadi, mencoba menghubungi server eksternal untuk file insidentil seperti font. Kami memblokirnya dengan Kebijakan Keamanan Konten yang dimasukkan ke dalam artikel, namun dalam beberapa kasus, jika artikel sudah memiliki CSP, artikel kami mungkin akan ditimpa. Perhatikan bahwa skrip hanya berjalan jika Anda mengaktifkan mode Service Worker di Konfigurasi.
Jika Anda yakin akses Internet Anda tidak aman, atau sedang diamati atau disensor, kami menyarankan Anda mematikan sepenuhnya akses Internet Anda (Data atau WiFi) sebelum menggunakan aplikasi.
Selain itu, jika Anda memperoleh aplikasi ini dari toko vendor (termasuk ekstensi), maka operator Toko dapat melacak penggunaan aplikasi oleh Anda (misalnya mengunduh, memasang, mencopot pemasangan, tanggal dan jumlah/durasi sesi) untuk tujuan menyediakan anonim, statistik penggunaan agregat untuk pengembang. Jika ini menyangkut Anda, Anda harus memeriksa Kebijakan Privasi Toko yang relevan untuk informasi lebih lanjut.
Tersedia versi aplikasi ini yang tidak menggunakan Toko atau Service Worker online. Silakan lihat:
Rilis
Versi NWJS - versi ini sepenuhnya mandiri dan tidak akan pernah mengakses server kecuali Anda mengizinkannya.
