calibre web

كاليبر ويب

Calibre-Web هو تطبيق ويب يوفر واجهة نظيفة وبديهية لتصفح الكتب الإلكترونية وقراءتها وتنزيلها باستخدام قاعدة بيانات Calibre صالحة.

جدول المحتويات (انقر للتوسيع)

1. عن
2. سمات
3. تثبيت
   • التثبيت عبر النقطة (مستحسن)
   • بداية سريعة
   • متطلبات
4. صور عامل الميناء
5. استكشاف الأخطاء وإصلاحها
6. الاعتراف بالمساهم
7. اتصال
8. المساهمة في كاليبر ويب

هذا البرنامج عبارة عن شوكة للمكتبة ومرخص بموجب ترخيص GPL v3.

سمات

• واجهة Bootstrap 3 HTML5 حديثة وسريعة الاستجابة
• الإعداد الرسومي الكامل
• إدارة شاملة للمستخدم مع أذونات دقيقة لكل مستخدم
• واجهة المشرف
• واجهة مستخدم متعددة اللغات تدعم أكثر من 20 لغة (اللغات المدعومة)
• تغذية OPDS لتطبيقات قارئ الكتب الإلكترونية
• خيارات البحث والتصفية المتقدمة
• إنشاء مجموعة كتب مخصصة (أرفف).
• دعم تحرير البيانات الوصفية للكتاب الإلكتروني وحذفها
• تنزيل البيانات الوصفية من مصادر مختلفة (قابلة للتوسعة عبر المكونات الإضافية)
• تحويل الكتب الإلكترونية من خلال ثنائيات كاليبر
• تقييد تنزيل الكتب الإلكترونية للمستخدمين الذين قاموا بتسجيل الدخول
• دعم تسجيل المستخدم العام
• أرسل الكتب الإلكترونية إلى القراء الإلكترونيين بنقرة واحدة
• مزامنة أجهزة Kobo مع مكتبة Caliber الخاصة بك
• دعم قراءة الكتب الإلكترونية داخل المتصفح لتنسيقات متعددة
• تحميل كتب جديدة بتنسيقات مختلفة، بما في ذلك التنسيقات الصوتية
• دعم أعمدة كاليبر المخصصة
• إخفاء المحتوى بناءً على الفئات ومحتوى العمود المخصص لكل مستخدم
• القدرة على التحديث الذاتي
• تسجيل الدخول "Magic Link" لسهولة الوصول إليه على أجهزة القراءة الإلكترونية
• دعم LDAP وGoogle/GitHub OAuth ومصادقة الوكيل

تثبيت

التثبيت عبر النقطة (مستحسن)

1. إنشاء بيئة افتراضية : من الضروري عزل تثبيت Calibre-Web الخاص بك لتجنب تعارضات التبعية. يمكنك إنشاء بيئة افتراضية عن طريق تشغيل:

    python3 -m venv calibre-web-env
   

2. تفعيل البيئة الافتراضية :

    source calibre-web-env/bin/activate
   

3. تثبيت Calibre-Web : استخدم النقطة لتثبيت التطبيق:

    pip install calibreweb
   

4. تثبيت ميزات اختيارية : للحصول على وظائف إضافية، قد تحتاج إلى تثبيت ميزات اختيارية. راجع هذه الصفحة للحصول على تفاصيل حول ما يمكن تثبيته.
5. بدء تشغيل Calibre-Web : بعد التثبيت، يمكنك بدء التطبيق باستخدام:

    cps
   

ملاحظة: قد يواجه مستخدمو Raspberry Pi OS مشكلات في التثبيت. إذا قمت بذلك، حاول ترقية النقطة و/أو تثبيت البضائع كما يلي:

 ./venv/bin/python3 -m pip install --upgrade pip
sudo apt install cargo

روابط مهمة

• للحصول على أمثلة تثبيت إضافية، تحقق مما يلي:
  • التثبيت اليدوي
  • تثبيت لينكس منت
  • إعداد موفر السحابة

بداية سريعة

1. الوصول إلى Calibre-Web : افتح متصفحك وانتقل إلى:

    http://localhost:8083
   

   أو لكتالوج OPDS:

    http://localhost:8083/opds
   

2. تسجيل الدخول : استخدم بيانات اعتماد المسؤول الافتراضية:
   • اسم المستخدم: المشرف
   • كلمة المرور: admin123
3. إعداد قاعدة البيانات : إذا لم يكن لديك قاعدة بيانات كاليبر، قم بتنزيل عينة من:

    https://github.com/janeczku/calibre-web/raw/master/library/metadata.db
   

   انقله خارج مجلد Calibre-Web لتجنب الكتابة فوقه أثناء التحديثات.
