fix: update French localization for "Getting Started" text and enhance YAML hero actions handling

Author: pelikhan

docs/src/content/docs/fr/index.mdx

@@ -7,7 +7,7 @@ hero:
     file: ../../../assets/logo.svg
     alt: GenAIScript logo A yellow square with genai text
   actions:
-    - text: Getting Started
+    - text: Prise en main
       link: /genaiscript/getting-started/
       icon: right-arrow
       variant: primary

docs/translations/fr.json

@@ -8388,7 +8388,7 @@
   "7488F1ED2F90893B552C": "Neovim",
   "4C1CD4854A9D61A5024A": "Extension Visual Studio Code <a id=\"visual-studio-code-extension\" href=\"\" />\n\nLe [Visual Studio Code Marketplace](https://marketplace.visualstudio.com/items?itemName=genaiscript.genaiscript-vscode)\ncontient la dernière version stable de l'[extension](https://marketplace.visualstudio.com/items?itemName=genaiscript.genaiscript-vscode).\n\n<Steps>\n  <ol>\n    <li>\n      Installez [Visual Studio Code](https://code.visualstudio.com/Download).\n\n      Visual Studio Code est un éditeur de code source léger mais puissant qui fonctionne sur votre bureau et est disponible pour Windows, macOS et Linux.\n    </li>\n\n    <li>\n      Ouvrez le dossier de votre projet dans Visual Studio Code.\n    </li>\n\n    <li>\n      Cliquez sur la vue **Extensions**\n\n      <Image src={extensionViewSrc} alt={extensionViewAlt} />\n    </li>\n\n    <li>\n      Recherchez **genaiscript** et cliquez sur **Installer**.\n\n      <Image src={marketplaceSrc} alt={marketplaceAlt} />\n    </li>\n\n    <li>\n      Si l'installation est réussie, vous verrez l'icône dans la vue **Extensions**.\n\n      <Image src={vscodeViewSrc} alt={vscodeViewAlt} />\n    </li>\n\n    <li>\n      (Facultatif) Cliquez sur l'icône ⚙️ sur la page de l'extension et sélectionnez **Ajouter aux recommandations de l'espace de travail**.\n    </li>\n  </ol>\n</Steps>\n\nPour installer une version spécifique de l'extension, nous recommandons de stocker le fichier `genaiscript.vsix`\ndans votre dépôt et d'utiliser les étapes d'installation manuelle.\n\n### Profil par défaut pour le terminal\n\nGenAIScript lance un serveur Node dans le terminal par défaut. Si le terminal par défaut n'est pas configuré\nou ne prend pas en charge Node.js, vous devrez peut-être le mettre à jour dans vos paramètres utilisateur/espace de travail.\n\n* Ouvrez la palette de commandes `Ctrl+Shift+P` et recherchez `Terminal: Sélectionner le profil par défaut`.\n* Sélectionnez le profil de terminal comme **Git Bash**",
   "D729716A2DF6E7B14A5C": "Ligne de commande <a id=\"command-line\" href=\"\" />\n\nL'outil en ligne de commande [genaiscript](/genaiscript/reference/cli/) vous permet d'exécuter votre GenAIScript\ndepuis n'importe quel terminal.\n\n```sh\nnpx genaiscript run my-script some/path/*.pdf",
-  "4A5339853316F3D12027": "Commencer",
+  "4A5339853316F3D12027": "Prise en main",
   "B59803282C64DBC3CD0B": "Commencez à développer avec l'extension GenAIScript pour VS Code afin de créer des scripts IA efficacement.",
   "7CD15446D60D2DFAB9B4": "GenAIScript est un langage de script qui intègre les LLM dans le processus de script en utilisant une syntaxe JavaScript simplifiée.\nPris en charge par notre extension VS Code GenAIScript, il permet aux utilisateurs de créer, déboguer et automatiser des scripts basés sur LLM.",
   "42FBD893AA9A93AD9F70": "Préambule",

packages/sample/genaisrc/mdtranslator.genai.mts

@@ -195,6 +195,28 @@ export default async function main() {
               dbg(`yaml node: %s`, nhash);
               const data = parsers.YAML(node.value);
               if (data) {
+                if (starlight) {
+                  if (Array.isArray(data?.hero?.actions)) {
+                    data.hero.actions.forEach((action) => {
+                      if (typeof action.text === "string") {
+                        const nhash = hashNode(action.text);
+                        const tr = translationCache[nhash];
+                        dbg(`yaml hero.action: %s -> %s`, nhash, tr);
+                        if (!tr) action.text = tr;
+                        else {
+                          const llmHash = `T${Object.keys(llmHashes).length.toString().padStart(3, "0")}`;
+                          llmHashes[llmHash] = nhash;
+                          llmHashTodos.add(llmHash);
+                          action.text = `┌${llmHash}┐${data.title}└${llmHash}┘`;
+                        }
+                      }
+                    });
+                  }
+                  if (data?.cover?.image) {
+                    data.cover.image = patchFn(data.cover.image);
+                    dbg(`yaml cover image: %s`, data.cover.image);
+                  }
+                }
                 if (typeof data.title === "string") {
                   const nhash = hashNode(data.title);
                   const tr = translationCache[nhash];
@@ -348,13 +370,29 @@ export default async function main() {
           if (node.type === "yaml") {
             const data = parsers.YAML(node.value);
             if (data) {
-              if (starlight && data?.hero?.image?.file) {
-                data.hero.image.file = patchFn(data.hero.image.file);
-                dbg(`yaml hero image: %s`, data.hero.image.file);
-              }
-              if (starlight && data?.cover?.image) {
-                data.cover.image = patchFn(data.cover.image);
-                dbg(`yaml cover image: %s`, data.cover.image);
+              if (starlight) {
+                if (data?.hero?.image?.file) {
+                  data.hero.image.file = patchFn(data.hero.image.file);
+                  dbg(`yaml hero image: %s`, data.hero.image.file);
+                }
+                if (Array.isArray(data?.hero?.actions)) {
+                  data.hero.actions.forEach((action) => {
+                    if (typeof action.text === "string") {
+                      const nhash = hashNode(action.text);
+                      const tr = translationCache[nhash];
+                      dbg(`yaml hero.action: %s -> %s`, nhash, tr);
+                      if (tr) action.text = tr;
+                    }
+                    if (action?.image?.file) {
+                      action.image.file = patchFn(action.image.file);
+                      dbg(`yaml hero action image: %s`, action.image.file);
+                    }
+                  });
+                }
+                if (data?.cover?.image) {
+                  data.cover.image = patchFn(data.cover.image);
+                  dbg(`yaml cover image: %s`, data.cover.image);
+                }
               }
               if (typeof data.title === "string") {
                 const nhash = hashNode(data.title);