Takardun Bayani: Amfani da TacoTranslate

Amfani da TacoTranslate

Hausa

Fassara rubutun

A halin yanzu akwai hanyoyi guda uku don fassara rubutun: sashin Translate, hook useTranslation, ko kayan aikin translateEntries.

Amfani da sashin Translate.
Yana fitar da fassara a cikin wani span abu, kuma yana goyon bayan nunin HTML.

import {Translate} from 'tacotranslate/react';

function Page() {
	return <Translate string="Hello, world!" />;
}

Kuna iya canza nau'in element ta amfani, alal misali, as="p" a kan sashin.

Amfani da useTranslation hook.
Yana dawo da fassara a matsayin ƙirtani mai sauƙi. Ya dace, misali, a cikin alamomin meta.

import {useEffect} from 'react';
import {useTranslation} from 'tacotranslate/react';

function Page() {
	const helloWorld = useTranslation('Hello, world!');

	useEffect(() => {
		alert(helloWorld);
	}, [helloWorld]);

	return (
		<title>{useTranslation('My page title')}</title>
	);
}

Amfani da translateEntries kayan aiki.
Fassara rubutattun jeri a ɓangaren uwar garken. Ƙara ƙarfi ga hotunan OpenGraph ɗinku.

import {createEntry, translateEntries} from 'tacotranslate';

async function generateMetadata(locale = 'es') {
	const title = createEntry({string: 'Hello, world!'});
	const description = createEntry({string: 'TacoTranslate on the server'});

	const translations = await translateEntries(
		tacoTranslate,
		{origin: 'opengraph', locale},
		[title, description]
	);

	return {
		title: translations(title),
		description: translations(description)
	};
}

Lokacin da rubutun suka isa sabobinmu, da farko muna tantance su kuma muna adana su, sannan nan da nan muna mayar da fassarar na'ura. Ko da yake fassarorin na'ura gabaɗaya suna da ƙarancin inganci idan aka kwatanta da fassarorinmu na AI, suna ba da saurin amsa na farko.

A lokaci guda, muna ƙaddamar da aikin fassara marar lokaci ɗaya don samar da fassarar AI mai inganci sosai kuma ta zamani ga kirtani ɗinku. Da zarar fassarar AI ta shirya, za ta maye gurbin fassarar na'ura kuma za a aika da ita duk lokacin da kuka nemi fassarar kirtani ɗinku.

Idan kun fassara wani matani da hannu, waɗancan fassarar suna da fifiko kuma za a mayar da su maimakon haka.

Amfani da asali

Ayyukan TacoTranslate sun ƙunshi abin da muke kira tushoshi. Za ka iya ɗaukar su a matsayin ƙofofin shiga, fayiloli, ko rukunai don rubutunku da fassarorinsu.

import {TacoTranslate} from 'tacotranslate/react';

function Menu() {
	return (
		<TacoTranslate origin="application-menu">
			// ...
		</TacoTranslate>
	);
}

Asaloli suna ba ku damar rarraba kirtani cikin akwatai masu ma'ana. Misali, kuna iya yin amfani da asali guda ɗaya don takardun bayani, kuma wani asali don shafin tallan ku.

Don ƙarin iko cikin dalla-dalla, za ku iya saita tushoshi a matakin bangare.

Domin cimma wannan, yi la'akari da amfani da masu samar da TacoTranslate da yawa a cikin aikin ku.

Da fatan za a lura cewa wannan rubutu guda na iya samun fassaruwa daban-daban a asali daban-daban.

A ƙarshe, yadda kuka rarraba strings cikin origins ya dogara da ku da bukatunku. Duk da haka, ku lura cewa samun strings da yawa a cikin origin ɗaya zai iya ƙara lokacin lodawa.

Sarrafa canje-canje

Ya kamata koyaushe ku yi amfani da masu canji (variables) don abubuwan da ke canzawa, kamar sunayen masu amfani, kwanan wata, adireshin imel, da sauransu.

Ana ayyana canje-canje a cikin kirtani ta amfani da murabba'ai biyu, kamar {{variable}}.

import {Translate} from 'tacotranslate/react';

function Greeting() {
	const name = 'Juan';
	return <Translate string="Hello, {{name}}!" variables={{name}} />;
}

import {useTranslation} from 'tacotranslate/react';

function useGreeting() {
	const name = 'Juan';
	return useTranslation('Hello, {{name}}!', {variables: {name}});
}

Sarrafa abun ciki na HTML

A matsayin tsoho, komponent ɗin Translate yana tallafawa kuma yana nuna abun HTML. Sai dai, za ku iya fita daga wannan hali ta hanyar saita useDangerouslySetInnerHTML zuwa false.

Ana ba da shawarar sosai a kashe nunin HTML lokacin fassara abubuwan da ba a yarda da su ba, kamar waɗanda masu amfani suka ƙirƙira.

Ana tsaftace duk abin da aka fitar koyaushe ta amfani da sanitize-html kafin a nuna shi.

import {Translate} from 'tacotranslate/react';

function Page() {
	return (
		<Translate
			string={`
				Welcome to <strong>my</strong> website.
				I’m using <a href="{{url}}">TacoTranslate</a> to translate text.
			`}
			variables={{url: 'https://tacotranslate.com'}}
			useDangerouslySetInnerHTML={false}
		/>
	);
}

Za a nuna misalin da ke sama a matsayin rubutu tsantsa.

Nunin gefen sabar

Amfani da TacoTranslate

Yadda ake fassara rubutun

Amfani da asali

Sarrafa canje-canje

Sarrafa abun ciki na HTML