# gt-react: General Translation React SDK: gt.config.json
URL: https://generaltranslation.com/ru/docs/react/api/config/gt-config-json.mdx
---
title: gt.config.json
description: Файл gt.config.json
---

{/* АВТОМАТИЧЕСКИ СГЕНЕРИРОВАНО: Не редактируйте напрямую. Вместо этого отредактируйте шаблон в content/docs-templates/. */}


## Обзор

Файл `gt.config.json` хранит конфигурацию вашего проекта.
В нём содержится важная информация, такая как `projectId` проекта, поддерживаемые локали и многое другое.
Он также содержит важные внутренние данные, например `versionId` проекта.

Этот файл используется (1) компонентом [`<GTProvider>`](/docs/react/api/components/gtprovider) и (2) командой [`gt translate`](/docs/cli/translate).
Поэтому мы рекомендуем хранить конфигурацию в файле `gt.config.json`, а не передавать её через prop в компонент [`<GTProvider>`](/docs/react/api/components/gtprovider).

Как правило, всё, что начинается с подчёркивания (например, `_versionId`), — это внутреннее свойство, и изменять его не следует.
Всё остальное можно менять.

***

## Поля

| Поле                | Тип        | Описание                                                                         |
| ------------------- | ---------- | -------------------------------------------------------------------------------- |
| `projectId`         | `string`   | Уникальный идентификатор вашего проекта в системе GT                             |
| `locales`           | `string[]` | Массив поддерживаемых кодов локалей проекта                                      |
| `defaultLocale`     | `string`   | Основной код локали, используемый как резервный вариант при отсутствии переводов |
| `cacheUrl`          | `string`   | URL конечной точки для кэширования данных перевода                               |
| `runtimeUrl`        | `string`   | URL конечной точки для сервисов перевода во время выполнения                     |
| `stageTranslations` | `boolean`  | Настройка функций перевода для staging/preview                                   |
| `files`             | `object`   | Путь к локальным файлам перевода для разработки и тестирования                   |
| `_versionId`        | `string`   | Внутреннее свойство для отслеживания версии проекта (не изменяйте)               |

### `cacheUrl` и `runtimeUrl`

Если вы храните переводы в облаке, `cacheUrl` — это базовый URL кэша.
`runtimeUrl` — это базовый URL для времени выполнения и используется только для переводов в режиме разработки.

### `stageTranslations`

`stageTranslations` — это флаг, который инструмент `gt` использует, чтобы помечать ваши переводы как требующие проверки.
Это означает, что их нужно утвердить вручную, прежде чем их можно будет развернуть в продакшене с помощью команды [`gt translate`](/docs/cli/translate).

### `files`

Поле `files` указывает путь к переводам, хранящимся локально (в отличие от хранения в облаке).
В частности, поле `output` указывает, куда будут записываться переводы.

```json
{
  "files": {
    "gt": {
      "output": "public/_gt/[locale].json"
    }
  },
}
```

Дополнительную информацию о том, как использовать поле `files`, см. в [документации по конфигурации CLI](/docs/cli/reference/config).


#### `parsingFlags`

Объект `files.gt.parsingFlags` определяет, как компилятор разбирает ваши исходные файлы.

| Флаг                     | Тип       | По умолчанию | Описание                                                                                                                                                                                           |
| ------------------------ | --------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `enableAutoJsxInjection` | `boolean` | `false`      | Автоматически оборачивает переводимый текст JSX в компоненты перевода на этапе сборки. См. [автоматическую инъекцию JSX](/docs/cli/features/auto-jsx-injection).                                   |
| `autoderive`             | `boolean` | `false`      | Автоматически рассматривает интерполированные значения в вызовах `t()`, `gt()` и `msg()` как вызовы [`derive()`](/docs/react/api/strings/derive). См. [autoderive](/docs/cli/features/autoderive). |

```json title="gt.config.json"
{
  "files": {
    "gt": {
      "output": "public/_gt/[locale].json",
      "parsingFlags": {
        "enableAutoJsxInjection": true,
        "autoderive": true
      }
    }
  }
}
```

{/* 
    ### `_versionId`

    Что важно:
    - внутренний параметр
    - можно указывать собственные названия версий */}

***

## Примеры

### Указание локалей

```json title="gt.config.json"
{
  "defaultLocale": "en", // Основная локаль — английский
  "locales": ["fr", "es"] // Дополнительные локали — французский и испанский
}
```

{/* ### Указание собственного versionId */}

***


## Примечания

* Файл `gt.config.json` используется для задания конфигурации проекта.
* Его читают и компонент [`<GTProvider>`](/docs/react/api/components/gtprovider), и команда [`gt translate`](/docs/cli/translate).
* Его следует разместить в корне проекта.

## Следующие шаги