Dokumentacioni: Përdorimi i TacoTranslate

Përdorimi i TacoTranslate

Albanian

Përkthimi i vargjeve

Aktualisht ka tre mënyra për të përkthyer vargjet: komponenti Translate, hook‑i useTranslation, ose mjeti translateEntries.

Përdorimi i komponentit Translate.
Shfaq përkthimet brenda një elementi span dhe mbështet renderimin e HTML-it.

import {Translate} from 'tacotranslate/react';

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

Mund të ndryshoni tipin e elementit duke përdorur, për shembull, as="p" në komponent.

Përdorimi i hook-ut useTranslation.
Kthen përkthime si tekst të thjeshtë. I dobishëm, për shembull, në etiketat 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>
	);
}

Përdorimi i mjetit translateEntries.
Përktheni vargjet në anën e serverit. Përforconi imazhet tuaja 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)
	};
}

Kur stringjet arrijnë në serverët tanë, së pari i verifikojmë dhe i ruajmë, pastaj menjëherë kthejmë një përkthim automatik. Ndërsa përkthimet automatike zakonisht janë më pak cilësore në krahasim me përkthimet tona të AI-së, ato ofrojnë një përgjigje fillestare të shpejtë.

Në të njëjtën kohë, ne nisim një detyrë përkthimi asinkrone për të gjeneruar një përkthim me AI të cilësisë së lartë dhe të përparuar për vargun tuaj. Sapo përkthimi me AI të jetë gati, ai do të zëvendësojë përkthimin automatik dhe do të dërgohet sa herë të kërkoni përkthime për vargjet tuaja.

Nëse keni përkthyer manualisht një varg, ato përkthime kanë përparësi dhe do të kthehen në vend të të tjerave.

Përdorimi i origjinave

Projektet TacoTranslate përmbajnë atë që ne e quajmë origjina. Mendojini si pika hyrëse, dosje ose grupe për vargjet dhe përkthimet tuaja.

import {TacoTranslate} from 'tacotranslate/react';

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

Origjinat ju lejojnë të ndash tekstet në grupe me kuptim. Për shembull, mund të keni një origjinë për dokumentacionin dhe një tjetër për faqen tuaj të marketingut.

Për kontroll më të detajuar, mund të konfiguroni origjinat në nivelin e komponentit.

Për ta arritur këtë, konsideroni të përdorni disa ofrues të TacoTranslate në projektin tuaj.

Ju lutemi vini re se i njëjti varg mund të marrë përkthime të ndryshme në origjina të ndryshme.

Në fund të fundit, mënyra se si i ndan vargjet në origjina është një vendim që varet nga ju dhe nga nevojat tuaja. Megjithatë, kini parasysh që pasja e shumë vargjeve brenda një origjine mund të rrisë kohët e ngarkimit.

Trajtimi i variablave

Duhet gjithmonë të përdorni variabla për përmbajtje dinamike, si emrat e përdoruesve, datat, adresat e postës elektronike dhe më shumë.

Variablat në stringje deklarohen duke përdorur kllapa të dyfishta, si {{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}});
}

Menaxhimi i përmbajtjes HTML

Si parazgjedhje, komponenti Translate mbështet dhe shfaq përmbajtje HTML. Megjithatë, mund ta çaktivizoni këtë sjellje duke vendosur useDangerouslySetInnerHTML në false.

Çaktivizimi i renderimit të HTML-it rekomandohet fuqimisht kur përktheni përmbajtje të pasigurta, siç është përmbajtja e gjeneruar nga përdoruesit.

Të gjitha rezultatet gjithmonë pastrohen me sanitize-html para se të shfaqen.

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}
		/>
	);
}

Shembulli i mësipërm do të shfaqet si tekst i thjeshtë.

Renderimi në server

Përdorimi i TacoTranslate

Si përkthehen tekstet

Përdorimi i origjinave

Trajtimi i variablave

Menaxhimi i përmbajtjes HTML