# General Translation Platform: Перевод строк
URL: https://generaltranslation.com/ru/docs/platform/core/guides/translating-strings.mdx
---
title: Перевод строк
description: Как переводить строки, наборы строк и структурированный контент напрямую из кода с помощью библиотеки generaltranslation.
related:
  links:
    - /docs/platform/core/guides/translating-files
    - /docs/platform/core/guides/locale-codes

---

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

Используйте перевод строк, если вашему приложению, скрипту или сервису нужен переведённый контент во время выполнения, а не перевод целого файла.

## Прежде чем начать [#before-start]

Убедитесь, что вы прошли [руководство по быстрому старту](/docs/platform/core/quickstart), чтобы установить `generaltranslation` и инициализировать класс [GT](/docs/platform/core/reference/gt-class/constructor).

## Перевести одну строку [#translate-one-string]

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

Если у вашего экземпляра [GT](/docs/platform/core/reference/gt-class/constructor) задан [targetLocale](/docs/platform/core/reference/types/gt-constructor-params), целевую локаль можно не указывать при вызове метода. Это удобно, если скрипт или сервис переводит много строк в одну и ту же локаль.

```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}`);
}
```

Подробнее см. в описании метода [translate](/docs/platform/core/reference/gt-class-methods/translation/translate).

## Перевод нескольких строк [#translate-many-strings]

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

```typescript title="src/index.ts"
const results = await gt.translateMany(
  ['Hello, world!', 'Welcome to our app', 'Click here to continue'],
  'es'
);
```

Подробнее см. в описании метода [translateMany](/docs/platform/core/reference/gt-class-methods/translation/translate-many).

## Добавьте контекст с помощью метаданных исходного текста [#add-context-source]

Используйте метаданные, когда строке нужен дополнительный контекст.

```typescript title="src/index.ts"
const result = await gt.translate(
  {
    source: 'Cells',
    metadata: {
      context: 'Spreadsheet column header',
    },
  },
  'es'
);
```

Метаданные полезны для неоднозначных слов, подписей в интерфейсе, специфичных для продукта терминов и строк, смысл которых трудно понять без контекста.
## Next steps

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