Dogfennol: Defnyddio TacoTranslate

Defnyddio TacoTranslate

Welsh

Cyfieithu llinynnau

Ar hyn o bryd mae tri ffordd i gyfieithu llinynnau: y cydran Translate, y hook useTranslation, neu'r offeryn translateEntries.

Defnyddio'r cydran Translate
Yn allbynnu 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 y cynnwys gan ddefnyddio, er enghraifft, as="p" ar y cydran.

Defnyddio'r useTranslation hook.
Yn dychwelyd cyfieithiadau fel llinyn plaen. Defnyddiol mewn, er enghraifft, 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 translateEntries.
Cyfieithwch linynnau ar ochr y gweinydd. Rhowch bŵer ychwanegol 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 yr edau yn cyrraedd ein gweinyddion, rydym yn eu dilysu ac yn eu cadw'n gyntaf, ac yna'n dychwelyd cyfieithiad peiriant ar unwaith. Er bod cyfieithiadau peiriant yn cael eu hystyried yn gyffredinol yn is o safon o gymharu â'n cyfieithiadau Deallusrwydd Artiffisial, maent yn darparu ymateb cychwynnol cyflym.

Ar yr un pryd, rydym yn cychwyn swydd cyfieithu anhrefnus i gynhyrchu cyfieithiad AI o ansawdd uchel, wedi’i deilwra â’r dechnoleg ddiweddaraf 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 gofynnwch am gyfieithiadau ar eich llinellau.

Os ydych wedi cyfieithu llinyn yn llaw, mae’r cyfieithiadau hynny’n cael blaenoriaeth ac fe’u dyfernir yn eu lle.

Manteisio ar darddiadau

Mae prosiectau TacoTranslate yn cynnwys yr hyn a alwn yn wrthoedd. Meddyliwch amdanynt fel pwyntiau mynediad, ffolderi, neu grwpiau ar gyfer eich cadwyni ac cyfieithiadau.

import {TacoTranslate} from 'tacotranslate/react';

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

Mae Gwreiddiau yn caniatáu ichi wahanu llinynnau i mewn i gynhwysyddion ystyrlon. Er enghraifft, gallech gael un gwreiddiol ar gyfer dogfennau a llall ar gyfer eich tudalen farchnata.

Ar gyfer rheolaeth fwy manwl, gallech sefydlu tarddiadau ar lefel y cydran.

I gyflawni hyn, ystyriwch ddefnyddio sawl darparwr TacoTranslate o fewn eich prosiect.

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

Yn y pen draw, sut ydych chi'n gwahanu darllenwyr i mewn i wreiddiau yw yn dibynnu arnoch chi a’ch anghenion. Fodd bynnag, nodwch y gall cael nifer fawr o darllenwyr mewn un gwreiddiad gynyddu amseroedd lwytho.

Trin newidynnau

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

Mae newidynnau 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 wrthod yr ymddygiad hwn drwy osod useDangerouslySetInnerHTML i false.

Mae analluogi rendro HTML yn cael ei argymell yn gryf wrth gyfieithu cynnwys nad yw'n ymddiried ynddo, megis cynnwys a gynhyrchwyd gan ddefnyddwyr.

Caiff pob allbwn ei lanhau bob amser gyda sanitize-html cyn 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 yr enghraifft uchod yn cael ei hargraffu fel testun plaen.

Rendro ochr y gweinydd