TacoTranslate
/
DoiciméadúPraghsáil
 
  1. Réamhrá
  2. Ag tosú
  3. Socrú agus cumraíocht
  4. Ag Úsáid 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 tacaíochta

Úsáid chun cinn

Ag déileáil le teangacha ó dheas go clé

Cuireann TacoTranslate ar chumas tacú go héasca le teangacha a léitear ó dheis go clé (RTL), ar nós Araibis agus Eabhraic, i do fheidhmchláir React. Cinntíonn láimhseáil chuí ar theangacha RTL go gcuirtear do chuid ábhair i láthair i gceart dóibh siúd a léann ó dheis go clé.

import {useTacoTranslate} from 'tacotranslate/react';

function Document() {
	const {locale, isRightToLeft} = useTacoTranslate();

	return (
		<html lang={locale} dir={isRightToLeft ? 'rtl' : 'ltr'}>
			<body>
				// ...
			</body>
		</html>
	);
}

Is féidir leat freisin an fheidhm isRightToLeftLocaleCode atá ar fáil a úsáid chun an teanga reatha a sheiceáil lasmuigh de React.

import {isRightToLeftLocaleCode} from 'tacotranslate';

function foo(locale = 'es') {
	const direction = isRightToLeftLocaleCode(locale) ? 'rtl' : 'ltr';
	// ...
}

Aistriúcháin a dhíchumasú

Chun aistriúcháin a dhíchumasú do chuid áirithe de shreang nó chun a chinntiú go gcoinnítear roinnt rannóg mar atá siad, is féidir leat bráicíní cearnacha trífacha a úsáid. Tá an ghné seo úsáideach chun formáid bhunaidh ainmneacha, téarmaí teicniúla, nó aon ábhar eile nach ba cheart a aistriú a choinneáil.

import {Translate} from 'tacotranslate/react';

function Component() {
	return (
		<Translate string="Hello, [[[TacoTranslate]]]!" />
	);
}

Sa sampla seo, fanfaidh an focal “TacoTranslate” gan athrú san aistriúchán.

Soláthróirí TacoTranslate iolracha

Molaimid go láidir úsáid a bhaint as iliomad soláthróirí TacoTranslate i do aip. Cabhraíonn sé seo le do chuid aistriúchán agus téacsanna a eagrú i bhfoinsí éagsúla, mar shampla do bharr, do bhun, nó do rannáin shonracha.

Is féidir leat tuilleadh a léamh anseo faoi conas origins a úsáid.

Soláthróirí TacoTranslate oidhreachtaithe socruithe ó aon soláthraí tuismitheora, mar sin ní bheidh ort aon socruithe eile a athrá.

import createTacoTranslateClient from 'tacotranslate';
import {TacoTranslate} from 'tacotranslate/react';

const tacoTranslateClient = createTacoTranslateClient({apiKey: 'YOUR_API_KEY'});

function Header() {
	return (
		<TacoTranslate origin="header">
			// ...
		</TacoTranslate>
	);
}

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

export default function App() {
	return (
		<TacoTranslate client={tacoTranslateClient} origin="page" locale="es">
			<Header />
			<Menu />
		</TacoTranslate>
	);
}

Ag sárú bunaidh nó áitiúlachta

Ina theannta sin, seachas úsáid a bhaint as il-TacoTranslate soláthróirí, is féidir leat freisin foinsí agus logainmneacha a shárú ag leibhéil an chomhpháirteach Translate agus an ghabhála useTranslation.

import {Translate, useTranslation} from 'tacotranslate/react';

function Greeting() {
	const spanishHello = useTranslation('Hello!', {locale: 'es'});

	return (
		<>
			{spanishHello}
			<Translate string="What’s up?" origin="greeting" />
		</>
	);
}

Bainistiú luchtaithe

Nuair a athraíonn an t-úsáideoir an teanga ar an gcliant, b’fhéidir go dtógfaidh sé cúpla nóiméad na haistriúcháin a fháil ag brath ar nasc an úsáideora. Is féidir leat táscaire luchtaithe a thaispeáint chun taithí an úsáideora a fheabhsú trí aiseolas amhairc a sholáthar le linn an aistrithe.

import {useTacoTranslate} from 'tacotranslate/react';

function Component() {
	const {isLoading} = useTacoTranslate();

	return (
		isLoading ? 'Translations are loading...' : null
	);
}

Iolrú

Chun iolrú a láimhseáil agus lipéid atá bunaithe ar chomhaireamh a thaispeáint i gceart i dteangacha éagsúla, mholtar an dea-chleachtas seo:

import {Translate, useLocale} from 'tacotranslate/react';

function PhotoCount() {
	const locale = useLocale();
	const count = 1;

	return count === 0 ? (
		<Translate string="You have no photos." />
	) : count === 1 ? (
		<Translate string="You have 1 photo." />
	) : (
		<Translate
			string="You have {{count}} photos."
			variables={{count: count.toLocaleString(locale)}}
		/>
	);
}

Ilteangacha

Chun tacú le teangacha iolracha ag an am céanna laistigh den aip chéanna, is féidir leat soláthróirí TacoTranslate iolracha a úsáid le luachanna locale éagsúla mar a thaispeántar thíos:

Is féidir leat an locale a shárú freisin ar leibhéal an chomhpháirte nó an hook.

import createTacoTranslateClient from 'tacotranslate';
import {TacoTranslate, Translate} from 'tacotranslate/react';

const tacoTranslateClient = createTacoTranslateClient({apiKey: 'YOUR_API_KEY'});

function Spanish() {
	return (
		<TacoTranslate locale="es">
			<Translate string="Hello, world in Spanish!" />
		</TacoTranslate>
	);
}

function Norwegian() {
	return (
		<TacoTranslate locale="no">
			<Translate string="Hello, world in Norwegian!" />
		</TacoTranslate>
	);
}

export default function App() {
	return (
		<TacoTranslate client={tacoTranslateClient} origin="page" locale="es">
			<Spanish />
			<Norwegian />
		</TacoTranslate>
	);
}

Ag úsáid aitheantóirí aistriúcháin

Is féidir leat id a chur leis an gcomhpháirt Translate chun déileáil le haistriúcháin nó le bríonna éagsúla don téacs céanna. Tá sé seo go háirithe úsáideach nuair is gá go mbeadh aistriúcháin éagsúla don téacs céanna bunaithe ar an gcomhthéacs. Trí IDanna uathúla a shannadh, cinntíonn tú go ndéantar gach cás den téacs a aistriú go cruinn de réir a bhrí shonrach.

import {Translate} from 'tacotranslate/react';

function Header() {
	return (
		<Translate id="header" string="Login" />
	);
}

function Footer() {
	return (
		<Translate id="footer" string="Login" />
	);
}

Mar shampla, d’fhéadfadh an nasc logála sa cheannlíne a aistriú go “Iniciar sesión”, agus d’fhéadfadh an nasc logála sa bhun a aistriú go “Acceder” sa Spáinnis.

Cleachtais is fearr

Táirge ó NattskiftetDéanta san Iorua