external/iiab
1
0
Fork 0
mirror of https://github.com/iiab/iiab.git synced 2025-03-09 15:40:17 +00:00
Code Issues Releases Wiki Activity

Merge pull request #1119 from holta/calibre-web-readme

Browse source 
Update Calibre-Web README with latest upstream fixes
This commit is contained in:
A Holt 2018-09-12 13:28:28 -04:00 • committed by GitHub
commit 917b4cfa4a
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 28 additions and 5 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

33
roles/calibre-web/README.rst
View file

@ -1,3 +1,14 @@
.. |ss| raw:: html
<strike>
.. |se| raw:: html
</strike>
.. |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 <https://github.com/janeczku/calibre-web/issues/620>`_
* As of August 2018, it's sometimes impossible to set the language of an
e-book: `#1040 <https://github.com/iiab/iiab/issues/1040>`_, `janeczku/calibre-web#593 <https://github.com/janeczku/calibre-web/issues/593>`_
* |ss| As of August 2018, it's sometimes impossible to set the language of an
e-book: `#1040 <https://github.com/iiab/iiab/issues/1040>`_, `janeczku/calibre-web#593 <https://github.com/janeczku/calibre-web/issues/593>`_ |se| |nbsp| Appears fixed as of 2018-09-12: `janeczku/calibre-web#620 <https://github.com/janeczku/calibre-web/issues/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 <https://github.com/janeczku/calibre-web/issues/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 <https://github.com/iiab/iiab/blob/master/roles/network/templates/gateway/iiab-gen-iptables#L93>`_,
even when ``services_externally_visible: true``. This is fixable, but perhaps