TacoTranslate
/
DoiciméadúPraghsáil
 
  1. Réamhrá
  2. Ag tosú
  3. Socrú agus cumrú
  4. Ag úsáid TacoTranslate
  5. Rindreáil taobh an fhreastalaí
  6. Úsáid chun cinn
  7. Cleachtais is fearr
  8. Láimhseáil earráidí agus dífhabhtú
  9. Tacar teangacha

Úsáid chun cinn

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

Déanann TacoTranslate éasca tacaíocht a sholáthar do theangacha ó dheas go clé (RTL), cosúil leis an Araibis agus an Eabhrais, i d’aipeanna React. Cinntíonn láimhseáil cheart ar theangacha RTL go bhfuil do chuid ábhair taispeántaithe i gceart dóibh siúd 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>
	);
}

Is féidir leat an fheidhm isRightToLeftLocaleCode atá curtha ar fáil 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';
	// ...
}

Ag díghníomhachtú aistriúcháin

Chun aistriúchán a dhíchumasú do chuid áirithe de shlabhra nó chun a chinntiú go gcoinnítear roinnt earnálacha mar atá, is féidir leat úsáid a bhaint as na lúibíní cearnacha triple. Tá an ghné seo úsáideach chun foirm bhunaidh ainmneacha, téarmaí teicniúla, nó aon ábhar eile nach mbaineann le haistriúchán a chothabháil.

import {Translate} from 'tacotranslate/react';

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

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

Iolraitheoirí TacoTranslate

Molaimid go láidir úsáid a bhaint as iliomad soláthróirí TacoTranslate i do fheidhmchlár. Tá sé seo úsáideach chun do aistriúcháin agus sreinge a eagrú i bhfoinseanna éagsúla, mar shampla do cheannlíne, do dromchla, nó rannáin shonracha.

Is féidir leat léamh níos mó faoi úsáid na bhfoinse anseo.

Soláthróirí TacoTranslate glactar le socruithe ó aon sholáthróir 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>
	);
}

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

Chomh maith le húsáid iliomad soláthraithe TacoTranslate, is féidir leat freisin bunaidh agus áitiúlacht a shárú ar leibhéil an chomhpháirte Translate agus an chróic 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 láimhseáil luchtaithe

Nuair a athraíonn tú 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 de réir 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 aistriúcháin.

import {useTacoTranslate} from 'tacotranslate/react';

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

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

Ilchineálú

Chun cinntiú go ndéantar ilchineálacht agus lipéid atá bunaithe ar líon a thaispeáint i gceart i dteangacha éagsúla, meastar gurb é seo an chleachtas is fearr:

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 tacaíocht a thabhairt do roinnt teangacha ag an am céanna laistigh den iarratas céanna, is féidir leat ilé-providers TacoTranslate a úsáid le luachanna éagsúla locale mar a thaispeántar thíos:

Is féidir leat freisin an locale a shárú ag 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 IDanna aistriúcháin

Is féidir leat id a chur leis an gcomhpháirt Translate chun láimhseáil a dhéanamh ar aistriúcháin éagsúla nó bríonna difriúla don tsreang chéanna. Tá sé seo an-úsáideach go háirithe nuair is gá aistriúcháin éagsúla don téacs céanna bunaithe ar chomhthéacs. Trí IDanna uathúla a shannadh, cinntíonn tú go ndéanfar gach sampla den tsreang 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 logáil isteach an cheannlíne a aistriú go “Iniciar sesión”, agus d’fhéadfadh logáil isteach an túsbhunachar a aistriú go “Acceder” sa Spáinnis.

Cleachtais is fearr

Táirge ó NattskiftetDéanta sa Iorua