TacoTranslate
/
DogfennaethPrisiau
 
  1. Cyflwyniad
  2. Dechrau gyda
  3. Sefydlu a chyfluniad
  4. Defnyddio TacoTranslate
  5. Rendro ochr-y-gweinydd
  6. Defnyddio Uwch
  7. Ymarferion gorau
  8. Rheoli gwallau a dadfygio
  9. Ieithoedd a gefnogir

Defnyddio TacoTranslate

Cyfieithu llinynnau

Ar hyn o bryd mae tair ffordd i gyfieithu llinynnau testun: y cydran Translate, y hhac useTranslation, neu'r cyfleustod translateEntries.


Defnyddio’r cydran Translate
Yn galluogi allbwn cyfieithiadau o fewn elfen span, ac yn cefnogi rendro HTML.

import {Translate} from 'tacotranslate/react';

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

Gallwch newid math yr elfen gan ddefnyddio, er enghraifft, as="p" ar y cydran.


Defnyddio’r hook useTranslation.
Dychwelyd cyfieithiadau fel llinyn syml. Defnyddiol, er enghraifft, mewn tagiau 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>
	);
}

Defnyddio'r offeryn utility translateEntries.
Cyfieithu llinynnau ar ochr y gweinydd. Rhoi hwb mawr i’ch delweddau 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)
	};
}

Sut mae llinynnau yn cael eu cyfieithu

Pan fydd llinynnau'n cyrraedd ein gweinyddion, rydym yn eu dilysu a'u cadw'n gyntaf, ac yn ôl hynny'n dychwelyd cyfieithiad peiriant yn syth. Er bod cyfieithiadau peiriant yn llai o ansawdd yn gyffredinol o gymharu â'n cyfieithiadau AI, maent yn darparu ymateb cychwynnol cyflym.

Ar yr un pryd, rydym yn cychwyn swydd cyfieithu anghydamserol i greu cyfieithiad AI o ansawdd uchel, o'r radd flaenaf ar gyfer eich llinyn. Unwaith y bydd y cyfieithiad AI yn barod, bydd yn disodli'r cyfieithiad peiriant a bydd yn cael ei anfon pa bryd bynnag y byddwch yn gofyn am gyfieithiadau ar gyfer eich llinynnau.

Os ydych wedi cyfieithu llinyn â llaw, bydd y cyfieithiadau hynny yn cael blaenoriaeth ac yn cael eu dychwelyd yn lle hynny.

Defnyddio tarddiadau

Mae prosiectau TacoTranslate yn cynnwys yr hyn a elwir gennym yn berthnasau. Meddyliwch amdanynt fel mannau mynediad, ffolderi, neu grwpiau ar gyfer eich llinellau a’ch cyfieithiadau.

import {TacoTranslate} from 'tacotranslate/react';

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

Mae originau yn eich galluogi i wahanu llinynnau i gynhwysyddion ystyrlon. Er enghraifft, gallech gael un origin ar gyfer dogfennaeth a un arall ar gyfer eich tudalen marchnata.

Am ragor o reolaeth fanwl, gallech sefydlu tarddiadau ar lefel y cydran.

I gyflawni hyn, ystyriwch ddefnyddio nifer o ddarparwyr TacoTranslate o fewn eich prosiect.

Sylwer y gall yr un llinyn dderbyn cyfieithiadau gwahanol mewn gwahanol darddiadau.

Yn y pen draw, sut rydych chi'n gwahanu'r llinynnau i mewn i darddiadau yw eich dewis chi a'ch anghenion. Fodd bynnag, nodwch y gall cael llawer o linynnau mewn un tarddiad gynyddu amseroedd llwytho.

Rheoli newidynnau

Dylech bob amser ddefnyddio newidiolion ar gyfer cynnwys deinamig, megis enwau defnyddwyr, dyddiadau, cyfeiriadau e-bost, a mwy.

Mae amrywiolion mewn llinynnau yn cael eu datgan gan ddefnyddio cromfachau dwbl, fel {{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}});
}

Rheoli cynnwys HTML

Yn ddiofyn, mae cydran Translate yn cefnogi ac yn rendro cynnwys HTML. Fodd bynnag, gallwch ddewis peidio â gwneud hyn trwy osod useDangerouslySetInnerHTML i false.

Argymhellir yn gryf analluogi rendro HTML pan fyddwch yn cyfieithu cynnwys anfoddadwy, megis cynnwys a grëwyd gan ddefnyddwyr.

Mae pob allbwn yn cael ei lanhau bob amser gyda sanitize-html cyn cael ei arddangos.

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}
		/>
	);
}

Bydd y enghraifft uchod yn cael ei rendro fel testun syml.

Rendro ochr-y-gweinydd

Cynnyrch gan NattskiftetWedi'i Wneud yn Norwy