Comment ça marche
Choisis ta langue dans le menu ☰. Les textes qui n’ont pas encore de traduction sont traduits pendant que tu les lis, gratuitement et sans rien régler. Un texte traduit l’indique, et un appui ramène à l’original anglais.
Tout ce qui est traduit reste sur ton appareil : chaque texte n’est traduit qu’une fois, et il reste disponible hors ligne. Quand l’app est en anglais, il n’y a rien à traduire.
Ouvre la page
Ouvre le menu ☰ et choisis Traduction automatique. Tu peux y activer ou couper la traduction des textes encore en anglais, et choisir son comportement.
Choisis son comportement
- Traduire les descriptions, pas les noms. La traduction automatique se débrouille bien avec les phrases et mal avec un nom isolé : sans contexte, un nom sort souvent faux. Avec cette option, les noms restent en anglais et le reste est traduit. Ça consomme aussi moins de caractères de ton quota.
- Améliorer les traductions avec le temps : si tu as une clé DeepL, les textes traduits gratuitement peuvent être retraduits avec elle.
Pourquoi une clé DeepL
Avec ta propre clé DeepL, les traductions sont meilleures. DeepL propose un forfait gratuit pour son API, avec un quota mensuel de caractères que DeepL peut modifier, et des forfaits payants. Les textes d’un jeu en consomment peu, et ce qui est traduit reste sur ton appareil : rien n’est payé deux fois.
Obtenir une clé DeepL
- Crée un compte gratuit pour l’API DeepL sur deepl.com/pro-api. Ce n’est pas le compte de l’app de traduction DeepL habituelle, et DeepL peut demander une carte bancaire pour vérifier ton identité.
- Ouvre ton compte et va dans l’onglet Clés d’API. Il y a une clé ; avec le forfait gratuit, elle finit par :fx.
- Copie-la.
Ne partage jamais la clé : qui l’a utilise ton quota.
Mets-la dans Heroquill
- Sur la page Traduction automatique, ouvre Avancé : ta clé DeepL et le relais.
- Colle la clé dans la case Clé DeepL.
- Appuie sur Vérifier la connexion. Si tout va bien, la page indique combien de caractères tu as utilisés ce mois-ci sur ton quota.
La clé reste sur ton appareil. Elle ne part vers DeepL, via le relais, qu’avec chaque demande de traduction.
Ce qu’est le relais
DeepL n’accepte pas les requêtes directement depuis une page web : elles passent par un petit relais. Celui par défaut est géré par l’auteur de Heroquill ; il ne garde ni ta clé ni tes textes, et son code est public dans le dépôt. Si tu préfères, tu peux faire tourner le tien et écrire son adresse dans la case Adresse du relais : le dépôt explique comment, dans docs/TRANSLATION_PROXY.md.
Si quelque chose ne va pas
- La vérification dit que la clé n’est pas valide : copie-la de nouveau, sans espaces, et assure-toi que c’est une clé d’API et non le mot de passe du compte.
- La vérification dit que le quota est épuisé : attends le mois suivant ou prends un forfait payant. En attendant, la traduction gratuite prend le relais.
- Rien n’est traduit : vérifie que l’app n’est pas en anglais et que Traduire les textes encore en anglais est activé.