Dukumentiyada: Isticmaalka Horumarsan

Isticmaalka horumarsan

Somali

Maaraynta luqadaha laga akhriyey midig ilaa bidix

TacoTranslate waxa ay fududeysaa taageeridda luqadaha qoraalkoodu ka bilaabmo midig ilaa bidix (RTL), sida Carabi iyo Cibraaniga, ee barnaamijyadaada React. Maaraynta saxda ah ee luqadaha RTL waxay hubisaa in waxyaabahaaga si sax ah loogu soo bandhigo isticmaale yaasha akhriya qoraalka iyaga oo ka bilaabaya 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 banaanka React.

import {isRightToLeftLocaleCode} from 'tacotranslate';

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

Dhismaha turjumaadda

Si aad u naaqusato turjumaadda qaybo gaar ah oo ka mid ah xarigga ama aad u hubiso in qaybo gaar ah sida ay yihiin loogu kaydiyo, waxaad isticmaali kartaa afar jibbaaro oo afar jibbaaro ah triple square brackets. Astaantan waxay waxtar u leedahay ilaalinta qaabka asalka ah ee magacyada, erayada farsamada, ama wax kasta oo kale oo aan la turjumin.

import {Translate} from 'tacotranslate/react';

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

Tusaalahan, erayga “TacoTranslate” lama beddeli doono turjumaadda.

Bixiyeyaasha badan ee TacoTranslate

Waxaan si xooggan ku dhiirigelinaynaa inaad isticmaasho bixiyeyaasha badan ee TacoTranslate ee app-kaaga. Tani waxay waxtar u leedahay habaynta turjumaadahaaga iyo xarigyadaaga iyadoo loo qaybiyo asal kala duwan, sida madaxa, hoose, ama qaybaha gaarka ah.

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

Bixiyeyaasha TacoTranslate waxay 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 beddelidda asalka ama deegaanka

Marka laga soo tago isticmaalka bixiyeyaasha badan ee TacoTranslate, waxaad sidoo kale beddeli kartaa asalka iyo deegaanka labadaba heerarka qaybta Translate iyo hook-ga 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 loading

Marka luqadaha la beddelo dhinaca macaamilka, soo qaadista turjumaadaha waxay qaadan kartaa dhowr ilbiriqsi iyadoo ku xiran xiriirka isticmaaleha. Waxaad muujin kartaa tilmaame raritaan si aad u hagaajiso waayo-aragnimada isticmaaleha adigoo siinaya jawaab muuqaal ah inta lagu guda jiro beddelka.

import {useTacoTranslate} from 'tacotranslate/react';

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

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

Labadlaha (Jamaca)

Si loo maareeyo jamac-sameynta iyo si sax ah loogu soo bandhigo calaamadaha ku saleysan tirada luqadaha kala duwan, tani waxaa loo tixgeliyaa habdhaqan 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 isla waqtigaas 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 qaybta ama heerka 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 turjumaado kala duwan ama macnayaal kala duwan oo isla xarafka ah. Tani waa mid gaar ahaan waxtar leh marka isla qoraalka uu u baahan yahay turjumaado kala duwan oo ku saleysan macnaha guud. Adigoo siinaya aqoonsiyo gaar ah, waxaad xaqiijinaysaa in munaasabad kasta oo xarafku leeyahay si sax ah loo turjumay iyadoo la raacayo macnaha gaarka ah ee uu leeyahay.

import {Translate} from 'tacotranslate/react';

function Header() {
	return (
		<Translate id="header" string="Login" />
	);
}

function Footer() {
	return (
		<Translate id="footer" string="Login" />
	);
}

Tusaale ahaan, login-ka madaxda waxa laga yaabaa inuu u turjumo “Iniciar sesión”, iyo login-ka hoose wuxuu u turjumi karaa “Acceder” af Isbaanish.

Dhaqamada ugu wanaagsan