Dogfennaeth: Defnyddio TacoTranslate

Defnyddio TacoTranslate

Welsh

Cyfieithu llinynnau

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

Defnyddio'r cydran Translate
Yn 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 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 utility translateEntries
Cyfieithwch linynnau ar ochr y gweinydd. Cyflymeddwch eich 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 strangau yn cael eu cyfieithu

Pan gyrhaeddant y llinellau ein gweinyddwyr, rydym yn eu dilysu ac yn eu cadw yn gyntaf, ac yna'n dychwelyd cyfieithiad peiriant ar unwaith. Er bod cyfieithiadau peiriant yn gyffredinol o ansawdd is na'n cyfieithiadau Deallusrwydd Artiffisial, maent yn darparu ymateb cychwynnol cyflym.

Ar yr un pryd, rydym yn cychwyn swydd cyfieithu anwythol i gynhyrchu 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 pryd bynnag y gofynnwch am gyfieithiadau ar gyfer eich llinynnau.

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

Defnyddio tarddiadau

Mae prosiectau TacoTranslate yn cynnwys yr hyn a elwir yn ffynhonnellau. Meddyliwch amdanynt fel mannau mynediad, ffolderau, neu grwpiau ar gyfer eich llinellau testun a chyfieithiadau.

import {TacoTranslate} from 'tacotranslate/react';

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

Mae'r ffynonellau yn eich galluogi i rannu cadwyni testun i mewn i gynhwysyddion ystyrlon. Er enghraifft, gallech gael un ffynhonnell ar gyfer dogfennaeth ac un arall ar gyfer eich tudalen marchnata.

I gael mwy o reolaeth fanwl, gallwch sefydlu tarddiadau ar lefel y cydran.

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

Sylwch efallai y bydd yr un llinyn yn derbyn cyfieithiadau gwahanol mewn gwahanol darddiadau.

Yn y pen draw, sut ydych chi’n gwahanu llinynnau i mewn i darddiadau yw’ch penderfyniad chi a’ch anghenion. Fodd bynnag, nodwch y gall cael sawl llinyn mewn un tarddiad gynyddu amseroedd llwytho.

Delio ag amrywiaethau

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

Mae newidiolion 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 ddewiso mewngofnodi o'r ymddygiad hwn drwy osod useDangerouslySetInnerHTML i false.

Argymhellir yn gryf anablu rendro HTML wrth gyfieithu cynnwys nad yw'n ymddiried ynddo, megis cynnwys a gynhyrchir gan ddefnyddwyr.

Mae pob allbwn bob amser yn cael ei lanhau 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 harchwilio fel testun plaen.

Rendro ochr y gweinydd