translate-book

Vue d’ensemble de la skill translate-book

Ce que fait translate-book

La skill translate-book est une chaîne de traduction de livres pour les fichiers PDF, DOCX et EPUB. Elle découpe un livre source en fragments Markdown, traduit ces fragments avec des sous-agents en parallèle, puis recompose le résultat en HTML, DOCX, EPUB et PDF. Si vous avez besoin de translate-book pour un travail de traduction sur des contenus longs, c’est particulièrement utile quand un seul prompt est trop fragile ou trop limité pour traiter un livre entier.

À qui l’installer

Installez translate-book si vous traduisez régulièrement des livres, des manuels ou des documents de longueur livre et que vous tenez à un résultat reproductible, à la reprise par fragment et à la régénération des formats. C’est un excellent choix pour les personnes qui veulent un flux de travail guidé plutôt que d’écrire un prompt de traduction ponctuel à partir de zéro. En revanche, l’outil est moins pertinent si vous n’avez besoin que d’un court extrait ou d’un résumé rapide.

Ce qui le distingue

Le principal atout de translate-book est sa conception en pipeline : conversion, découpage en fragments, traduction parallèle, validation par hash et reconstruction sont autant d’étapes explicites. Cette structure réduit les pertes de contexte et aide à repérer les fragments manquants ou obsolètes avant l’assemblage final. Elle rend aussi la décision d’installation plus claire qu’un simple prompt générique du type « traduisez ce fichier », car le repo impose une vision précise de la chaîne d’outils et des artefacts de sortie.

Comment utiliser la skill translate-book

Installer et vérifier les prérequis

Suivez le flux d’installation indiqué par le projet, puis vérifiez que les outils externes attendus par le pipeline sont bien disponibles : python3, pandoc et ebook-convert de Calibre ou calibre. Si ebook-convert manque, l’étape translate-book install peut réussir, mais le flux échouera au moment de la conversion ; il faut donc vérifier l’environnement d’exécution en premier.

Partir d’un prompt d’entrée complet

La skill fonctionne mieux si vous fournissez dans une seule demande le chemin du fichier, la langue cible et toute contrainte de style. Un bon prompt ressemble à : Translate /path/to/book.epub into Japanese, keep technical terms consistent, preserve chapter structure, and use a formal tone. Cela donne à translate-book usage suffisamment de contexte pour choisir les bons paramètres et éviter les allers-retours. Si vous omettez le chemin du fichier, la skill doit s’arrêter et le demander.

Lire d’abord les bons fichiers

Pour être sûr que translate-book correspond à votre besoin, commencez par lire SKILL.md, puis README.md, AGENTS.md et CLAUDE.md si vous voulez des notes sur l’implémentation et les tests. Dans ce repo, les scripts comptent davantage qu’un simple survol du README : scripts/convert.py, scripts/manifest.py, scripts/glossary.py et scripts/merge_and_build.py expliquent comment les fragments sont créés, suivis, harmonisés et reconstruits. C’est le moyen le plus rapide de savoir si translate-book s’aligne sur votre flux de travail.

Utiliser un flux de travail conscient des fragments

Il ne faut pas voir cela comme un simple appel de traduction. Le flux prévu est : fichier d’entrée → fragments Markdown → sorties traduites par fragment → livre fusionné. Quand vous formulez la demande, précisez tout ce qui peut influencer la qualité des fragments : la nécessité de préserver les notes de bas de page, les tableaux ou les blocs de code ; le fait que les noms doivent rester non traduits ; et le besoin d’une cohérence terminologique sur tout l’ouvrage. Ces détails aident les sous-agents à faire moins de choix locaux qui entrent ensuite en conflit.

FAQ de la skill translate-book

translate-book est-elle adaptée aux débutants ?

Oui, si vous pouvez fournir un chemin de fichier et une langue cible. La skill masque le pipeline en plusieurs étapes, mais elle suppose quand même que vous compreniez les contraintes propres à un livre, comme la fidélité de la mise en forme et la cohérence terminologique. Les débutants obtiennent généralement de meilleurs résultats en commençant par un EPUB ou un DOCX court avant d’attaquer un gros PDF numérisé.

Quand ne faut-il pas utiliser translate-book ?

N’utilisez pas translate-book pour de courts passages, de la traduction en conversation ou les cas où vous n’avez besoin que d’une idée générale. C’est aussi un choix moins solide pour les PDF très numérisés avec un OCR médiocre, car la qualité de conversion du document source limitera ensuite la qualité de la traduction. Si le fichier d’entrée ne peut pas être converti proprement, aucun prompt ne pourra entièrement récupérer la structure.

En quoi est-ce différent d’un prompt de traduction classique ?

Un prompt classique traduit en général dans une seule fenêtre de contexte et reste vulnérable à la troncature, à la dérive et aux incohérences terminologiques. translate-book repose au contraire sur des étapes de découpage, de validation et de reconstruction ; il est donc mieux adapté aux documents longs où la continuité compte. Le compromis, c’est davantage de préparation et davantage de vérifications des dépendances.

translate-book fonctionne-t-elle pour n’importe quelle paire de langues ?

Le repo est conçu pour plusieurs langues cibles, mais la qualité dépend toujours de la complexité du texte source et de la densité terminologique. Les meilleurs résultats viennent quand vous précisez le code de langue cible et que vous fournissez des consignes de glossaire pour les termes de domaine. Pour les projets très chargés en traduction, cette cohérence terminologique compte autant que le choix de la langue elle-même.

Comment améliorer la skill translate-book

Donner de meilleures contraintes source

Le gain de qualité le plus important vient du fait d’indiquer à translate-book ce qui ne doit pas changer. Fournissez les titres de chapitres à préserver, les termes à conserver en anglais, les translittérations préférées, les règles de mise en forme pour les tableaux ou les blocs de code, ainsi que le niveau de public visé, par exemple un ton académique ou grand public. Par exemple : Keep API names unchanged, translate prose formally, and preserve Markdown headings exactly.

Réduire tôt la dérive du glossaire

Comme le pipeline fait appel à des sous-agents en parallèle, la terminologie peut dériver si vous ne définissez pas les termes clés dès le départ. Avant de lancer un livre volumineux, préparez un petit glossaire de noms, de termes produit et d’expressions techniques récurrentes. C’est particulièrement important pour les projets translate-book for Translation, où un seul terme incohérent peut se propager à de nombreux fragments.

Surveiller les échecs de conversion et de découpage

Les modes d’échec les plus courants sont un OCR cassé, un format source mal structuré et des frontières de fragments qui coupent mal les tableaux ou les listes. Si la première sortie paraît irrégulière, inspectez les fichiers intermédiaires des fragments et le manifeste avant d’accuser la qualité de la traduction. Le réflexe le plus utile dans un translate-book guide est de corriger d’abord le pipeline source, puis de relancer la traduction sur des fragments propres.

Itérer à partir de la première sortie

Après le premier passage, relisez quelques fragments représentatifs plutôt que le livre fusionné uniquement. Vérifiez les débuts de chapitre, les termes du glossaire, les titres et tous les passages où le source comportait une mise en forme dense. Si nécessaire, relancez avec des consignes plus strictes au lieu de modifier tout le livre à la main ; c’est le moyen le plus rapide d’améliorer la prochaine exécution de translate-book skill.