Takardun bayani: Amfani na ci gaba

Amfani na ci gaba

Hausa

Kula da harsunan da ake rubuta daga dama zuwa hagu

TacoTranslate yana sauƙaƙa tallafawa harsunan da ake rubutawa daga dama zuwa hagu (RTL), kamar Larabci da Ibrananci, a cikin aikace-aikacen React ɗinku. Sarrafa harsunan RTL yadda ya kamata yana tabbatar cewa abubuwan cikin ku suna bayyana daidai ga masu amfani waɗanda ke karantawa daga dama zuwa hagu.

import {useTacoTranslate} from 'tacotranslate/react';

function Document() {
	const {locale, isRightToLeft} = useTacoTranslate();

	return (
		<html lang={locale} dir={isRightToLeft ? 'rtl' : 'ltr'}>
			<body>
				// ...
			</body>
		</html>
	);
}

Haka kuma, za ku iya amfani da aikin isRightToLeftLocaleCode da aka bayar don duba yaren yanzu a wajen React.

import {isRightToLeftLocaleCode} from 'tacotranslate';

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

Dakatar da fassara

Don hana fassara ga wasu sassa na rubutu ko don tabbatar da cewa wasu ɓangarori su kasance kamar yadda suke, za ka iya amfani da alamomin murabba'i sau uku (triple square brackets). Wannan fasalin yana da amfani wajen kiyaye ainihin tsarin sunaye, kalmomin fasaha, ko duk wani abun ciki da bai kamata a fassara ba.

import {Translate} from 'tacotranslate/react';

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

A cikin wannan misalin, kalmar “TacoTranslate” ba za a canza ta ba a cikin fassara.

Mabambantan masu samar da TacoTranslate

Muna ƙarfafa ku sosai ku yi amfani da masu samar da TacoTranslate da yawa a cikin aikace-aikacenku. Wannan yana da amfani wajen tsara fassarorinku da layukan rubutu cikin asali daban-daban, kamar kan shafi, ƙasan shafi, ko wasu sassa na musamman.

Za ku iya karanta ƙarin bayani game da amfani da asali anan.

TacoTranslate masu ba da sabis suna gado saituna daga kowanne mahaifi mai ba da sabis, don haka ba za ku buƙaci maimaita sauran saituna ba.

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>
	);
}

Maye gurbin tushen ko saitin yare

Bugu da ƙari ga amfani da masu samar da TacoTranslate da yawa, za ka kuma iya maye gurbinsa ta hanyar maye gurbin asali da yare a matakin sashin Translate da matakin hook useTranslation.

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

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

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

Gudanar da lodawa

Lokacin canza harshe a ɓangaren abokin ciniki, samun fassarori na iya ɗaukar 'yan daƙiƙa, gwargwadon haɗin intanet na mai amfani. Kuna iya nuna alamar loda don inganta ƙwarewar mai amfani ta hanyar ba da amsa ta gani yayin sauyawa.

import {useTacoTranslate} from 'tacotranslate/react';

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

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

Jam'i

Don kula da jam'i da kuma nuna alamu masu dangantaka da ƙididdiga daidai a cikin harsuna daban-daban, ana ɗaukar wannan mafi kyawun aiki:

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)}}
		/>
	);
}

Harsuna da yawa

Don tallafawa harsuna da yawa a lokaci guda a cikin wannan aikace-aikacen, za ku iya yi amfani da masu samar da TacoTranslate da yawa tare da ƙimar locale daban-daban kamar yadda aka nuna a ƙasa:

Hakanan za ku iya musanya locale a matakin ɓangare ko na hook.

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>
	);
}

Amfani da lambobin ID na fassara

Kuna iya ƙara id zuwa sashin Translate don sarrafa fassarori ko ma'anonin daban-daban na wannan rubutu. Wannan yana da matuƙar amfani musamman idan rubutu guda ɗaya yana buƙatar fassarori daban-daban gwargwadon mahalli. Ta hanyar bai wa kowane ID na musamman, kuna tabbatar da cewa kowace misali na wannan rubutu an fassara shi daidai bisa ga ma'anarsa ta musamman.

import {Translate} from 'tacotranslate/react';

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

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

Alal misali, maɓallin shiga na kan shafi na iya fassaruwa zuwa “Iniciar sesión”, kuma maɓallin shiga na ƙasan shafi na iya fassaruwa zuwa “Acceder” a cikin Sifaniyanci.

Mafi kyawun hanyoyi