Dukumeenti: Isticmaalka TacoTranslate

Isticmaalka TacoTranslate

Somali

Turjumaadda xadhigyada

Hadda waxaa jira sadex siyaabood oo kala duwan oo loo turjumi karo xarfo: Qaybta Translate, hook-ga useTranslation, ama adeegga translateEntries.

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

import {Translate} from 'tacotranslate/react';

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

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

Isticmaalka useTranslation hook.
Waxay soo celisaa turjumaad ahaan xarig nadiif ah. Waxay waxtar u leedahay, tusaale ahaan, summadaha 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 utility-ga translateEntries.
Turjun xarfo dhinaca server-ka ah. 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)
	};
}

Marka xarfo ay gaaraan server-yadeena, waxaan marka hore xaqiijinaynaa oo kaydinaynaa, ka dibna si degdeg ah u soo celinaa tarjumaad mashiin. In kasta oo tarjumaadaha mashiinka ay guud ahaan tayadoodu ka hooseyso tarjumaadaha AI-ga ee aanu bixino, haddana waxay bixiyaan jawaab degdeg ah oo bilow ah.

Isla waqtigaas, waxaan bilaabaynaa hawl turjumid asynchronous ah si aan u soo saarno turjumid AI oo tayo sare leh, oo casri ah oo loogu talagalay xarafkaaga. Marka turjumiddai AI-ga diyaar noqoto, waxay beddeli doontaa turjumidda mashiinka waxaana lagu soo diri doonaa mar kasta oo aad codsato turjumaadaha xarafkaaga.

Haddii aad si gacanta ah u turjuntay xaraf, turjumaadahaas ayaa mudnaanta leh oo waxaa lagu soo celiyaa beddelkeeda.

Adeegsiga ilaha

Mashaariicda TacoTranslate waxay ka kooban yihiin waxa aan ugu yeerno asal. Ka fikir sidii meelaha laga galo, faylal, ama kooxo loogu talagalay xarafyadaada iyo tarjumidaada.

import {TacoTranslate} from 'tacotranslate/react';

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

Asalka ayaa kuu oggolaanaya inaad kala soocdo xarfo macno leh. Tusaale ahaan, waxaad yeelan kartaa asal mid ah dukumiintiyada iyo mid kale oo ah boggaaga suuqgeynta.

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

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

Fadlan ogow in xarafka isku midka ah uu heli karo turjumaado kala duwan oo ka yimaada origins kala duwan.

Ugu dambeyntii, sida aad u kala saarto xarfo ilaha waxaa go'aamiya adiga iyo baahiyahaaga. Si kastaba ha ahaatee, ogow in lahaanshaha xarfo badan il hal meel ay kordhin karto waqtiga rarista.

Maareynta doorsoomayaasha

Waxaad mar walba isticmaali kartaa isbeddellada (variables) waxyaabaha firfircoon, sida magacyada isticmaalayaasha, taariikhaha, cinwaanada iimaylka, iyo in ka badan.

Isbeddelada ku jira xarfo waxaa lagu dhawaaqaa iyadoo la isticmaalayo labo labajibbaaran, 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

Caadi ahaan, qaybta Translate waxay taageertaa oo soo bandhigtaa waxyaabaha HTML. Si kastaba ha ahaatee, waxaad ka bixi kartaa habkan adigoo dejinaya useDangerouslySetInnerHTML ilaa false.

Joojinta muujinta HTML si adag ayaa lagu talinayaa marka la turjumayo waxyaabo aan la aamini karin, sida waxyaabaha ay isticmaaleen 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 kore waxaa lagu soo bandhigi doonaa qoraal fidsan.

Soo-saarista dhinaca server-ka

Isticmaalka TacoTranslate

Sida xargaha loo turjumo

Adeegsiga ilaha

Maareynta doorsoomayaasha

Maareynta nuxurka HTML