Takardun Bayani: Amfani da TacoTranslate

Amfani da TacoTranslate

Hausa

Fassara ƙirar rubutu

A halin yanzu akwai hanyoyi guda uku na fassara jimloli: Translate bangare, useTranslation ƙyallin, ko kuma translateEntries kayan aiki.

Amfani da Translate sassan.
Yana fitar da fassarar a cikin wani span abu, kuma yana goyon bayan nunawa HTML.

import {Translate} from 'tacotranslate/react';

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

Kuna iya canza nau'in abu ta amfani da, misali, as="p" a kan bangaren.

Amfani da useTranslation hook.
Yana dawo da fassarar a matsayin rubutu mai sauƙi. Amfani ne, misali, a cikin meta tags.

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 ƙiraye-ƙiraye a gefen uwar garke. Kara ƙarfi ga 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 zaren kalmomi suka kai ga sabobinmu, da farko muna tabbatarwa da adana su, sannan nan take muna dawo da fassarar injin. Duk da cewa fassarorin injin gabaɗaya suna da ƙasa a inganci idan aka kwatanta da fassarorin AI ɗinmu, suna samar da saurin amsa ta farko.

A lokaci guda, muna farawa aikin fassara na asynchronous don ƙirƙirar fassarar AI mai inganci, na zamani ga ƙirar ku. Da zarar fassarar AI ta shirya, za ta maye gurbin fassarar na'ura kuma za a aika ta duk lokacin da kuka nemi fassarar ƙirar ku.

Idan kun fassara wata kalma da hannu, waɗannan fassarorin suna da fifiko kuma za a mayar da su a madadin haka.

Amfani da tushen bayanai

Ayyukan TacoTranslate suna ɗauke da abin da muke kira origins. Ka ɗauke su a matsayin ƙofofi na shiga, manyan fayiloli, ko ƙungiyoyi don haruffanka da fassarar ka.

import {TacoTranslate} from 'tacotranslate/react';

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

Asalin suna ba ka damar raba jerin kalmomi cikin kwantena masu ma’ana. Alal misali, za ka iya samun asali guda ɗaya don takardun bayanai da wani don shafin tallan ka.

Don samun cikakken iko, za ka iya saita origins a matakin bangaren.

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

Da fatan za a lura cewa irin wannan rubutu na iya samun fassaloli daban-daban a wurare daban-daban.

A ƙarshe, yadda kuke raba igiyoyi zuwa asali ya dogara da ku da bukatunku. Koyaya, ku lura cewa samun igiyoyi da yawa cikin asali ɗaya na iya ƙara lokutan lodawa.

Sarrafa canje-canje

Ya kamata koyaushe ku yi amfani da [variables] don abubuwan da ke canzawa, kamar sunayen masu amfani, kwanan wata, adireshin imel, da ƙari.

Ana bayyana canje-canje a cikin igiyoyi ta amfani da ƙugiya 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 yayin da aka saba, Translate sashin yana tallafawa kuma yana fassara abun cikin HTML. Koyaya, za ka iya rashin zuwa wannan halayya ta hanyar saita useDangerouslySetInnerHTML zuwa false.

Ana ƙarfafa sosai a kashe yin fassarar HTML lokacin da ake fassara abubuwan da ba a yarda da su ba, kamar abun da masu amfani suka ƙirƙira.

Dukkan fitarwa ana tsaftace su koyaushe 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 fassara misalin da ke sama cikin rubutu kai tsaye.

Nuna a ɓangaren uwar garke

Amfani da TacoTranslate

Yadda ake fassara ƙaɗa

Amfani da tushen bayanai

Sarrafa canje-canje

Sarrafa abun ciki na HTML