Dukumentiyada: Isticmaalka horumarsan

Isticmaalka horumarsan

Somali

Maareynta luqadaha laga akhriyo midig ilaa bidix

TacoTranslate waxay fududeyneysaa taageerida luqadaha bidix ilaa midig (RTL), sida Carabi iyo Cibraani, ee codsiyadaada React. Maareynta saxda ah ee luqadaha RTL waxay hubineysaa in waxyaabahaaga si sax ah loogu soo bandhigo isticmaaleyaasha akhrista bidix ilaa midig.

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 isRightToLeftLocaleCode si aad u hubiso luqadda hadda jirta marka laga soo baxo React.

import {isRightToLeftLocaleCode} from 'tacotranslate';

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

Dhimista turjumaadda

Si aad uga joojiso turjumaadda qaybaha qaarkood ee xaraf ama si aad u hubiso in qaybo gaar ah sidii ay yihiin loo ilaaliyo, waxaad isticmaali kartaa saddexda calaamadood ee afar geesle ah . Astaantan waxay waxtar leedahay si loo ilaaliyo qaabka asalka ah ee magacyada, ereyada 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” ma beddeli doono tarjumadda.

Bixiyeyaasha TacoTranslate ee badan

Waxaan si xooggan u dhiirrigelinaynaa in la isticmaalo dhowr bixiye oo TacoTranslate ah gudaha app-kaaga. Tani waxay waxtar u leedahay abaabulka turjumaadahaaga iyo xarigyadaada qaybaha kala duwan, sida cinwaankaaga, footer-ka, ama qaybaha gaarka ah.

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

Bixiyeyaasha TacoTranslate waxay ka dhaxlaan dejimaha bixiyaha waalidka, sidaas 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>
	);
}

Beddelidda asal ama luqad deegaanka

Marka laga soo tago isticmaalka bixiyeyaasha badan ee TacoTranslate, waxaad sidoo kale ka beddeli kartaa asalka iyo goobta luqadda ee qaybta Translate iyo heerarka useTranslation hook.

import {Translate, useTranslation} from 'tacotranslate/react';

function Greeting() {
	const spanishHello = useTranslation('Hello!', {locale: 'es'});

	return (
		<>
			{spanishHello}
			<Translate string="What’s up?" origin="greeting" />
		</>
	);
}

Maaraynta rarista

Marka la beddelayo luqadaha dhinaca macaamilka, soo helida turjumaadaha waxay qaadan kartaa xoogaa waqti ah iyadoo ku xiran isku xirka isticmaalaha. Waxaad soo bandhigi kartaa muujiyaha raritaanka 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
	);
}

Is-ururin magac-badan

Si loo maareeyo jamac ahaan iyo si sax ah loo soo bandhigo calaamadaha ku saleysan tirinta luqadaha kala duwan, tani waxaa loo arkaa 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)}}
		/>
	);
}

Luuqado badan

Si aad u taageerto luqado badan isla waqtigaas gudaheeda isla codsi, waxaad isticmaali kartaa bixiyeyaasha TacoTranslate ee badan iyadoo la adeegsanayo qiimayaasha kala duwan ee locale, sida hoos ku cad:

Waxaad sidoo kale ka badali kartaa locale heerka qaybta 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 maareyso tarjumado kala duwan ama macnooyin kala duwan oo ku saabsan xadhig isku mid ah. Tani waxay si gaar ah faa’iido u leedahay marka isla qoraalka uu u baahan yahay turjumaado kala duwan iyadoo ku xiran macnaha guud. Adigoo siinaya IDs gaar ah, waxaad hubisaa in tusaalaha kasta ee xadhigga loo turjumay si sax ah iyadoo loo eegayo macnaha 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 madaxa wuxuu noqon karaa “Iniciar sesión”, iyo gelitaanka cagta hoose wuxuu noqon karaa “Acceder” af Isbaanish.

Hababka ugu wanaagsan