Documentation
Documentation technique
Les guides ci-dessous sont ceux livrés avec Libris Translate, publiés ici tels qu’ils figurent dans la version. Chaque page indique la révision dont elle provient ; les instantanés de travaux en cours sont signalés comme tels.
Les guides d’utilisation et d’exploitation sont publiés en français lorsqu’une traduction existe. Les documents d’architecture et de développement restent en anglais.
Les résultats s’affichent sous le champ pendant la saisie. Parcourez-les avec les flèches haut et bas, ouvrez-en un avec Entrée, fermez la liste avec Échap.
Consulter cette documentation par MCP
Un assistant peut rechercher et lire les pages publiques de Libris Web avec un serveur MCP dédié. Configurez un serveur HTTP distant à cette adresse :
https://libris-translate.com/docs-mcp
Les outils search_docs et get_doc renvoient des extraits, les pages et leurs adresses à citer. Aucun jeton n’est nécessaire : seuls les contenus publics sont accessibles. L’index suit automatiquement la version publiée ici. Le MCP de votre installation Libris, décrit dans la rubrique Intégrations, est distinct.
Installer et exploiter
- Installer avec Docker Installer, se connecter, brancher un modèle et traduire un premier livre. Accès réseau et HTTPS, mises à jour, désinstallation, dépannage. docs/docker.md
- Référence de configuration Toutes les variables d’environnement, des budgets à la file équitable en passant par le mode d’analyse, et les réglages modifiables dans l’interface. docs/configuration.md
- Exploitation Mettre à jour, surveiller, tenir les coûts, lire les journaux et dépanner une installation en service. docs/operations.md
- Sauvegarde et restauration Sauvegarder la base et les livres, et vérifier qu’une sauvegarde se restaure vraiment. docs/backup.md
- Codex et ChatGPT Traduire avec les modèles Codex, par clé d’API ou avec un compte ChatGPT. docs/codex.md
- OpenViking Utiliser OpenViking comme mémoire externe de vos livres et séries, et la nettoyer quand ils sont supprimés. docs/openviking.md
- LDAP et Active Directory Raccorder un annuaire en sécurité, le tester, associer ses groupes, et comprendre ce qui distingue ses identités des comptes locaux. docs/ldap.fr.md
Utiliser Libris Translate
- Guide d’utilisation Toute l’interface, de la bibliothèque aux exports : séries, carte des chapitres, qualité, budgets, glossaires partagés, file d’attente et jetons d’API. docs/user-guide.fr.md
- Publication en bibliothèque Déposer les livres finis dans un dossier surveillé par Calibre-Web, Komga ou Kavita, ou sur le serveur WebDAV d’un compte. docs/publication.fr.md
- Le pilote automatique Ce qui se passe entre l’import et le livre fini, comment les échecs sont traités, et comment le désactiver. docs/autopilot.md
- Juge qualité Faire relire chaque passage traduit par le modèle d’un autre provider, qui fait corriger les erreurs qu’il trouve : ce qu’il cherche, ce qu’il coûte, comment le choisir pour l’installation ou pour un livre. docs/quality.md
- API d’automatisation Envoyer des livres ou de nouveaux chapitres depuis un script et récupérer la traduction. docs/api.md
- Le serveur MCP Piloter l’installation depuis opencode, Claude Code ou Codex : les outils, les portées à donner à un jeton, et ce qu’un agent ne peut jamais faire. docs/mcp.md
- Description OpenAPI Le contrat de l’API d’automatisation en OpenAPI 3.1, pour les outils OpenAPI et les générateurs de clients. docs/openapi/libris-v1.json
- Client d’exemple Un client Python qui n’utilise que la bibliothèque standard : envoyer, attendre, télécharger et recevoir les webhooks. examples/libris_client.py
Comprendre Libris Translate
Projet
Les guides ci-dessus se lisent en ligne ; la description OpenAPI et le client d’exemple se téléchargent. Les fichiers cités comme code source font partie de votre installation. Une question : licences@libris-translate.com.