Dukumentiga: Isticmaalka horumarsan

Isticmaalka horumarsan

Somali

Maareynta luqadaha laga akhriyo midig ilaa bidix

TacoTranslate waxay sahlaysaa in la taageero luqadaha laga akhriyo midig ilaa bidix (RTL), sida Carabi iyo Cibraani, ee codsiyadaada React. Maareynta saxda ah ee luqadahaan RTL waxay xaqiijisaa in nuxurkaagu 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 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 turjumaadda

Si aad u joojiso turjumaadda qayb gaar ah oo xadhig ah ama si aad u hubiso in qaybo gaar ah lagu hayo sidii ay yihiin, waxaad isticmaali kartaa triple square brackets. Astaantan waxay waxtar u leedahay inay ilaaliso 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]]]!" />
	);
}

Tusaalahan, erayga “TacoTranslate” lama beddeli doono tarjumaadda.

Bixiyeyaasha badan ee TacoTranslate

Waxaan si xoogan u dhiirrigelinaynaa in aad isticmaasho dhowr ka mid ah bixiyeyaasha TacoTranslate ee app-kaaga. Tani waa mid waxtar leh marka la habaynayo turjumaadahaaga iyo xargaha qoraalka ee asalo kala duwan, sida qaybta sare (header), qaybta hoose (footer), ama qaybo gaar ah.

Waxaad halkan ka akhrisan kartaa wax dheeraad ah oo ku saabsan isticmaalka asalka.

TacoTranslate bixiyeyaasha waxay 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 luqadda

Intaa waxaa dheer, marka laga soo tago isticmaalka bixiyeyaasha badan ee TacoTranslate, waxaad sidoo kale ka beddeli kartaa labadaba 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 luqadaha laga beddelayo dhinaca macmiilka, soo dejinta turjumaadaha waxay qaadan kartaa dhowr ilbiriqsi iyadoo ku xiran xawaaraha xiriirka isticmaalaha. Waxaad soo bandhigi kartaa tilmaame raritaan si aad u wanaajiso khibradda isticmaalaha adigoo siinaya jawaab muuqaal inta lagu guda jiro is-beddelka.

import {useTacoTranslate} from 'tacotranslate/react';

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

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

Jamacayn

Si sax ah loogu maareeyo muujinta jamaca loona soo bandhigo calaamadaha ku saleysan tirada luqado kala duwan, tani waxaa loo tixgeliyaa 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 kala duwan isku mar gudaha isla codsi, waxaad isticmaal kartaa bixiyeyaal TacoTranslate badan oo leh qiimayaal locale kala duwan sida hoos ka muuqata:

Waxaad sidoo kale dib uga qori 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 turjumaado ama macneyaal kala duwan oo loogu talagalay isla xadhigga qoraalka. Tani waxay si gaar ah waxtar u leedahay marka isla qoraalka uu u baahan yahay turjumaado kala duwan iyadoo ku xiran macnaha guud. Adigoo siinaya aqoonsiyo gaar ah, waxaad xaqiijinaysaa in nuqul kasta oo xadhigga si sax ah loogu turjumo iyadoo lagu salaynayo 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 ciwaanka sare waxaa laga yaabaa in lagu turjumo “Iniciar sesión”, halka gelitaanka ciwaanka hoose-na laga yaabaa in lagu turjumo “Acceder” Af-Isbaanish.

Dhaqamada ugu wanaagsan