1
0
Fork 0
mirror of https://github.com/iiab/iiab.git synced 2025-03-09 15:40:17 +00:00

calibre-web/README.rst: Overhaul intro

This commit is contained in:
A Holt 2023-08-05 08:01:51 -04:00 committed by GitHub
parent fc75b456bd
commit 8661026319
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -13,26 +13,39 @@
Calibre-Web README Calibre-Web README
================== ==================
Calibre-Web provides a clean interface for browsing, reading and downloading This Ansible role installs
e-books using a `Calibre database <https://manual.calibre-ebook.com/db_api.html>`_. `Calibre-Web <https://github.com/janeczku/calibre-web#readme>`_ as a modern
Teachers can upload e-books, adjust e-book metadata, and create custom e-book client-server alternative to Calibre, for your
collections ("bookshelves"): `Internet-in-a-Box (IIAB) <https://internet-in-a-box.org>`_.
https://github.com/janeczku/calibre-web#about Calibre-Web provides a clean web interface for students to browse, read and
download e-books using a
`Calibre-compatible database <https://manual.calibre-ebook.com/db_api.html>`_.
This Ansible role installs Calibre-Web, as a modern alternative to Teachers upload e-books, adjust e-book metadata, and create custom "bookshelf"
`Calibre <https://calibre-ebook.com/whats-new>`_, collections — to help students build the best local library!
for your Internet-in-a-Box (IIAB).
*NOTE: Calibre-Web takes advantage of Calibre's own* .. image:: https://www.yankodesign.com/images/design_news/2019/05/221758/luo_beetle_library_8.jpg
`/usr/bin/ebook-convert <https://manual.calibre-ebook.com/generated/en/ebook-convert.html>`_
*program if that's installed — so consider also installing Calibre during your
IIAB installation — if you tolerate the weighty ~1 GB (of graphical OS
libraries) that Calibre mandates!*
Please note Calibre-Web's Ansible playbook is 🍒 GURU TIPS 🍒
``/opt/iiab/iiab/roles/calibre-web`` whereas its Ansible variables
``calibreweb_*`` do **not** include the dash. * Calibre-Web takes advantage of Calibre's own `/usr/bin/ebook-convert
<https://manual.calibre-ebook.com/generated/en/ebook-convert.html>`_ program
if that's installed — so consider also installing
`Calibre <https://calibre-ebook.com/whats-new>`_ during your IIAB
installation — *if you tolerate the weighty ~1 GB (of graphical OS libraries)
that Calibre mandates!*
* If you choose to also install Calibre (e.g. by running
``sudo apt install calibre``) then you'll get useful e-book
importing/organizing tools like
`/usr/bin/calibredb <https://manual.calibre-ebook.com/generated/en/calibredb.html>`_.
* WARNING: Calibre-Web's Ansible playbook is
``/opt/iiab/iiab/roles/calibre-web`` whereas its Ansible variables (in
`/etc/iiab/local_vars.yml
<https://wiki.iiab.io/go/FAQ#What_is_local_vars.yml_and_how_do_I_customize_it%3F>`_)
``calibreweb_*`` do **not** include the dash.
Using It Using It
-------- --------