kiwix js pwa
Kiwix
العروض التوضيحية: [تثبيت PWA على سطح المكتب] [التثبيت والاستخدام: Android] [التثبيت والاستخدام: Firefox Android] [اختيار مجلد من الأرشيفات] [معالجة الملفات (سطح المكتب)] [عرض توضيحي لجميع ميزات OPFS] [إضافة تطبيق إلى شريط Edge الجانبي]
Kiwix هو متصفح غير متصل بالإنترنت لـ Wikipedia وProject Gutenberg وTED Talks وWikivoyage وStackexchange والعديد من المواقع والموارد الأخرى. فهو يجعل المعرفة متاحة بالعديد من اللغات المختلفة للأشخاص الذين لديهم إمكانية وصول محدودة أو معدومة إلى الإنترنت. البرنامج والمحتوى مجانيان ليستخدمهما أي شخص. احصل على التطبيق وقم بتنزيل المحتوى الذي تختاره دون الاتصال بالإنترنت (أرشيفات ZIM، والتي يمكن تنزيلها مجانًا داخل التطبيق). هناك المئات من الأرشيفات متعددة اللغات للاختيار من بينها، والتي تتناول العديد من المواضيع والمواضيع المختلفة. أنشئ مكتبة رقمية كاملة من المعرفة غير المتصلة بالإنترنت!
يعد هذا التطبيق جزءًا من عائلة Kiwix، وهو متاح إما كتطبيق ويب تقدمي (PWA) قابل للتثبيت وغير متصل بالإنترنت، لجميع المتصفحات والأجهزة الحديثة تقريبًا، أو كحزم تطبيقات لأنظمة تشغيل Windows وLinux المختلفة: راجع Kiwix JS للاطلاع على ويندوز ولينكس . بالنسبة لنظامي التشغيل Mac وiOS ، استخدم PWA دون اتصال بالإنترنت.
لدينا أيضًا تطبيقات مجمعة لـ WikiMed بواسطة Kiwix (موسوعة طبية كاملة)، و Wikivoyage بواسطة Kiwix (دليل سفر كامل) باللغة الإنجليزية - لا حاجة لتنزيل إضافي! (ومع ذلك، يمكنك تنزيل لغات أخرى في هذه التطبيقات.)
إذا كنت تستخدم نظام التشغيل Windows 10 أو 11 ، فإن التطبيقات الثلاثة متاحة بسهولة في متجر Microsoft: Kiwix JS UWP و WikiMed by Kiwix و Wikivoyage by Kiwix . سيتم تحديثها تلقائيًا عند توفر حزمة جديدة. إذا كنت تستخدم Linux ، فإن حزمة Electron AppImage الخاصة بـ Kiwix JS تقوم أيضًا (اختياريًا) بالتحديث الذاتي، كما هو الحال مع حزمة Windows Electron القابلة للتثبيت. ستُعلمك التطبيقات الأخرى عند توفر تحديث.
لا أحب المتاجر أو الطرود؟ لقد قمنا بتغطيتك! قم بتشغيل هذا التطبيق على الفور عن طريق فتح PWA (تطبيق الويب التقدمي) القابل للتثبيت وغير المتصل بالإنترنت في متصفحك الآن على pwa.kiwix.org . يعمل هذا في أي متصفح يدعم عمال الخدمة: Chrome وEdge وFirefox وSafari الحديث (لاحظ أنه على أجهزة iOS، يجب عليك استخدام Safari لأن Apple تحظر استخدام عمال الخدمة في أي متصفح آخر على أجهزة i).
احصل على أرشيف ZIM مجاني لاستخدامه مع PWA من صفحة التكوين الخاصة بالتطبيق، أو يمكنك معاينة ZIM على Library.kiwix.org قبل تنزيله. بمجرد تثبيته أو وضع إشارة مرجعية عليه أو إضافته إلى شاشتك الرئيسية، يعمل PWA حتى عندما يكون جهازك غير متصل بالإنترنت تمامًا! ألقِ نظرة على العرض التوضيحي الذي يوضح مدى سرعة وسهولة تثبيت PWA.
إذا كنت تريده مع الصور، فيرجى العلم أنه يمثل تنزيلًا كبيرًا: يبلغ حجم النسخة الإنجليزية حوالي 97 جيجابايت! نوصيك بتجربته أولاً باستخدام أحد الأرشيفات الأصغر حجمًا، مثل علم الفلك والكيمياء والرياضيات والفيزياء وما إلى ذلك. ستجد داخل التطبيق قائمة منسدلة سهلة الاستخدام تتيح لك اختيار لغتك وموضوعك ، ثم قم بتنزيله. سيتم تنزيل الأرشيف في متصفحك.
إذا كنت تريد حقًا ويكيبيديا الإنجليزية الكاملة مع الصور، فإننا نوصيك بشدة باستخدام التطبيق مفتوح المصدر qBittorrent لتنزيله على جهاز كمبيوتر به مساحة كبيرة على القرص. قم أولاً بتثبيت برنامج qBittorrent. بعد ذلك، عند تحديد أرشيف كبير للتنزيل في التطبيق، سيزودك برابط تورنت. انقر فوق الرابط واسمح للمتصفح الخاص بك بتنزيل ملف التورنت وفتحه. سيتم فتح هذا الملف الصغير في برنامج qBittorrent وسيتم سؤالك عن المكان الذي تريد حفظ الأرشيف الذي تريد تنزيله فيه. إنه أسهل بكثير مما يبدو!
Zimit هي خدمة تسمح بأرشفة أي موقع ويب كملف ZIM، على الرغم من وجود الكثير من ZIMs المثيرة التي تم الزحف إليها مسبقًا والمستندة إلى Zimit والتي يمكنك استخدامها (انظر أدناه). إذا كنت تريد أن تصنع بنفسك، جربه على https://youzim.it/. تتمتع تطبيقات Kiwix JS PWA وElectron بدعم كامل للأرشيفات المستندة إلى Zimit اعتبارًا من الإصدار 2.8.5 باستخدام قارئ Replay Web Archive مفتوح المصدر، وتدعم بالفعل تنسيق Zimit v2 القادم. يرجى ملاحظة أن معظم أرشيفات Zimit ستتطلب وضع ServiceWorker، نظرًا لمحتواها الديناميكي للغاية.
تنشر مكتبة تنزيل Kiwix (المتوفرة داخل التطبيق) عددًا من المواقع المرجعية المفيدة بشكل خيالي بتنسيق ملف Zimit، مثل موقع الاستعداد للكوارث Ready.Gov ، ومجلة Low-Tech الرائعة، وكتاب حقائق العالم لوكالة المخابرات المركزية ، ومكتبة مشروع Harmony من النوتة الموسيقية، وموسوعة الإنترنت للفلسفة - من بين أشياء أخرى كثيرة. ما عليك سوى فتح دليل Zimit في المكتبة داخل التطبيق.
نحن نفخر بالحفاظ على دعم المتصفحات والأنظمة الأساسية القديمة، نظرًا لأن الجمهور المستهدف المهم لهذا التطبيق يتكون من المستخدمين في العالم النامي الذين قد لا يمكنهم الوصول إلا إلى الأجهزة القديمة التي تحتوي على برامج قديمة. نحن نختبر التطبيق بشكل متكرر على المتصفحات وأنظمة التشغيل الأقدم. سيكتشف التطبيق عادةً الميزات التي لا تعمل على متصفح معين، ويقوم بتعطيلها أو التغلب عليها. ومع ذلك، في بعض الحالات (مثل Firefox <= 59)، سيقوم التطبيق بضبط نفسه على وضع Service Worker، ولكن هذا الوضع سيفشل بصمت. إذا تأثرت، فيرجى محاولة تحويل التطبيق إلى الوضع المقيد (راجع وضع حقن المحتوى في التكوين).
كتطبيق ويب تقدمي (PWA) على Linux وWindows وAndroid وiOS وmacOS:
Google Chrome / Chromium >= 59 (والعديد من المتصفحات المستندة إلى Chromium، مثل Opera وSamsung Internet)
مايكروسوفت إيدج (كروميوم) >= 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 Private File System. يوجد خطأ في Firefox حيث يحاول المتصفح قراءة أرشيف ZIM بالكامل في الذاكرة في حالة فتحه من نظام الملفات المرئي للمستخدم.
على الرغم من الإيقاف، سنستمر في تقديم الدعم طالما كان ذلك عمليًا:
Internet Explorer 11 (الوضع المقيد فقط، لا يوجد استخدام لـ PWA في وضع عدم الاتصال)
Edge Legacy <= 17 (الوضع المقيد فقط، لا يوجد استخدام لـ PWA في وضع عدم الاتصال)
Firefox 45-67 (تتطلب بعض الإصدارات من المستخدم التبديل يدويًا إلى الوضع المقيد، والبعض الآخر غير قادر على عرض صور WebP)
Chromium 49-58 (بعض الإصدارات تعمل فقط في الوضع المقيد)
الرجاء استخدام أداة تتبع المشكلات في هذا المستودع للإبلاغ عن أي أخطاء وجدتها في البرنامج. افتح تذكرة جديدة (بعد التأكد من أن المشكلة التي حددتها لا تحتوي على تذكرة بالفعل). يرجى الإشارة بوضوح إلى رقم الإصدار الذي تستخدمه (في الجزء العلوي من صفحة التكوين في التطبيق)، والمتصفح أو النظام الأساسي الذي تستخدمه.
إذا كنت تواجه صعوبات مع البرنامج، أو ترغب في رؤية ميزة جديدة، فيرجى أيضًا فتح تذكرة. وبدلاً من ذلك، راجع قسم التعليقات في صفحة "حول" في التطبيق للتعرف على طرق أخرى للحصول على الدعم الفني لمشكلتك. لا تتردد في الاتصال بنا (انظر حول صفحة التطبيق) إذا كنت ترغب فقط في تقديم تعليقات، أو ترك تعليق إذا حصلت على التطبيق من أحد المتاجر. إذا أعجبك التطبيق، يرجى وضع نجمة على هذا المستودع (انظر الأعلى)!
هذا المستودع مخصص لتطوير تطبيق Kiwix JS لـ PWA وElectron وNWJS وWindows 10/11 Universal Windows Platform (UWP). عادةً ما يكون أحدث رمز موجودًا في الفرع الرئيسي، ولكن يتم استخدامه للتطوير النشط وقد يكون هناك عدة التزامات قبل الإصدارات. تتوفر الإصدارات القابلة للتثبيت والمحمولة لنظام التشغيل Windows (XP/Vista/7/8/10/11) وLinux (32 بت و64 بت) من الإصدارات. تتوفر إصدارات ليلية غير مستقرة لتطبيقات Electron وNWJS مع نشر التطوير، ولكن قد تكون التعليمات البرمجية بها أخطاء وتتغير بسرعة. بالإضافة إلى ذلك، تكون ثنائيات Windows الليلية غير موقعة .
يعتمد الكود على Kiwix JS، وهو منفذ HTML/JavaScript خفيف الوزن لقارئ Kiwix Offline. لقد تم تطوير كبير في تعبئة هذا التطبيق لأطر عمل مختلفة، ولإضافة بعض الميزات التي غالبًا ما يتم نقلها إلى المنبع. يمكن تثبيت PWA كتطبيق نظام متكامل تمامًا إذا تم فتحه في متصفح Chromium حديث، ويستخدم واجهة برمجة تطبيقات الوصول إلى نظام الملفات وواجهة برمجة تطبيقات التعامل مع الملفات للحصول على تجربة أصلية في المتصفحات التي تدعم واجهات برمجة التطبيقات هذه. لمزيد من المعلومات حول واجهات برمجة التطبيقات هذه، راجع الجزء السفلي من هذه الصفحة: واجهة برمجة التطبيقات للوصول إلى نظام الملفات ومعالجة الملفات.
التطبيقات متاحة أيضًا في WinGet Package Manager. يمكنك تحميل إصدار UWP (في نظام التشغيل Windows 10/11) عن طريق فتح موجه الأوامر أو محطة PowerShell وكتابة winget install kiwix.kiwixjs (لن يتم تحديث هذا الإصدار تلقائيًا، ولكنه سيخبرك عندما يكون التحديث الجديد جاهزًا) ثَبَّتَ). تتوفر تعليمات التحميل الجانبي البديلة في ملاحظات الإصدار. يمكن تثبيت إصدار Electron باستخدام winget install kiwix.kiwixjs.electron أو عن طريق تنزيل حزمة من الإصدارات. للاختبار، تأتي إصدارات 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 والتطبيقات الأخرى هو بواسطة Geoffrey Kantaris. يمكن الاتصال بي عبر البريد الإلكتروني: egk10 at cam ac uk.
إذا كانت لديك خبرة في البرمجة وكنت مهتمًا بالمساهمة في هذا المشروع، نقترح عليك البدء بالمساهمة في مستودع Kiwix JS الأولي، حيث يتم نقل الكثير من التعليمات البرمجية التي تمت المساهمة بها هناك لاحقًا إلى هذا المستودع. يرجى الاطلاع على CONTRIBUTING.md للحصول على التفاصيل. إذا كنت ترغب في المساهمة في ميزة معينة في Kiwix JS PWA، فيرجى فتح مشكلة في هذا المستودع لشرح الميزة أو التعليمات البرمجية الأخرى التي تهدف إلى المساهمة بها وكيف تقترح القيام بذلك. يجب أن تكون مرتاحًا في إنشاء العلاقات العامة ولديك معرفة جيدة بجافا سكريبت. اتبع نفس إرشادات المساهمة المتبعة في 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 . سيؤدي هذا إلى تشغيل التطبيق غير المجمع في إصدار Electron المحدد في package.json . شاهد العديد من البرامج النصية لإنشاء الإصدار المجمع من تطبيق Electron في package.json (يمكنك إنشاءه فقط لنظام التشغيل الذي تستخدمه حاليًا، على الرغم من أنه يمكن إنشاء تطبيق Linux على Windows باستخدام WSL).
إذا أعجبك هذا المشروع وترغب في المساهمة ماليًا في استمرار تشغيله، فيمكنك تقديم تبرعات لمرة واحدة أو بشكل منتظم على صفحة دعم Kiwix. تساعد التبرعات في دفع تكاليف الخوادم وشهادات الترميز والصيانة وما إلى ذلك. إذا كنت ترغب في المساهمة بالوقت والخبرة بدلاً من المال، ولديك معرفة جيدة بلغة أجنبية، فيمكنك المساعدة في ترجمة مشاريع Kiwix. وبدلاً من ذلك، يمكنك المساعدة في تحسين مشاريع ويكيميديا عن طريق إجراء تعديلات أو تصحيحات على مقالات ويكيبيديا أو ويكي الرحلات.
تنطبق سياسة الخصوصية هذه على تطبيق الويب Kiwix JS Progressive Web App وإصداراته المجمعة لأطر عمل Electron وNWJS وUWP التي يتم نشرها على خوادم Kiwix ومن خلال حسابات Kiwix الرسمية على GitHub ومتاجر البائعين الخارجية الأخرى ("متاجر التطبيقات"). ).
عند التثبيت، يكون هذا التطبيق قادرًا على العمل دون اتصال بالإنترنت تمامًا. ولا يقوم بجمع أو تسجيل أي من بياناتك الشخصية، على الرغم من أنه إذا قمت بتثبيته من أحد المتاجر، فقد يقوم مشغل المتجر بجمع بيانات استخدام مجهولة المصدر (انظر أدناه). يتذكر التطبيق فقط سجل التصفح الخاص بك طوال مدة الجلسة (لغرض العودة إلى الصفحات التي تم عرضها مسبقًا). يتم فقدان هذا السجل عند الخروج من التطبيق مع الاستثناء الاختياري للصفحة الأخيرة التي تمت زيارتها.
إذا قمت بالوصول إلى هذا التطبيق من خادم ويب آمن (مثل خادم PWA)، فلن يعمل دون اتصال بالإنترنت إلا إذا كان متصفحك قادرًا على تثبيت عامل الخدمة. إذا قمت بتثبيت إصدار PWA أو وضع إشارة مرجعية عليه في وضع Service Worker، فسوف يعمل دون اتصال بالإنترنت، ولكن لاحظ أنه حسب التصميم، فإن أي PWA سيقوم بفحص خادم PWA بشكل دوري (في هذه الحالة، https://pwa.kiwix.org/)، إذا إنه متاح للتحقق من وجود عامل خدمة محدث.
ستعرض إصدارات التطبيق التي لم يتم تثبيتها عبر المتجر أو التي ليست تطبيقات PWA، التحقق من GitHub Releases API للحصول على التحديثات عند بدء التشغيل، ولكن هذه الوظيفة اختيارية ويمكن إيقافها. ستقوم بعض تطبيقات Electron أيضًا بالتحديث الذاتي اختياريًا (عبر نفس واجهة برمجة التطبيقات)، إذا سمحت لها بالتحقق من التحديثات. ينطبق هذا على إصدار برنامج التثبيت (الإعداد) لنظام التشغيل Windows، وعلى إصدار AppImage لنظام التشغيل Linux. يتم أيضًا تحديث إصدار المتجر وPWA ذاتيًا، ولكن لا يمكن التحكم في ذلك داخل التطبيق.
افتراضيًا، سيتذكر هذا التطبيق آخر صفحة قمت بزيارتها بين الجلسات باستخدام التخزين المحلي أو ملف تعريف الارتباط الذي لا يمكن الوصول إليه إلا على هذا الجهاز. إذا كنت تصل إلى معلومات حساسة لا ترغب في عرضها في المرة التالية التي تفتح فيها هذا التطبيق، فنوصي بإيقاف تشغيل هذا الخيار في خيارات التكوين.
يقرأ هذا التطبيق فقط ملفات الأرشيف التي تحددها صراحةً على جهازك والملفات المضمنة في الحزمة الخاصة به: فهو غير قادر على قراءة أي ملفات أخرى. لن يتمكن من الوصول إلى خادم تنزيل أرشيف Kiwix إلا إذا طلبت منه على وجه التحديد الوصول إلى مكتبة التنزيل لأرشيفات ZIM في صفحة التكوين. إذا قمت بتشغيل التطبيق كـ PWA، فسيقوم بتخزين الكود الخاص به من خادم PWA الآمن ومن ثم يمكن استخدامه دون اتصال بالإنترنت. تحتوي بعض أرشيفات ZIM على محتوى نشط (نصوص برمجية) قد يحاول، في حالات نادرة، الاتصال بخوادم خارجية للحصول على ملفات عرضية مثل الخطوط. نحن نحظر ذلك من خلال سياسة أمان المحتوى التي يتم إدخالها في المقالات، ولكن في بعض الحالات، إذا كانت المقالة تحتوي بالفعل على CSP، فقد تتم الكتابة فوق سياستنا. لاحظ أن البرامج النصية تعمل فقط إذا قمت بتمكين وضع عامل الخدمة في التكوين.
إذا كنت تعتقد أن وصولك إلى الإنترنت غير آمن، أو أنه يخضع للمراقبة أو الرقابة، فنوصيك بإيقاف وصولك إلى الإنترنت (البيانات أو WiFi) تمامًا قبل استخدام التطبيق.
بالإضافة إلى ذلك، إذا حصلت على هذا التطبيق من أحد متاجر البائعين (بما في ذلك الملحقات)، فقد يتتبع مشغل المتجر استخدامك للتطبيق (على سبيل المثال التنزيل والتثبيت وإلغاء التثبيت وتاريخ وعدد/مدة الجلسات) بغرض توفير معلومات مجهولة المصدر، إحصائيات الاستخدام الإجمالية للمطورين. إذا كان هذا الأمر يقلقك، فيجب عليك مراجعة سياسة خصوصية المتجر ذات الصلة للحصول على مزيد من المعلومات.
تتوفر إصدارات من هذا التطبيق لا تستخدم متجرًا أو عامل خدمة عبر الإنترنت. يرجى الاطلاع على:
الإصدارات
إصدار NWJS - هذا الإصدار مستقل تمامًا ولن يصل أبدًا إلى الخوادم إلا إذا سمحت بذلك.
