Dukumentiyada: Isticmaalka Sare

Isticmaalka horumarsan

Somali

Maareynta luqadaha ka qora midig ilaa bidix

TacoTranslate waxay fududeysaa taageerada luqadaha laga akhriyo midig ilaa bidix (RTL), sida Carabiga iyo Cibraani, gudaha codsiyadaaga React. Maamulka saxda ah ee luqadaha RTL wuxuu hubinayaa in macluumaadkaaga 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 hawsha la bixiyay ee isRightToLeftLocaleCode si aad u hubiso luqadda hadda jirta marka laga baxo React.

import {isRightToLeftLocaleCode} from 'tacotranslate';

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

Dhimista turjumaadda

Si aad u joojiso turjumaadda qaybaha gaarka ah ee xarafka ama aad u hubiso in qaybaha qaarkood sida ay yihiin loo ilaaliyo, waxaad isticmaali kartaa qawaaniinka saddex jibbaaran ee fidsan. Astaantan waxay waxtar u leedahay ilaalinta qaabka asalka ah ee magacyada, erayada farsamada, ama wax kasta oo kale oo aan la turjumin doonin.

import {Translate} from 'tacotranslate/react';

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

Tusaalahan, erayga “TacoTranslate” ma beddelmi doono tarjumaadda.

Bixiyeyaasha TacoTranslate ee badan

Waxaan si xooggan ku dhiirrigelinaynaa in aad isticmaasho dhowr bixiye oo TacoTranslate ah codsigaaga gudaheeda. Tani waxay waxtar u leedahay habaynta turjumaadahaaga iyo xariggaaga meelo kala duwan, sida madaxda, cagta, ama qaybo gaar ah.

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

Bixiyeyaasha TacoTranslate waxay 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>
	);
}

Ka beddelidda asalka ama deegaanka

Marka laga soo tago isticmaalka dhowr bixiyeyaasha TacoTranslate, waxaad sidoo kale ka beddeli kartaa asalka iyo luqadda ee qeybta Translate iyo heerarka 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 raritaanka

Marka luqadaha laga beddelayo dhinaca macmiilka, soo helidda turjumaadaha waxay qaadan kartaa dhowr ilbiriqsi iyadoo ku xiran isku xirka isticmaaleha. Waxaad soo bandhigi kartaa tilmaame loading si aad u hagaajiso waayo-aragnimada isticmaaleha 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
	);
}

Kala-badalashada lambarada markii la tirinayo

Si loo maareeyo badan-qoraalka loona muujiyo calaamadaha ku saleysan tirinta si sax ah afafka kala duwan, tani waa waxa ugu wanaagsan ee la sameeyo:

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 hal codsi, waxaad isticmaali kartaa bixiyeyaasha TacoTranslate badan oo leh qiimayaasha locale ee kala duwan sida hoos ku muujisan:

Waxaad sidoo kale ka bedeli 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 translation IDs

Waxaad ku dari kartaa id qaybta Translate si aad u maareyso turjumaado ama macnayaal kala duwan oo xadhig isku mid ah ah. Tani waxay si gaar ah waxtar u leedahay marka isla qoraalka uu u baahan yahay turjumaado kala duwan iyadoo ku xiran macnaha. Adigoo siinaya IDs gaar ah, waxaad xaqiijineysaa in tusaale kasta oo qoraalka ka mid ah si sax ah loogu turjumo 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, galitaanka madaxa waxa laga yaabaa in loo turjumo “Iniciar sesión”, iyo galitaanka hoose waxa laga yaabaa in loo turjumo “Acceder” af Isbaanish.

Hababka ugu wanaagsan