Takardun Bayani: Amfani na Ci Gaba

Amfani na ci gaba

Hausa

Magance harsunan da ake rubutawa daga dama zuwa hagu

TacoTranslate yana sauƙaƙa goyon bayan harsuna daga dama zuwa hagu (RTL), kamar Larabci da Ibrananci, a cikin aikace-aikacen React ɗinku. Kyakkyawan sarrafa harsunan RTL yana tabbatar da cewa abun cikin ku yana nunawa 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>
	);
}

Hakanan za ku iya amfani da isRightToLeftLocaleCode da aka bayar don duba yaren yanzu daga wajen React.

import {isRightToLeftLocaleCode} from 'tacotranslate';

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

Kashe fassara

Don hana fassara wasu takamaiman sassa na rubutu ko don tabbatar da cewa wasu ɓangarori za su kasance kamar yadda suke, za ka iya amfani da bakunan murabba'i guda uku. Wannan fasalin yana da amfani wajen kiyaye asalin tsarin sunaye, ƙamus na 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” za ta kasance ba a canza ta ba a cikin fassarar.

Masu samar da TacoTranslate da yawa

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

Za ku iya karanta ƙarin bayani kan yadda ake amfani da tushoshi anan.

TacoTranslate masu samar sun gaji saituna daga kowanne mai samar na uwa, 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 asali ko saitin yare

Ban da amfani da masu samar da TacoTranslate da yawa, za ku kuma iya maye gurbin duka asali da saitin yare a matakan sashin Translate da matakan hook na useTranslation.

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

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

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

Sarrafa lodawa

Lokacin da ake canza harshe a bangaren mai amfani, ɗaukar fassarori na iya ɗaukar ƴan dakikoki dangane da haɗin intanet na mai amfani. Kuna iya nuna alamar loda don inganta ƙwarewar mai amfani ta hanyar samar da amsa ta gani yayin sauyin.

import {useTacoTranslate} from 'tacotranslate/react';

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

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

Yin jam'i

Don sarrafa jam’i da kuma nuna lakabi na adadi cikin harsuna daban-daban yadda ya kamata, ana ganin wannan a matsayin 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 dama

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

Haka kuma za ka iya maye gurbin locale a matakin bangare (component) 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 ID ɗin fassara

Kuna iya ƙara id zuwa bangaren Translate don sarrafa fassaruwa ko ma'anonin daban-daban ga rubutu guda. Wannan yana da amfani musamman idan rubutu ɗaya yana buƙatar fassaruwa daban-daban gwargwadon mahalli. Ta hanyar sanya ID na musamman, kuna tabbatar cewa kowace maimaita wannan rubutu ana fassara ta daidai bisa ga ma'anarta 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 header zai iya fassaruwa zuwa “Iniciar sesión”, kuma maɓallin shiga na footer zai iya fassaruwa zuwa “Acceder” a Sifaniyanci.

Mafi kyawun hanyoyi