Dukumentiyada: Sida loo isticmaalo TacoTranslate

Isticmaalka TacoTranslate

Somali

Turjumaadda xadhigyada

Hadda waxaa jira saddex siyaabood oo lagu turjumo xadhigyada: Qaybta Translate, hook-ka useTranslation, ama qalabka translateEntries.

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

import {Translate} from 'tacotranslate/react';

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

Waxaad beddeli kartaa nooca element-ka, tusaale ahaan adigoo ku adeegsanaya as="p" qaybta.

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

Marka xargaha ay gaaraan server-yadeena, waxaan marka hore xaqiijinaynaa oo kaydinaynaa, ka dibna si dhakhso ah ayaanu u soo celinaynaa tarjumaad mashiin. In kasta oo tarjumaadaha mashiinka guud ahaan ay tayadoodu ka hooseyso tarjumaadaha AI-ga, waxay bixiyaan jawaab hordhac oo degdeg ah.

Isla mar ahaantaana, waxaan bilownaa hawl turjumaad oo asynkroon ah si aan u soo saarno turjumaad AI oo casri ah oo tayo sare leh oo loogu talagalay qoraalkaaga. Marka turjumaadda AI-ga ay diyaar noqoto, waxay beddeli doontaa turjumaaddii mashiinka waxayna la diri doontaa markasta oo aad codsato turjumaadaha qoraalladaada.

Haddii aad xarig si gacanta ah u tarjumtay, turjumaadahaas ayaa mudnaanta leh waxaana lagu soo celinayaa beddelkood.

Isticmaalka asalada

Mashruucyada TacoTranslate waxay ka kooban yihiin waxa aan ugu yeerno origins. U qaado inay yihiin barta gelitaanka, faylal, ama kooxo loogu talagalay xarigyadaada iyo turjumaadahaada.

import {TacoTranslate} from 'tacotranslate/react';

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

Ilo waxay kuu oggolaanayaan inaad xargaha kala saarto kuna kaydiso weelal macno leh. Tusaale ahaan, waxaad hal il u yeelan kartaa dukumentiyada iyo il kale boggaaga suuq-geynta.

Si aad u hesho xakameyn faahfaahsan, waxaad asalooyin ku samayn kartaa heerka qaybta.

Si tan loo gaaro, tixgeli in aad isticmaasho bixiyeyaal badan oo TacoTranslate gudaha mashruucaaga.

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

Ugu dambeyntiina, sida aad u kala qaybiso xarigyada iyada oo loo eegayo asalka waa adiga iyo baahiyahaaga. Si kastaba ha noqotee, ogow in xarigyo badan oo hal asal ku jira ay kordhin karaan wakhtiga rarida.

Maaraynta doorsoomayaasha

Mar walba waa inaad isticmaashaa doorsoomayaal marka ay timaaddo nuxurka isbeddelaya, sida magacyada isticmaalayaasha, taariikhaha, cinwaanada iimaylka, iyo wixii la mid ah.

Doorsoomayaasha ku jira xargaha waxaa lagu qeexaa iyadoo la isticmaalayo laba brackets, 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}});
}

Maareynta nuxurka HTML

Si caadi ah, qaybta Translate waxay taageertaa kana soo bandhigtaa nuxurka HTML. Si kastaba ha ahaatee, waad ka bixi kartaa dhaqankan adigoo dejinaya useDangerouslySetInnerHTML ilaa false.

Marka la turjumayo waxyaabo aan la isku halayn karin, sida waxyaabaha ay isticmaalayaashu abuureen, si xooggan ayaa loogu talinayaa in la damiyo muujinta HTML.

Dhammaan wax soo-saarka waxaa had iyo jeer lagu nadiifiyaa 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 caadi ah.

Soo-saarista dhinaca server-ka

Isticmaalka TacoTranslate

Sida xadhigyada loo turjumo

Isticmaalka asalada

Maaraynta doorsoomayaasha

Maareynta nuxurka HTML