Dukumiinti: Isticmaalka horumarsan

Isticmaalka horumarsan

Somali

Maareynta luqadaha laga qoro midig ilaa bidix

TacoTranslate waxay fududeysaa taageeridda luqadaha qoraalka ka dhaca midig ilaa bidix (RTL), sida Carabi iyo Cibraani, ee ku jira codsiyadaada React. Maareynta habboon ee luqadaha RTL waxay xaqiijinaysaa in nuxurkaagu si sax ah loogu soo bandhigo isticmaaleyaasha akhriya midig ilaa bidix.

import {useTacoTranslate} from 'tacotranslate/react';

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

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

Waxaad sidoo kale isticmaali kartaa hawsha la bixiyay isRightToLeftLocaleCode si aad uga hubiso luqadda hadda jirta meel ka baxsan React.

import {isRightToLeftLocaleCode} from 'tacotranslate';

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

Joojinta tarjumaadda

Si aad u joojiso turjumaadda qaybo gaar ah oo ka mid ah xarig ama si aad u hubiso in qaybo gaar ah loo hayo sidii ay yihiin, waxaad isticmaali kartaa triple square brackets. Astaantan waxay waxtar u leedahay ilaalinta qaabka asalka ah ee magacyada, ereyo farsamo, ama wax kasta oo kale oo aan la rabin in la turjumo.

import {Translate} from 'tacotranslate/react';

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

Tusaalahan, erayga “TacoTranslate” lama beddeli doono inta lagu jiro turjumaadda.

Bixiyeyaasha kala duwan ee TacoTranslate

Waxaan si xooggan ku dhiirrigelinaynaa isticmaalka dhowr bixiye TacoTranslate oo ku jira codsigaaga. Tani waxay waxtar u leedahay in la abaabulo turjumaadahaaga iyo xarigyada (strings) gudaha ilaha kala duwan, sida madaxa (header), qaybta hoose (footer), ama qaybo gaar ah.

Waxaad halkan ka akhrisan kartaa wax dheeraad ah oo ku saabsan sida loo isticmaalo asalooyinka.

TacoTranslate bixiyeyaashu waxay ka dhaxlaan dejimaha bixiyaha waalidka, sidaas darteed uma baahnid inaad dejimo kale ku celiso.

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

Beddelida asalka ama deegaanka

Marka lagu daro isticmaalka bixiyeyaasha badan ee TacoTranslate, waxaad sidoo kale ka beddeli kartaa labada — asalka iyo deegaanka (locale) — heerarka qaybta Translate iyo hook-ka useTranslation.

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

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

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

Maareynta raritaanka

Marka luqadda laga beddelayo dhinaca macmiilka, helidda turjumaaduhu waxay qaadan kartaa waqti kooban iyadoo ku xiran xawliga isku xirka isticmaalaha. Waxaad muujin kartaa muujiyaha rarista si aad u hagaajiso waayo-aragnimada isticmaalaha adigoo siinaya jawaab muuqaal inta lagu jiro beddelka.

import {useTacoTranslate} from 'tacotranslate/react';

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

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

Jamacaynta

Si loo maareeyo kala-duwanaanta jamaca (pluralization) iyo si sax ah loogu soo bandhigo calaamadaha ku saleysan tirada luqado kala duwan, tani waxaa loo arkaa dhaqanka ugu wanaagsan:

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

Luqado badan

Si aad si wadajir ah ugu taageerto luqado kala duwan gudaha isla codsiga, waxaad isticmaali kartaa bixiyeyaasha TacoTranslate ee badan oo leh qiimayaal kala duwan locale, sida hoos lagu muujiyey:

Waxaad sidoo kale ka beddeli kartaa locale heerka qaybta ama hook-ka.

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

Isticmaalka aqoonsiyada tarjumaadda

Waxaad ku dari kartaa id qaybta Translate si aad u maareyso tarjumaado ama macneyaal kala duwan oo loogu talagalay isla kelmada. Tani gaar ahaan way waxtaraysaa marka qoraalka isku midka ah uu u baahan yahay tarjumaado kala duwan iyadoo ku xiran macnaha. Adigoo u qoondeynaya aqoonsiyo gaar ah (IDs), waxaad hubisaa in nuqul kasta oo qoraalka ah la turjumo si sax ah iyadoo loo eegayo macnihiisa gaarka ah.

import {Translate} from 'tacotranslate/react';

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

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

Tusaale ahaan, galitaanka ku jira header-ka waxaa laga yaabaa in loo turjumo “Iniciar sesión”, halka galitaanka ku jira footer-ka waxaa laga yaabaa in loo turjumo “Acceder” af Isbaanish.

Hababka ugu wanaagsan