TacoTranslate
/
SkjölVerðlagning
 
  1. Kynning
  2. Að byrja
  3. Uppsetning og stillingar
  4. Að nota TacoTranslate
  5. Þjónustuhliðarröndunar
  6. Ítarleg notkun
  7. Bestu vinnubrögð
  8. Villusýning og bilanaleit
  9. Stuðningsmál

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.

Þjónustuhliðarröndunar

Vara frá NattskiftetGerð í Noregi