TacoTranslate
/
DogfennaethPrisiau
 
  1. Cyflwyniad
  2. Dechrau defnyddio
  3. Sefydlu a chonfigurasiwn
  4. Defnyddio TacoTranslate
  5. Rendro ochr y gweinydd
  6. Defnyddio uwch
  7. Ymarferion Gorau
  8. Gwybodaeth am drin gwallau a dadfygio
  9. Ieithoedd a gefnogir

Defnyddio TacoTranslate

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 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 cyfleustodwr translateEntries
Trosi llinynnau ar ochr y gweinydd. Rhoi hwb 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 ddaw’r strings at ein gweinyddion, rydym yn eu dilysu a’u cadw yn gyntaf, yna’n dychwelyd cyfieithiad peiriant ar unwaith. Er bod cyfieithiadau peiriant yn gyffredinol yn is o safon o gymharu â’n cyfieithiadau AI, maent yn darparu ymateb cychwynnol cyflym.

Ar unwaith, rydym yn dechrau gwaith cyfieithu anffurfiol i gynhyrchu cyfieithiad AI o ansawdd uchel, mwyaf modern 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 byddwch yn gofyn am gyfieithiadau ar gyfer eich llinynnau.

Os ydych wedi cyfieithu llinyn â llaw, ceir blaenoriaeth i’r cyfieithiadau hynny a dywedir nhw yn eu lle.

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.

Am reolaeth mwy manwl, gallech sefydlu tarddiadau ar lefel y cydran.

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

Sylwch gall y llinyn hwnnw dderbyn cyfieithiadau gwahanol mewn gwahanol darddiad.

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 â chynhyrfewyr

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

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 ddewis peidio â defnyddio’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

Cynnyrch gan NattskiftetWedi'i wneud yn Norwy