> For AI agents: the complete documentation index is available at /rspress-russian/llms.txt, the full documentation bundle is available at /rspress-russian/llms-full.txt.

# useI18n

`useI18n` позволяет читать локализованный текст внутри пользовательских компонентов, используя настроенный источник. Подробности см. в [config.i18nSource](/rspress-russian/api/config/config-basic.md#i18nsource).

Rspress предоставляет хук [`useI18n`](/rspress-russian/ui/hooks/use-i18n.md) для получения текста на нужном языке. Использование выглядит следующим образом:

```tsx
import { useI18n } from '@rspress/core/runtime';

const MyComponent = () => {
  const t = useI18n();

  return <div>{t('gettingStarted')}</div>;
};
```

Если вы используете `i18n.json`, вы можете настроить `paths` в `tsconfig.json` для более удобных подсказок типов:

```json
{
  "compilerOptions": {
    "paths": {
      "i18n": ["./i18n.json"]
    }
  }
}
```

Затем используйте это следующим образом в компоненте:

```tsx
import { useI18n } from '@rspress/core/runtime';

const MyComponent = () => {
  const t = useI18n<typeof import('i18n')>();

  return <div>{t('gettingStarted')}</div>;
};
```

Таким образом вы получаете подсказки типов для всех текстовых ключей, определённых в `i18n.json`.
