Dukumeenti: Isticmaalka horumarsan

Isticmaalka horumarsan

Somali

Maaraynta luqadaha laga akhriyo midig ilaa bidix

TacoTranslate waxay fududaynaysaa taageerada luqadaha laga akhriyo midig ilaa bidix (RTL), sida Carabiga iyo Cibraaniga, barnaamijyadaada React. Maareynta saxda ah ee luqadaha RTL waxay xaqiijisaa in nuxurkaaga si sax ah loogu soo bandhigo isticmaalayaasha 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 bixiyey isRightToLeftLocaleCode si aad u hubiso luqadda hadda jirta dibadda 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 weedh, ama si aad u hubiso in qaybo cayiman loo ilaaliyo sidii ay yihiin, waxaad isticmaali kartaa calaamadaha saddex-laaban ee labo-geesoodka. Astaantan waxay waxtar u leedahay ilaalinta qaabka asalka ah ee magacyada, eray-bixinta farsamada, ama wixii kale ee 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 u dhiirigelinaynaa in la isticmaalo dhowr bixiye oo TacoTranslate ah app-kaaga. Tani waxay waxtar u leedahay in turjumaadaha iyo xargaha qoraalka lagu kala habeeyo meelo kala duwan, sida ciwaanka sare, ciwaanka hoose, ama qaybaha gaarka ah.

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

TacoTranslate bixiyeyaasha waxay ka dhaxlaan dejimaha bixiyaha waalidka, markaa 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 lagu daro isticmaalka dhowr ka mid ah bixiyeyaasha TacoTranslate, waxaad sidoo kale ka beddeli kartaa asalka iyo deegaanka luqadda 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 rarista

Marka luqadda laga beddelayo dhinaca macmiilka, soo dejinta turjumaadaha waxay qaadan kartaa dhowr ilbiriqsi iyadoo ku xiran isku xirka isticmaalaha. Waxaad soo bandhigi kartaa tilmaame raritaan si aad u hagaajiso waayo-aragnimada isticmaalaha adigoo bixinaya jawaab muuqaal ah inta lagu jiro beddelka.

import {useTacoTranslate} from 'tacotranslate/react';

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

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

Jamacaynta

Si jamac-qaabeynta loo maareeyo loona muujiyo calaamadaha ku saleysan tirada si sax ah luqadaha 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 isku mar gudaha isla codsiga, waxaad isticmaali kartaa bixiyeyaasha TacoTranslate badan oo leh qiimaha locale kala duwan sida hoos ku cad:

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 maamusho tarjumaado ama macneyaal kala duwan oo isla xarigga ah. Tani waxay si gaar ah waxtar u leedahay marka qoraalka isku midka ah uu u baahan yahay tarjumaado kala duwan iyadoo ku xiran macnaha guud. Adigoo siinaya aqoonsiyo gaar ah, waxaad hubinaysaa in mar kasta oo xarigga la isticmaalo si sax ah loogu turjumo iyadoo la raacayo 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 Af-Isbaanish loo turjumo “Iniciar sesión”, halka gelitaanka footer-ka laga yaabo in loo turjumo “Acceder”.

Farsamooyinka ugu fiican