Comment publier les traductions pour que mon application les utilise ?

La publication est l'étape qui rend une traduction réelle pour votre application. Tant que vous n'avez pas publié, tout ce que vous avez écrit ne vit que dans le tableau de bord.

Il n'y a ni build ni déploiement entre les deux.

Ce qui se passe #

Code

Publish
  → les traductions sont écrites sur l'origine du CDN
  → le cache est purgé pour ce qui a changé
  → votre application récupère la nouvelle version à sa requête suivante

Comment faire #

Ouvrez votre projet
Cliquez sur Publish
Lisez ce qui est listé — c'est la partie importante
Confirmez

La fenêtre liste exactement ce qui va être mis en ligne, regroupé pour que vous puissiez le voir plutôt que de faire confiance à un compteur.

Lisez la liste avant de confirmer #

Les brouillons sont publiés aussi. Cela surprend, alors autant être direct : la publication inclut à la fois les traductions approuvées et les brouillons. Le comportement par défaut de l'API se limite aux traductions approuvées ; le tableau de bord élargit délibérément ce périmètre pour que ce qui est listé corresponde à ce qui part réellement — annoncer « 12 prêtes » et n'en publier que 9 serait pire.

La conséquence : brouillon ne veut pas dire « ne peut pas être mis en ligne », mais « personne ne s'en est encore porté garant ». Si l'approbation doit être un vrai verrou, relisez avant de publier plutôt que de compter sur le statut. Voir Comment relire et approuver les traductions ?.

Au bout de combien de temps les visiteurs le voient-ils #

Le CDN sert les traductions avec un cache d'une minute, et la publication purge ce qui a changé — la réponse habituelle se compte donc en secondes, et une minute est le plafond.

Les couches qui peuvent ajouter leur propre délai :

Couche	Délai
Edge du CDN	Purgé à la publication ; sinon `max-age=60`
Cache mémoire du SDK	Jusqu'à son intervalle de rafraîchissement
ISR de Next.js	La valeur de `revalidate` que vous avez définie

Si votre application rend les traductions au moment du build ou les met en cache pendant une heure, ce chiffre est le vôtre, pas le nôtre. J'ai publié mais mon application affiche encore les anciennes traductions explique comment trouver la couche fautive.

Depuis la CLI #

Bash

better-i18n publish:status   # ce qui serait mis en ligne maintenant
better-i18n publish          # le faire

Lancer publish:status en premier dans un pipeline en vaut la peine : c'est la réponse honnête à « y a-t-il quelque chose en attente ».

Il n'y a pas de retour arrière #

La publication n'est pas versionnée et il n'existe aucun instantané à restaurer. Corriger une mauvaise publication consiste à modifier la traduction et à publier de nouveau — environ une minute, donc rarement une crise, mais cela signifie que la relecture se fait avant le bouton, pas après.

Chaque publication est enregistrée comme un job consultable :