Dukumentiyada: Isticmaalka TacoTranslate

Isticmaalka TacoTranslate

Somali

Tarjumidda xadhigyada

Waxaa hadda jira saddex siyaabood oo xargaha loo turjumi karo: qaybta Translate, hook-ka useTranslation, ama qalabka translateEntries.

Isticmaalka qaybta Translate.
Waxay soo saaraysaa turjumaadaha gudaha walaxda 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 isticmaalaya as="p" qaybta.

Isticmaalka useTranslation hook-ka.
Waxay soo celisaa turjumaadaha sida xarig caadi ah. Waxay ku habboon tahay, 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 qalabka.
Tarjum xarigyada dhinaca server-ka. Si xawli ah 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 xarigyo ay gaaraan server-yadayada, marka hore waan xaqiijinnaa oo waan keydinnaa, ka dibna isla markiiba waxaan soo celinaa turjumaad mashiin. Inkastoo turjumaadaha mashiinku guud ahaan tayadoodu ka hooseyso turjumaadaha AI-ga, haddana waxay bixiyaan jawaab hordhac ah oo degdeg ah.

Isla mar ahaantaana, waxaan bilaabaynaa hawl turjumaad oo aan toos ahayn si aan u soo saarno turjumaad AI oo tayo sare leh, oo casri ah, oo loogu talagalay xadhiggaaga. Marka turjumaadda AI ay diyaar noqoto, waxay beddeli doontaa turjumaadda mashiinka waana la diri doonaa mar kasta oo aad codsato turjumaadaha xadhigyadaada.

Haddii aad xadhig si gacanta ah u turjumtay, turjumaadihiias ayaa mudnaanta leh waxaana lagu soo celinayaa.

Isticmaalka asalaha

Mashaariicda TacoTranslate waxay ka kooban yihiin waxa aan ugu yeerno asal. Ka fikir inay yihiin meelaha gelitaanka, faylal, ama kooxo loogu talagalay xargahaaga iyo turjumaadahooda.

import {TacoTranslate} from 'tacotranslate/react';

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

Origins waxay kuu oggolaanayaan inaad xargaha kala soocdo una geliso goobo macno leh. Tusaale ahaan, waxaad yeelan kartaa hal asal oo loogu talagalay dukumentiyada iyo mid kale oo loogu talagalay boggaaga suuq-geynta.

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

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

Fadlan ogow in hal xarig laga yaabo in loo turjumo siyaabo kala duwan iyadoo ku xiran asalka.

Ugu dambeyntii, sida aad xadhkaha ugu kala qaybsato asallo waxay ku xiran tahay adiga iyo baahiyahaaga. Si kastaba ha noqotee, ogow in xadhkaha badan hal asal gudaheeda ay kordhin karaan waqtiga soo rarista.

Maaraynta doorsoomayaasha

Waa inaad had iyo jeer isticmaashaa doorsoomayaasha nuxurka firfircoon, sida magacyada isticmaalayaasha, taariikhaha, cinwaanada iimaylka, iyo wixii la mid ah.

Isbeddellada ku jira xarigyada waxaa lagu qeexaa iyadoo la adeegsanayo labo qalooc, 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

Sida caadiga ah, qaybta Translate waxay taageertaa oo soo bandhigtaa nuxurka HTML. Si kastaba ha noqotee, waad ka bixi kartaa hab-dhaqankan adigoo dejinaya useDangerouslySetInnerHTML ilaa false.

Waxaa si xooggan loogu talinayaa in la damiyo soo bandhigida HTML marka la turjumayo waxyaabo aan la isku halayn, sida kuwa ay isticmaalaayaashu abuureen.

Dhammaan wax soo saarka waxaa mar walba 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 xarigaha loo turjumo

Isticmaalka asalaha

Maaraynta doorsoomayaasha

Maareynta nuxurka HTML