Takardun bayani: Yin amfani da TacoTranslate

Amfani da TacoTranslate

Hausa

Fassarar ƙirtani

A halin yanzu akwai hanyoyi guda uku na fassara ƙirtani: sashin Translate, hook ɗin useTranslation, ko kuma ƙayan aikin translateEntries.

Amfani da sashin Translate.
Yana fitar da fassara 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" a kan sashi.

Amfani da hook na useTranslation.
Yana mayar da fassara a matsayin rubutu mai sauƙi. Ana amfani da shi, 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 kirtani a ɓangaren uwar garke. 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)
	};
}

Lokacin da rubutun suka isa sabobinmu, da farko muna tantance su kuma mu adana su, sannan nan take mu mayar da fassarar na'ura. Ko da yake fassarorin na'ura gabaɗaya ba sa kai ingancin fassarorin AI ɗinmu, suna ba da amsa ta farko cikin sauri.

A lokaci guda, muna ƙaddamar da aikin fassara a bayan fage don samar da fassarar AI mai inganci kuma na zamani ga rubutunku. Da zarar fassarar AI ta shirya, za ta maye gurbin fassarar injin kuma za a aiko ta duk lokacin da kuka nemi fassarar rubutunku.

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

Amfanin asali

Ayyukan TacoTranslate sun ƙunshi abin da muke kira tushoshi. Ka yi tunanin su a matsayin wuraren shiga, fayiloli, ko rukunai don ƙirtaninka da fassararsu.

import {TacoTranslate} from 'tacotranslate/react';

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

Origins suna ba ku damar raba kirtani zuwa cikin akwatuna masu ma'ana. Misali, za ku iya samun asali guda ɗaya don takardun bayani, kuma wani don shafin tallan ku.

Don samun iko mai daki-daki, za ku iya saita tushoshi a matakin bangare.

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

Da fatan za a lura cewa irin wannan rubutu na iya samun fassarori daban-daban a majiyoyi daban-daban.

A ƙarshe, yadda kuke raba rubutun zuwa tushoshi ya dogara da ku da bukatunku. Duk da haka, ku lura cewa yawan rubutun a cikin tushe guda na iya ƙara lokacin loda.

Sarrafa masu canzawa

Ya kamata koyaushe ku yi amfani da masu canji don abun ciki mai canzawa, kamar sunayen masu amfani, ranaku, adireshin imel, da sauransu.

Ana ayyana masu canji a cikin kirtani ta amfani da alamun baka guda 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}});
}

Gudanar da abun ciki na HTML

A tsoho, bangaren Translate yana tallafawa kuma yana nuna abun HTML. Duk da haka, za ku iya zaɓar yin watsi da wannan halayya ta hanyar saita useDangerouslySetInnerHTML zuwa false.

Ana ba da shawara sosai a kashe nunin HTML lokacin da ake fassara abun da ba a yarda da shi ba, kamar abun da masu amfani suka ƙirƙira.

Koyaushe ana tsabtace duk abin da ake fitarwa tare 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 kawai.

Nunin gefen sabar

Amfani da TacoTranslate

Yadda ake fassara rubutun

Amfanin asali

Sarrafa masu canzawa

Gudanar da abun ciki na HTML