# gt: General Translation CLI tool: gt generate
URL: https://generaltranslation.com/ru/docs/cli/reference/commands/generate.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Генерирует исходные шаблоны для ручного перевода. Справочник API по команде gt generate.

Генерирует локальные файлы шаблонов для локали по умолчанию и целевых локалей. Используйте эту команду, если вы переводите контент самостоятельно, а не через General Translation API.

*Примечание: команда доступна, если CLI обнаруживает `gt-next`, `gt-react`, `gt-react-native`, `gt-tanstack-start`, `gt-node`, `gt-vue`, `gt-flask` или `gt-fastapi`. В проектах, где нет ни одной из этих библиотек, она не регистрируется. Если вы используете General Translation API, используйте вместо неё [`gt translate`](/docs/cli/reference/commands/translate).*

## Обзор [#overview]

Сначала настройте проект, а затем сгенерируйте шаблоны:

```bash
npx gt configure
npx gt generate
```

## Как это работает [#how-it-works]

1. Считывает `gt.config.json`, чтобы определить локаль по умолчанию и целевые локали, пути к исходным файлам, словарь и путь `files.gt.output`.
2. С помощью парсера обнаруженной библиотеки сканирует встроенный контент и настроенный словарь — так же, как это делает [`gt translate`](/docs/cli/reference/commands/translate) при сборе контента.
3. Заменяет шаблон для локали по умолчанию текущими исходными записями.
4. Объединяет эти записи с файлом каждой целевой локали: существующие целевые значения сохраняются, для новых записей используется исходный текст, а устаревшие записи удаляются.

Команда не обращается к General Translation API. Если `files.gt.output` не настроен, она сканирует проект, но завершает работу, не создавая шаблон.

## Флаги [#flags]

### Флаги генерации шаблонов

| Параметр                                        | Описание                                                                                                         | Тип        | Необязательно | По умолчанию                                             |
| ----------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | ---------- | ------------- | -------------------------------------------------------- |
| `-c, --config <path>`                           | Путь к `gt.config.json`.                                                                                         | `string`   | Да            | Обнаруженный `gt.config.json`                            |
| `--default-language, --default-locale <locale>` | Локаль по умолчанию для исходного шаблона.                                                                       | `string`   | Да            | Настроенная локаль по умолчанию                          |
| `--new, --locales <locales...>`                 | Целевые локали, файлы шаблонов которых подвергаются слиянию.                                                     | `string[]` | Да            | Настроенные локали                                       |
| `--src <paths...>`                              | Glob-шаблоны для исходных файлов.                                                                                | `string[]` | Да            | Glob-шаблоны для `src`, `app`, `pages` и `components`    |
| `--dictionary <path>`                           | Путь к файлу словаря.                                                                                            | `string`   | Да            | —                                                        |
| `--tsconfig, --jsconfig <path>`                 | Путь к конфигурационному файлу TypeScript или JavaScript, используемому для разрешения импортов в исходном коде. | `string`   | Да            | Обнаруженный конфигурационный файл или `./tsconfig.json` |
| `--inline`                                      | Учитывать встроенный контент, поддерживаемый обнаруженной библиотекой.                                           | `boolean`  | Да            | `true`                                                   |
| `--ignore-errors`                               | Игнорировать ошибки, найденные при сканировании встроенного контента.                                            | `boolean`  | Да            | `false`                                                  |

### Поддерживаемые флаги совместимости

Команда использует тот же парсер, что и [`gt translate`](/docs/cli/reference/commands/translate), поэтому принимает перечисленные ниже флаги, и они отображаются в её справке. На локальную генерацию шаблонов они не влияют. В частности, `--dry-run` не отключает запись файлов.

| Параметр                                  | Описание                                      | Тип                 | Необязательно | По умолчанию                         |
| ----------------------------------------- | --------------------------------------------- | ------------------- | ------------- | ------------------------------------ |
| `--api-key <key>`                         | Принимается, но не используется.              | `string`            | Да            | —                                    |
| `--project-id <id>`                       | Принимается, но не используется.              | `string`            | Да            | —                                    |
| `--version-id <id>`                       | Принимается, но не используется.              | `string`            | Да            | —                                    |
| `--dry-run`                               | Принимается, но не отключает запись шаблонов. | `boolean`           | Да            | `false`                              |
| `--timeout <seconds>`                     | Принимается, но не используется.              | `number`            | Да            | `900`                                |
| `--save-local`, `--no-save-local`         | Принимается, но не используется.              | `boolean`           | Да            | Значение из конфигурации или `false` |
| `--publish`                               | Принимается, но не используется.              | `boolean`           | Да            | `false`                              |
| `--experimental-localize-static-urls`     | Принимается, но не используется.              | `boolean`           | Да            | `false`                              |
| `--experimental-hide-default-locale`      | Принимается, но не используется.              | `boolean`           | Да            | `false`                              |
| `--experimental-flatten-json-files`       | Принимается, но не используется.              | `boolean`           | Да            | `false`                              |
| `--experimental-localize-static-imports`  | Принимается, но не используется.              | `boolean`           | Да            | `false`                              |
| `--experimental-localize-relative-assets` | Принимается, но не используется.              | `boolean`           | Да            | `false`                              |
| `--force`                                 | Принимается, но не используется.              | `boolean`           | Да            | `false`                              |
| `--force-download`                        | Принимается, но не используется.              | `boolean`           | Да            | `false`                              |
| `--omit-config-ids`                       | Принимается, но не используется.              | `boolean`           | Да            | `false`                              |
| `--experimental-clear-locale-dirs`        | Принимается, но не используется.              | `boolean`           | Да            | `false`                              |
| `--branch <branch>`                       | Принимается, но не используется.              | `string`            | Да            | —                                    |
| `--disable-branch-detection`              | Принимается, но не используется.              | `boolean`           | Да            | `false`                              |
| `--enable-branching`                      | Принимается, но не используется.              | `boolean`           | Да            | `false`                              |
| `--remote-name <name>`                    | Принимается, но не используется.              | `string`            | Да            | `origin`                             |
| `--tag [value]`                           | Принимается, но не используется.              | `string \| boolean` | Да            | —                                    |
| `-m, --message <message>`                 | Принимается, но не используется.              | `string`            | Да            | —                                    |

## Пример [#example]

```bash
# Генерация шаблонов для настроенных локалей
npx gt generate

# Генерация из пользовательской исходной локали с игнорированием ошибок сканирования
npx gt generate --default-locale en-US --ignore-errors
```

## Прочие замечания [#notes]

Сгенерировав файлы шаблонов, переведите целевые значения и подключите их с помощью [локального перевода](/docs/react/guides/storing-translations). Повторно запускайте `generate` при каждом изменении исходного содержимого и проверяйте целевые файлы: записи, удалённые из исходного кода, удаляются и из них.

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.