Dukumentiyada: Isticmaalka TacoTranslate

Isticmaalka TacoTranslate

Somali

Tarjumidda xarumaha

Waxaa hadda jira saddex siyaabood oo xarfo loo turjumi karo: qaybta Translate, hook-ga useTranslation, ama adeegga translateEntries.

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

import {Translate} from 'tacotranslate/react';

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

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

Isticmaalka useTranslation hook.
Wuxuu soo celiyaa turjumaad sida xarig fidsan. 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 adeegga translateEntries
Tarjum xarigyada dhinaca server-ka. Kordhi awoodda 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)
	};
}

Markii xarafyada ay gaaraan server-yadayada, waxaan marka hore xaqiijinaynaa oo keydinaa, ka dibna si degdeg ah waxaan ku soo celinaa tarjumaad mashiin. Inkastoo tarjumaadaha mashiinka guud ahaan tayadoodu ka hooseyso tan tarjumaadaha AI-ga, haddana waxay bixiyaan jawaab horudhac ah oo degdeg ah.

Sidoo kale, waxaan bilownaa shaqo turjumid oo asynchronous ah si aan u soo saarno turjumid tayo sare leh, AI casri ah oo loogu talagalay xarafkaaga. Marka turjumida AI diyaar noqoto, waxay beddeli doontaa turjumida mashiinka waxaana loo diri doonaa mar kasta oo aad codsato turjumidda xarafkaaga.

Haddii aad si gacanta ah u turjumtay xaraf, turjumaadahaas ayaa mudnaan leh waxaana la soo celinayaa beddelkii.

Isticmaalka asalka

Mashaariicda TacoTranslate waxay ka kooban yihiin waxa aan ugu yeerno asal. Ka fakar sida meelaha laga galo, faylal, ama kooxo loogu talagalay xarfo iyo turjumaadahaaga.

import {TacoTranslate} from 'tacotranslate/react';

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

Asalka ayaa kuu oggolaanaya inaad kala soocdo xarfo ku jira weelal macno leh. Tusaale ahaan, waxaad yeelan kartaa hal asal oo qoraallo iyo mid kale oo bogga suuq-geyntaada ah.

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 isla xarafku uu heli karo turjumado kala duwan asalyo kala duwan.

Ugu dambeyntii, sida aad xarigyada ugu kala saarto asalka waxay kugu xiran tahay adiga iyo baahiyahaaga. Si kastaba ha ahaatee, ogow in helitaanka xarigyo badan hal asal gudaheeda ay kordhin karto waqtiga raridda.

Maaraynta isbeddellada

Waa inaad mar walba isticmaashaa variables loogu talagalay qoraalka isbeddelaya, sida magacyada isticmaala, taariikhaha, cinwaannada e-maylka, iyo wixii la mid ah.

Isbeddellada xadhkaha waxaa lagu qeexaa iyadoo la adeegsanayo laba jibaaran oo meelaha ah, 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

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

Si adag ayaa looga soo jeedinayaa in la joojiyo HTML rendering marka la turjumayo waxyaabo aan la isku halleyn karin, sida waxyaabaha ay isticmaale-yaashu abuureen.

Dhammaan natiijooyinka waxaa mar walba loo 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 loo soo bandhigi doonaa qoraal nadiif ah.

Muuqaalka dhinaca server-ka

Isticmaalka TacoTranslate

Sida xarafyada loo turjumo

Isticmaalka asalka

Maaraynta isbeddellada

Maaraynta nuxurka HTML