Dukumentiga: Isticmaalka TacoTranslate

Isticmaalka TacoTranslate

Somali

Tarjumida xarigyada

Hadda waxaa jira saddex siyaabood oo lagu turjumi karo xadhigyada: qaybta Translate, hook-ka useTranslation, ama qalabka translateEntries.

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

import {Translate} from 'tacotranslate/react';

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

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

Isticmaalka useTranslation hook-ka.
Waxay soo celisaa turjumaadaha sida xarig caadi ah. Tusaale ahaan, waxay waxtar u leedahay 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 qalabka translateEntries.
Tarjum xadhigyada qoraalka 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)
	};
}

Marka xadhkaha ay gaaraan server-keena, waxaan marka hore xaqiijinaynaa oo kaydinaynaa, ka dibna isla markiiba waxaan soo celinnaa turjumaad mashiin ah. In kasta oo turjumaadaha mashiinka ay guud ahaan tayo ahaan ka hooseeyaan turjumaadaha AI-ga, haddana waxay bixiyaan jawaab hordhac ah oo degdeg ah.

Isla mar ahaantaana, waxaan bilaabaynaa hawl tarjumaad oo aan isla waqti ahayn si loo soo saaro tarjumaad AI oo tayo sare leh, oo casri ah, oo loogu talagalay xadhiggaaga. Marka tarjumaadda AI ay diyaar noqoto, waxay beddeli doontaa tarjumaadda mashiinka waxaana la diri doonaa mar kasta oo aad codsato tarjumaadaha xadhigyadaada.

Haddii aad si gacanta ah u turjuntay xadhig, turjumaadahaas ayaa mudnaanta leh waxaana lagu soo celinayaa bedel ahaan.

Isticmaalka ilaha

Mashaariicda TacoTranslate waxay ka kooban yihiin waxa aan ugu yeerno origins. Tixgeli inay yihiin barta gelitaanka, faylal, ama kooxo loogu talagalay xarigyadaada iyo turjumaadahooda.

import {TacoTranslate} from 'tacotranslate/react';

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

Ilo waxay kuu oggolaanayaan inaad qoraallada u kala saarto qaybaha macno leh. Tusaale ahaan, waxaad yeelan kartaa hal il oo loogu talagalay dukumiintiyada iyo il kale oo loogu talagalay boggaaga suuq-geynta.

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 xadhiggu laga yaabo inuu ku turjumo siyaabo kala duwan marka laga eego ilal kala duwan.

Ugu dambeyntii, sida aad xadhigyada ugu kala qaybiso ilaha ayaa kugu xiran adiga iyo baahiyahaaga. Si kastaba ha noqotee, ogow in xadhigyo badan oo ku jira hal il ay kordhin karaan wakhtiyada rarida.

Maareynta doorsoomayaasha

Mar walba waa inaad isticmaashaa doorsoomayaal loogu talagalay waxyaabaha isbeddelaya, sida magacyada isticmaalayaasha, taariikhaha, cinwaannada iimaylka, iyo wixii la mid ah.

Beddelada ku jira xarigyada waxaa lagu qeexaa iyadoo la adeegsanayo labo bracket oo isku xigta, 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, komponentiga Translate wuxuu taageeraa oo soo bandhigaa nuxurka HTML. Si kastaba ha ahaatee, waxaad ka bixi kartaa dhaqankan adigoo dejinaya useDangerouslySetInnerHTML inuu noqdo false.

Si aad ah ayaa loogu talinayaa in la joojiyo muujinta HTML marka la turjumayo waxyaabo aan lagu kalsoonaan karin, sida waxyaabaha ay adeegsadayaashu abuureen.

Dhammaan wax soo saarka mar walba waxaa lagu nadiifiyaa iyadoo la adeegsanayo 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-saarida dhinaca server-ka

Isticmaalka TacoTranslate

Sida xarigyada loo turjumo

Isticmaalka ilaha

Maareynta doorsoomayaasha

Maaraynta nuxurka HTML