TacoTranslate
/
DoiciméadúPraghsáil
 
  1. Réamhrá
  2. Ag tosú
  3. Socrú agus cumraíocht
  4. Ag baint úsáide as TacoTranslate
  5. Rindreáil ar thaobh an fhreastalaí
  6. Úsáid chun cinn
  7. Cleachtais is fearr
  8. Láimhseáil Earráidí agus Dífhabhtú
  9. Teangacha tacaite

Ag baint úsáide as TacoTranslate

Aistriú téacsanna

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


Ag baint úsáide as an chomhpháirt Translate.
Tugann sé aistriúcháin laistigh d'eilimint span, agus tacaíonn sé le rindreáil HTML.

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.
Tugann sé aistriúcháin ar ais 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 uirlis translateEntries.
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 sreanga

Nuair a shroicheann téacsanna ár bhfreastalaithe, déanaimid iad a fhíorú agus a shábháil ar dtús, agus filleann muid aistriúchán meaisín láithreach. Cé go mbíonn aistriúcháin mheaisín go ginearálta níos ísle ó thaobh cáilíochta ná ár n-aistriúcháin AI, soláthraíonn siad freagra tosaigh tapa.

Ag an am céanna, cuirimid tasc aistrithe asíncrónach i mbun chun aistriúchán AI nua-aimseartha ar ardchaighdeán a ghiniúint do shreang. Nuair a bheidh an t-aistriúchán AI réidh, cuirfear ina áit é an t-aistriúchán meaisín agus seolfar é gach uair a iarrann tú aistriúcháin ar do shreanganna.

Má tá téacs aistrithe agat de láimh, tugtar tosaíocht don aistriú sin agus cuirtear é ar ais ina ionad.

Ag baint úsáide as bunúsanna

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

import {TacoTranslate} from 'tacotranslate/react';

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

Cuireann Origíní ar do chumas téacsanna a scaradh i gcoimeádáin chiallmhara. Mar shampla, d’fhéadfá Origín amháin a bheith agat don doiciméadú agus Origín eile don leathanach margaíochta.

Le haghaidh rialaithe níos mionsonraithe, d’fhéadfá origins a bhunú ar leibhéal an chomhpháirte.

Chun é seo a bhaint amach, smaoinigh ar úsáid a bhaint as roinnt soláthraithe 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.

Ar deireadh thiar thall, tá sé faoi do smacht féin agus faoi do riachtanais conas a roinnfidh tú na sreingeanna idir fhoinsí. Mar sin féin, tabhair faoi deara gur féidir le go leor sreingeanna i bhfhoinse amháin amanna luchtaithe a mhéadú.

Ag obair le athróga

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

Fógraítear athróga i sreangacha ag baint úsáide as lúibíní dúbailte, mar shampla {{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 agus léiríonn an chomhpháirt Translate ábhar HTML. Mar sin féin, is féidir leat an iompar seo a dhíghníomhachtú trí useDangerouslySetInnerHTML a shocrú ar false.

Moltar go láidir HTML a dhíchumasú nuair a bhíonn ábhar neamhiontaofa á aistriú, mar shampla ábhar a ghintear ag úsáideoirí.

Déantar gach aschur a ghlanadh i gcónaí ag baint úsáide as sanitize-html sula gcuirtear i láthair é.

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 leagtha amach mar théacs gnáth.

Rindreáil ar thaobh an fhreastalaí

Táirge ó NattskiftetDéanta san Iorua