# gt: General Translation CLI tool: gt generate URL: https://generaltranslation.com/es/docs/cli/reference/commands/generate.mdx Docs index: https://generaltranslation.com/llms.txt Description: Genera plantillas de origen para la traducción manual. Referencia de la API del comando gt generate. Genera archivos de plantilla locales para tu locale predeterminado y tus locales de destino. Úsalo cuando gestiones las traducciones por tu cuenta en lugar de usar la General Translation API. *Nota: Disponible cuando la CLI detecta `gt-next`, `gt-react`, `gt-react-native`, `gt-tanstack-start`, `gt-node`, `gt-vue`, `gt-flask` o `gt-fastapi`. No se registra en proyectos que no usen ninguna de estas bibliotecas. Si usas la General Translation API, utiliza [`gt translate`](/docs/cli/reference/commands/translate).* ## Descripción general [#overview] Primero configura el proyecto y después genera las plantillas: ```bash npx gt configure npx gt generate ``` ## Cómo funciona [#how-it-works] 1. Lee `gt.config.json` para determinar el locale predeterminado y los locales de destino, las rutas de origen, el diccionario y la ruta `files.gt.output`. 2. Usa el analizador de la biblioteca detectada para escanear el contenido inline y el diccionario configurado, del mismo modo en que [`gt translate`](/docs/cli/reference/commands/translate) recopila el contenido. 3. Sustituye la plantilla del locale predeterminado por las entradas de origen actuales. 4. Fusiona esas entradas en cada archivo de locale de destino. Se conservan los valores de destino existentes, las entradas nuevas usan el texto de origen y se eliminan las entradas obsoletas. El comando no llama a la General Translation API. Si `files.gt.output` no está configurado, escanea el proyecto, pero finaliza sin escribir ninguna plantilla. ## Flags [#flags] ### Flags de generación de plantillas | Parámetro | Descripción | Tipo | Opcional | Predeterminado | | ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | ---------- | -------- | -------------------------------------------------- | | `-c, --config ` | Ruta a `gt.config.json`. | `string` | Sí | `gt.config.json` detectado | | `--default-language, --default-locale ` | Locale predeterminado que se usa para la plantilla de origen. | `string` | Sí | Locale predeterminado del proyecto | | `--new, --locales ` | Locales de destino cuyos archivos de plantilla se fusionan. | `string[]` | Sí | Locales del proyecto | | `--src ` | Patrones glob para los archivos fuente. | `string[]` | Sí | Globs de `src`, `app`, `pages` y `components` | | `--dictionary ` | Ruta al archivo de diccionario. | `string` | Sí | — | | `--tsconfig, --jsconfig ` | Ruta a un archivo de configuración de TypeScript o JavaScript que se usa para resolver las importaciones del código fuente. | `string` | Sí | Configuración detectada o `./tsconfig.json` | | `--inline` | Incluye el contenido inline compatible con la biblioteca detectada. | `boolean` | Sí | `true` | | `--ignore-errors` | Ignora los errores encontrados al analizar el contenido inline. | `boolean` | Sí | `false` | ### Flags de compatibilidad aceptados El comando comparte su analizador con [`gt translate`](/docs/cli/reference/commands/translate), por lo que su salida de ayuda acepta los flags que se indican a continuación. Estos no afectan a la generación local de plantillas. En particular, `--dry-run` no impide la escritura de archivos. | Parámetro | Descripción | Tipo | Opcional | Valor predeterminado | | ----------------------------------------- | ----------------------------------------------------- | ------------------- | -------- | --------------------------- | | `--api-key ` | Se acepta, pero no se utiliza. | `string` | Sí | — | | `--project-id ` | Se acepta, pero no se utiliza. | `string` | Sí | — | | `--version-id ` | Se acepta, pero no se utiliza. | `string` | Sí | — | | `--dry-run` | Se acepta, pero no impide la escritura de plantillas. | `boolean` | Sí | `false` | | `--timeout ` | Se acepta, pero no se utiliza. | `number` | Sí | `900` | | `--save-local`, `--no-save-local` | Se acepta, pero no se utiliza. | `boolean` | Sí | Valor configurado o `false` | | `--publish` | Se acepta, pero no se utiliza. | `boolean` | Sí | `false` | | `--experimental-localize-static-urls` | Se acepta, pero no se utiliza. | `boolean` | Sí | `false` | | `--experimental-hide-default-locale` | Se acepta, pero no se utiliza. | `boolean` | Sí | `false` | | `--experimental-flatten-json-files` | Se acepta, pero no se utiliza. | `boolean` | Sí | `false` | | `--experimental-localize-static-imports` | Se acepta, pero no se utiliza. | `boolean` | Sí | `false` | | `--experimental-localize-relative-assets` | Se acepta, pero no se utiliza. | `boolean` | Sí | `false` | | `--force` | Se acepta, pero no se utiliza. | `boolean` | Sí | `false` | | `--force-download` | Se acepta, pero no se utiliza. | `boolean` | Sí | `false` | | `--omit-config-ids` | Se acepta, pero no se utiliza. | `boolean` | Sí | `false` | | `--experimental-clear-locale-dirs` | Se acepta, pero no se utiliza. | `boolean` | Sí | `false` | | `--branch ` | Se acepta, pero no se utiliza. | `string` | Sí | — | | `--disable-branch-detection` | Se acepta, pero no se utiliza. | `boolean` | Sí | `false` | | `--enable-branching` | Se acepta, pero no se utiliza. | `boolean` | Sí | `false` | | `--remote-name ` | Se acepta, pero no se utiliza. | `string` | Sí | `origin` | | `--tag [value]` | Se acepta, pero no se utiliza. | `string \| boolean` | Sí | — | | `-m, --message ` | Se acepta, pero no se utiliza. | `string` | Sí | — | ## Ejemplo [#example] ```bash # Generar plantillas para los locales configurados npx gt generate # Generar desde una configuración regional de origen personalizada, ignorando errores de escaneo npx gt generate --default-locale en-US --ignore-errors ``` ## Otras notas [#notes] Después de generar los archivos de plantilla, traduce los valores de destino y sírvelos mediante [traducciones locales](/docs/react/guides/storing-translations). Vuelve a ejecutar `generate` cada vez que cambie el contenido de origen y revisa los archivos de destino, ya que las entradas eliminadas del origen también se eliminan en ellos. ## Sitemap See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.