Dukumentiga: Isticmaalka TacoTranslate

Isticmaalka TacoTranslate

Somali

Turjumaadda xarigyada

Hadda waxaa jira saddex siyaabood oo lagu turjumi karo xadhigyada: 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!" />;
}

Waxaad beddeli kartaa nooca walaxda, tusaale ahaan, adigoo qaybta ku isticmaalaya as="p".

Isticmaalka useTranslation hook-ka.
Waxay soo celisaa turjumaadaha sida xarig caadi ah. 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>
	);
}

Adeegsiga qalabka translateEntries.
Tarjumaadda xargaha qoraalka dhinaca server-ka. Si weyn u 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)
	};
}

Markay xarigyadu gaaraan server-yadayada, marka hore waxaan xaqiijinaynaa oo keydinaynaa, ka dibna si dhaqso ah ayaan u soo celinaynaa tarjumaad mashiin. In kasta oo tarjumaadaha mashiinku guud ahaan tayadoodu ka hooseyso tarjumaadaha AI-ga, haddana waxay bixiyaan jawaab hordhac ah oo dhakhso leh.

Isla mar ahaantaana, waxaan bilaabaynaa hawl tarjumaad asynkroon ah si loo soo saaro tarjumaad AI oo tayo sare leh, oo casri ah, oo loogu talagalay xadhigyadaada qoraalka. Marka tarjumaadda AI ay diyaar noqoto, waxay beddeli doontaa tarjumaadda mashiinka oo la diri doonaa mar kasta oo aad codsato tarjumaadaha xadhigyadaada.

Haddii aad si gacanta ah u turjumtay xadhig, turjumaadahaas ayaa mudnaanta leh waxaana lagu soo celin doonaa beddel ahaan.

Isticmaalka ilaha

Mashaariicda TacoTranslate waxay ka kooban yihiin waxa aan ugu yeerno origins. Ka fikir inay yihiin meelaha gelitaanka, galal, ama kooxo loogu talagalay xarigyada qoraalkaaga iyo turjumaadahaaga.

import {TacoTranslate} from 'tacotranslate/react';

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

Ilo waxay kuu oggolaanayaan inaad kala soocdo xarigyada una geliso weelal macno leh. Tusaale ahaan, waxaad yeelan kartaa hal ilo oo loogu talagalay dukumiintiyada iyo mid kale oo loogu talagalay boggaaga suuq-geynta.

Si aad u hesho xakameyn faahfaahsan, waad dejin kartaa origins heerka component-ka.

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

Fadlan ogow in xadhig isku mid ah laga yaabo inuu helo turjumaado kala duwan marka laga turjumo asalo kala duwan.

Ugu dambeyntii, sida aad xadhkaha ugu kala qaybiso ilaha waxay ku xiran tahay adiga iyo baahiyahaaga. Si kastaba ha ahaatee, ogow in haysashada xadhkaha badan hal il gudaheeda ay kordhin karto wakhtiga rarista.

Maaraynta doorsoomayaasha

Waa inaad had iyo jeer isticmaashaa doorsoomayaal (variables) marka aad la macaamilayso waxyaabaha firfircoon, sida magacyada isticmaalayaasha, taariikhaha, cinwaannada iimaylka, iyo waxyaabo kale.

Doorsoomayaasha ku jira xarigyada waxaa lagu qeexaa iyadoo la adeegsanayo laba calaamad isku xigta, tusaale ahaan {{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}});
}

Maareynta nuxurka HTML

Si caadi ah, qaybta Translate waxay taageertaa oo soo bandhigtaa nuxurka HTML. Si kastaba ha noqotee, waxaad ka bixi kartaa dhaqankan adigoo u dejinaya useDangerouslySetInnerHTML inay noqoto false.

Waxaa si xooggan loogu talinayaa in la joojiyo soo bandhigida HTML marka la turjumayo nuxur aan la aamini karin, sida nuxurka ay isticmaalayaashu abuureen.

Dhammaan wax soo saarka mar walba waa la nadiifiyaa iyadoo la isticmaalayo 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 si qoraal ah ayaa loo soo bandhigi doonaa.

Soo bandhigida dhinaca server-ka

Isticmaalka TacoTranslate

Sida xarigyada loo tarjumayo

Isticmaalka ilaha

Maaraynta doorsoomayaasha

Maareynta nuxurka HTML