From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../api/i18n/detectlanguage/index.html | 115 ++++++++++++++++++ .../api/i18n/getacceptlanguages/index.html | 92 +++++++++++++++ .../webextensions/api/i18n/getmessage/index.html | 119 +++++++++++++++++++ .../api/i18n/getuilanguage/index.html | 86 ++++++++++++++ .../add-ons/webextensions/api/i18n/index.html | 57 +++++++++ .../webextensions/api/i18n/languagecode/index.html | 69 +++++++++++ .../locale-specific_message_reference/index.html | 129 +++++++++++++++++++++ 7 files changed, 667 insertions(+) create mode 100644 files/fr/mozilla/add-ons/webextensions/api/i18n/detectlanguage/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/i18n/getacceptlanguages/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/i18n/getmessage/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/i18n/getuilanguage/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/i18n/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/i18n/languagecode/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/i18n/locale-specific_message_reference/index.html (limited to 'files/fr/mozilla/add-ons/webextensions/api/i18n') diff --git a/files/fr/mozilla/add-ons/webextensions/api/i18n/detectlanguage/index.html b/files/fr/mozilla/add-ons/webextensions/api/i18n/detectlanguage/index.html new file mode 100644 index 0000000000..20b63588d6 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/i18n/detectlanguage/index.html @@ -0,0 +1,115 @@ +--- +title: i18n.detectLanguage() +slug: Mozilla/Add-ons/WebExtensions/API/i18n/detectLanguage +tags: + - API + - Add-ons + - Extensions + - Method + - Non-standard + - Reference + - WebExtensions + - detectLanguage + - i18n +translation_of: Mozilla/Add-ons/WebExtensions/API/i18n/detectLanguage +--- +
{{AddonSidebar()}}
+ +

Détecte la langue du texte fourni à l'aide du détecteur de langue compact (CLD).

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var detectingLanguages = browser.i18n.detectLanguage(
+  text                  // string
+)
+
+ +

Paramètres

+ +
+
text
+
string. Chaîne d'entrée de l'utilisateur à traduire.
+
+ +

Valeur retournée

+ +

Une Promise qui sera remplie avec un objet résultat. L'objet résultat a deux propriétés :

+ +
+
isReliable
+
boolean. Si la langue a été détectée de manière fiable.
+
languages
+
array d'objets, dont chacun a deux propriétés:
+
+
+
language
+
{{WebExtAPIRef('i18n.LanguageCode')}}. La langue détectée.
+
percentage
+
integer. Le pourcentage de la chaîne d'entrée qui était dans la langue détectée.
+
+
+
+ +

Compatibilité du navigateur

+ + + +

{{Compat("webextensions.api.i18n.detectLanguage")}}

+ +

Exemples

+ +
function onLanguageDetected(langInfo) {
+  for (lang of  langInfo.languages) {
+    console.log("Le langage est : " + lang.language);
+    console.log("Le pourcentage est : " + lang.percentage);
+  }
+}
+
+var text = "L'homme est né libre, et partout il est dans les fers."
+
+var detecting = browser.i18n.detectLanguage(text);
+detecting.then(onLanguageDetected);
+
+
+ +

{{WebExtExamples}}

+ +
Remerciements : + +

Cette API est basée sur l'API Chromium chrome.i18n. Cette documentation est dérivée de i18n.json dans le code de Chromium code.

+ +

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/i18n/getacceptlanguages/index.html b/files/fr/mozilla/add-ons/webextensions/api/i18n/getacceptlanguages/index.html new file mode 100644 index 0000000000..a7868e3b35 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/i18n/getacceptlanguages/index.html @@ -0,0 +1,92 @@ +--- +title: i18n.getAcceptLanguages() +slug: Mozilla/Add-ons/WebExtensions/API/i18n/getAcceptLanguages +tags: + - API + - Add-ons + - Extensions + - Method + - Non-standard + - Reference + - WebExtensions + - getAcceptLanguages + - i18n +translation_of: Mozilla/Add-ons/WebExtensions/API/i18n/getAcceptLanguages +--- +
{{AddonSidebar()}}
+ +

Obtient les accept-languages du navigateur. Ceci est différent des paramètres régionaux utilisés par le navigateur. Pour obtenir les paramètres régionaux, utilisez  {{WebExtAPIRef('i18n.getUILanguage')}}.

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var gettingAcceptLanguages = browser.i18n.getAcceptLanguages()
+
+ +

Paramètres

+ +

None.

+ +

Valeur retournée

+ +

