Dukumiintiyada: Isticmaalka horumarsan

Isticmaalka horumarsan

Somali

Maaraynta luqadaha ka bilowda midig ilaa bidix

TacoTranslate waxay fududeysaa taageeridda luqadaha laga akhriyo midig ilaa bidix (RTL), sida Carabiga iyo Cibraani, ee codsiyadaaga React. Maareynta saxda ah ee luqadaha RTL waxay xaqiijineysaa in waxa ku jira la tuso si sax ah 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 shaqada la bixiyay ee isRightToLeftLocaleCode si aad u hubiso luqadda hada jirta ee ka baxsan React.

import {isRightToLeftLocaleCode} from 'tacotranslate';

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

Dhimista turjumaadda

Si aad u joojiso turjumaadda qaybaha gaarka ah ee xarigga ama si aad u hubiso in qaybo gaar ah sidaa loo hayo, waxaad isticmaali kartaa triple square brackets. Astaantani waxay faa’iido u leedahay ilaalinta qaabka asalka ah ee magacyada, ereyada farsamada, ama wixii kale oo aan la turjumin doonin.

import {Translate} from 'tacotranslate/react';

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

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

Bixiyeyaal badan oo TacoTranslate ah

Waxaan si xooggan kuula talineynaa inaad isticmaasho bixiyeyaal badan oo TacoTranslate ah gudaha app-kaaga. Tani waxay waxtar u tahay sidii aad u habayn lahayd turjumayaashaada iyo xarriiqyadaada qaybaha kala duwan, sida madaxa, gabal-dhamaadka, ama qaybaha gaarka ah.

Waxaad ka akhrisan kartaa macluumaad dheeraad ah oo ku saabsan sida loo isticmaalo asalka halkan.

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

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

Ka sarreysa asal ahaan ama luqadda deegaanka

Marka laga soo tago isticmaalka bixiyeyaasha badan ee TacoTranslate, waxaad sidoo kale ka beddeli kartaa asal ahaan iyo luqadda qaybta Translate iyo heerarka xadhigga 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 rarista

Marka luqadaha laga beddelayo dhinaca macaamiisha, soo qaadista turjumaadaha waxay qaadan kartaa daqiiqado yar iyadoo ku xiran xiriirka isticmaalaha. Waad soo bandhigi kartaa tilmaame rarid si aad u wanaajiso waayo-aragnimada 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
	);
}

Isku-darka jamac

Si loo maareeyo jamac ahaan iyo in si sax ah loogu muujiyo 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 ula taageerto luqado badan isla waqtigaas codsi isku mid ah, waxaad istcimaali kartaa bixiyeyaasha TacoTranslate ee badan oo leh locale qiimeyaal kala duwan sida hoos ku cad:

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

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 turjumaado ama macnayaal kala duwan oo loogu talagalay hal xaraf. Tani waxay si gaar ah waxtar u leedahay marka isla qoraalka uu u baahan yahay turjumaado kala duwan oo ku saleysan macnaha. Adiga oo siiya aqoonsiyo gaar ah, waxaad hubinaysaa in tusaalaha kasta ee xarafka si sax ah loo turjumay 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 madaxda waxaa laga yaabaa in lagu turjumo “Iniciar sesión”, iyo galitaanka hoose waxaa laga yaabaa in lagu turjumo “Acceder” af Isbaanish.

Hababka ugu wanaagsan