TacoTranslate
/
Takardun BayaniFarashi
 
  1. Gabatarwa
  2. Fara amfani
  3. Saitawa da daidaitawa
  4. Amfani da TacoTranslate
  5. Fassarar ɓangaren uwar garke
  6. Amfani na ci gaba
  7. Mafi kyawun ayyuka
  8. Magance kuskure da gano matsala
  9. Harsunan da ake goyan baya

Amfani na ci gaba

Sarrafa harsunan daga dama zuwa hagu

TacoTranslate yana sauƙaƙa goyon bayan harsunan daga dama zuwa hagu (RTL), kamar Larabci da Ibrananci, a cikin aikace-aikacen React ɗinku. Yin amfani da harsunan RTL yadda ya kamata yana tabbatar da cewa abun cikin ku yana bayyana daidai ga masu amfani da 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 zaka iya amfani da aikin isRightToLeftLocaleCode da aka bayar don duba harshen yanzu a wajen React.

import {isRightToLeftLocaleCode} from 'tacotranslate';

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

Kashe fassara

Don kashe fassara ga wasu sassa na rubutu ko don tabbatar da cewa wasu bangarori su zauna yadda suke, za ka iya amfani da triple square brackets. Wannan fasalin yana da amfani wajen kiyaye asalin tsarin sunaye, kalmomin fasaha, ko duk wani abun da bai kamata a fassara ba.

import {Translate} from 'tacotranslate/react';

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

A cikin wannan misali, kalmar “TacoTranslate” ba za ta chanja ba a cikin fassarar.

Masu bayar da TacoTranslate da yawa

Muna ƙarfafa sosai amfani da masu bayar da TacoTranslate da yawa a cikin aikace-aikacenku. Wannan yana da amfani wajen tsara fassarorinku da ƙungiyoyi cikin asali daban-daban, kamar kanun shafi, ƙasan shafi, ko sassa na musamman.

Kuna iya karanta ƙarin bayani game da amfani da asalai anan.

Masu samar da TacoTranslate suna gada saituna daga kowanne mai samarwa na uba, don haka ba za ku buƙaci maimaita wasu 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>
	);
}

Maimaita asalin ko yanki

Baya ga amfani da masu samar da TacoTranslate da yawa, za ka iya kuma canza asalinsa da harshen Translate na kayan aikin da kuma matakai na 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" />
		</>
	);
}

Sarrafa lodin

Lokacin canza harsuna a gefen abokin ciniki, daukar lokaci don samo fassarar na iya ɗaukar wasu 'yan lokuta gwargwadon haɗin intanet na mai amfani. Kuna iya nuna alamar lodawa don inganta ƙwarewar mai amfani ta hanyar bayar da ra'ayi na gani yayin canjin.

import {useTacoTranslate} from 'tacotranslate/react';

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

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

Yawaitar jam'i

Don sarrafa jam'i da nuna lakabi bisa ga ƙididdiga daidai a cikin harsuna daban-daban, wannan ana ɗauka 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 yawa

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

Hakanan zaka iya sauya locale a matakin sashi ko na makulli.

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 na fassara

Kuna iya ƙara id zuwa Translate sashin don sarrafa fassarar daban-daban ko ma'anoni daban-daban na layin rubutu ɗaya. Wannan yana da amfani sosai lokacin da rubutun ɗaya yake buƙatar fassara daban-daban bisa ga mahallin da ake ciki. Ta hanyar bai wa kowanne daban na ID na musamman, kuna tabbatar da cewa kowanne misalin layin rubutun ana fassara shi daidai da ma'anar sa 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, shiga na header na iya fassaruwa zuwa “Iniciar sesión”, kuma shiga na footer na iya fassaruwa zuwa “Acceder” a cikin harshen Sifaniyanci.

Mafi kyawun ayyuka

Wani samfurin daga NattskiftetAn yi a Norway