Að nota TacoTranslate
Þýða strengi
Það eru núna þrjár leiðir til að þýða strengji: Translate
íhlutinn, useTranslation
krókurinn, eða translateEntries
gagnsemi.
Notkun á Translate
íhlutanum.
Skilar þýðingum innan span
þáttar og styður HTML framsetningu.
import {Translate} from 'tacotranslate/react';
function Page() {
return <Translate string="Hello, world!" />;
}
Þú getur breytt tegund frumefnisins með því að nota, til dæmis, as="p"
á íhlutanum.
Notkun useTranslation
hook.
Skilar þýðingum sem einfaldan streng. Hjálplegt til dæmis í meta
merkjum.
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>
);
}
Notkun á translateEntries
hjálparforritinu.
Þýddu strengina á þjóninum. Gefðu OpenGraph myndunum þínum kraft.
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)
};
}
Hvernig strengir eru þýddir
Þegar strengir berast til okkar netþjóna staðfestim við þá fyrst og vistum, og skila síðan tafarlaust vélþýðingu. Þó að vélþýðingar séu almennt með lægri gæðum miðað við AI-þýðingar okkar, bjóða þær upp á skjótan upphafssvar.
Á sama tíma byrjum við ósamstillta þýðingarvinnu til að búa til hágæða, nýjustu AI-þýðingu fyrir strenginn þinn. Um leið og AI-þýðingin er tilbúin mun hún koma í stað vélþýðingarinnar og verða send þegar þú biður um þýðingar á strengjunum þínum.
Ef þú hefur þýtt streng handvirkt, hafa þær þýðingar forgang og eru skilaðar í staðinn.
Nýting uppruna
TacoTranslate verkefni innihalda það sem við köllum origins. Hugsaðu um þau sem inngangspunkta, möppur eða hópa fyrir strengina þína og þýðingar.
import {TacoTranslate} from 'tacotranslate/react';
function Menu() {
return (
<TacoTranslate origin="application-menu">
// ...
</TacoTranslate>
);
}
Origins leyfa þér að skipta strengjum í merkingarbæra gáma. Til dæmis gætir þú haft einn origin fyrir skjölun og annan fyrir markaðssíðuna þína.
Fyrir nákvæmari stjórn gætirðu stillt uppruna á hlutastigi.
Til þess að ná þessu, íhugaðu að nota marga TacoTranslate þjónustuaðila innan verkefnisins þíns.
Vinsamlegast athugið að sami strengur getur fengið mismunandi þýðingar í mismunandi uppruna.
Að lokum er það undir þér komið og þínum þörfum hvernig þú aðskilur strengi í origin. Hins vegar skaltu hafa í huga að það að hafa marga strengi innan eins origin getur aukið hleðslutíma.
Meðhöndlun breyta
Þú ættir alltaf að nota breytur fyrir gagnvirkt efni, svo sem notandanafn, dagsetningar, netfang og fleira.
Breyturnar í strengjum eru skilgreindar með notkun tvöfaldra hornklofa, eins og {{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}});
}
Stjórnun á HTML-innihaldi
Sjálfgefið styður Translate
íhluturinn og birtir HTML-innihald. Hins vegar geturðu afþakkað þetta með því að stilla useDangerouslySetInnerHTML
á false
.
Það er eindregið mælt með að slökkva á HTML-renderun þegar verið er að þýða efni sem ekki er treyst, svo sem efni sem notendur búa til.
Allur úttak er alltaf hreinsaður með sanitize-html áður en það er birt.
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}
/>
);
}
Ofangreint dæmi verður birt sem venjulegur texti.