Dukumentiga: Isticmaalka TacoTranslate

Isticmaalka TacoTranslate

Somali

Tarjumidda xarafka

Hadda waxaa jira saddex waddo oo loo turjumo xadhkaha: qaybta Translate, hook-ka useTranslation, ama adeegga translateEntries.

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

import {Translate} from 'tacotranslate/react';

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

Waad beddeli kartaa nooca curiyaha adigoo tusaale ahaan isticmaalaya as="p" ee qaybta.

Isticmaalka useTranslation hook.
Waxay soo celisaa turjumaadaha sidii xarig caadi ah. 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
Tarjum xarfo ku yaal dhinaca server-ka. Kor u qaad 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 xarfooyinku gaaraan server-yadayada, marka hore waanu hubinaa oo waanu keydinaa, ka dibna si degdeg ah ayaan u soo celinaa tarjumaad mashiin. In kasta oo tarjumaadaha mashiinku sida caadiga ah ay ka hooseeyaan tayada tarjumaadaha AI-ga, haddana waxay bixiyaan jawaab degdeg ah oo hore.

Isla markaas, waxaan bilaabaynaa shaqo turjumaan oo asynchronous ah si aan u soo saarno turjumaad AI oo tayo sare leh, oo casri ah oo ku habboon xarafkaaga. Marka turjumaadda AI diyaar noqoto, waxay beddeli doontaa turjumaadda mashiinka waxaana la diri doonaa mar kasta oo aad codsato turjumaadaha xarafkaaga.

Haddii aad si gacanta ah u turjuntay xaraf, turjumaadahaas ayaa mudnaan leh waxaana lagu soo celinayaa beddelkeeda.

Ka faa’iidaysiga asalka

Mashaariicda TacoTranslate waxay ka kooban yihiin waxa aan ugu yeerno origins. Ka fikir iyaga sida meelaha laga galo, faylal, ama kooxo loogu talagalay xarumahaaga iyo tarjumaadahaaga.

import {TacoTranslate} from 'tacotranslate/react';

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

Asalka waxay kuu oggolaanayaan inaad kala soocdo xarfo macno leh oo kala duwan. Tusaale ahaan, waxaad yeelan kartaa hal asal oo loogu talagalay dukumentiyada iyo mid kale oo loogu talagalay boggaaga suuqgeynta.

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

Si tan loo gaaro, ka fiirso isticmaalka dhowr bixiye oo TacoTranslate ah gudaha mashruucaaga.

Fadlan ogow in isla xarafkaas laga yaabo inuu helo turjumaado kala duwan ilo asal oo kala duwan.

Ugu dambeyntii, sidaad u kala qaybinayso xarigyada asal ahaan waa ku xiran tahay adiga iyo baahiyahaaga. Si kastaba ha ahaatee, ogow in lahaanshaha xarigyo badan hal asal gudaheeda ay kordhin karto wakhtiyada rarida.

Maaraynta xuduudaha

Waa inaad mar walba isticmaashaa doorsoomayaal (variables) loogu talagalay waxyaabaha isbeddelaya, sida magacyada isticmaalaha, taariikhaha, cinwaanada iimaylka, iyo kuwo kale.

Isbeddelada ku jira xarigyada waxaa lagu cadeeyaa iyadoo la adeegsanayo labo calaamadood oo furan, 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

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

Damiitaanka soo bandhigida HTML ayaa si aad ah looga soo jeedinayaa marka aad turjumayso waxyaabo aan la aamini karin, sida waxyaabaha ay isticmaalaayaashu abuuraan.

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 fudud.

Muuqaal-gacmeedka server-ka

Isticmaalka TacoTranslate

Sida xarfo loo turjumo

Ka faa’iidaysiga asalka

Maaraynta xuduudaha

Maaraynta nuxurka HTML