Dukumentiga: Isticmaalka TacoTranslate

Isticmaalka TacoTranslate

Somali

Tarjumidda xarfooyinka

Waxaa hadda jira saddex hab oo loogu turjumo xarfo: Qaybta Translate, isku xidhka useTranslation, ama adeegga translateEntries.

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

import {Translate} from 'tacotranslate/react';

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

Waad beddeli kartaa nooca unugga adigoo adeegsanaya, tusaale ahaan, as="p" qaybta ku jirta.

Isticmaalka useTranslation hook.
Waxay soo celineysaa turjumaadaha sida xaraf fudud. Waxaa waxtar leh, 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 ee utility-ga.
Tarjum xarfo dhinaca server-ka. 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 xarafyada ay gaaraan server-radayada, marka hore waan xaqiijinaynaa oo kaydinaynaa, kadibna si dhaqso ah ayaan u soo celinaa turjumaad mashiin ah. In kasta oo turjumaadaha mashiinku guud ahaan tayadoodu ka hooseyso turjumaadaha AI-ga, haddana waxay bixiyaan jawaab degdeg ah oo bilow ah.

Isla mar ahaantaana, waxaan bilaabaynaa hawl turjumid asynchronous ah si loo soo saaro turjumid tayo sare leh, oo casri ah oo AI ah oo loogu talagalay xarafkaaga. Marka turjumida AI-da ay diyaar noqoto, waxay beddeli doontaa turjumida mashiinka waxaana loo diri doonaa mar kasta oo aad codsato turjumaadaha xarafkaaga.

Haddii aad si gacanta ah u turjuntay xaraf, turjumaadahaas ayaa mudnaanta leh waxaana badalaya kuwo kale.

Isticmaalka asalka

Mashaariicda TacoTranslate waxay ka kooban yihiin waxa aan ugu yeerno asal. U malayn sidii 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 wuxuu kuu ogolaanayaa inaad xarfo ku kala soocdo weelal macno leh. Tusaale ahaan, waxaad yeelan kartaa hal asal oo loogu talagalay dukumentiyada iyo mid kalena boggaaga suuqgeynta.

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

Si tan loo gaaro, tixgeli isticmaalka bixiyeyaal badan oo TacoTranslate ah gudaha mashruucaaga.

Fadlan ogow in xarafka isku midka ah laga yaabo inuu helo turjumaado kala duwan meelo kala duwan.

Ugu dambeyntii, sida aad u kala saarto xarriijimaha ilaha waa adiga iyo baahiyahaaga. Si kastaba ha noqotee, ogow in lahaanshaha xarriijimo badan hal il laga yaabo inay kordhiso waqtiga raritaanka.

Maareynta isbeddelayaasha

Waa inaad mar walba isticmaashaa isbeddelayaasha loogu talagalay waxyaabaha isbedbeddelka ah, sida magacyada isticmaalayaasha, taariikhaha, cinwaanada iimaylka, iyo wixii la mid ah.

Isbeddellada ku jira xarriiqaha waxaa lagu qeexaa iyadoo la adeegsanayo laba jibbaaran, 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 waxyaabaha HTML

Asalka ahaan, qaybta Translate waxay taageertaa oo soo bandhigtaa nuxurka HTML. Si kastaba ha noqotee, waxaad ka bixi kartaa dhaqankan adigoo dejinaya useDangerouslySetInnerHTML oo u dhiganta false.

Joojinta muujinta HTML si xooggan ayaa loogu talinayaa marka la turjumayo waxyaabo aan la isku halleyn karin, sida waxyaabaha ay isticmaalehu abuureen.

Dhammaan natiijada 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 kore waxa lagu soo bandhigi doonaa qoraal saafi ah.

Muuqaal-gareynta dhinaca server-ka

Isticmaalka TacoTranslate

Sida xarafyada loo turjumo

Isticmaalka asalka

Maareynta isbeddelayaasha

Maaraynta waxyaabaha HTML