Une Promise qui sera remplie avec un array d'objets {{WebExtAPIRef('i18n.LanguageCode')}}.

+ +

Compatibilité du navigateur

+ + + +

{{Compat("webextensions.api.i18n.getAcceptLanguages")}}

+ +

Exemples

+ +
function onGot(languages) {
+  console.log(languages);
+  //e.g. Array [ "en-US", "en" ]
+}
+
+var gettingAcceptLanguages = browser.i18n.getAcceptLanguages();
+gettingAcceptLanguages.then(onGot);
+
+ + + +

{{WebExtExamples}}

+ +
Remerciements : + +

Cette API est basée sur l'API Chromium chrome.i18n. Cette documentation est dérivée de i18n.json dans le code de Chromium code.

+ +

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/i18n/getmessage/index.html b/files/fr/mozilla/add-ons/webextensions/api/i18n/getmessage/index.html new file mode 100644 index 0000000000..464a46cfc0 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/i18n/getmessage/index.html @@ -0,0 +1,119 @@ +--- +title: i18n.getMessage() +slug: Mozilla/Add-ons/WebExtensions/API/i18n/getMessage +tags: + - API + - Add-ons + - Extensions + - Method + - Non-standard + - Reference + - WebExtensions + - getMessage + - i18n +translation_of: Mozilla/Add-ons/WebExtensions/API/i18n/getMessage +--- +
{{AddonSidebar()}}
+ +

Obtient la chaîne localisée pour le message spécifié.

+ +

Syntaxe

+ +
browser.i18n.getMessage(
+  messageName,  // string
+  substitutions // optional any
+)
+
+ +

Paramètres

+ +
+
messageName
+
string. Le nom du message, tel que spécifié dans le fichier messages.json. Si le message ne peut pas être trouvé dans messages.json :
+
+
    +
  • Firefox renvoie "" et enregistre une erreur.
    • +
  • Chrome renvoie "" et n'enregistre pas d'erreur.
    • +
+
+
substitutions{{optional_inline}}
+
string ou array de string. Une chaîne de substitution unique ou un tableau de chaînes de substitution.
+
Dans Chrome, si vous fournissez plus de 9 chaînes de substitution, getMessage() renvoie undefined.
+
+ +

Valeur retournée

+ +

string. Message localisé pour les paramètres régionaux en cours.

+ +

Compatibilité du navigateur

+ + + +

{{Compat("webextensions.api.i18n.getMessage")}}

+ +

Exemples

+ +

Obtenez la chaîne localisée pour "messageContent", avec target.url substitué :

+ +
var message = browser.i18n.getMessage("messageContent", target.url);
+console.log(message);
+
+ +

Cela fonctionnerait avec un fichier _locales/en/messages.json contenant :

+ +
{
+  "messageContent": {
+    "message": "You clicked $URL$.",
+    "description": "Tells the user which link they clicked.",
+    "placeholders": {
+      "url" : {
+        "content" : "$1",
+        "example" : "https://developer.mozilla.org"
+      }
+    }
+  }
+}
+ +

Si target.url est "https://developer.mozilla.org", alors la valeur de message, dans la locale "en", serait :

+ +
"You clicked https://developer.mozilla.org."
+ +

{{WebExtExamples}}

+ +
Remerciements : + +

Cette API est basée sur l'API Chromium chrome.i18n. Cette documentation est dérivée de i18n.json dans le code de Chromium code.

+ +

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/i18n/getuilanguage/index.html b/files/fr/mozilla/add-ons/webextensions/api/i18n/getuilanguage/index.html new file mode 100644 index 0000000000..0e5c7c343d --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/i18n/getuilanguage/index.html @@ -0,0 +1,86 @@ +--- +title: i18n.getUILanguage() +slug: Mozilla/Add-ons/WebExtensions/API/i18n/getUILanguage +tags: + - API + - Add-ons + - Extensions + - Method + - Non-standard + - Reference + - WebExtensions + - getUILanguage + - i18n +translation_of: Mozilla/Add-ons/WebExtensions/API/i18n/getUILanguage +--- +
{{AddonSidebar()}}
+ +

Obtient la langue de l'interface utilisateur du navigateur. Ceci est différent de {{WebExtAPIRef('i18n.getAcceptLanguages')}} qui renvoie les langues utilisateur préférées.

+ +

Syntaxe

+ +
browser.i18n.getUILanguage()
+
+ +

Paramètres

+ +
+
None.
+
+ +

Valeur retournée

+ +

