Dukumentiga: Isticmaalka horumarsan

Isticmaalka horumarsan

Somali

Maareynta luqadaha laga qoro midig ilaa bidix

TacoTranslate waxay ka dhigaysaa mid sahlan in la taageero luqadaha laga akhriyo midig ilaa bidix (RTL), sida Carabi iyo Ibraani, codsiyadaada React. Maareynta saxda ah ee luqadaha RTL waxay xaqiijinaysaa in nuxurkaaga 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>
	);
}

Sidoo kale waxaad isticmaali kartaa shaqada la bixiyey isRightToLeftLocaleCode si aad u 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 qaybaha qaarkood ee xadhig 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 ilaalinta qaabka asalka ah ee magacyada, erayada farsamada, ama wax kasta oo kale oo aan la rabin in la turjumin.

import {Translate} from 'tacotranslate/react';

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

Tusaale ahaan, erayga “TacoTranslate” lama beddeli doono marka la turjumayo.

Bixiyeyaasha badan ee TacoTranslate

Waxaan si xooggan ku dhiirrigelinaynaa inaad isticmaasho dhowr bixiyayaal TacoTranslate gudaha app-kaaga. Tani waxay waxtar u leedahay abaabulidda turjumaadahaaga iyo xargaha qoraalka ee asallo kala duwan, sida madaxa (header), cagta (footer), ama qaybaha gaarka ah.

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

Bixiyeyaasha TacoTranslate waxay ka dhaxlaan dejimaha bixiyaha waalidka, sidaa 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 tanaasulka asalka ama luqadda deegaanka

Marka laga soo tago isticmaalka bixiyeyaasha badan ee TacoTranslate, waxaad sidoo kale ka beddeli kartaa asal iyo luqad labadaba heerarka qaybta Translate iyo isku xidhka 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 dhinaca macmiilka la beddelayo, soo dejinta turjumaadaha waxay qaadan kartaa waqti kooban iyadoo ku xiran isku xirka isticmaalaha. Waxaad muujin kartaa tilmaame rarid si aad u wanaajiso khibradda 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 loo maareeyo jamac-bixinta loona muujiyo calaamadaha ku saleysan tirada si sax ah luqado kala duwan, tani waa 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 u taageerto luqado badan isla mar ahaantaana gudaha isla codsiga, waxaad isticmaali kartaa bixiyeyaasha TacoTranslate ee badan oo leh qiimayaasha locale ee kala duwan, sida hoos ku cad:

Waxaad sidoo kale ka beddeli kartaa locale heerka component-ka 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 turjumaadda

Waad ku dari kartaa id qaybta Translate si aad u maamusho turjumaado ama macnayaal kala duwan oo isla weedh ah. Tani aad bay waxtar u leedahay marka isla qoraalka laga rabo turjumaado kala duwan iyadoo ku xiran macnaha. Markaad siiso aqoonsiyo gaar ah, waxaad xaqiijinaysaa in tusaal kasta 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, galitaanka cinwaanka sare waxaa laga yaabaa in lagu turjumo “Iniciar sesión”, iyo galitaanka cinwaanka hoose waxaa laga yaabaa in lagu turjumo “Acceder” Af Isbaanish.

Hababka ugu wanaagsan