funky-framadate-front/docs/cadrage/i18n.md

26 lines
1.6 KiB
Markdown
Raw Permalink Normal View History

# Internationalisation - i18n
2022-02-03 11:33:57 +01:00
<a href="https://weblate.framasoft.org/engage/funky-framadate/">
<img src="https://weblate.framasoft.org/widgets/funky-framadate/-/funky-framadate-front/svg-badge.svg" alt="État de la traduction" />
</a>
2022-02-03 11:44:30 +01:00
## Dans les templates HTML
2022-02-03 11:33:57 +01:00
Toutes les chaînes de texte doivent être disponible en minimum deux langues: Français et Anglais.
2022-02-03 10:45:09 +01:00
Pour l'ajout de nouvelles traductions voir [la documentations des traductions.md](../traductions.md)
La documentation a été pensée pour être compréhensible en premier lieu par des personnes francophones, le projet étant issu de Framasoft et de personnes uniquement Francophones, nous avons jugé que c'était le moyen le plus efficace pour le faire grandir.
2022-02-03 10:45:09 +01:00
Voir les fichiers dans le dossier **src/assets/i18n**
2022-02-03 14:16:52 +01:00
[EN.json](/src/assets/i18n/en.json) et [FR.json](/src/assets/i18n/fr.json)
2022-02-03 10:45:09 +01:00
La traduction se base sur un système de clés-valeur dans des fichiers JSON.
Les clés sont entrées dans les templates html, et c'est la config d'Angular qui les traduit selon la langue demandée par le visiteur du site.
2022-02-03 10:45:09 +01:00
Utilisez des sous groupes dans vos traductions afin de mieux segmenter les chaines de caractère par page et selon leur sens.
Faites en sorte de réutiliser au maximum les phrases identiques.
2021-05-17 10:57:09 +02:00
## Traduction de la documentation mkdocs
Pour traduire cette documentation (les fichiers markdwon dans le dossier /docs/) qui génère un mini site avec mkdocs avec la commande de build, il faut faire des fichiers avec un nom de langue tels que index.fr.md et index.en.md.
Plus d'infos: https://www.mkdocs.org/user-guide/configuration/#lang