Dukumiinti: Isticmaalka horumarsan

Isticmaalka horumarsan

Somali

Maaraynta luqadaha laga akhriyo midig ilaa bidix

TacoTranslate waxay ka dhigtaa mid sahlan taageeridda luqadaha laga akhriyo midig ilaa bidix (RTL), sida Carabiga iyo Ibraaniga, ee codsiyadaada React. Maareynta saxda ah ee luqadaha RTL waxay hubisaa in waxyaabahaaga 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 turjumaadda

Si aad u joojiso turjumaadda qaybaha gaarka ah ee xarigga ama si aad u hubiso in qaybo gaar ah loo ilaaliyo sidii ay yihiin, waxaad isticmaali kartaa triple square brackets. Astaantan waxay waxtar u leedahay in la ilaaliyo qaabka asalka ah ee magacyada, erayada farsamada, ama wax kasta oo kale oo aan la turjumin doonin.

import {Translate} from 'tacotranslate/react';

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

Tusaalahan, erayga “TacoTranslate” wuxuu ahaan doonaa mid aan waxba laga beddelin turjumaadda.

Bixiyeyaasha TacoTranslate ee badan

Waxaan si xoogan u dhiirrigelinaynaa inaad isticmaasho bixiyayaal TacoTranslate badan oo ku jira app-kaaga. Tani waxay waxtar u leedahay abaabulidda tarjumaadahaaga iyo xargahaaga meelo asal ahaan kala duwan, sida qaybta sare (header), qaybta hoose (footer), ama qaybo gaar ah.

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

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

Maaraynta raritaanka

Marka luqadda laga beddelayo dhinaca macmiilka, soo helida turjumaadaha waxay qaadan kartaa dhowr ilbiriqsi iyadoo ku xiran xawaaraha xiriirka internetka ee isticmaalaha. Waxaad muujin kartaa tilmaame muujinaya in la rarayo si aad u wanaajiso khibradda 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
	);
}

Jamac

Si loo maareeyo kala-duwanaanshaha jamaca iyo si sax ah loogu soo bandhigo calaamadaha ku saleysan tirinta luqado kala duwan, tani waa loo arkaa inay tahay 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)}}
		/>
	);
}

Luqado badan

Si aad u taageerto luqado badan isla mar ahaantaana gudaha isla codsiga, waxaad isticmaal dhowr bixiye TacoTranslate ah oo leh qiimayaal locale oo 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 turjumaadda

Waad ku dari kartaa id qaybta Translate si aad u maamusho turjumaado ama macnayaal kala duwan oo loogu talagalay isla qoraalka. Tani waa si gaar ah waxtar u leh marka qoraalka isku midka ah uu u baahan yahay turjumaado kala duwan iyadoo ku xiran macnaha guud. Adigoo siinaya aqoonsiyo gaar ah, waxaad hubisaa in nuqul kasta oo qoraalka ah si sax ah loogu 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, gelitaanka header-ka waxaa laga yaabaa inuu u turjumo “Iniciar sesión”, halka gelitaanka footer-ka waxaa laga yaabaa inuu u turjumo “Acceder” Af Isbaanish.

Hababka ugu wanaagsan