Traduire une application Django en espagnol

Le fichier à envoyer : django.po pour la locale es

Django lit des catalogues gettext. La commande python manage.py makemessages -l es rassemble les chaînes marquées (gettext, _(), {% translate %}, {% blocktranslate %}) et produit locale/es/LC_MESSAGES/django.po. C’est ce fichier que vous déposez. Si une partie de l’interface passe par le catalogue JavaScript de Django, lancez aussi makemessages -d djangojs -l es et envoyez le djangojs.po.

Pour un public d’Amérique latine précis, Django accepte des locales régionales : le dossier s’appelle alors locale/es_MX/ (tiret bas), tandis que le code déclaré dans LANGUAGES s’écrit es-mx. Décidez-le avant de générer le fichier : c’est le nom du dossier qui indique à Django où chercher la traduction.

Le devis compte les mots du texte à traduire ; la syntaxe du fichier, les clés et les balises ne sont pas comptées.

Ce que l’espagnol change dans vos chaînes Django

• Pluriels. CLDR donne trois catégories à l’espagnol : one, many, other ; « many » concerne les grands nombres ronds (« un millón de usuarios »). Pour Django, ce qui compte est l’en-tête Plural-Forms du .po : chaque msgid_plural doit avoir autant de msgstr[n] que l’en-tête annonce de formes. Autre différence avec le français : zéro prend le pluriel, « 0 archivos ».
• Ordre des mots. « %(count)s files deleted » devient « Se eliminaron %(count)s archivos » : la variable change de place. Avec des variables nommées, aucun risque ; avec plusieurs %s anonymes, l’ordre ne peut pas être inversé.
• Genre. Nuevo pedido mais Nueva factura, Ningún archivo mais Ninguna página. Une chaîne générique comme « Add %(name)s » alimentée par un verbose_name ne peut pas accorder correctement ; séparez les cas avec pgettext et un contexte.
• ¿ et ¡. Le signe ouvrant se place en tête de phrase : « ¿Eliminar este elemento? ». Une question découpée en deux chaînes concaténées dans le gabarit ne peut pas être ponctuée correctement.
• Registre et variante. Tutoiement (Introduce tu contraseña) ou vouvoiement (Introduzca su contraseña) ; ordenador en Espagne, computadora au Mexique ; móvil ou celular. Vérifiez la convention retenue sur l’extrait gratuit avant de payer.
• Longueur. L’espagnol est plus long que l’anglais, proche du français : « Save » devient « Guardar cambios ». Prévoyez des boutons et menus qui s’élargissent.

Ce que Manuce rend, et ce qu’il ne fait pas

Vous récupérez le même django.po : indentation, ordre des entrées, guillemets, commentaires et références #:, fins de ligne, encodage et BOM éventuel sont conservés ; seules les valeurs traduites changent.

Chaque traduction est comparée à sa source : les variables %(name)s et {name} doivent toutes être présentes, de même que les balises HTML d’un blocktranslate. En cas d’écart persistant, la chaîne source est gardée et le rapport le signale : mieux vaut une chaîne restée en anglais qu’une erreur à la compilation ou au rendu. URL, adresses email, nombres, identifiants, formats de date, valeurs vides et tout ce qui est marqué non traduisible restent tels quels.

Le rapport liste les chaînes traduites et celles laissées telles quelles, avec la raison.

Manuce ne lance ni makemessages ni compilemessages, ne modifie ni votre code ni vos gabarits, ne retire pas les marques #, fuzzy et ne corrige pas l’en-tête Plural-Forms. Les contenus stockés en base (pages, fiches produit) ne passent pas par gettext et ne sont donc pas dans ce fichier.

Préparer le fichier avant l’envoi

• Remplacez les %s multiples par des variables nommées : _("%(user)s commented on %(post)s") permet d’écrire « %(user)s comentó en %(post)s » ou de réordonner librement.
• Donnez du contexte aux mots courts : pgettext("month name", "May") doit donner mayo (en minuscule, comme tous les mois en espagnol), pas puede.
• Ajoutez des commentaires commençant par Translators: dans le code : Django les reprend dans le .po, utile pour préciser qu’un « Post » est un verbe.
• Ne figez aucune date ni aucun montant dans une chaîne : avec la localisation active, Django affiche lui-même « 3 de marzo de 2025 » et la virgule décimale « 1.234,56 » pour la locale es.
• Supprimez les concaténations de fragments dans les gabarits au profit d’un seul blocktranslate par phrase.

Après la livraison : compiler et tester

1. Replacez le fichier dans locale/es/LC_MESSAGES/ et relisez les entrées marquées #, fuzzy : compilemessages les ignore tant que la marque reste.
2. Lancez python manage.py compilemessages -l es pour produire le django.mo ; une variable incohérente dans une chaîne python-format y serait signalée.
3. Vérifiez que es figure dans LANGUAGES et que LocaleMiddleware est actif, puis parcourez l’application en espagnol.
4. Testez les pluriels avec 0, 1 et 2, les messages de formulaire, et les écrans aux boutons étroits.

En pratique

1. Lancez makemessages -l es (et -d djangojs si besoin).
2. Déposez locale/es/LC_MESSAGES/django.po et relisez l’extrait gratuit.
3. Récupérez le .po traduit et son rapport.
4. Replacez-le, traitez les entrées fuzzy, lancez compilemessages -l es.
5. Testez l’interface en espagnol, pluriels et longueurs compris.