Langues

Installer un pack de langue, traduire depuis le panneau, et exporter une langue que vous avez construite.

Bondry est livré en anglais, qui est la source de chaque chaîne. Les autres langues arrivent sous forme de packs, ou vous les construisez dans le panneau.

Deux couches#

Une traduction est résolue dans cet ordre :

1. une surcharge stockée en base de données, depuis l'éditeur du panneau ;
2. le fichier de cette langue, depuis le pack livré ;
3. l'anglais.

Rien n'est jamais vide. Une langue à moitié traduite retombe sur l'anglais clé par clé plutôt que d'afficher un identifiant brut.

Installer un pack#

Appearance > Languages > Add prend un zip avec un manifeste language.json. Le panneau le valide, extrait les fichiers, enregistre la locale et l'affiche dans la liste avec sa couverture.

Créer une langue dans le panneau#

Vous pouvez aussi partir de rien. Appearance > Languages > Create demande le code de la locale, le nom, le nom natif, le sens d'écriture et les métadonnées dont un pack distribuable a besoin : auteur, version, compatibilité et description. Ces champs sont obligatoires parce que le pack que vous construisez est exportable et commercialisable.

La nouvelle langue démarre vide et hérite de l'anglais jusqu'à ce que vous traduisiez.

L'éditeur de traduction#

Appearance > Languages > Translate liste chaque clé, groupée par espace de noms : le core d'abord, puis un groupe par module installé. Chaque ligne montre la source anglaise à côté du champ pour la langue cible.

• Enregistrer écrit dans la couche base de données et prend effet immédiatement.
• La couverture par langue est affichée au fur et à mesure.
• Les paramètres comme :name et la pluralisation sont validés : une traduction qui perd un paramètre est refusée.
• Avec un terme de recherche, l'éditeur cherche dans tous les groupes à la fois. Sans terme, il parcourt le groupe sélectionné.

Nouvelles chaînes depuis une mise à jour#

Quand une mise à jour du core ou d'un module ajoute des chaînes, elles apparaissent automatiquement dans chaque pack de langue, amorcées en anglais, et le taux de couverture baisse pour le refléter. Vous n'avez jamais à chercher ce qui est nouveau.

Exporter#

Appearance > Languages > Export produit un zip selon l'un de deux modes, les deux fusionnant vos surcharges de base de données dans les fichiers :

Utilisez-le pour des sauvegardes, pour déplacer une langue entre des installations, ou pour la publier.

Les membres et leur langue#

Chaque membre choisit une langue dans son profil, parmi les langues que vous avez marquées comme visibles. Marquer une langue comme non visible la retire seulement de ce sélecteur : les membres qui l'utilisent déjà la conservent tant qu'elle reste activée.

Anglais#

L'anglais peut être désactivé, une fois qu'une autre langue est celle par défaut du site, mais il ne peut jamais être supprimé. C'est le repli qui empêche toute autre langue de montrer des trous, et la langue par défaut actuelle ne peut être ni désactivée ni supprimée non plus.