# Langues et traductions

> Proposez votre application en plusieurs langues - langues de l'application, langue par défaut de chaque réseau et client, fichiers de traduction publiés.

Wakastart conserve les langues proposées par votre [wakapp](/v1.0/glossaire#wakapp) et ses textes traduits. Il les publie sous forme de fichiers JSON, un par langue et par usage, que votre application charge au démarrage. Il détermine aussi, pour chaque utilisateur, la langue dans laquelle l'accueillir.

## Comment ça marche

```mermaid
flowchart LR
  K["Clés de traduction<br/>FRONT · BACK · EXTRA"] -- "publication automatique" --> F["Fichiers JSON<br/>i18-EXAPP1-front-fr.json…"]
  L["Langue de l'utilisateur<br/>préférence › client › réseau › application"] --> J["Jeton enrichi<br/>revendication wlng"]
  J --> W["Votre wakapp"]
  W -- "GET /api/languages/code/fr/file" --> A["API publique"]
  A -- "URL du fichier" --> W
  W -- "téléchargement" --> F
```

1. L'application déclare ses langues, dont une langue par défaut. Le français et l'anglais sont toujours présents.
2. Les textes sont rangés par clé (`common.buttons.save`) et par type de fichier : interface (`FRONT`), messages serveur (`BACK`), compléments (`EXTRA`).
3. À chaque modification, Wakastart republie le fichier JSON de la langue concernée.
4. À la connexion, le jeton de l'utilisateur porte sa langue résolue. Votre application demande l'adresse du fichier correspondant, le télécharge et l'utilise.

## Commencer

::::cards{cols=3}
:::card{title="Résolution de la langue" href="/v1.0/langues-et-traductions/resolution-de-la-langue" icon="Languages"}
Quelle langue s'applique à quel utilisateur, et pourquoi.
:::
:::card{title="Gérer les langues" href="/v1.0/langues-et-traductions/gerer-les-langues-de-l-application" icon="Settings"}
Ajouter une langue à l'application et choisir la langue par défaut.
:::
:::card{title="Charger les traductions" href="/v1.0/langues-et-traductions/charger-les-traductions" icon="Code"}
Récupérer le fichier JSON de la bonne langue dans votre application.
:::
::::

## Fonctionnalités

- Des langues propres à chaque application, choisies dans un référentiel commun à la plateforme.
- Une langue par défaut pour l'application, chaque réseau, chaque client, et une langue préférée par utilisateur.
- Trois fichiers par langue, pour séparer l'interface, les messages serveur et les textes complémentaires.
- Des fichiers JSON publiés automatiquement après chaque modification.

## Produits liés

::::cards{cols=3}
:::card{title="Apparence" href="/v1.0/apparence" icon="Palette"}
Le thème suit la même cascade que la langue.
:::
:::card{title="E-mails" href="/v1.0/emails" icon="Mail"}
Les e-mails d'invitation existent en sept langues.
:::
:::card{title="Authentification" href="/v1.0/authentification" icon="LogIn"}
Obtenir le jeton enrichi qui porte la langue de l'utilisateur.
:::
::::

## Ressources

- [Référence des langues et traductions](/v1.0/langues-et-traductions/reference)
- [Résoudre les problèmes de langues](/v1.0/langues-et-traductions/depannage)
- [Traduire l'interface avec waka-ui](/v1.0/interface-waka-ui/traduire-l-interface) : si votre front utilise la bibliothèque de composants de Wakastart.
- [Référence API : contenus de l'application](/v1.0/reference-api/contenus-application)
