cops

رجال الشرطة

يرمز COPS إلى Caliber OPDS (و HTML) Php Server.

انظر: منزل COPS لمزيد من التفاصيل.

لا تنسى التحقق من الويكي.

لماذا ؟

في رأيي، تعد Caliber أداة رائعة ولكنها كبيرة جدًا وتحتوي على الكثير من التبعيات بحيث لا يمكن استخدامها لخادم المحتوى الخاص بها.

هذا هو السبب الرئيسي وراء قيامي بترميز خادم OPDS هذا. كنت بحاجة إلى أداة بسيطة ليتم تثبيتها على خادم صغير (Seagate Dockstar في حالتي).

لقد فكرت في البداية في Calibre2OPDS ولكن نظرًا لأنه ينشئ ملفًا ثابتًا، لم يكن من الممكن إجراء بحث.

قمت لاحقًا بإضافة كتالوج HTML بسيط يمكن استخدامه على جهاز Kobo الخاص بي.

لذا فإن المزايا الرئيسية لـ COPS هي:

• لا حاجة للعديد من التبعيات.
• لا حاجة للكثير من وحدة المعالجة المركزية أو ذاكرة الوصول العشوائي.
• ليس الكثير من التعليمات البرمجية.
• البحث متاح.
• لقد كان من الممتع البرمجة.

إذا كنت تريد استخدام موجز OPDS، فلا تنس تحديد Feed.php في نهاية عنوان URL الخاص بك.

كل ما عليك فعله هو مزامنة دليل Caliber الخاص بك مع خادم COPS الخاص بك بالطريقة التي تفضلها (Dropbox، وBt Sync، وSyncthing، واستخدام دليل مشترك مع Nextcloud، ...).

المتطلبات الأساسية

1. PHP 5.3، 5.4، 5.5، 5.6، 7.X أو hhvm مع معالجة الصور GD ودعم Libxml وIntl وJson وSQLite3 (يوصى باستخدام PHP 5.6 أو أحدث).
2. خادم ويب يدعم لغة PHP. لقد اختبرت باستخدام إصدارات مختلفة من Nginx وApache. أبلغ أشخاص آخرون عن العمل مع Apache وCherokee. يمكنك أيضًا استخدام خادم PHP المضمن (https://github.com/seblucas/cops/wiki/Howto---PhpEmbeddedServer)
3. المسار إلى مكتبة ذات عيار (metadata.db، التنسيق، وملفات الغلاف).

على أي نظام Linux يعتمد على Debian، يمكنك استخدام: apt-get install php5-gd php5-sqlite php5-json php5-intl

إذا كنت تستخدم Debian Stretch: apt-get install php7.0-gd php7.0-sqlite3 php7.0-json php7.0-intl php7.0-xml php7.0-mbstring php7.0-zip

في Centos قد تضطر إلى إضافة: yum install php-xml

تثبيت الإصدار (أسهل طريقة)

1. قم باستخراج الملف المضغوط الذي حصلت عليه من صفحة الإصدار إلى مجلد في مساحة الويب (مرئي لخادم الويب).
2. إذا كنت تقوم بالتثبيت لأول مرة، فانسخ config_local.php.example إلى config_local.php
3. قم بتحرير config_local.php ليطابق التكوين الخاص بك.
4. إذا لزم الأمر، قم بإضافة عنصر تكوين آخر من config_default.php

إذا كنت تحب Docker، فيمكنك أيضًا تجربة حاوية الإرساء متعددة القوس هذه من linuxserver.io، فهي تحتوي على إصدارات لـ x64 وarmhf وarm64.

التثبيت من المصادر

git clone https://github.com/seblucas/cops.git # or download lastest zip see below
cd cops
wget https://getcomposer.org/composer.phar
php composer.phar global require " fxp/composer-asset-plugin:~1.1 "
php composer.phar install --no-dev --optimize-autoloader

بعد ذلك يمكنك استخدام الطريقة السابقة بدءًا من الخطوة الثانية.

لاحظ أنه بدلاً من الاستنساخ، يمكنك أيضًا الحصول على أحدث نسخة رئيسية بتنسيق Zip

لاحظ أنه إذا كان إصدار PHP الخاص بك أقل من 5.6، فقد تضطر إلى إزالة composer.lock قبل بدء السطر الأخير.

أين أضع دليل كاليبر الخاص بي؟

قصة قصيرة طويلة: دائمًا خارج دليل COPS خاصةً إذا كان COPS مثبتًا على VPS / Server. إذا اتبعت نصيحتي، فستكون بياناتك آمنة.

إذا اخترت وضع دليل Caliber الخاص بك داخل دليل الويب الخاص بك واستخدام Nginx، فسيتعين عليك تعديل /etc/nginx/mime.types لإضافة هذه السطور:

 application/epub+zip epub;
application/x-mobipocket-ebook mobi prc azw;

المشاكل المعروفة

ليس كثيرًا، باستثناء الجودة السيئة للكود (أول مشروع PHP على الإطلاق) ;)

يرجى الاطلاع على https://github.com/seblucas/cops/issues للتعرف على المشكلات المفتوحة

بحاجة الى مساعدة

يرجى قراءة https://github.com/seblucas/cops/wiki والتحقق من الأسئلة الشائعة.

المساهمة

كما ترون هنا، أنا أقدر كل المساهمات وكان هناك الكثير مع مرور الوقت. لذلك لا تخجل وأرسل طلبات السحب الخاصة بك.

ملاحظة للمترجمين: يرجى تفضيل استخدام Transifex بدلاً من إجراء العلاقات العامة.

لدي حد واحد فقط (قد يكون لدي أكثر ولكن هذا هو الأسوأ): هدف COPS هو توفير بديل لخادم محتوى Calibre وليس استبدال Caliber بالكامل. لذلك سأرفض أي علاقات عامة تقوم بإجراء تغييرات على محتوى قاعدة البيانات.

الاعتمادات

• التعامل مع الرسائل المحلية مستوحى من https://www.mind-it.info/2010/02/22/a-simple-approach-to-localization-in-php
• تأتي وظيفة str_format من http://tmont.com/blargh/2010/1/string-format-in-php
• جميع الرموز تأتي من Font Awesome: https://github.com/FortAwesome/Font-Awesome
• مدقق OPDS غير الرسمي: http://opds-validator.appspot.com/
• شكرًا لجميع المختبرين والمترجمين والمساهمين.
• أيقونات الخلاصات التي أنشأتها Freepik من موقع Flaticon مرخصة بموجب Creative Commons BY 3.0 http://www.flaticon.com وhttp://www.freepik.com
• شكرًا جزيلاً لشركة Jetbrains لدعمها COPS من خلال توفير مجموعة من التراخيص المجانية لمنتجاتها لعدة سنوات حتى الآن!
• تم اختبار هذا المشروع باستخدام BrowserStack.

المكتبات الخارجية المستخدمة :

• مسج: http://jquery.com/
• النافذة المنبثقة الرائعة: http://dimsemenov.com/plugins/magnific-popup/
• Php-epub-meta : https://github.com/splitbrain/php-epub-meta مع بعض التعديلات التي قمت بها (https://github.com/seblucas/php-epub-meta)
• TbsZip : http://www.tinybutstrong.com/apps/tbszip/tbszip_help.html
• DoT.js : http://olado.github.io/doT/index.html
• PHPMailer : https://github.com/PHPMailer/PHPMailer
• js-lru : https://github.com/rsms/js-lru

حقوق الطبع والنشر والترخيص

COPS - 2012-2019 (ج) سيباستيان لوكاس

راجع النسخ ورؤوس الملفات للحصول على معلومات الترخيص