Comment ajouter et gérer des langues

Donnez à chaque langue une place claire dans le CMS

Un enregistrement de langue PostnHost indique au CMS quelles langues votre publication prend en charge. Il fournit aussi le code utilisé dans les URL localisées ainsi que pour l'attribut lang du HTML de la page.

Trois éléments liés fonctionnent ensemble :

• Les enregistrements de langue rendent une langue disponible dans le CMS.
• Les traductions de contenu fournissent des articles, pages et catégories localisés.
• Les fichiers de locale ou remplacements I18n traduisent le texte public partagé, comme les libellés de navigation et les états vides.

L'ajout d'un élément n'entraîne pas la création automatique des deux autres.

Ajouter une langue

1. Ouvrez Langues dans la navigation du CMS.
2. Sélectionnez Nouvelle langue.
3. Saisissez le nom public, par exemple « espagnol ».
4. Saisissez le code de langue correspondant, par exemple es.
5. Activez Langue par défaut uniquement lorsque celle-ci doit être la langue principale du site.
6. Créez la langue.

Conservez un code court et cohérent. Il fait partie des routes localisées telles que /es, donc le modifier ultérieurement peut changer les URLs publiques.

La liste des Langues identifie la langue par défaut et affiche les compteurs de contenu original et de traductions.

Comprendre la langue par défaut

Chaque site devrait avoir une langue par défaut. C'est la langue principale de publication et la langue de secours lorsqu'une version localisée n'est pas demandée. Ne la modifiez que dans le cadre d'un plan réfléchi de langues et d'URL pour l'ensemble du site.

Utilisez la liste des langues et la page de détail

Les deux badges de compteur indiquent le contenu rédigé à l'origine dans cette langue et les variantes traduites dans cette langue. Sélectionnez le nom d'une langue ou son action de consultation pour voir le contenu associé en détail.

Une langue peut exister avant que les traductions ne soient prêtes, donc un compteur à zéro est normal. Créez les traductions séparément de l'article, de la page ou de la catégorie qui fournit le contenu source.

Si la page de détail indique qu'aucun fichier de locale n'existe, l'enregistrement de langue est disponible mais le texte partagé de l'interface publique n'est pas entièrement prêt pour ce code. Utilisez la configuration développeur optionnelle ci-dessous.

Avant de modifier un code ou de supprimer une langue, examinez son contenu et ses traductions. Ces modifications peuvent affecter les routes localisées et les enregistrements associés.

Quand aucune configuration développeur n'est nécessaire

PostnHost inclut des fichiers de locale publics pour l'anglais, le français, l'allemand, le japonais, le coréen, le portugais, le polonais, l'espagnol et le russe : en, fr, de, ja, ko, pt, pl, es, et ru.

Si le code choisi est déjà disponible dans l'application hôte, vous pouvez créer l'enregistrement de Langue correspondant dans le tableau de bord, ajouter des traductions de contenu et personnaliser le texte partagé sous Paramètres → I18n.

Ajouter d'autres langues

Cette section concerne uniquement un code de langue que l'application hôte ne prend pas encore en charge. Demandez à un développeur ayant accès à l'application Rails de la compléter.

Ajoutez le nouveau code tout en préservant la liste de locales existante :

# config/application.rb
config.i18n.default_locale = :en
config.i18n.available_locales = %i[en fr de ja ko pt pl es ru it]
config.i18n.fallbacks = [:en]

Générez un fichier de locale pour l'application hôte avec le même code :

bin/rails g postnhost:locale it

1. Traduisez les clés pertinentes sous postnhost.public dans config/locales/it.yml.
2. Redémarrez Rails après avoir modifié config/application.rb.
3. Créez l'enregistrement de Langue correspondant dans PostnHost avec le code it.
4. Ajoutez séparément les traductions d'articles, de pages et de catégories.

L'enregistrement de Langue, l'entrée available_locales et le nom du fichier de locale doivent utiliser le même code. Une incohérence peut entraîner l'absence de texte d'interface ou des routes localisées inattendues. Conservez l'anglais comme langue de secours, ou utilisez une table de correspondance de secours qui aboutit finalement à la langue par défaut.

Vérifiez la nouvelle langue

• Ouvrez son index localisé, par exemple /es ou /it.
• Vérifiez le sélecteur de langue public.
• Vérifiez le texte partagé sous Paramètres → I18n.
• Publiez et ouvrez au moins un élément de contenu traduit.