Skip to content

Simple web to share books, Calibre, Jester, Spectre CSS, No JavaScript, WebP & ZIP to reduce bandwidth

License

Notifications You must be signed in to change notification settings

juancarlospaco/biblioteca-guarrilla

Repository files navigation

Biblioteca-Guarrilla

Biblioteca-Guarrilla

Biblioteca-Guarrilla

Biblioteca-Guarrilla

Biblioteca-Guarrilla

  • 1 file.
  • ~300Kb.
  • ~130 Lines of code.
  • 0 Dependencies (libzip may or may not be required depending on your system config, should be present on most OS nowadays).
  • English & Spanish supported.

Requisites

  • A Calibre database metadata.db (with the books on the same folder as the database, as typically used by Calibre App).

Use

Spanish:

./biblioteca_guarrilla --color --filtros --desbichar --limite=42 --autorefresco=9 --mensaje='Un mensaje de Admin aqui' '/ruta/a/calibre/metadata.db'

Opciones:

  • --desbichar Modo de depuracion de errores.
  • --color Usar coloreado de la salide de Terminal.
  • --autorefresco=9 Forzar Auto-Refresco de la Web en Segundos, numero 1 ~ 255.
  • --filtros Usar Filtros por Inicial del nombre del libro en la pagina Web.
  • --mensaje="foo" Mensaje de Admin se ve en la pagina Web, ideal MOTD, COC, etc.
  • --limite=42 Limite maximo de Libros a publicar en la Web, numero 1 ~ 255.
  • --salida='/ruta/a/archivo.html' Escribir Web a un archivo en lugar de servirla.
  • Ver Ayuda con --ayuda.

English:

./biblioteca_guarrilla --color --filters --debug --limit=42 --autorefresh=9 --message='Some Admin message here' '/path/to/calibre/metadata.db'

Options:

  • --debug Debug mode.
  • --color Use colored Terminal output.
  • --autorefresh=9 Force Auto-Refresh of Web on Seconds, 1 ~ 255 integer.
  • --filters Use Filters per book name on the Web.
  • --message="foo" Admin Message seen on the Web, ideal for MOTD, COC, etc.
  • --limit=42 Max number of books to publish on the Web, 1 ~ 255 integer.
  • --output='/path/to/file.html' Write the Web to a file instead of serving it.
  • See Help with --help.

FAQ

  • Works over Wifi?.

Yes.

  • How to set English as default language?.

Its designed in a way that spoken language does not really matter too much.

  • Necesita Nim instalado?.

No.

  • Necesita Servidor Web?.

No.

  • Se puede usar con Python, Flask, Bottlepy, etc?.

Si, usar opcion --salida= y servir la web con la App Python (No provista).

  • Como se instala?.

No se instala. Solo ejecutalo y listo.

  • Como se configura?.

No se configura. Solo ejecutalo y listo.

  • How to use Calibre?.

See docs.

  • Que hace?.

Genera una web a partir de un catalogo de Calibre. Calibre es una App de Libros Digitales. Recorre la carpeta de Calibre procesando archivos. Luego optimiza las tapas de libros de JPG a WebP. WebP pesa la mitad que JPG, para previews es mas que suficiente. La web mostrara una foto paisaje o similar si falta la tapa del libro. Luego optimiza los libros Mobi y PDF comprimiendolos en ZIP. PDF en ZIP es mas liviano. EPUB no se ZIPean. No borra ningun archivo. Al final la misma aplicacion sirve la web y se ve desde el browser.

  • Donde se Descarga?.

https://github.com/juancarlospaco/biblioteca-guarrilla/releases

  • Fails with Error: unhandled exception: cannot open: static/css/spectre.min.css [IOError] ?

Copy over the /static/ folder.

Internal Structure

Biblioteca-Guarrilla

Run nim doc biblioteca_guarrilla.nim for more Documentation.