From 16701a6db1560c47beb4a69190fd03ec89ee6fed Mon Sep 17 00:00:00 2001 From: A Holt Date: Wed, 12 Sep 2018 18:30:42 -0400 Subject: [PATCH 1/3] Update README.rst --- roles/calibre-web/README.rst | 23 ++++++++++++++--------- 1 file changed, 14 insertions(+), 9 deletions(-) diff --git a/roles/calibre-web/README.rst b/roles/calibre-web/README.rst index 2531d146b..6b3fda446 100644 --- a/roles/calibre-web/README.rst +++ b/roles/calibre-web/README.rst @@ -116,14 +116,19 @@ Known Issues * |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). |se| |nbsp| This new Calibre-Web - feature (which depends on Calibre's ebook-converter program) needs to be manually - configured in IIAB 6.6 as of 2018-09-12: `janeczku/calibre-web#624 `_ + teachers to convert between PDF, EPUB, TXT etc — to permit reading on a + wider array client devices and client software). |se| |nbsp| Fixed by + `janeczku/calibre-web#609 `_ + in early September 2018. - 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: +* |ss| This new Calibre-Web feature (which depends on Calibre's ebook-converter + program) needs to be manually configured as of 2018-09-12: + `janeczku/calibre-web#624 `_ + |se| |nbsp| Fixed by `#1127 `_ on 2018-09-12. + + 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`` @@ -131,10 +136,10 @@ Known Issues * 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 `_, +* |ss| 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 it's not a priority, as URL's like {http://192.168.0.x/books, - http://10.8.0.x/books, http://127.0.0.1/books and http://box/books} all work. + http://10.8.0.x/books, http://127.0.0.1/books and http://box/books} all work. |se| |nbsp| Marked as "wontfix" on 2018-09-12: `#1050 `_ * Calibre-Web does not currently use version numbers, so glitches might occasionally arise, when upstream developers change its master branch without From 65c3883922d8b9210b31d0278fba0280aae27fd7 Mon Sep 17 00:00:00 2001 From: A Holt Date: Wed, 12 Sep 2018 18:31:47 -0400 Subject: [PATCH 2/3] Update README.rst --- roles/calibre-web/README.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/roles/calibre-web/README.rst b/roles/calibre-web/README.rst index 6b3fda446..c3b1fd972 100644 --- a/roles/calibre-web/README.rst +++ b/roles/calibre-web/README.rst @@ -141,7 +141,7 @@ Known Issues it's not a priority, as URL's like {http://192.168.0.x/books, http://10.8.0.x/books, http://127.0.0.1/books and http://box/books} all work. |se| |nbsp| Marked as "wontfix" on 2018-09-12: `#1050 `_ -* Calibre-Web does not currently use version numbers, so glitches might +* Calibre-Web does not currently use version numbers, so glitches may occasionally arise, when upstream developers change its master branch without warning. From 210cd370c8f2d3db485774c07cd7f7a2996c6c78 Mon Sep 17 00:00:00 2001 From: A Holt Date: Wed, 12 Sep 2018 18:48:57 -0400 Subject: [PATCH 3/3] Update README.rst --- roles/calibre-web/README.rst | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/roles/calibre-web/README.rst b/roles/calibre-web/README.rst index c3b1fd972..72f9f8451 100644 --- a/roles/calibre-web/README.rst +++ b/roles/calibre-web/README.rst @@ -126,12 +126,16 @@ Known Issues `janeczku/calibre-web#624 `_ |se| |nbsp| Fixed by `#1127 `_ on 2018-09-12. - 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: + To manually enable the converting of e-books (automated above, should no + longer be necessary!) log in to http://box/books as Admin/changeme (etc) then + click 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`` + + Then: + * 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