Dokumentacion: 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 shërbimi translateEntries.

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

import {Translate} from 'tacotranslate/react';

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

Ju mund të ndryshoni llojin e elementit duke përdorur, për shembull, as="p" në komponent.

Përdorimi i useTranslation hook.
Kthen përkthime si një varg i thjeshtë. I dobishëm, për shembull, në etiketa 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 utilitetit translateEntries.
Përkthe vargje në anën e serverit. Forco 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ë serverat tanë, ne së pari i verifikojmë dhe i ruajmë, pastaj menjëherë kthejmë një përkthim me makinë. Ndërkohë që përkthimet me makinë janë përgjithësisht me cilësi më të ulët krahasuar me përkthimet tona me AI, ato sigurojnë një përgjigje të shpejtë fillestare.

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

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

Përdorimi i origjinave

Projektet TacoTranslate përmbajnë atë që ne e quajmë origjina. Mendoni për to 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>
	);
}

Origjina ju lejon të ndash fjalitë në kontejnerë 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 origins në nivelin e komponentit.

Për të arritur këtë, konsideroni përdorimin e disa ofruesve TacoTranslate brenda projektit tuaj.

Ju lutemi kini parasysh që e njëjta varg mund të marrë përkthime të ndryshme në origjina të ndryshme.

Në fund të fundit, mënyra se si ndani stringjet në origjinat është në dorën tuaj dhe në bazë të nevojave tuaja. Megjithatë, vini re se pasur shumë stringje brenda një origjine mund të rrisë kohën e ngarkimit.

Menaxhimi i variablave

Duhet gjithmonë të përdorni variabla për përmbajtje dinamike, si emrat e përdoruesve, datat, adresat e email-it dhe më shumë.

Variablat në vargje 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

Në mënyrë të paracaktuar, komponenti Translate mbështet dhe shfaq përmbajtje HTML. Megjithatë, mund të hiqni dorë nga kjo sjellje duke vendosur useDangerouslySetInnerHTML në false.

Çaktivizimi i renderimit HTML rekomandohet fuqishëm kur përktheni përmbajtje të pa besueshme, siç është përmbajtja e krijuar nga përdoruesit.

Gjithçka që dalin përpunohet gjithmonë 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 i mësipërm do të shfaqet si tekst i thjeshtë.

Renditja në anën e serverit

Përdorimi i TacoTranslate

Si përkthehen vargjet

Përdorimi i origjinave

Menaxhimi i variablave

Menaxhimi i përmbajtjes HTML