# General Translation Platform: Быстрый старт
URL: https://generaltranslation.com/ru/docs/platform/core/quickstart.mdx
---

title: Быстрый старт
description: Узнайте, для чего нужна базовая библиотека `generaltranslation`, когда ее использовать и как перевести свою первую строку.
related:
  links:
    - /docs/platform/core/guides/translating-strings
    - /docs/platform/core/guides/translating-files
    - /docs/platform/core/guides/locale-codes

---

`generaltranslation` — это базовая i18n-библиотека General Translation для перевода, форматирования и утилит для работы с локалями.

В большинстве приложений на фреймворках стоит начинать с [gt-react or gt-next](/docs/react/overview). Используйте `generaltranslation` напрямую, если вам нужен более низкоуровневый контроль, собственный процесс работы или утилиты перевода вне интеграции с фреймворком.

## Что делает `generaltranslation` [#what-it-does]

`generaltranslation` даёт вам прямой доступ к:

* **Переводу строк** для перевода строк или структурированного контента из кода.
* **Переводу файлов** для загрузки исходных файлов, постановки задач перевода в очередь, проверки статуса и скачивания переведённого результата.
* **Утилитам локалей** для проверки, сравнения, определения и отображения кодов локалей.
* **Утилитам форматирования** для локалезависимых чисел, дат, сообщений, списков и относительного времени.

## Когда использовать `generaltranslation` [#when-to-use]

Используйте `generaltranslation`, если вам нужно:

* Переводить контент из скрипта, серверного сервиса, воркера или пользовательского шага сборки.
* Загружать и скачивать файлы перевода без использования CLI.
* Настраивать собственную автоматизацию перевода для файлов Project, задач, веток или тегов.
* Форматировать числа, даты, сообщения или названия локалей вне React или Next.js.
* Повторно использовать поведение GT в пакетах, которые работают с разными фронтенд-фреймворками.

## Быстрый старт [#quickstart]

Установите `generaltranslation`, создайте экземпляр [GT](/docs/platform/core/reference/gt-class/constructor) с вашим идентификатором проекта и API-ключом и переведите свою первую строку.

### 1. Установите `generaltranslation`

<Tabs items={['npm', 'yarn', 'bun', 'pnpm']}>
  <Tab value="npm">
    ```bash
    npm install generaltranslation
    ```
  </Tab>

  <Tab value="yarn">
    ```bash
    yarn add generaltranslation
    ```
  </Tab>

  <Tab value="bun">
    ```bash
    bun add generaltranslation
    ```
  </Tab>

  <Tab value="pnpm">
    ```bash
    pnpm add generaltranslation
    ```
  </Tab>
</Tabs>

### 2. Получите API-ключ

Создайте `GT_PROJECT_ID` и `GT_API_KEY` в Dashboard. Откройте [страницу API Keys](https://dash.generaltranslation.com/api-keys), нажмите **Create API Key**, введите имя и подтвердите.

```bash
GT_PROJECT_ID=your-project-id
GT_API_KEY=your-api-key
```

General Translation предлагает щедрые бесплатные лимиты запросов для личных проектов, независимых разработчиков и сообщества.

### 3. Инициализируйте класс GT

Инициализируйте класс [GT](/docs/platform/core/reference/gt-class/constructor) и безопасно передайте `GT_PROJECT_ID` и `GT_API_KEY`.

```typescript title="src/index.ts"
import { GT } from 'generaltranslation';

const gt = new GT({
  projectId: 'your-project-id',
  apiKey: 'your-api-key',
});
```

Вы можете настроить локали по умолчанию в экземпляре [GT](/docs/platform/core/reference/gt-class/constructor). Используйте локали по умолчанию, если в большинстве вызовов применяется одна и та же исходная или целевая локаль.

```typescript title="src/index.ts"
const gt = new GT({
  projectId: 'your-project-id',
  apiKey: 'your-api-key',
  sourceLocale: 'en',
  targetLocale: 'es',
});
```

См. [класс GT](/docs/platform/core/reference/gt-class/constructor), чтобы узнать обо всех параметрах конструктора.

### 4. Переведите первую строку

Вызовите метод [translate](/docs/platform/core/reference/gt-class-methods/translation/translate), чтобы перевести первую строку. Передайте строку, которую хотите перевести, и целевую локаль.

```typescript title="src/index.ts"
const result = await gt.translate('Hello, world!', 'es');

if (result.success) {
  console.log(result.translation); // "¡Hola, mundo!"
} else {
  console.error(`Translation failed: ${result.error}`);
}
```

Для методов перевода требуются API-ключ и идентификатор проекта. Средства форматирования и работы с локалями можно использовать без доступа к API перевода.
## Next steps

- /docs/platform/core/guides/translating-strings
- /docs/platform/core/guides/translating-files
- /docs/platform/core/guides/locale-codes