string. Le code de langue de l'interface utilisateur du navigateur en tant que  {{WebExtAPIRef("i18n.LanguageCode")}}.

+ +

Compatibilité du navigateur

+ + + +

{{Compat("webextensions.api.i18n.getUILanguage")}}

+ +

Exemples

+ +
var uiLanguage = browser.i18n.getUILanguage();
+console.log(uiLanguage);
+
+//e.g. "fr"
+ +

{{WebExtExamples}}

+ +
Remerciements : + +

Cette API est basée sur l'API Chromium chrome.i18n. Cette documentation est dérivée de i18n.json dans le code de Chromium code.

+ +

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/i18n/index.html b/files/fr/mozilla/add-ons/webextensions/api/i18n/index.html new file mode 100644 index 0000000000..bb22f56649 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/i18n/index.html @@ -0,0 +1,57 @@ +--- +title: i18n +slug: Mozilla/Add-ons/WebExtensions/API/i18n +tags: + - API + - Add-ons + - Extensions + - Interface + - Non-standard + - Reference + - WebExtensions + - i18n +translation_of: Mozilla/Add-ons/WebExtensions/API/i18n +--- +
{{AddonSidebar}}
+ +

Fonctions permettant d'internationaliser votre extension. Vous pouvez utiliser ces API pour obtenir des chaînes localisées à partir de fichiers locaux conditionnés avec votre extension, connaître la langue actuelle du navigateur et en connaître la valeur de son En-tete "Accept-Language".

+ +

Pour plus de détails sur l'utilisation de i18n pour votre extension, voir :

+ + + +

Types

+ +
+
{{WebExtAPIRef("i18n.LanguageCode")}}
+
Une balise de langue telle que "en-US" ou "fr".
+
+ +

Fonctions

+ +
+
{{WebExtAPIRef("i18n.getAcceptLanguages()")}}
+
Obtient les accept-languages du navigateur. Ceci est différent des paramètres régionaux utilisés par le navigateur. Pour obtenir les paramètres régionaux, utilisez  {{WebExtAPIRef('i18n.getUILanguage')}}.
+
{{WebExtAPIRef("i18n.getMessage()")}}
+
Obtient la chaîne localisée pour le message spécifié.
+
{{WebExtAPIRef("i18n.getUILanguage()")}}
+
Obtient la langue de l'interface utilisateur du navigateur. Ceci est différent de  {{WebExtAPIRef('i18n.getAcceptLanguages')}} qui renvoie les langues utilisateur préférées.
+
{{WebExtAPIRef("i18n.detectLanguage()")}}
+
Détecte la langue du texte fourni en utilisant le détecteur de langue compact.
+
+ +

Compatibilité des navigateurs

+ +

{{Compat("webextensions.api.i18n")}}

+ +

{{WebExtExamples("h2")}}

+ +
+

Remerciements
+ Cette API est basée sur l'API Chromium chrome.i18n. Cette documentation est dérivée de i18n.json dans le code de Chromium.
+
+ Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.

+
diff --git a/files/fr/mozilla/add-ons/webextensions/api/i18n/languagecode/index.html b/files/fr/mozilla/add-ons/webextensions/api/i18n/languagecode/index.html new file mode 100644 index 0000000000..1030735ae9 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/i18n/languagecode/index.html @@ -0,0 +1,69 @@ +--- +title: i18n.LanguageCode +slug: Mozilla/Add-ons/WebExtensions/API/i18n/LanguageCode +tags: + - API + - Add-ons + - Extension + - Extensions + - LanguageCode + - Non-standard + - Reference + - Type + - WebExtensions + - i18n +translation_of: Mozilla/Add-ons/WebExtensions/API/i18n/LanguageCode +--- +
{{AddonSidebar()}}
+ +

Une balise de langue telle que "en-US" ou "fr".

+ +

Type

+ +

Les valeurs de ce type sont des chaînes.

+ +

Compatibilité du navigateur

+ + + +

{{Compat("webextensions.api.i18n.LanguageCode")}}

+ +

{{WebExtExamples}}

+ +
Remerciements : + +

Cette API est basée sur l'API Chromium chrome.i18n. Cette documentation est dérivée de i18n.json dans le code de Chromium code.

+ +

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/i18n/locale-specific_message_reference/index.html b/files/fr/mozilla/add-ons/webextensions/api/i18n/locale-specific_message_reference/index.html new file mode 100644 index 0000000000..843010173d --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/i18n/locale-specific_message_reference/index.html @@ -0,0 +1,129 @@ +--- +title: Locale-specific message reference +slug: Mozilla/Add-ons/WebExtensions/API/i18n/Locale-Specific_Message_reference +tags: + - Internationalization + - Localization + - Reference + - String + - WebExtensions + - i18n + - message + - messages.json + - placeholders +translation_of: Mozilla/Add-ons/WebExtensions/API/i18n/Locale-Specific_Message_reference +--- +

