Takardun Bayani: Amfani da TacoTranslate

Amfani da TacoTranslate

Hausa

Fassarar rubutu

A halin yanzu akwai hanyoyi guda uku don fassara kirtani: bangaren Translate, hook ɗin useTranslation, ko kayan aikin translateEntries.

Amfani da sashin Translate.
Yana fitar da fassarori a cikin wani span element, kuma yana tallafawa nuna HTML.

import {Translate} from 'tacotranslate/react';

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

Kuna iya canza nau'in element ta amfani da, misali, as="p" akan bangaren.

Amfani da useTranslation hook.
Yana dawo da fassarori a matsayin kirtani mai sauƙi. Yana da amfani, misali, a cikin alamun 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 kayan aikin translateEntries.
Fassara rubutun a ɓangaren uwar garken. Haɓaka hotunanka na OpenGraph.

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

Idan kirtani sun isa sabobinmu, muna fara tantance su kuma mu adana su, sannan nan take mu mayar da fassarar na'ura. Duk da cewa fassarorin na'ura gabaɗaya ba su da irin ingancin fassarorin AI ɗinmu, suna ba da amsa ta farko cikin sauri.

A lokaci guda, muna kaddamar da aikin fassara a bango don samar da fassarar AI mai inganci kuma ta zamani ga rubutunku. Da zarar fassarar AI ta shirya, za ta maye gurbin fassarar na'ura kuma za a aiko ta duk lokacin da kuka nemi fassarar rubutunku.

Idan kun fassara wata ƙirtani da hannu, waɗancan fassarorin suna da fifiko kuma za a mayar da su maimakon haka.

Amfani da asali

Ayyukan TacoTranslate suna ƙunshe da abin da muke kira origins. Ka ɗauke su a matsayin wuraren shiga, manyan fayiloli, ko ƙungiyoyi don strings ɗinku da fassarorinsu.

import {TacoTranslate} from 'tacotranslate/react';

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

Tushoshi suna ba ku damar raba rubuce-rubuce zuwa cikin ma'ajiyoyi masu ma'ana. Misali, za ku iya samun tushe guda ɗaya don takardun bayani, kuma wani daban don shafin tallan ku.

Don samun iko mafi dalla-dalla, za ku iya saita origins a matakin bangare.

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

Da fatan a lura cewa rubutu guda ɗaya na iya samun fassarori daban-daban a cikin asali daban-daban.

A ƙarshe, yadda kake raba strings zuwa origins ya dogara da kai da bukatunka. Duk da haka, ka lura cewa yawan strings a cikin origin guda na iya ƙara lokacin lodawa.

Sarrafa canje-canje

Ya kamata koyaushe ku yi amfani da masu canji don abubuwan da ke canzawa, kamar sunayen masu amfani, kwanaki, adireshin imel, da sauransu.

Ana bayyana masu canji a cikin ƙirtani ta amfani da alamar baka 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, sashin Translate yana tallafawa kuma yana nuna abun HTML. Sai dai, za ka iya zaɓar kada wannan hali ya kasance ta hanyar saita useDangerouslySetInnerHTML zuwa false.

Ana ba da shawarar matuƙa a kashe nuna HTML lokacin fassara abubuwan da ba a yarda da su ba, kamar abubuwan da masu amfani suka ƙirƙira.

Ana tsabtace dukkanin fitarwa koyaushe ta amfani da sanitize-html kafin a nuna su.

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 mai sauƙi.

Nunin gefen sabar

Amfani da TacoTranslate

Yadda ake fassara rubutun

Amfani da asali

Sarrafa canje-canje

Sarrafa abun ciki na HTML