4. تكوين قاعدة بيانات Caliber : في واجهة الإدارة، قم بتعيين Location of Calibre database على مسار المجلد الذي يحتوي على مكتبة Caliber الخاصة بك (حيث توجد metadata.db ) وانقر فوق "حفظ".
5. تكامل Google Drive : لاستضافة مكتبة Caliber الخاصة بك على Google Drive، راجع دليل تكامل Google Drive.
6. تكوين المسؤول : قم بتكوين المثيل الخاص بك عبر صفحة المسؤول، بالرجوع إلى دليل التكوين الأساسي وتكوين واجهة المستخدم.

متطلبات

• إصدار Python : تأكد من أن لديك Python 3.7 أو أحدث.
• Imagemagick : مطلوب لاستخراج الغلاف من ملفات EPUB. قد يحتاج مستخدمو Windows أيضًا إلى تثبيت Ghostscript لاستخراج غلاف PDF.
• الأدوات الاختيارية :
  • برنامج Caliber لسطح المكتب : يوصى به للتحويل الفوري وتحرير البيانات التعريفية. قم بتعيين المسار إلى أداة تحويل Calibre في صفحة الإعداد.
  • أداة Kepubify : مطلوبة لدعم جهاز Kobo. قم بتنزيل الأداة ووضع الملف الثنائي في /opt/kepubify على Linux أو C:Program Fileskepubify على Windows.

صور عامل الميناء

تتوفر صور Docker المعدة مسبقًا:

لينكس سيرفر - x64، aarch64

• Docker Hub : Linuxserver/calibre-web
• جيثب : خادم لينكس/docker-calibre-web
• طبقة العيار الاختيارية : linuxserver/docker-mods

لتضمين ملف Caliber ebook-convert الثنائي (x64 فقط)، قم بإضافة متغير البيئة:

 DOCKER_MODS=linuxserver/mods:universal-calibre

في ملف تشغيل/إنشاء Docker الخاص بك. احذف هذا المتغير للحصول على صورة خفيفة الوزن.

• تكوين المسارات :
  • قم بتعيين المسار إلى Caliber Binaries إلى /usr/bin .
  • قم بتعيين المسار إلى Unrar إلى /usr/bin/unrar .

استكشاف الأخطاء وإصلاحها

• القضايا المشتركة :

  • إذا واجهت مشكلات في بدء تشغيل التطبيق، فتحقق من ملفات السجل الموجودة في دليل logs بحثًا عن رسائل الخطأ.
  • إذا فشل تحميل الكتب الإلكترونية، فتأكد من تعيين Location of Calibre database بشكل صحيح ومن إمكانية الوصول إلى ملف قاعدة البيانات.

• أخطاء التكوين : تأكد من أن قاعدة بيانات Caliber الخاصة بك متوافقة ومنسقة بشكل صحيح. ارجع إلى وثائق كاليبر للحصول على إرشادات حول صيانة قاعدة البيانات.

• مشاكل الأداء :

  • إذا كان التطبيق بطيئًا، ففكر في زيادة الموارد المخصصة (CPU/RAM) لخادمك أو تحسين قاعدة بيانات Caliber عن طريق إزالة التكرارات والإدخالات غير الضرورية.
  • امسح ذاكرة التخزين المؤقت في متصفح الويب الخاص بك بانتظام لتحسين أوقات التحميل.

• مشكلات إدارة المستخدم : إذا لم يتمكن المستخدمون من تسجيل الدخول أو التسجيل، فتحقق من إعدادات إذن المستخدم في واجهة الإدارة. تأكد من تمكين التسجيل ومن تعيين الأدوار المناسبة للمستخدمين.

• موارد الدعم : للحصول على مساعدة إضافية، فكر في زيارة قسم الأسئلة الشائعة في الويكي أو نشر أسئلتك في مجتمع Discord.

الاعتراف بالمساهم

نود أن نشكر جميع المساهمين والمشرفين على Calibre-Web على مساهماتهم القيمة وتفانيهم في المشروع. هي موضع تقدير كبير مساهماتك.

اتصال

انضم إلينا على الديسكورد

لمزيد من المعلومات، والكيفية، والأسئلة الشائعة، يرجى زيارة Wiki

المساهمة في كاليبر ويب

للمساهمة، يرجى مراجعة إرشادات المساهمة لدينا. نحن نرحب بالمشكلات وطلبات الميزات وطلبات السحب من المجتمع.

الإبلاغ عن الأخطاء

إذا واجهت أخطاء أو مشكلات، فيرجى الإبلاغ عنها في قسم المشكلات في المستودع. تأكد من تضمين معلومات مفصلة حول الإعداد والمشكلة التي واجهتها.

طلبات الميزة

نحن نرحب باقتراحات الميزات الجديدة. يرجى إنشاء عدد جديد في المستودع لمناقشة أفكارك.

موارد إضافية

• التوثيق : التوثيق الشامل متاح على موقع Calibre-Web wiki.
• مساهمات المجتمع : استكشف مساهمات المجتمع لمعرفة العمل المستمر وكيف يمكنك المشاركة.

---

شكرًا لك على استخدام Calibre-Web! نأمل أن تستمتع بإدارة مكتبة كتبك الإلكترونية باستخدام أداتنا.