Dokumentacioni: Përdorimi i TacoTranslate

Përdorimi i TacoTranslate

Albanian

Përkthimi i vargjeve

Aktualisht ka tre mënyra për të përkthyer stringje: komponenti Translate, hook-u useTranslation ose utiliteti 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 ta ndryshoni llojin e elementit duke përdorur, për shembull, as="p" në komponentin.

Përdorimi i useTranslation hook-ut.
Kthen përkthimet 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ërkthe vargjet në anën e serverit. Fuqizoni 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 vargjet mbërrijnë në serverët tanë, së pari i verifikojmë dhe i ruajmë, pastaj menjëherë kthejmë një përkthim makinerik. Edhe pse përkthimet makinerike zakonisht janë më pak cilësore krahasuar me përkthimet tona me AI, ato ofrojnë një përgjigje fillestare të shpejtë.

Njëkohësisht, ne nisim një detyrë përkthimi asinkrone për të gjeneruar një përkthim me AI me cilësi të lartë dhe të avancuar për vargun tuaj. Pasi përkthimi me AI të jetë gati, ai do të zëvendësojë përkthimin automatik dhe do të dërgohet sa herë që kërkoni përkthime për vargjet tuaja.

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

Përdorimi i origjinave

Projektet e TacoTranslate përmbajnë atë që ne e quajmë origjinat. Mendojini ato 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ë ndani vargjet në kontejnerë të kuptimplotë. 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ë hollësishëm, mund të konfiguroni origjina në nivelin e komponentit.

Për ta arritur këtë, konsideroni përdorimin e disa ofruesve të TacoTranslate brenda projektit 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, se si i ndan vargjet në origjina varet nga ju dhe nga nevojat tuaja. Megjithatë, kini parasysh se një numër i madh vargjesh brenda një origjine mund të rrisë kohën 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ë vargje shënohen me 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 së HTML-it

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

Çaktivizimi i renderimit HTML rekomandohet fuqimisht kur përktheni përmbajtje të pa besueshme, siç janë përmbajtjet e krijuara nga përdoruesit.

E gjithë përmbajtja gjithmonë pastrohet me sanitize-html para se të shfaqet.

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 më sipër do të shfaqet si tekst i thjeshtë.

Renderizimi nga ana e serverit

Përdorimi i TacoTranslate

Si përkthehen vargjet

Përdorimi i origjinave

Trajtimi i variablave

Menaxhimi i përmbajtjes së HTML-it