Update translations, add French language (#44)

Author: microbit-robert

_locales/fr/machine-learning-jsdoc-strings.json

@@ -0,0 +1,15 @@
+{
+  "ml.getCertainty": "Obtenez la certitude d'un événement en pourcentage (0 à 100).",
+  "ml.getCertainty|param|event": "l'une des actions sur lesquelles le modèle d'apprentissage automatique a été formé",
+  "ml.isDetected": "Teste si un événement d'apprentissage est détecté.",
+  "ml.isDetected|param|event": "l'une des actions sur lesquelles le modèle d'apprentissage automatique a été formé",
+  "ml.onStart": "Faire quelque chose quand un événement d'apprentissage est détecté.",
+  "ml.onStart|param|body": "code à exécuter",
+  "ml.onStart|param|event": "l'une des actions sur lesquelles le modèle d'apprentissage automatique a été formé",
+  "ml.onStop": "Faire quelque chose quand un événement d'apprentissage n'est plus détecté.",
+  "ml.onStopDetailed": "Faire quelque chose quand un événement d'apprentissage n'est plus détecté.",
+  "ml.onStopDetailed|param|body": "code à exécuter",
+  "ml.onStopDetailed|param|event": "l'une des actions sur lesquelles le modèle d'apprentissage automatique a été formé",
+  "ml.onStop|param|body": "code à exécuter",
+  "ml.onStop|param|event": "l'une des actions sur lesquelles le modèle d'apprentissage automatique a été formé"
+}

_locales/fr/machine-learning-strings.json

@@ -0,0 +1,12 @@
+{
+  "ml.event.Unknown|block": "inconnu",
+  "ml.getCertainty|block": "certitude (\\%) ML $event",
+  "ml.isDetected|block": "ML $event détecté",
+  "ml.onStart|block": "au démarrage de ML $event",
+  "ml.onStopDetailed|block": "à l'arrêt de ML $event $duration (ms)",
+  "ml.onStop|block": "à l'arrêt de ML $event",
+  "ml|block": "Apprentissage automatique",
+  "{id:category}Ml": "Ml",
+  "{id:category}MlEvent": "MlEvent",
+  "{id:group}micro:bit (V2)": "micro:bit (V2)"
+}

bin/update-translations.sh

@@ -17,11 +17,11 @@ if [ $# -eq 0 ]; then
   exit 1
 fi
 
-languages="ca es-ES ja ko nl pl pt-BR zh-TW"
+languages="ca es-ES fr ja ko nl pl pt-BR zh-TW"
 
 for language in $languages; do
     lower="${language,,}"
-    prefix="${1}/${language}"
+    prefix="${1}/${language}/new/makecode-extensions/pxt-microbit-ml"
     cp "${prefix}/ui.en.json" "simx/lang/ui.${lower}.json"
 
     mkdir -p "_locales/${language}"

docs/_locales/fr/ml_get_event_certainty.md

@@ -0,0 +1,32 @@
+# certitude (%) ML
+
+Récupère la dernière valeur de certitude pour une action ML.
+
+```sig
+ml.getCertainty(ml.event.Unknown)
+```
+
+Le modèle ML s'exécute plusieurs fois par seconde et calcule une valeur de certitude pour chaque action. L'action estimée est l'action avec la plus grande certitude. Une action ne peut pas être l'action estimée lorsque sa certitude est inférieure au point de reconnaissance. Certains programmes peuvent avoir besoin d'utiliser directement les valeurs de certitude, par exemple pour les afficher ou les enregistrer. La plupart des programmes peuvent utiliser l'action estimée au lieu des valeurs de certitude.
+
+## Paramètres
+
+- **événement** : une des actions sur lesquelles le modèle d'apprentissage automatique a été formé.
+
+## Retours
+
+- un pourcentage en [nombre](/types/number) de 0 à 100, représentant la certitude du modèle ML que c'est l'action en cours. La certitude pour `inconnu` est toujours 0.
+
+## Exemple
+
+Cet exemple montre la certitude du modèle ML, exprimée en pourcentage, que l'action en cours est `applaudir` toutes les secondes.
+
+```blocks
+loops.everyInterval(1000, function () {
+    basic.showNumber(ml.getCertainty(ml.event.Clapping))
+})
+```
+
+```package
+machine-learning-help-stubs=github:microbit-foundation/pxt-microbit-ml-help-stubs#v0.0.1
+machine-learning=github:microbit-foundation/pxt-microbit-ml#v1.0.8
+```

docs/_locales/fr/ml_is_event_detected.md

@@ -0,0 +1,36 @@
+# ML détecté
+
+Vérifie si une action ML est l'action estimée.
+
+```sig
+ml.isDetected(ml.event.Unknown)
+```
+
+Le modèle ML met à jour son action estimée plusieurs fois par seconde. Cette fonction renvoie `true` si l'action choisie est actuellement estimée. Utilisez la valeur booléenne pour prendre des décisions logiques dans votre programme.
+
+Certains programmes seront plus faciles à écrire en utilisant les gestionnaires d'événements « au démarrage de ML » et « à l'arrêt de ML » à la place.
+
+## Paramètres
+
+- **événement** : une des actions sur lesquelles le modèle d'apprentissage automatique a été formé. La valeur spéciale `unknown` représente le cas où aucune action n'a une certitude au-dessus du point de reconnaissance.
+
+## Retours
+
+- une valeur [boolean](/types/boolean) qui est `true` si l'action ML est l'action estimée, `false` si l'action ML n'est pas l'action estimée.
+
+## Exemple
+
+Cet exemple affichera une icône de coche sur l'écran LED si l'action estimée est `applaudir` au moment où l'instruction conditionnelle est vérifiée.
+
+```blocks
+basic.forever(function () {
+    if (ml.isDetected(ml.event.Clapping)) {
+        basic.showIcon(IconNames.Yes)
+    }
+})
+```
+
+```package
+machine-learning-help-stubs=github:microbit-foundation/pxt-microbit-ml-help-stubs#v0.0.1
+machine-learning=github:microbit-foundation/pxt-microbit-ml#v1.0.8
+```

docs/_locales/fr/ml_on_event_start.md

@@ -0,0 +1,29 @@
+# au démarrage de ML
+
+Démarrer un [gestionnaire d'événements](/reference/event-handler) (partie du programme qui s'exécutera quand quelque chose se passe). Ce gestionnaire fonctionne lorsque l'action estimée du modèle ML passe à l'action que vous avez sélectionnée.
+
+```sig
+ml.onStart(ml.event.Unknown, function () {
+})
+```
+
+Le modèle ML met à jour son action estimée plusieurs fois par seconde, mais ce gestionnaire d'événements ne s'exécute que lorsque l'action estimée change.
+
+## Paramètres
+
+- **événement** : une des actions sur lesquelles le modèle d'apprentissage automatique a été formé. La valeur spéciale `unknown` représente le cas où aucune action n'a une certitude au-dessus du point de reconnaissance.
+
+## Exemple
+
+Cet exemple joue une mélodie musicale en arrière-plan lorsque l'action `applaudir` a une certitude au-dessus du point de reconnaissance.
+
+```blocks
+ml.onStart(ml.event.Clapping, function () {
+    music._playDefaultBackground(music.builtInPlayableMelody(Melodies.Dadadadum), music.PlaybackMode.InBackground)
+})
+```
+
+```package
+machine-learning-help-stubs=github:microbit-foundation/pxt-microbit-ml-help-stubs#v0.0.1
+machine-learning=github:microbit-foundation/pxt-microbit-ml#v1.0.8
+```

docs/_locales/fr/ml_on_event_stop.md

@@ -0,0 +1,31 @@
+# à l'arrêt de ML
+
+Démarrez un [gestionnaire d'événements](/reference/event-handler) (partie du programme qui s'exécutera quand quelque chose se passe). Ce gestionnaire fonctionne lorsque l'action estimée du modèle ML change de l'action que vous sélectionnez.
+
+```sig
+ml.onStop(ml.event.Unknown, function () {
+})
+```
+
+Lorsqu'une action est modifiée, le gestionnaire d'événements d'arrêt pour l'action précédente s'exécutera, suivi du gestionnaire d'événements de début pour la prochaine action.
+
+Par exemple, si votre gestionnaire d'événements de départ pour une action démarre la musique en arrière-plan, vous pouvez utiliser un gestionnaire d'événements stop pour l'arrêter.
+
+## Paramètres
+
+- **événement** : une des actions sur lesquelles le modèle d'apprentissage automatique a été formé. La valeur spéciale `unknown` représente le cas où aucune action n'a une certitude au-dessus du point de reconnaissance.
+
+## Exemple
+
+Cet exemple arrête de jouer une mélodie musicale lorsque l'action estimée passe de « applaudir  » à n'importe quelle autre action.
+
+```blocks
+ml.onStop(ml.event.Clapping, function () {
+    music.stopMelody(MelodyStopOptions.All)
+})
+```
+
+```package
+machine-learning-help-stubs=github:microbit-foundation/pxt-microbit-ml-help-stubs#v0.0.1
+machine-learning=github:microbit-foundation/pxt-microbit-ml#v1.0.8
+```

docs/_locales/fr/ml_on_event_stop_detailed.md

@@ -0,0 +1,33 @@
+# à l'arrêt de ML
+
+Démarrer un [gestionnaire d'événements](/reference/event-handler) (partie du programme qui s'exécutera quand quelque chose se passe). Ce gestionnaire fonctionne lorsque l'action estimée du modèle ML change de l'action que vous sélectionnez.
+
+```sig
+ml.onStopDetailed(ml.event.Unknown, function (duration) {
+})
+```
+
+Lorsqu'une action est modifiée, le gestionnaire d'événements d'arrêt pour l'action précédente s'exécutera, suivi du gestionnaire d'événements de début pour la prochaine action.
+
+Par exemple, si votre gestionnaire d'événements de départ pour une action démarre la musique en arrière-plan, vous pouvez utiliser un gestionnaire d'événements stop pour l'arrêter.
+
+Un paramètre `durée` est passé au gestionnaire d'événement. La durée est le [nombre](/types/number) de millisecondes depuis que cette action est devenue l'action estimée. Vous pouvez utiliser le paramètre de durée dans votre code, par exemple l'afficher ou utiliser une variable pour garder un total en cours d'exécution.
+
+## Paramètres
+
+- **événement** : une des actions sur lesquelles le modèle d'apprentissage automatique a été formé. La valeur spéciale `unknown` représente le cas où aucune action n'a une certitude au-dessus du point de reconnaissance.
+
+## Exemple
+
+Cet exemple montre sur l'écran LED, en secondes, combien de temps l'action estimée a été `applaudir`, lorsque l'action estimée passe de `applaudir` à n'importe quelle autre action.
+
+```blocks
+ml.onStopDetailed(ml.event.Clapping, function (duration) {
+    basic.showNumber(duration / 1000)
+})
+```
+
+```package
+machine-learning-help-stubs=github:microbit-foundation/pxt-microbit-ml-help-stubs#v0.0.1
+machine-learning=github:microbit-foundation/pxt-microbit-ml#v1.0.8
+```

docs/_locales/ja/ml_get_event_certainty.md

@@ -1,24 +1,24 @@
 # 確実性(%) ML
 
-ML の動きの確実性の値を取得します。
+MLの動きの確実性の値を取得します。
 
 ```sig
 ml.getCertainty(ml.event.Unknown)
 ```
 
-ML モデルは 1 秒間に数回実行され、各アクションの確実性の値を算出します。 推定した動きは、最も高い確実性を持つ動きです。 アクションの確実性が認識点を下回る場合、そのアクションを推定アクションとすることはできません。 プログラムによっては、例えば確かな値を表示したりログに記録したりするために、その値を直接使う必要があるかもしれません。 ほとんどのプログラムでは、確実な値の代わりに推定アクションを使うことができます。
+MLモデルは1秒間に数回実行され、各アクションの確実性の値を算出します。 推定した動きは、最も高い確実性を持つ動きです。 アクションの確実性が認識点を下回る場合、そのアクションを推定アクションとすることはできません。 プログラムによっては、例えば確かな値を表示したりログに記録したりするために、その値を直接使う必要があるかもしれません。 ほとんどのプログラムでは、確実な値の代わりに推定アクションを使うことができます。
 
 ## パラメータ
 
-- **イベント**：機械学習モデルがトレーニングされたアクションの 1 つ。
+- **イベント**：機械学習モデルがトレーニングされたアクションの1つ。
 
 ## 戻る
 
-- パーセンテージは 0 から 100 までの[数値](/types/number)で、ML モデルがこのアクションが実行されることを確信する度合いを表す。 「不明」の確実性は常に 0 である。
+- パーセンテージは0から100までの[数値](/types/number)で、MLモデルがこのアクションが実行されることを確信する度合いを表す。 「不明」の確実性は常に0である。
 
 ## 例
 
-この例では、現在のアクションが 1 秒ごとに`clapping`しているという ML モデルの確信度をパーセントで表示しています。
+この例では、現在のアクションが1秒ごとに`clapping`しているというMLモデルの確信度をパーセントで表示しています。
 
 ```blocks
 loops.everyInterval(1000, function () {basic.showNumber(ml.getCertainty(ml.event.Clapping))

docs/_locales/ja/ml_is_event_detected.md

@@ -1,26 +1,26 @@
-# ML が を検出したとき
+# ML が  を検出したとき
 
-ML のアクションが推定されたアクションかどうかをチェックします。
+MLのアクションが推定されたアクションかどうかをチェックします。
 
 ```sig
 ml.isDetected(ml.event.Unknown)
 ```
 
-ML モデルは 1 秒間に数回、推定された行動を更新します。 この関数は、選択されたアクションが現在推定されている場合、「真」を返します。 論理値を使って、プログラムで論理的な判断を下します。
+MLモデルは1秒間に数回、推定された行動を更新します。 この関数は、選択されたアクションが現在推定されている場合、「真」を返します。 論理値を使って、プログラムで論理的な判断を下します。
 
-いくつかのプログラムは、「ML で開始」 と 「ML で停止」 イベント取扱機能を使った方が書きやすいでしょう。
+いくつかのプログラムは、「MLで開始」 と 「MLで停止」 イベント取扱機能を使った方が書きやすいでしょう。
 
 ## パラメータ
 
-- **イベント**：機械学習モデルがトレーニングされたアクションの 1 つ。 特別な値「不明」は、認識点以上の確実性を持つアクションがない場合を表します。
+- **イベント**：機械学習モデルがトレーニングされたアクションの1つ。 特別な値「不明」は、認識点以上の確実性を持つアクションがない場合を表します。
 
 ## 戻る
 
-- [論理](/types/boolean) 値が「真」であるなら、ML アクションが推定されたアクションであり、「偽」であれば推定されたアクションでないということです。
+- [論理](/types/boolean) 値が「真」であるなら、MLアクションが推定されたアクションであり、「偽」であれば推定されたアクションでないということです。
 
 ## 例
 
-この例では、条件文がチェックされた時点で、推定されるアクションが`clapping`であれば、LED ディスプレイにティックアイコンを表示します。
+この例では、条件文がチェックされた時点で、推定されるアクションが`clapping`であれば、LEDディスプレイにティックアイコンを表示します。
 
 ```blocks
 basic.forever(function () {