#calibrogue

Generates a catalogue in HTML format from a Calibre ebook library

#Usage

Place your CSS, JavaScript, and ebook covers in the catalogue directory.

Then activate a Python virtualenv and run:

pip install .
calibrogue path/to/library > catalogue/index.html

The entire catalogue folder can then be pushed to your web server.

By default, templates/catalogue.html is used as the template for the catalogue, and the links to ebook files in the catalogue will point to the same host as the catalogue itself. The template and the root URL for the links can be changed by setting these environment variables:

export CALIBROGUE_REMOTE_BASE=https://library.example.com/ebooks
export CALIBROGUE_TEMPLATE=templates/plain.txt

calibrogue path/to/library > catalogue/index.txt
grep "library.example.com" catalogue/index.txt

The included contrib/tasks.py can be used to generate the catalogue and also to produce thumbnails of the ebook covers in the correct directory structure. Run it like this (requires yatte ≥ 0.9 and GraphicsMagick):

LIBRARY_DIR=~/ebooks
CATALOGUE_DIR=catalogue
YATTE_TASKFILE=contrib/tasks.py
yatte catalogue
yatte thumbnails

#Development

To run the tests, activate a virtualenv and run:

pip install .[test]
make check