Dukumentiyada: Isticmaalka TacoTranslate

Isticmaalka TacoTranslate

Somali

Tarjumida xarigga

Waxaa hadda jira saddex siyaabood oo loo turjumo xarfo: 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!" />;
}

Waxaad beddeli kartaa nooca curiyaha adigoo adeegsanaya, tusaale ahaan, as="p" qaybta.

Isticmaalka useTranslation hook.
Waxay soo celineysaa turjumaadaha sida xarig caadi ah. Waxay waxtar leedahay 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 utility-ga.
Tarjum xarfo dhinaca server-ka ah. Kor u qaad sawiradaada 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-radayada, waxaan marka hore xaqiijinaynaa oo keydinaynaa, kadibna isla markiiba waxaan soo celinaa tarjumaad mashiin ah. In kasta oo tarjumaadaha mashiinka ay guud ahaan tayo hooseeya leeyihiin marka loo eego tarjumaadaha AI-ga, haddana waxay bixiyaan jawaab degdeg ah oo bilow ah.

Isla mar ahaantaana, waxaan bilaabaynaa shaqo turjumid asynchronous ah si aan u soo saarno turjumaad AI oo tayo sare leh, casri ah oo loogu talagalay xarafkaaga. Marka turjumaadda AI-da ay diyaar noqoto, waxay beddeli doontaa turjumaadda mashiinka waxayna la soo diri doontaa mar kasta oo aad codsato turjumaadda xarafkaaga.

Haddii aad si gacanta ah u turjumtay xaraf, turjumaadahaas ayaa mudnaanta leh waxaana lagu soo celinayaa beddel ahaan.

Ka faa’iidaysiga asalka

Mashruucyada TacoTranslate waxay ka kooban yihiin waxa aan ugu yeerno origins. Ka fikir iyaga sida meelaha galitaanka, faylal, ama kooxo loogu talagalay xarriijimahaaga iyo turjumaadahaaga.

import {TacoTranslate} from 'tacotranslate/react';

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

Asal ahaan waxay kuu oggolaanayaan inaad xarfo u kala qaybiso weelal macno leh. 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, tixgeli isticmaalka bixiyeyaasha badan ee TacoTranslate gudaha mashruucaaga.

Fadlan ogow in isku xarafku uu heli karo turjumaado kala duwan oo kasoo jeeda meelo kala duwan.

Ugu dambeyntii, sidaad u kala qaybinayso xarigyada ujeeddooyinka waa adiga iyo baahiyahaaga. Si kastaba ha ahaatee, ogow in lahaanshaha xarigyo badan hal ujeeddo gudaheeda ay kordhin karto wakhtiyada loading-ka.

Maareynta kala duwanaanshaha

Waa inaad mar walba isticmaashaa doorsoomayaal loogu talagalay maaddooyinka firfircoon, sida magacyada isticmaalayaasha, taariikhaha, cinwaanada iimaylka, iyo wixii la mid ah.

Isbeddelka xargaha waxaa lagu qeexaa iyadoo la adeegsanayo labo qolaal, 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, waxaad ka bixi kartaa dhaqan-qaadkan adigoo dejinaya useDangerouslySetInnerHTML ilaa false.

Joojinta soo bandhigida HTML si xoog leh ayaa lagu taliyay marka la turjumayo waxyaabo aan la isku hallayn karin, sida waxyaabaha ay soo saareen isticmaaleyaashu.

Dhammaan wax soo saarka ayaa 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.

Ku-sameynta server-ka dhinaca

Isticmaalka TacoTranslate

Sida xarriiqaha loo turjumo

Ka faa’iidaysiga asalka

Maareynta kala duwanaanshaha

Maareynta nuxurka HTML