TacoTranslate
/
DoiciméadúPraghsanna
 
  1. Réamhrá
  2. Tús
  3. Socrú agus cumraíocht
  4. Ag baint úsáide as TacoTranslate
  5. Rindreáil ar an bhfreastalaí
  6. Úsáid chun cinn
  7. Cleachtais is fearr
  8. Láimhseáil earráide agus dífhabhtú
  9. Teangacha a thacaítear leo

Ag baint úsáide as TacoTranslate

Ag aistriú téacsanna

Tá trí bhealach ann faoi láthair chun sreingeanna a aistriú: an chomhpháirt Translate, an hook useTranslation, nó an uirlis translateEntries.


Ag baint úsáide as an chomhpháirt Translate.
Soláthraíonn sé aistriúcháin i eilimint span, agus tacaíonn sé le HTML a rindreáil.

import {Translate} from 'tacotranslate/react';

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

Is féidir leat cineál an eilimint a athrú, mar shampla trí as="p" a úsáid ar an gcomhpháirt.


Ag baint úsáide as an useTranslation hook.
Filleann sé aistriúcháin mar shreang shimplí. Úsáideach, mar shampla, i lipéid 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>
	);
}

Ag baint úsáide as an translateEntries uirlis.
Aistrigh sreanga téacs ar thaobh an fhreastalaí. Cuir cumhacht bhreise le do íomhánna 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)
	};
}

Conas a aistrítear téacsanna

Nuair a shroicheann na téacsanna ár bhfreastalaithe, déanaimid iad a fhíordheimhniú agus a shábháil ar dtús, agus ansin tugaimid aistriúchán meaisín ar ais láithreach. Cé go mbíonn aistriúcháin mheaisín de ghnáth ar chaighdeán níos ísle ná ár n-aistriúcháin AI, soláthraíonn siad freagra tosaigh tapa.

Ag an am céanna, tionscnaímid post aistrithe asínchrónach chun aistriúchán AI ar ardchaighdeán a ghiniúint do théacs. Nuair a bheidh an t-aistriúchán AI réidh, cuirfidh sé an t-aistriúchán meaisín ina ionad agus seolfar é gach uair a iarrann tú aistriúcháin do théacsanna.

Má aistrigh tú téacs de láimh, bíonn tosaíocht ag na haistriúcháin sin agus tugtar iad ina n-áit.

Ag baint úsáide as foinsí

Cuimsíonn tionscadail TacoTranslate an méid a ghlaoimid origins. Smaoinigh orthu mar phointí iontrála, mar fhillteáin, nó mar ghrúpaí do shreanganna agus d'aistriúcháin.

import {TacoTranslate} from 'tacotranslate/react';

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

Ligeann foinseanna duit sreanga a scaradh i gcoimeádáin chiallacha. Mar shampla, d’fhéadfá foinsé amháin a bheith agat don doiciméadú agus foinse eile do leathanach margaíochta.

Chun smacht níos mionsonraithe a fháil, d’fhéadfá origins a chur ar bun ar leibhéal an chomhpháirte.

Chun seo a bhaint amach, smaoinigh ar úsáid a bhaint as roinnt soláthróirí TacoTranslate laistigh de do thionscadal.

Tabhair faoi deara go bhféadfadh an téacs céanna aistriúcháin éagsúla a fháil i bhfoinsí éagsúla.

I ndeireadh na dála, is leatsa féin agus do riachtanais a rogha é conas a roinneann tú téacsanna idir fhoinsí. Áfach, tabhair faoi deara gur féidir le go leor téacsanna i bhfoinse amháin amanna luchtaithe a mhéadú.

Láimhseáil athróga

Ba cheart duit i gcónaí athróga a úsáid le haghaidh ábhar dinimiciúil, mar shampla ainmneacha úsáideoirí, dátaí, seoltaí ríomhphoist agus níos mó.

Fógraítear athróga i sreangáin trí lúibíní dúbailte a úsáid, mar {{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}});
}

Bainistiú ábhar HTML

De réir réamhshocraithe, tacaíonn an chomhpháirt Translate le hábhar HTML agus déantar é a rindreáil. Mar sin féin, is féidir leat an iompar seo a sheachaint trí useDangerouslySetInnerHTML a shocrú go false.

Moltar go láidir an léiriú HTML a mhúchadh nuair a bhíonn ábhar nach bhfuil iontaofa á aistriú, mar shampla ábhar a ghintear ag úsáideoirí.

Déantar gach aschur a ghlanadh i gcónaí le sanitize-html sula ndéantar é a thaispeáint.

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

Beidh an sampla thuas á chur i láthair mar théacs lom.

Rindreáil ar an bhfreastalaí

Táirge ó NattskiftetDéanta san Iorua