Prise en charge du format de message pour la localisation

[Discourse]

Directives pour les traducteurs

Dans Discourse, toutes les chaînes de format de message ont une clé se terminant par “_MF”. L’éditeur Crowdin dispose d’un aperçu qui vous permet d’expérimenter différentes valeurs, ce qui est très utile pour vérifier vos traductions.

Important : Vous devez modifier les formes plurielles de votre traduction si votre langue utilise des formes autres que “one” et “other”. Vous pouvez ajouter ou supprimer des formes dans un bloc { FOO, plural, ... } afin que cela fonctionne pour vos langues. L’aperçu dans l’éditeur Crowdin affichera une “Erreur de syntaxe” lorsque votre traduction présente un problème.

Les formes plurielles disponibles sont :

• zero
• one
• two
• few
• many
• other (requis — forme plurielle générale — également utilisée pour les langues sans distinction entre les formes singulière et plurielle)

Parfois, vous verrez un bloc vide =0 {} dans une chaîne source anglaise, ce qui signifie que la variable ne peut pas avoir la valeur 0.

Directives pour les développeurs

Les chaînes de format de message ne sont actuellement disponibles que pour les traductions côté client. Elles sont utiles si votre chaîne contient plus d’un nombre ou de nombreuses variables qui entraîneraient un nombre élevé de permutations.

• Les clés des chaînes de format de message doivent se terminer par “_MF”

• Utilisez le format suivant pour les nombres (# sera remplacé par le nombre) :

  { variable_name, plural,
      one: {# texte singulier}
    other: {# texte pluriel}
  }
  

• Utilisez le format suivant pour les choix :

  { variable_name, select,
    foo: {Ceci est foo}
    bar: {Ceci est bar}
    baz: {Ceci est baz}
  }
  

• Voici comment l’utiliser en JavaScript :

  I18n.messageFormat("key_MF", {
    variable1: "foo",
    variable2: 42,
  });
  

• Recommandation : Si possible, utilisez les arguments complexes comme structure la plus externe d’un message, et écrivez des phrases complètes dans leurs sous-messages. Si vous avez des arguments select et plural imbriqués, placez les arguments select (avec leurs ensembles fixes de choix) à l’extérieur et imbriquez les arguments plural (au plus un, espérons-le) à l’intérieur. Voir Formatting Messages | ICU Documentation

• Rendez-les lisibles – voir les exemples existants dans client.en.yml

  Mauvais

  There {currentTopics, plural, one {is <strong>#</strong> topic} other {are <strong>#</strong> topics}}. Visitors need more to read and reply to – we recommend at least { requiredTopics, plural, one {<strong>#</strong> topic} other {<strong>#</strong> topics}}. Only staff can see this message.
  

  Bon

  There { currentTopics, plural,
      one {is <strong>#</strong> topic}
    other {are <strong>#</strong> topics}
  }. Visitors need more to read and reply to – we recommend at least { requiredTopics, plural,
      one {<strong>#</strong> topic}
    other {<strong>#</strong> topics}
  }. Only staff can see this message.
  

Outils et informations supplémentaires

• Online ICU Message Editor vous permet de tester une chaîne de format de message au cas où il y aurait un problème avec l’éditeur Crowdin. Veuillez désactiver l’option “Parse simple xml/html tags”, sinon vous pourriez voir un message d’erreur.

• ICU Message Format for Translators

---

Ce document est contrôlé par version - suggérez des modifications sur github.