# General Translation Integrations: paraglide-context URL: https://generaltranslation.com/fr/docs/integrations/paraglide/reference/paraglide-context.mdx Docs index: https://generaltranslation.com/llms.txt Description: Enregistre dans des fichiers de métadonnées le code source entourant chaque utilisation d’un message Paraglide JS. Référence de l’API de la commande paraglide-context. La commande est installée avec `@generaltranslation/paraglide-js`. Chaque exécution analyse l’application, écrit les fichiers de métadonnées, puis se termine. Exécutez-la avant [`gt translate`](/docs/cli/reference/commands/translate). ## Vue d’ensemble [#overview] ```bash npx paraglide-context [root] [options] ``` `root` désigne le projet, ou l'un de ses répertoires. Par défaut, il s'agit du répertoire de travail. Tous les chemins passés aux options sont relatifs à la racine du projet : le `package.json` le plus proche, au niveau de `root` ou au-dessus. [`collectContext`](/docs/integrations/paraglide/reference/collect-context) fait la même chose depuis le code et accepte les mêmes options. ## Fonctionnement [#how-it-works] * Sélectionne les fichiers sources, résout leurs importations et repère chaque utilisation d’un message Paraglide JS. (Voir [Détection des utilisations](/docs/integrations/paraglide/reference/usage-detection).) * Écrit un fichier de métadonnées à côté de chaque fichier de messages du paramètre régional de base, par exemple `messages/en.metadata.json`. (Voir [Fichiers de métadonnées](/docs/integrations/paraglide/reference/metadata-files).) * N’exécute jamais le bundler de l’application. Les alias d’importation sont lus dans `tsconfig.json`, `package.json` et dans une configuration Vite, webpack ou rspack. * Affiche un avertissement pour chaque élément ignoré. Les avertissements n’affectent pas le code de sortie. ## Options [#flags] Chaque option de ligne de commande définit une option de [`collectContext`](/docs/integrations/paraglide/reference/collect-context#options), dont le comportement y est documenté en détail. Pour transmettre plusieurs valeurs, répétez une option marquée *répétable*. | Paramètre | Description | Type | Facultatif | Par défaut | | --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | ---------- | -------------------------------- | | `[root]` | Le projet, ou l’un de ses répertoires. Définit [`root`](/docs/integrations/paraglide/reference/collect-context#root). | `string` | Oui | Répertoire de travail | | `--include ` | Chemin ou glob à analyser. Répétable. Définit [`include`](/docs/integrations/paraglide/reference/collect-context#include). | `string[]` | Oui | L’ensemble du projet | | `--exclude ` | Chemin ou glob à ignorer. Répétable. Définit [`exclude`](/docs/integrations/paraglide/reference/collect-context#exclude). | `string[]` | Oui | Tests et configurations d’outils | | `--outdir ` | Répertoire de sortie Paraglide JS à utiliser sans vérification. Répétable. Définit [`outdirs`](/docs/integrations/paraglide/reference/collect-context#outdirs). | `string[]` | Oui | Détecté | | `--project ` | Projet inlang dont les messages reçoivent des fichiers de métadonnées. Répétable. Définit [`inlangProjects`](/docs/integrations/paraglide/reference/collect-context#inlang-projects). | `string[]` | Oui | Détecté | | `--alias ` | Alias d’importation, par exemple `~=./src`. Un remplacement commençant par `.` se résout à partir de la racine du projet. Répétable. Définit [`alias`](/docs/integrations/paraglide/reference/collect-context#alias). | `string[]` | Oui | — | | `--no-bundler-config` | Ne lit pas les alias depuis une configuration de bundler. Définit [`bundlerConfigs`](/docs/integrations/paraglide/reference/collect-context#bundler-configs) sur `[]`. | `boolean` | Oui | `false` | | `--radius ` | Nombre de lignes de contexte au-dessus et au-dessous de chaque utilisation. Entier positif ou nul. Définit [`radius`](/docs/integrations/paraglide/reference/collect-context#radius). | `number` | Oui | `10` | | `--verbose` | Affiche un résumé : les utilisations trouvées, les fichiers analysés, les répertoires de sortie utilisés et la configuration dont les alias ont été lus. | `boolean` | Oui | `false` | | `-h, --help` | Affiche l’aide d’utilisation. | `boolean` | Oui | `false` | Les options `targets`, `languages`, `autoImports`, `conditions` et `rootDirectory` n’ont pas d’équivalent en ligne de commande. Définissez-les via [`collectContext`](/docs/integrations/paraglide/reference/collect-context). ## Exemple [#example] ```bash # Analyser l'application du répertoire de travail npx paraglide-context # Analyser une seule application d'un monorepo, avec un résumé npx paraglide-context apps/web --verbose # Analyser src et un paquet partagé, avec 5 lignes de contexte npx paraglide-context --include src --include ../shared --radius 5 # Déclarer un alias et ignorer la configuration du bundler npx paraglide-context --alias ~=./src --no-bundler-config ``` ## Autres remarques [#notes] | Code de sortie | Signification | | -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `0` | L’exécution s’est terminée, avec ou sans avertissements. | | `1` | Une erreur a interrompu l’exécution, par exemple l’impossibilité d’écrire un fichier de métadonnées. L’erreur est affichée. | | `2` | Option inconnue, valeur manquante, plusieurs `root` ou valeur de `--radius` qui n’est pas un entier positif ou nul. Le texte d’aide à l’utilisation est affiché. | * Les avertissements commencent par `[paraglide-context]` et sont envoyés vers la sortie d’erreur standard. * Un fichier de métadonnées n’est écrit que si son contenu change. Une deuxième exécution sans modification de la source n’écrit donc rien. ## Sitemap See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.