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-u useTranslation, ose mjeti translateEntries.

Përdorimi i komponentit Translate.
Shfaq përkthimet brenda një elementi span, dhe mbështet renderizimin e HTML.

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.

Duke përdorur useTranslation hook.
Kthen përkthimet si një varg të thjeshtë. E dobishme, 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. Përforco 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ë serverat 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 krahasuar me përkthimet tona të bazuara në AI, 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 më të avancuar për tekstin 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 tekstet tuaja.

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

Përdorimi i origjinave

Projektet TacoTranslate përmbajnë atë që ne i quajmë origjinat. Mendoni për to si pika hyrjeje, 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 tekstet në kontejnerë të kuptueshëm. 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 përdorimin e disa ofruesve 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ë origjinat varet nga ju dhe nga nevojat tuaja. Megjithatë, kini parasysh se të kesh shumë vargje brenda një origjine mund të rrisë kohën e ngarkimit.

Trajtimi i variablave

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

Variablat brenda vargjeve 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 të çaktivizoni këtë sjellje duke vendosur useDangerouslySetInnerHTML në false.

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

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

Renderimi në anën e serverit

Përdorimi i TacoTranslate

Si përkthehen tekstet

Përdorimi i origjinave

Trajtimi i variablave

Menaxhimi i përmbajtjes HTML