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}
/>
);
}
Дээрх жишээ энгийн текст хэлбэрээр харуулах болно.