Dukumentiga: Isticmaalka horumarsan

Isticmaalka horumarsan

Somali

Maaraynta luqadaha laga akhriyo midig ilaa bidix

TacoTranslate waxay ka dhigaysaa mid sahlan in lagu taageero luqadaha qoraalka ka bilaabma midig ilaa bidix (RTL), sida Carabiga iyo Ibraniga, codsiyadaada React. Maareynta saxda ah ee luqadaha RTL waxay xaqiijinaysaa in nuxurkaaga si sax ah loogu soo bandhigo isticmaaleyaasha ka 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 shaqada 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 qayb gaar ah oo ka mid ah xadhig ama si aad u hubiso in qaybo qaarkood sidii ay yihiin loo ilaaliyo, waxaad isticmaali kartaa saddex xabbo oo labajibbaaran (triple square brackets). Astaantan waxay waxtar u leedahay ilaalinta qaabka asalka ah ee magacyada, erayada farsamada, ama wax kasta oo kale oo aan la rabin in la turjumo.

import {Translate} from 'tacotranslate/react';

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

Tusaale ahaan, erayga “TacoTranslate” lama beddeli doono turjumaadda.

Bixiyeyaal badan oo TacoTranslate ah

Waxaan si xoog leh kuugu dhiirigelinaynaa inaad gudaha app-kaaga isticmaasho dhowr TacoTranslate bixiyayaal. Tani waxay ka caawinaysaa abaabulidda turjumaadahaaga iyo xargaha si loogu habeeyo asalo kala duwan, sida madaxa, qaybta hoose, ama qaybaha gaarka ah.

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

TacoTranslate bixiyayaasha waxay ka dhaxlaan dejimaha bixiyaha waalid kasta, 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

Intaa waxaa dheer, marka aad isticmaasho bixiyeyaasha badan ee TacoTranslate, waxaad sidoo kale ku bedeli kartaa labadaba asalka iyo deegaanka luqadda (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" />
		</>
	);
}

Maaraynta rarida

Marka luqadda laga beddelayo dhinaca macaamiisha, helidda turjumaadaha waxay qaadan kartaa dhowr ilbiriqsi iyadoo ku xiran xawaaraha isku xirka isticmaalaha. Waxaad soo bandhigi kartaa tilmaame muujinaya raritaanka si aad kor ugu qaaddo khibrada isticmaalaha adigoo siinaya jawaab muuqaal ah inta lagu jiro beddelka.

import {useTacoTranslate} from 'tacotranslate/react';

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

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

Jamacayn

Si sax ah loogu maareeyo qaabaynta jamaca iyo in loo soo bandhigo calaamadaha ku saleysan tirada luqado kala duwan, tani waxaa loo arkaa habka 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)}}
		/>
	);
}

Luuqado badan

Si aad u taageerto luqado badan isla mar ahaantaana gudaha isla codsiga, waxaad isticmaali kartaa bixiyeyaasha TacoTranslate ee badan oo leh qiimeyaal locale oo kala duwan sida hoos ku cad:

Waxaad sidoo kale ka beddeli kartaa locale heerka qaybta ama 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>
	);
}

Isticmaalka aqoonsiyada turjumaadda

Waxaad ku dari kartaa id qaybta Translate si aad u maareyso turjumaado ama macneyaal kala duwan oo loogu talagalay isla qoraalka. Tani waxay si gaar ah waxtar u leedahay marka qoraalka isku midka ah uu u baahan yahay turjumaado kala duwan iyadoo ku xiran macnaha. Marka aad siiso aqoonsiyo gaar ah, waxaad hubinaysaa in tusaal walba oo qoraalka ah si sax ah loogu turjumo 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, gelitaanka header-ka waxaa laga yaabaa in lagu turjumo “Iniciar sesión”, halka gelitaanka footer-ka waxaa laga yaabaa in lagu turjumo “Acceder” Af Isbaanish.

Hababka ugu wanaagsan