{{AddonSidebar()}}

+ +

Chaque extension internationalisée a au moins un fichier nommé messages.json qui fournit des chaînes spécifiques aux paramètres régionaux. Cette page décrit le format des fichiers messages.json.

+ +
+

Remarque : Pour plus d'informations sur l'internationalisation de vos extensions, consultez notre guide i18n.

+
+ +

Exemple messages.json

+ +

Le code suivant montre un exemple de fichier messages.json file, tiré de notre extension d'exemple notify-link-clicks-i18n. Seuls les champs "name" et "message" ont obligatoires.

+ +
{
+  "extensionName": {
+    "message": "Notify link clicks i18n",
+    "description": "Name of the extension."
+  },
+
+  "extensionDescription": {
+    "message": "Shows a notification when the user clicks on links.",
+    "description": "Description of the extension."
+  },
+
+  "notificationTitle": {
+    "message": "Click notification",
+    "description": "Title of the click notification."
+  },
+
+  "notificationContent": {
+    "message": "You clicked $URL$.",
+    "description": "Tells the user which link they clicked.",
+    "placeholders": {
+      "url" : {
+        "content" : "$1",
+        "example" : "https://developer.mozilla.org"
+      }
+    }
+  }
+}
+ +

Placement

+ +

Vos fichiers messages.json doivent être placés dans des répertoires nommés d'après les paramètres régionaux que chacun supporte — en, de, ja, etc. Ceux-ci doivent être placés dans un répertoire appelé _locales, à l'intérieur de la racine de votre extension.

+ +

Détails des membres

+ +

Cette section décrit chaque membre qui peut apparaître dans un fichier messages.json.

+ +

name

+ +

Chaque membre de niveau supérieur est nommé d'après le nom de la chaîne de message que vous localisez, par exemple "extensionName" ou "notificationContent" dans l'exemple ci-dessus. Chaque nom est insensible à la casse et agit comme une clé vous permettant de récupérer le texte du message localisé.

+ +

Le nom peut inclure les caractères suivants :

+ + + +

Remarque : Vous ne devez pas définir les noms commençant par @@. Ces noms sont réservés aux messages prédéfinis.

+ +

message

+ +

Au moins, cette propriété doit être définie pour chaque chaîne. Le membre "message" contient une chaîne localisée qui peut contenir {{anch("placeholders")}}. Vous pouvez utiliser :

+ + + +

Autres points à noter :

+ + + +

description

+ +

{{optional_inline}}

+ +

Le membre "description" doit contenir une description du contenu de la chaîne de message, destinée à fournir un traducteur pour aider à créer la meilleure traduction possible de la chaîne.

+ +

placeholders

+ +

{{optional_inline}}

+ +

Le membre "placeholders" définit une ou plusieurs sous-chaînes à utiliser dans le message — celles-ci peuvent être utilisées pour coder en dur les éléments que vous ne voulez pas traduire, ou vous référer à des variables.

+ +

Chaque définition de sous-chaîne d'espace réservé possède un certain nombre de valeurs :

+ +
"url" : {
+  "content" : "$1",
+  "example" : "https://developer.mozilla.org"
+}
+ +

Nom placeholder

+ +

Le nom de l'espace réservé est utilisé pour représenter l'espace réservé dans la chaîne de substitution (par exemple "url" devient $url$). Il est insensible à la casse et peut contenir les mêmes caractères qu'une chaîne de message {{anch("name")}}.

+ +

contenu

+ +

L'élément "contenu" définit le contenu de l'espace réservé. Cela peut être une chaîne codée en dur, telle que "My placeholder", mais elle peut également inclure des valeurs obtenues à partir d'un appel {{WebExtAPIRef("i18n.getMessage()")}}. Cette propriété est obligatoire Pour plus d'informations, voir Récupération des chaînes de messages à partir de Javascript.

+ +

exemple

+ +

{{optional_inline}}

+ +

L'élément optionnel "exemple" est là encore destiné à aider les traducteurs en leur montrant un exemple de la façon dont l'espace réservé apparaîtrait aux utilisateurs finaux, leur permettant de faire le meilleur choix lors de la localisation du fichier.

-- cgit v1.2.3-54-g00ecf