# gt-next: General Translation Next.js SDK: getGT
URL: https://generaltranslation.com/ru/docs/next/api/strings/get-gt.mdx
---
title: getGT
description: Справочник по API функции перевода строк getGT()
---

## Обзор

Функция `getGT` — асинхронная функция для перевода строк на этапе сборки.

```jsx
const gt = await getGT();

<p>{  gt('This text will be translated')  }</p>;
```

<Callout>
  **Перевод на этапе сборки:**
  Переводы `getGT` выполняются на этапе сборки, до развертывания приложения.
  Хотя в переводимую строку можно передавать переменные, переводить можно только содержимое, известное на этапе сборки.
</Callout>


## Справочник

### Параметры

Отсутствуют

### Возвращает

Промис, возвращающий функцию обратного вызова `gt`, которая переводит переданный контент.

```jsx
Promise<(content: string, options?: InlineTranslationOptions) => string>
```

| Название   | Тип                                                                           | Описание                                         |
| ---------- | ----------------------------------------------------------------------------- | ------------------------------------------------ |
| `content`  | `string`                                                                      | Строковое содержимое для перевода.               |
| `options?` | [`InlineTranslationOptions`](/docs/next/api/types/inline-translation-options) | Параметры перевода для настройки поведения `gt`. |

***


## Поведение

### Продакшен

В процессе CD любой контент в вызове функции `gt` переводится до развертывания приложения.
Это обеспечивает быструю загрузку для всех локалей, но переводить можно только контент, известный на этапе сборки.

После генерации переводы либо (1) сохраняются в CDN, либо (2) включаются в результаты сборки приложения — в зависимости от конфигурации.
После этого переведённый контент отдаётся пользователям.
Если перевод не найден, используется исходный контент.

Обязательно ознакомьтесь с [руководством по развертыванию](/docs/next/tutorials/quickdeploy).

### Разработка

Во время разработки функция `gt` будет переводить содержимое по запросу.
Это удобно для того, чтобы быстро проверить, как ваше приложение будет выглядеть на разных языках.
Не забудьте добавить Dev API key в переменные окружения, чтобы включить это поведение.

При переводе по запросу в режиме разработки будет заметна задержка.
В production-сборках этого не происходит, если только содержимое не переводится по запросу явно,
то есть с использованием [`tx`](/docs/next/api/strings/tx) или [`<Tx>`](/docs/next/api/components/tx).

***

## Пример

### Базовое использование

С помощью `getGT` можно переводить строки.

```javascript copy
import { getGT } from 'gt-next/server';

export default async function TranslateGreeting() {
  const gt = await getGT();

  return (
    <p>
      {gt('Hello, Alice!')}
    </p>
  );
}
```

Примечание: &quot;Alice&quot; будет переведено на предпочитаемый пользователем язык.


### Использование переменных [#variables]

Вы можете передавать переменные в переводы из словаря.

```javascript copy
import { getGT } from 'gt-next/server';

export default async function TranslateGreeting() {
  const gt = await getGT();

  return (
    <p>
      {gt('Hello, {name}!', { name: 'Alice' })}
    </p>
  );
}
```

Примечание: &quot;Alice&quot; не будет переведено на предпочитаемый пользователем язык, поскольку это переменная.


### Перевод метаданных страницы [#metadata]

Используйте `getGT` в `generateMetadata` Next.js, чтобы переводить заголовки страниц, описания и теги Open Graph.

```javascript copy
import { getGT } from 'gt-next/server';
import { Metadata } from 'next';

export async function generateMetadata(): Promise<Metadata> {
  const gt = await getGT();
  return {
    title: gt('My App'),
    description: gt('A fast, modern web application'),
    openGraph: {
      title: gt('My App'),
      description: gt('A fast, modern web application'),
    },
  };
}
```


### Использование формата сообщений ICU

`gt-next` поддерживает формат сообщений ICU, который также позволяет форматировать значения переменных.

```javascript copy
import { getGT } from 'gt-next/server';

export default async function TranslateGreeting() {
  const gt = await getGT();
  return (
    <p>
      {gt('There are {count, plural, =0 {no items} =1 {one item} other {{count} items}} in the cart', { count: 10 })}
    </p>
  );
}
```

<Callout>
  Формат сообщений ICU — это удобный и мощный способ форматировать переменные.
  Подробнее см. в [документации по формату сообщений ICU](https://unicode-org.github.io/icu/userguide/format_parse/messages/).
</Callout>

***


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

* Функция `getGT` — серверная: она переводит строки.
* Перевод строк с помощью `getGT` выполняется до времени выполнения, на этапе сборки (кроме режима разработки).

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

* См. [`useGT`](/docs/next/api/strings/use-gt) для перевода строк на стороне клиента на этапе сборки.
* О переводе во время выполнения см. [`tx`](/docs/next/api/strings/tx) и [`<Tx>`](/docs/next/api/components/tx).