Libris Translate
Français

Libris Translate 0.28.0 · User guide

Automate

Nextcloud and WebDAV

Import sources from your cloud and send finished books back, through a connection that belongs to your account.

Steps

  1. An administrator lists the allowed servers in WEBDAV_HOSTS and, for a NAS on the local network, its range in WEBDAV_PRIVATE_NETWORKS, then restarts Libris Translate. With the list empty, the feature does not exist on the installation.
  2. In My account › Nextcloud / WebDAV connections, enter a “Connection name”, the “WebDAV address”, the “WebDAV username” and an “App password”, then “Test the WebDAV connection”.
  3. In the import assistant, choose “From Nextcloud/WebDAV”, browse from the root folder and click “Add the chosen files”.
  4. On a finished book, click “Send to Nextcloud/WebDAV”, pick the “Format sent” (the finished book’s EPUB, a bilingual EPUB, Word without revisions, text, or one file per chapter) and the folder, then “Send to this folder”. Follow the sending as pending, sent or failed; “Send again” retries it without retranslating anything.
  5. To send every finished book there without clicking, open the connection’s form (“Edit the connection” for an existing one), tick “Automatically send every finished book to this connection”, choose the “Automatic sending folder” and the “Automatic sending format”, then “Save the WebDAV connection”.

What to know

Each connection belongs to one account, and its password is encrypted on the server and never shown again. HTTPS is required, except inside a private network the administrator allowed. Libris Translate calls the address it checked, refuses redirects to another server, ignores the server’s proxy settings, and reads a remote file up to the same size limit as a browser upload, 256 MB by default. A sending that fails because the server is unreachable or the book is not ready yet is retried on its own. A destination folder that does not exist is created with its parents, inside the connection only. Automatic sending is off until you turn it on, goes through the same queue and retries as a sending by hand, and only covers the books you own: a book shared with you never leaves on its own.

Fictional example

An administrator allows cloud.example.test; a member connects with an app password, imports one fictional TXT chapter, then sends the finished EPUB to the Books/Libris folder.

Continue