From 0832714cae7b57f013e9eba1adab746b723fcafd Mon Sep 17 00:00:00 2001 From: A Holt Date: Wed, 29 Aug 2018 17:06:46 -0400 Subject: [PATCH 1/8] Update README.rst --- roles/calibre-web/README.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/roles/calibre-web/README.rst b/roles/calibre-web/README.rst index 3ce5241f5..b940116a8 100644 --- a/roles/calibre-web/README.rst +++ b/roles/calibre-web/README.rst @@ -57,8 +57,8 @@ See also:: /library/calibre-web/metadata_db_prefs_backup.json -Back Up Your Content --------------------- +Backup +------ Please back up the entire folder ``/library/calibre-web`` before upgrading — as it contains your calibre-web content **and** settings! From f1d54a7ef542d325ae35e8d095197b61f409adc0 Mon Sep 17 00:00:00 2001 From: A Holt Date: Wed, 29 Aug 2018 17:12:54 -0400 Subject: [PATCH 2/8] Update README.rst --- roles/calibre-web/README.rst | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/roles/calibre-web/README.rst b/roles/calibre-web/README.rst index b940116a8..2ff4695ff 100644 --- a/roles/calibre-web/README.rst +++ b/roles/calibre-web/README.rst @@ -70,8 +70,9 @@ Reinstalling calibre-web automatically upgrades to the latest version. Back up your content **and** settings before reinstalling, as explained above. -**Move your /library/calibre-web/metadata.db if you're sure you want to install -a bare/minimal metadata.db and force all settings to the default. Then run**:: +**Move your /library/calibre-web/metadata.db if you're sure you want to +reinstall a bare/minimal metadata.db and force all settings to the default. +Then run**:: cd /opt/iiab/iiab ./runrole calibre-web From b52fca117514073d00a0428b5dd244e8ee992dad Mon Sep 17 00:00:00 2001 From: A Holt Date: Wed, 29 Aug 2018 17:14:16 -0400 Subject: [PATCH 3/8] Update README.rst --- roles/calibre-web/README.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/roles/calibre-web/README.rst b/roles/calibre-web/README.rst index 2ff4695ff..32ac5aafa 100644 --- a/roles/calibre-web/README.rst +++ b/roles/calibre-web/README.rst @@ -57,8 +57,8 @@ See also:: /library/calibre-web/metadata_db_prefs_backup.json -Backup ------- +Back Up Everything +------------------ Please back up the entire folder ``/library/calibre-web`` before upgrading — as it contains your calibre-web content **and** settings! From 8f5d3077774dfded9323089e60356e377ca3ed26 Mon Sep 17 00:00:00 2001 From: A Holt Date: Wed, 29 Aug 2018 17:26:45 -0400 Subject: [PATCH 4/8] Update README.rst --- roles/calibre-web/README.rst | 29 +++++++++++++++-------------- 1 file changed, 15 insertions(+), 14 deletions(-) diff --git a/roles/calibre-web/README.rst b/roles/calibre-web/README.rst index 32ac5aafa..2ae5d5c17 100644 --- a/roles/calibre-web/README.rst +++ b/roles/calibre-web/README.rst @@ -3,14 +3,14 @@ Calibre-Web README ================== Calibre-Web provides a clean interface for browsing, reading and downloading -e-books using an existing Calibre database. Teachers can add upload e-books, -adjust e-book metadata, and create custom book collections ("bookshelves"): +e-books using an existing Calibre database. Teachers can upload e-books, +adjust e-book metadata, and create custom e-book collections ("bookshelves"): https://github.com/janeczku/calibre-web#about -This Ansible role installs Calibre-Web as part of your Internet-in-a-Box, as a -possible alternative to Calibre (we'll call it 'calibre-web' from here down, -noting that ``calibreweb_*`` variables do not include the dash, per Ansible -recommendations). +This Ansible role installs Calibre-Web as part of your Internet-in-a-Box (IIAB) +as a possible alternative to Calibre (we'll call it 'calibre-web' from here +down, noting that ``calibreweb_*`` variables do not include the dash, per +Ansible recommendations). Using It -------- @@ -24,7 +24,7 @@ whereas teachers add books using an administrative account, as follows:: Password: changeme If the default configuration is not found, the calibre-web server creates a -new settings file with calibre-web's own administrative account default:: +new settings file with calibre-web's own default administrative account:: Username: admin Password: admin123 @@ -42,7 +42,7 @@ You can manage the backend calibre-web server with these systemd commands:: Configuration ------------- -To configure calibre-web, login as user 'Admin' then click 'Admin' on top. +To configure calibre-web, log in as user 'Admin' then click 'Admin' on top. Check 'Configuration' options near the bottom of the page. Critical settings are stored in:: @@ -66,18 +66,19 @@ as it contains your calibre-web content **and** settings! Upgrading --------- -Reinstalling calibre-web automatically upgrades to the latest version. +Reinstalling calibre-web automatically upgrades to the latest version if your +Internet-in-a-Box (IIAB) is online. -Back up your content **and** settings before reinstalling, as explained above. +But first: back up your content **and** settings, as explained above. -**Move your /library/calibre-web/metadata.db if you're sure you want to -reinstall a bare/minimal metadata.db and force all settings to the default. -Then run**:: +**Then move your /library/calibre-web/metadata.db out of the way, if you're +sure you want to (re)install bare/minimal metadata, and force all settings to +the default. Then run**:: cd /opt/iiab/iiab ./runrole calibre-web -Or, to reinstall all of Internet-in-a-Box:: +Or, to reinstall all of IIAB:: cd /opt/iiab/iiab ./iiab-install --reinstall From 3624404f6c70b0c9fef5f6fc5ff127149037c481 Mon Sep 17 00:00:00 2001 From: A Holt Date: Wed, 29 Aug 2018 17:35:47 -0400 Subject: [PATCH 5/8] Update README.rst --- roles/calibre-web/README.rst | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/roles/calibre-web/README.rst b/roles/calibre-web/README.rst index 2ae5d5c17..9aacd1556 100644 --- a/roles/calibre-web/README.rst +++ b/roles/calibre-web/README.rst @@ -94,21 +94,21 @@ Known Issues * Trying to access an empty public bookshelf causes a system error. -* It's sometime impossible to set the language of an e-book: `#1040 `_ +* It's sometimes impossible to set the language of an e-book: `#1040 `_ `janeczku/calibre-web#593 `_ * 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, txt etc — to permit reading on a wider - array client devices and client software). + teachers to convert between PDF, EPUB, HTML, TXT etc — to permit reading on a + wider array client devices and client software). * 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 {http://192.168.0.x/books, http://box/books, etc} URL's - all work. + 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. * calibre-web does not currently use version numbers, so glitches might - occasionally arise using its master branch. + occasionally arise, when changes impact its master branch without warning. * *Please assist us in reporting serious issues here:* https://github.com/janeczku/calibre-web/issues From 46df5157f0b8a34ffc8f77be220a82a016c57c3f Mon Sep 17 00:00:00 2001 From: A Holt Date: Wed, 29 Aug 2018 17:42:22 -0400 Subject: [PATCH 6/8] Update README.rst --- roles/calibre-web/README.rst | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/roles/calibre-web/README.rst b/roles/calibre-web/README.rst index 9aacd1556..8cd493390 100644 --- a/roles/calibre-web/README.rst +++ b/roles/calibre-web/README.rst @@ -72,8 +72,8 @@ Internet-in-a-Box (IIAB) is online. But first: back up your content **and** settings, as explained above. **Then move your /library/calibre-web/metadata.db out of the way, if you're -sure you want to (re)install bare/minimal metadata, and force all settings to -the default. Then run**:: +sure you want to (re)install bare/minimal metadata, and force all calibre-web +settings to the default. Then run**:: cd /opt/iiab/iiab ./runrole calibre-web @@ -108,7 +108,8 @@ Known Issues http://10.8.0.x/books, http://127.0.0.1/books and http://box/books} all work. * calibre-web does not currently use version numbers, so glitches might - occasionally arise, when changes impact its master branch without warning. + occasionally arise, when upstream developers change its master branch without + warning. * *Please assist us in reporting serious issues here:* https://github.com/janeczku/calibre-web/issues From 4a9ea88babcf36342c64a828508e60aa3a1b1770 Mon Sep 17 00:00:00 2001 From: A Holt Date: Wed, 29 Aug 2018 17:45:01 -0400 Subject: [PATCH 7/8] Update README.rst --- roles/calibre-web/README.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/roles/calibre-web/README.rst b/roles/calibre-web/README.rst index 8cd493390..b2527156a 100644 --- a/roles/calibre-web/README.rst +++ b/roles/calibre-web/README.rst @@ -94,8 +94,8 @@ Known Issues * Trying to access an empty public bookshelf causes a system error. -* It's sometimes impossible to set the language of an e-book: `#1040 `_ - `janeczku/calibre-web#593 `_ +* As of August 2018, it's sometimes impossible to set the language of an + e-book: `#1040 `_, `janeczku/calibre-web#593 `_ * 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 From 6fdf346c3511cb30caa53e4523e845cf4a741d23 Mon Sep 17 00:00:00 2001 From: A Holt Date: Thu, 30 Aug 2018 12:30:40 -0400 Subject: [PATCH 8/8] kiwix-tools 0.6.0 -> 0.6.1 --- roles/kiwix/defaults/main.yml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/roles/kiwix/defaults/main.yml b/roles/kiwix/defaults/main.yml index c6334b8dd..d9f815822 100644 --- a/roles/kiwix/defaults/main.yml +++ b/roles/kiwix/defaults/main.yml @@ -1,9 +1,9 @@ # Which kiwix-tools to download from http://download.iiab.io/packages/ # As obtained from http://download.kiwix.org/release/kiwix-tools/ or http://download.kiwix.org/nightly/ -kiwix_version_armhf: "kiwix-tools_linux-armhf-0.6.0" -kiwix_version_linux64: "kiwix-tools_linux-x86_64-0.6.0" -kiwix_version_i686: "kiwix-tools_linux-i586-0.6.0" +kiwix_version_armhf: "kiwix-tools_linux-armhf-0.6.1" +kiwix_version_linux64: "kiwix-tools_linux-x86_64-0.6.1" +kiwix_version_i686: "kiwix-tools_linux-i586-0.6.1" # kiwix_src_file_i686: "kiwix-linux-i686.tar.bz2" # v0.9 for i686 published May 2014 ("use it to test legacy ZIM content") # v0.10 for i686 published Oct 2016 ("experimental") REPLACED IN EARLY 2018, thx to Matthieu Gautier: