Dukumentiyada: Isticmaalka horumarsan

Isticmaalka horumarsan

Somali

Maaraynta luqadaha ka bilaabma midig ilaa bidix

TacoTranslate waxay fududaysaa taageeridda luqadaha ka socda midig ilaa bidix (RTL), sida Carabiga iyo Cibraaniga, ee codsiyadaaga React. Maareynta saxda ah ee luqadaha RTL waxay xaqiijineysaa 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 shaqada la bixiyay ee ah isRightToLeftLocaleCode si aad u hubiso luqadda hadda jirta bannaanka React.

import {isRightToLeftLocaleCode} from 'tacotranslate';

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

Dhaqaajinta joojinta turjumaadda

Si aad u naaquiso turjumaadda qaybo gaar ah oo ka mid ah xaraf, ama si aad u hubiso in qaybo gaar ah si sidan oo kale loo hayo, waxaad isticmaali kartaa . Astaantan waxay waxtar u leedahay ilaalinta qaabka asalka ah ee magacyada, erayada farsamada, ama wax kasta oo kale oo aan la turjumin karin.

import {Translate} from 'tacotranslate/react';

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

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

Bixiyeyaasha TacoTranslate ee badan

Waxaan si weyn u dhiirrigelinaynaa in la isticmaalo bixiyeyaal badan oo TacoTranslate ah gudaha app-kaaga. Tani waa mid waxtar leh si loo habeeyo turjumaadahaaga iyo xarigyadaada qaybaha kala duwan, sida madaxdaada, lugta, ama qeybaha gaarka ah.

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

Bixiyeyaasha TacoTranslate waxay dhaxlaan dejimaha bixiyaha waalidka, sidaa darteed uma baahnid inaad ku celiso dejinno 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 dhaafidda asalka ama gobolka

Marka laga soo tago isticmaalka bixiyeyaasha badan ee TacoTranslate, waxaad sidoo kale ka beddeli kartaa labadaba asal iyo luqad heerarka qaybta Translate iyo qalabka 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 raridda

Marka luqadaha lagu beddelayo dhinaca macaamiisha, helitaanka turjumaadaha waxaa laga yaabaa inay qaadato dhowr daqiiqo iyadoo ku xiran xiriirka isticmaaleha. Waxa aad soo bandhigi kartaa tilmaame raritaan si aad u hagaajiso 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
	);
}

Jamac ahaan

Si loo maareeyo jamac ahaan iyo in si sax ah loo muujiyo calaamadaha ku saleysan tirada luqadaha kala duwan, tani waxaa loo tixgeliyaa dhaqan fiican:

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 waqtigaas gudaha isla codsiga, waxaad isticmaali kartaa bixiyeyaasha TacoTranslate ee badan oo leh qiimayaal locale oo kala duwan sida hoos lagu muujiyey:

Sidoo kale waxaad ka beddeli kartaa locale heerka qeybta 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 maamusho tarjumaado ama macnayaal kala duwan oo ku saabsan isla xarafkaas. Tani waa mid gaar ahaan faa'iido leh marka qoraalka isku midka ah uu u baahan yahay tarjumaado kala duwan iyadoo ku saleysan macnaha guud. Adigoo siinaya IDs gaar ah, waxaad hubinaysaa in tusaalaha kasta ee xarafka si sax ah loo 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, galitaanka madaxda waxaa laga yaabaa inuu u turjumo “Iniciar sesión”, halka galitaanka hoose uu u turjumi karo “Acceder” af Isbaanish.

Hab-dhaqannada ugu wanaagsan