cops

policías

COPS significa Servidor Php Calibre OPDS (y HTML).

Ver: Casa de COPS para más detalles.

No olvides consultar la Wiki.

Por qué ?

En mi opinión, Calibre es una herramienta maravillosa, pero es demasiado grande y tiene demasiadas dependencias para usarse en su servidor de contenidos.

Esa es la razón principal por la que codifiqué este servidor OPDS. Necesitaba instalar una herramienta sencilla en un servidor pequeño (Seagate Dockstar en mi caso).

Inicialmente pensé en Calibre2OPDS pero como genera un archivo estático no fue posible realizar búsquedas.

Más tarde agregué un catálogo HTML simple que debería poder usarse en mi Kobo.

Entonces las principales ventajas de COPS son:

• No hay necesidad de muchas dependencias.
• No se necesita mucha CPU o RAM.
• No hay mucho código.
• La búsqueda está disponible.
• Fue divertido codificar.

Si desea utilizar el feed OPDS, no olvide especificar feed.php al final de su URL.

Sólo tienes que sincronizar tu directorio Calibre con tu servidor COPS de la forma que prefieras (Dropbox, Bt Sync, Syncthing, usar un directorio compartido con Nextcloud,...).

Requisitos previos

1. PHP 5.3, 5.4, 5.5, 5.6, 7.X o hhvm con procesamiento de imágenes GD, compatibilidad con Libxml, Intl, Json y SQLite3 (se recomienda PHP 5.6 o posterior).
2. Un servidor web con soporte PHP. Probé con varias versiones de Nginx y Apache. Otras personas informaron que trabajaba con Apache y Cherokee. También puede utilizar el servidor integrado PHP (https://github.com/seblucas/cops/wiki/Howto---PhpEmbeddedServer)
3. La ruta a una biblioteca de calibre (archivos metadata.db, formato y portada).

En cualquier Linux basado en Debian puedes usar: apt-get install php5-gd php5-sqlite php5-json php5-intl

Si usa 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

En Centos es posible que tengas que agregar: yum install php-xml

Instalar una versión (la forma más fácil)

1. Extraiga el archivo zip que obtuvo de la página de lanzamiento a una carpeta en el espacio web (visible para el servidor web).
2. Si está realizando una instalación por primera vez, copie config_local.php.example a config_local.php
3. Edite config_local.php para que coincida con su configuración.
4. Si es necesario, agregue otro elemento de configuración desde config_default.php

Si te gusta Docker, también puedes probar este contenedor acoplable multiarca de linuxserver.io. Tiene compilaciones para x64, armhf y arm64.

Instalar desde fuentes

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

Después de eso, puede utilizar el procedimiento anterior comenzando en el segundo paso.

Tenga en cuenta que en lugar de clonar, también puede obtener el archivo maestro más reciente como zip.

Tenga en cuenta que si su versión de PHP es inferior a 5.6, es posible que deba eliminar composer.lock antes de comenzar la última línea.

¿Dónde poner mi directorio Calibre?

En pocas palabras: SIEMPRE fuera del directorio de COPS, especialmente si COPS está instalado en un VPS/Servidor. Si sigues mi consejo, tus datos estarán seguros.

Si elige colocar su directorio Calibre dentro de su directorio web y usa Nginx, tendrá que editar /etc/nginx/mime.types para agregar estas líneas:

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

Problemas conocidos

No mucho, excepto por la mala calidad del código (primer proyecto PHP);)

Consulte https://github.com/seblucas/cops/issues para conocer los problemas abiertos

Necesitar ayuda

Lea https://github.com/seblucas/cops/wiki y consulte las preguntas frecuentes.

Contribuyendo

Como puede ver aquí, aprecio todas las contribuciones y hubo muchas a lo largo del tiempo. Así que no seas tímido y envía tus Pull Requests.

Nota para los traductores: prefieran usar Transifex en lugar de hacer un PR.

Solo tengo un límite (puede que tenga más, pero ese es el peor): el objetivo de COPS es proporcionar una alternativa al servidor de contenidos de Calibre y no reemplazar a Calibre por completo. Por lo tanto, rechazaré cualquier PR que realice cambios en el contenido de la base de datos.

Créditos

• El manejo de mensajes locales está inspirado en https://www.mind-it.info/2010/02/22/a-simple-approach-to-localization-in-php
• La función str_format proviene de http://tmont.com/blargh/2010/1/string-format-in-php
• Todos los íconos provienen de Font Awesome: https://github.com/FortAwesome/Font-Awesome
• El validador OPDS no oficial: http://opds-validator.appspot.com/
• Gracias a todos los evaluadores, traductores y contribuyentes.
• Íconos de feeds creados por Freepik a partir del sitio web Flaticon con licencia Creative Commons BY 3.0 http://www.flaticon.com y http://www.freepik.com
• ¡Muchísimas gracias a Jetbrains por apoyar a COPS proporcionando un conjunto de licencias gratuitas para sus productos desde hace varios años!
• Este proyecto se prueba con BrowserStack.

Bibliotecas externas utilizadas:

• JQuery: http://jquery.com/
• Magnífica ventana emergente: http://dimsemenov.com/plugins/magnific-popup/
• Php-epub-meta: https://github.com/splitbrain/php-epub-meta con algunas modificaciones mías (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

Derechos de autor y licencia

COPS - 2012-2019 (c) Sébastien Lucas

Consulte COPIA y encabezados de archivos para obtener información sobre la licencia.