Документация: Использование TacoTranslate

Использование TacoTranslate

Russian

Перевод строк

В настоящее время существует три способа перевода строк: компонент Translate, хук useTranslation, или утилита translateEntries.

Использование компонента Translate.
Выводит переводы внутри элемента span, и поддерживает рендеринг HTML.

import {Translate} from 'tacotranslate/react';

function Page() {
	return <Translate string="Hello, world!" />;
}

Вы можете изменить тип элемента, используя, например, as="p" в компоненте.

Использование хука useTranslation.
Возвращает переводы в виде простой строки. Полезно, например, в meta тегах.

import {useEffect} from 'react';
import {useTranslation} from 'tacotranslate/react';

function Page() {
	const helloWorld = useTranslation('Hello, world!');

	useEffect(() => {
		alert(helloWorld);
	}, [helloWorld]);

	return (
		<title>{useTranslation('My page title')}</title>
	);
}

Использование утилиты translateEntries.
Переводите строки на стороне сервера. Ускорьте ваши OpenGraph изображения.

import {createEntry, translateEntries} from 'tacotranslate';

async function generateMetadata(locale = 'es') {
	const title = createEntry({string: 'Hello, world!'});
	const description = createEntry({string: 'TacoTranslate on the server'});

	const translations = await translateEntries(
		tacoTranslate,
		{origin: 'opengraph', locale},
		[title, description]
	);

	return {
		title: translations(title),
		description: translations(description)
	};
}

Когда строки доходят до наших серверов, мы сначала их проверяем и сохраняем, а затем сразу возвращаем машинный перевод. Хотя машинные переводы, как правило, имеют более низкое качество по сравнению с нашими ИИ-переводами, они предоставляют быстрый первоначальный ответ.

Одновременно мы инициируем асинхронную задачу перевода для генерации качественного, современного AI-перевода для вашей строки. Как только AI-перевод будет готов, он заменит машинный перевод и будет отправлен каждый раз, когда вы запрашиваете переводы для ваших строк.

Если вы вручную перевели строку, эти переводы имеют приоритет и возвращаются вместо этого.

Использование источников

Проекты TacoTranslate содержат то, что мы называем источниками. Думайте о них как о входных точках, папках или группах для ваших строк и переводов.

import {TacoTranslate} from 'tacotranslate/react';

function Menu() {
	return (
		<TacoTranslate origin="application-menu">
			// ...
		</TacoTranslate>
	);
}

Происхождение позволяет вам разделить строки на значимые контейнеры. Например, у вас может быть одно происхождение для документации и другое для вашей маркетинговой страницы.

Для более детального контроля вы можете настроить источники на уровне компонента.

Чтобы достичь этого, рассмотрите возможность использования нескольких TacoTranslate провайдеров в вашем проекте.

Пожалуйста, обратите внимание, что одна и та же строка может иметь разные переводы в разных источниках.

В конечном итоге, как вы разделяете строки на источники, зависит от вас и ваших потребностей. Однако имейте в виду, что наличие большого количества строк в одном источнике может увеличить время загрузки.

Обработка переменных

Вы всегда должны использовать переменные для динамического контента, такого как имена пользователей, даты, адреса электронной почты и многое другое.

Переменные в строках объявляются с использованием двойных скобок, как {{variable}}.

import {Translate} from 'tacotranslate/react';

function Greeting() {
	const name = 'Juan';
	return <Translate string="Hello, {{name}}!" variables={{name}} />;
}

import {useTranslation} from 'tacotranslate/react';

function useGreeting() {
	const name = 'Juan';
	return useTranslation('Hello, {{name}}!', {variables: {name}});
}

Управление HTML-контентом

По умолчанию компонент Translate поддерживает и отображает HTML-контент. Однако вы можете отказаться от этого поведения, установив useDangerouslySetInnerHTML в false.

Отключение рендеринга HTML настоятельно рекомендуется при переводе ненадежного контента, такого как контент, созданный пользователями.

Все выходные данные всегда очищаются с помощью sanitize-html перед рендерингом.

import {Translate} from 'tacotranslate/react';

function Page() {
	return (
		<Translate
			string={`
				Welcome to <strong>my</strong> website.
				I’m using <a href="{{url}}">TacoTranslate</a> to translate text.
			`}
			variables={{url: 'https://tacotranslate.com'}}
			useDangerouslySetInnerHTML={false}
		/>
	);
}

Приведенный выше пример будет отображаться как простой текст.

Серверная отрисовка

Использование TacoTranslate

Как строки переводятся

Использование источников

Обработка переменных

Управление HTML-контентом