TacoTranslate
/
Баримт бичигҮнийн мэдээлэл
 
  1. Танилцуулга
  2. Эхлэх
  3. Тохиргоо ба суулгалт
  4. TacoTranslate ашиглах
  5. Серверийн талаас рендерлэх
  6. Дэвшилтэт ашиглалт
  7. Хамгийн сайн туршлагууд
  8. Алдааг боловсруулах ба программын алдааг тодорхойлох
  9. Дэмжигдсэн хэлүүд

TacoTranslate ашиглах

Тэмдэгт мөрүүдийг орчуулах

Одоо мөрүүдийг орчуулах гурван арга байна: Translate компонент, useTranslation hook, эсвэл translateEntries хэрэгсэл.


Translate бүрэлдэхүүн хэсгийг ашиглах.
span элемент дотор орчуулгыг гаргаж, HTML-г дүрслэхийг дэмждэг.

import {Translate} from 'tacotranslate/react';

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

Та элементийн төрлийг, жишээ нь, бүрэлдэхүүн хэсэг дээр as="p" ашиглан өөрчилж болно.


useTranslation hook-г ашиглах.
Орчуулгыг энгийн текст хэлбэрээр буцаана. Жишээлбэл, 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) орчуулгыг үүсгэх асинхрон орчуулгын ажлыг эхлүүлдэг. AI орчуулга бэлэн болсны дараа машин орчуулгыг орлуулж, таны хүргүүлсэн орчуулгын хүсэлт бүрт илгээх болно.

Хэрэв та тэмдэгт мөрийг гарын авлагаар орчуулсан бол энэ орчуулгууд давуу эрхтэй бөгөөд оронд нь буцаж ирнэ.

Эх сурвалжийг ашиглах

TacoTranslate төслүүд нь бид origins гэж нэрлэдэг зүйлийг агуулдаг. Үүнийг таны тэмдэгтүүд болон орчуулгуудын орц, хавтас эсвэл бүлгүүд гэж төсөөлөөрэй.

import {TacoTranslate} from 'tacotranslate/react';

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

Origins нь таны мессежүүдийг утга учиртай саванд хуваах боломж олгодог. Жишээлбэл, таны нэг origin нь баримт бичигт зориулагдаж, нөгөө origin нь маркетингийн хуудсанд зориулагдаж болно.

Илүү нарийвчлалтай хяналт хийхийн тулд та компонентын түвшинд origins-г тохируулж болно.

Үүнийг хэрэгжүүлэхийн тулд төсөлдөө олон 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}
		/>
	);
}

Дээрх жишээ энгийн текст хэлбэрээр харуулах болно.

Серверийн талаас рендерлэх

Nattskiftet-ийн бүтээгдэхүүн