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

Úsáid chun cinn

Ag láimhseáil teangacha ó dheas go clé

Cuireann TacoTranslate éascaíocht ar fáil maidir le tacaíocht a thabhairt do theangacha a léitear ó dheas go clé (RTL), mar shampla Araibis agus Eabhrais, i do fheidhmchláir React. Cinntíonn láimhseáil cheart ar theangacha RTL go bhfuil do chuid ábhar le feiceáil i gceart do úsáideoirí a léann ó dheas go clé.

import {useTacoTranslate} from 'tacotranslate/react';

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

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

Féadfaidh tú an fheidhm soláthraithe isRightToLeftLocaleCode a úsáid freisin 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 an t-aistriúchán a dhíchumasú do chuid shonracha de shreang nó chun a chinntiú go gcoinnítear codanna áirithe mar atá siad, is féidir leat trí lúibíní cearnacha a úsáid. Tá an ghné seo úsáideach chun formáid bhunaidh ainmneacha, téarmaí teicniúla, nó aon ábhar eile nach cheart a aistriú a chothabháil.

import {Translate} from 'tacotranslate/react';

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

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

Il-soláthraithe TacoTranslate

Molaimid go láidir úsáid a bhaint as iliomad soláthróirí TacoTranslate i do aip. Tá sé úsáideach chun do chuid aistriúchán agus téacsanna a eagrú i bhfoinsí éagsúla, mar shampla do cheannlíne, do choiscéim, nó rannáin shonracha.

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

Faigheann soláthraithe TacoTranslate socruithe ó aon soláthraí tuismitheora, mar sin ní bheidh ort aon socruithe eile a athdhéanamh.

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

An fhoinse nó an réigiún a shárú

Chomh maith le húsáid iliomad TacoTranslate soláthróirí, is féidir leat freisin an origin agus an locale a shárú ar leibhéil an chomhpháirte Translate agus an hook useTranslation.

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

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

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

Ag déileáil le luchtú

Nuair a bhíonn tú ag athrú teangacha ar thaobh an chliaint, d’fhéadfadh sé cúpla nóiméad a thógáil chun aistriú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 athraithe.

import {useTacoTranslate} from 'tacotranslate/react';

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

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

Iolrú

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

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 freisin an locale a shárú 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 baint úsáide as IDanna aistriúcháin

Is féidir leat id a chur le comhpháirt Translate chun déileáil le haistriúcháin éagsúla nó le bríonna éagsúla don téacs céanna. Tá sé seo go háirithe úsáideach nuair a éilíonn an téacs céanna aistriúcháin éagsúla bunaithe ar chomhthéacs. Trí IDanna uathúla a shannadh, cinntíonn tú go ndéantar gach sampla den téacs a aistriú go beacht 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 logáil isteach sa cheanntásc a aistriú go “Iniciar sesión”, agus d’fhéadfadh logáil isteach sa bhunleathanach a aistriú go “Acceder” sa Spáinnis.

Cleachtais is fearr

Táirge ó NattskiftetDéanta san Iorua