diff --git a/roles/calibre-web/README.rst b/roles/calibre-web/README.rst index b2527156a..57932e1cb 100644 --- a/roles/calibre-web/README.rst +++ b/roles/calibre-web/README.rst @@ -1,3 +1,14 @@ +.. |ss| raw:: html + + + +.. |se| raw:: html + + + +.. |nbsp| unicode:: 0xA0 + :trim: + ================== Calibre-Web README ================== @@ -92,15 +103,27 @@ manually:: Known Issues ------------ -* Trying to access an empty public bookshelf causes a system error. +* |ss| Trying to access an empty public bookshelf causes a system error. |se| |nbsp| Appears fixed as of 2018-09-12: `janeczku/calibre-web#620 `_ -* As of August 2018, it's sometimes impossible to set the language of an - e-book: `#1040 `_, `janeczku/calibre-web#593 `_ +* |ss| As of August 2018, it's sometimes impossible to set the language of an + e-book: `#1040 `_, `janeczku/calibre-web#593 `_ |se| |nbsp| Appears fixed as of 2018-09-12: `janeczku/calibre-web#620 `_ -* As of August 2018, calibre-web doesn't yet include Calibre's e-book +* |ss| As of August 2018, calibre-web doesn't yet include Calibre's e-book conversion functionality (e.g. Calibre 3.27.1 [released 2018-07-06] allows teachers to convert between PDF, EPUB, HTML, TXT etc — to permit reading on a - wider array client devices and client software). + wider array client devices and client software). |se| |nbsp| This new calibre-web + feature (which requires Calibre's ebook-converter program) needs to be manually + configured in IIAB 6.6 as of 2018-09-12: `janeczku/calibre-web#624 `_ + + Specifically, to enable e-book conversion, log in as Admin/changeme (etc) then + click http://box/books -> Admin -> Basic Configuration -> External binaries, then + change these 2 settings: + + * Change radio button "No converter" to "Use calibre's ebook converter" + * In textfield "Path to convertertool" type in: ``/usr/bin/ebook-convert`` + * Submit + * Verify that "ebook-convert" appears on calibre-web's "About" page at http://box/books/stats + * Test it by clicking any e-book -> Edit metadata -> Convert book format: * http://192.168.0.x:8083 does not work, as a result of `iptables `_, even when ``services_externally_visible: true``. This is fixable, but perhaps