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

Update README.rst

Browse source
This commit is contained in:
A Holt 2018-08-29 17:26:45 -04:00 • committed by GitHub
parent b52fca1175
commit 8f5d307777
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 15 additions and 14 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -3,14 +3,14 @@ Calibre-Web README
================== ==================
Calibre-Web provides a clean interface for browsing, reading and downloading Calibre-Web provides a clean interface for browsing, reading and downloading
e-books using an existing Calibre database. Teachers can add upload e-books, e-books using an existing Calibre database. Teachers can upload e-books,
adjust e-book metadata, and create custom book collections ("bookshelves"): adjust e-book metadata, and create custom e-book collections ("bookshelves"):
https://github.com/janeczku/calibre-web#about https://github.com/janeczku/calibre-web#about
This Ansible role installs Calibre-Web as part of your Internet-in-a-Box, as a This Ansible role installs Calibre-Web as part of your Internet-in-a-Box (IIAB)
possible alternative to Calibre (we'll call it 'calibre-web' from here down, as a possible alternative to Calibre (we'll call it 'calibre-web' from here
noting that ``calibreweb_*`` variables do not include the dash, per Ansible down, noting that ``calibreweb_*`` variables do not include the dash, per
recommendations). Ansible recommendations).
Using It Using It
-------- --------
@ -24,7 +24,7 @@ whereas teachers add books using an administrative account, as follows::
Password: changeme Password: changeme
If the default configuration is not found, the calibre-web server creates a 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 Username: admin
Password: admin123 Password: admin123
@ -42,7 +42,7 @@ You can manage the backend calibre-web server with these systemd commands::
Configuration 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. Check 'Configuration' options near the bottom of the page.
Critical settings are stored in:: Critical settings are stored in::
@ -66,18 +66,19 @@ as it contains your calibre-web content **and** settings!
Upgrading 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 **Then move your /library/calibre-web/metadata.db out of the way, if you're
reinstall a bare/minimal metadata.db and force all settings to the default. sure you want to (re)install bare/minimal metadata, and force all settings to
Then run**:: the default. Then run**::
cd /opt/iiab/iiab cd /opt/iiab/iiab
./runrole calibre-web ./runrole calibre-web
Or, to reinstall all of Internet-in-a-Box:: Or, to reinstall all of IIAB::
cd /opt/iiab/iiab cd /opt/iiab/iiab
./iiab-install --reinstall ./iiab-install --reinstall