Analyse

Analyse votre projet à la recherche de contenu traduisible

Utilisation

npx gtx-cli scan

Aperçu

La commande gtx-cli scan analyse votre projet pour détecter le contenu traduisible. Elle fait cela en analysant l'arborescence des fichiers de votre projet et en utilisant babel pour envelopper le composant <T> autour du contenu statique. Tout contenu dynamique sera automatiquement enveloppé avec des composants <Var>.

Cette commande est similaire à la commande setup, mais elle est plus directe et ne fait qu'envelopper le composant <T> autour du contenu.

Elle n'ajoute pas d'autres composants comme <GTProvider>. Ainsi, nous recommandons d'exécuter cette commande occasionnellement pour s'assurer que tout le contenu de votre projet est traduisible.

Vous devriez exécuter setup la première fois que vous intégrez General Translation dans votre projet.

src/app/Home.js
import { T, Var } from 'gt-next'; 

export default function Home({ user }) {
  return (
    <div>
      <T id="app.home.0">
        Hello, world! My name is <Var>{ user.name }</Var>
      </T>
    </div>
  );
}

Paramètres

ParamètreDescriptionTypeOptionnelPar défaut
--src <path>Le répertoire source à analyserstringtrue./src && ./app && ./pages && ./components
--config <path>Le chemin vers le fichier de configuration GTstringtrue"gt.config.json"
--disable-idsDésactive la génération automatique d'IDs pour les composants <T>flagtruefalse
--disable-formattingDésactive le formatage automatiqueflagtruefalse

Comportement

La prop id

La commande scan génèrera automatiquement des IDs uniques pour vos composants <T>. Ceci est utile pour les projets qui utilisent beaucoup de composants <T> et veulent éviter d'avoir à assigner manuellement un ID unique à chacun.

Cet id est utile pour référencer des traductions spécifiques dans l'éditeur de traduction et dans la console.

Pour désactiver ce comportement, vous pouvez utiliser le flag --disable-ids.

Comportement d'injection <T>

Cas de base

Le CLI enveloppera les éléments JSX au niveau le plus élevé possible. Cela signifie qu'il enveloppera l'ensemble du composant dans un composant <T> s'il n'est pas déjà enveloppé.

<div>Hello, world!</div> -> <T id="SOME_ID"><div>Hello, world!</div></T>

Voir la référence pour plus de détails sur la façon dont le composant <T> est enveloppé.

Formatage automatique

La commande scan formatera automatiquement les modifications qu'elle apporte à votre base de code avec Prettier, Biome, ou ESLint selon la configuration de votre projet.

Pour désactiver ce comportement, vous pouvez utiliser le flag --disable-formatting.

Comment trouvez-vous ce guide ?