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
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