Dukumentiyada: Isticmaalka TacoTranslate

Isticmaalka TacoTranslate

Somali

Turjumaadda xarriiqyada

Waxaa hadda jira saddex siyaabood oo loola turjumo xarfo: Qaybta Translate, hook-ka useTranslation, ama adeegga translateEntries.

Isticmaalka qaybta Translate
Waxay soo saartaa tarjumaadaha gudaha curiyaha span, waxayna taageertaa soo bandhigida HTML.

import {Translate} from 'tacotranslate/react';

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

Waad beddeli kartaa nooca walxaha adigoo isticmaalaya, tusaale ahaan, as="p" qaybta.

Isticmaalka useTranslation hook.
Waxay soo celisaa turjumida sida xarig fudud. Waxay waxtar u leedahay, tusaale ahaan, calaamadaha 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>
	);
}

Isticmaalka translateEntries utility-ga.
Tarjum xadhkaha dhinaca server-ka. Ku xooji sawirradaada 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)
	};
}

Marka xarfo ay gaaraan server-yadayada, marka hore waxaan xaqiijin iyo kaydin ku sameynaa, kadibna si degdeg ah waxaan soo celinaa turjumaad mashiin ah. Inkastoo turjumaadaha mashiinka ay guud ahaan tayadoodu ka hooseyso turjumaadaha AI-ga, haddana waxay bixiyaan jawaab degdeg ah oo bilow ah.

Isla waqtigaas, waxaan bilownaa hawl turjumid asynchronous ah si aan u soo saaro turjumid AI tayo sare leh, oo casri ah oo loogu talagalay xarafkaaga. Marka turjumida AI diyaar noqoto, waxay beddeli doontaa turjumida mashiinka waxaana la diri doonaa marka aad codsato turjumaadaha xarafkaaga.

Haddii aad si gacanta ah u turjuntay xaraf, turjumaadahaas ayaa mudnaanta leh waxaana lagu soo celinayaa beddel ahaan.

U Adeegsiga asalka

Mashaariicda TacoTranslate waxay ka kooban yihiin waxa aan ugu yeerno asalka. U fikir iyaga sidii goobo gelitaan, faylal, ama kooxo loogu talagalay xarfooyinkaaga iyo turjumaadahaaga.

import {TacoTranslate} from 'tacotranslate/react';

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

Asalka wuxuu kuu oggolaanayaa inaad xargaha u kala saarto weelal macno leh. Tusaale ahaan, waxaad yeelan kartaa hal asal oo loogu talagalay dukumentiyada iyo mid kale oo loogu talagalay boggaaga suuqgeynta.

Si aad u hesho xakameyn faahfaahsan, waxaad dejin kartaa origins heerka qaybta.

Si tan loo gaaro, tixgeli isticmaalka bixiyeyaasha badan ee TacoTranslate gudaha mashruucaaga.

Fadlan ogow in ereyga isku midka ah laga yaabo inuu helo turjumaado kala duwan asal kala duwan.

Ugu dambeyntii, sidaad xarfo ugu kala soocdo asalka waxay kugu xiran tahay adiga iyo baahiyahaaga. Si kastaba ha ahaatee, ogow in lahaanshaha xarfo badan hal asal gudaheeda ay kordhin karto waqtiga rarista.

Maareynta Isbeddellada

Waa inaad mar walba isticmaashaa variables qoraal isbeddelaya, sida magacyada isticmaalayaasha, taariikhaha, cinwaanada iimaylka, iyo wixii la mid ah.

Isbeddelada ku jira xarigga waxaa lagu cadeeyaa iyadoo la isticmaalayo labo giraangirood oo isku xiga, sida {{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}});
}

Maaraynta nuxurka HTML

Sida caadiga ah, qaybta Translate waxay taageertaa oo soo bandhigtaa macluumaadka HTML. Si kastaba ha ahaatee, waxaad ka baxsan kartaa dhaqankan adigoo dejinaya useDangerouslySetInnerHTML ilaa false.

Naafeynta muuqaalkan HTML si xoog leh ayaa lagu talinayaa markaad turjumayso qoraallo aan lagu kalsoonaan karin, sida qoraallada ay adeegsadayaashu abuureen.

Dhammaan wax soo saarka ayaa mar walba lagu nadiifiyaa iyadoo la adeegsanayo sanitize-html ka hor inta aan la soo bandhigin.

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

Tusaalaha kor ku xusan waxaa lagu soo bandhigi doonaa qoraal fidsan.

Server-ka dhinaca soo-saaridda

Isticmaalka TacoTranslate

Sida xarfo loo turjumo

U Adeegsiga asalka

Maareynta Isbeddellada

Maaraynta nuxurka HTML