დოკუმენტაცია: TacoTranslate-ის გამოყენება

TacoTranslate-ის გამოყენება

Georgian

სტრინგების თარგმნა

ამჟამად სტრიქონების თარგმნის სამი გზა არსებობს: Translate კომპონენტი, useTranslation hook, ან translateEntries უზრუნველყოფა.

გამოიყენეთ Translate კომპონენტი.
თარგმნებს ხელს უწყობს span ელემენტში და მხარდაჭერილია HTML-ის რენდერინგი.

import {Translate} from 'tacotranslate/react';

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

თქვენ შეგიძლიათ შეცვალოთ ელემენტის ტიპი, მაგალითად, კომპონენტზე დააყენოთ as="p".

გამოიყენეთ useTranslation hook.
ბრუნდება თარგმნები როგორც უბრალო სტრინგი. სასარგებლოა, მაგალითად, 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>
	);
}

გადატანის ინსტრუმენტის translateEntries გამოყენება.
სტრიქონების გადათარგმნა სერვერის მხარეს. გააძლიერეთ თქვენი 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)
	};
}

როდესაც სტრიქონები ჩვენს სერვერებამდე მივიდა, ჩვენ პირველ რიგში ვამოწმებთ და ვუმახსოვრებთ მათ, შემდეგ კი მაშინვე მივცემთ მანქანური თარგმანის შედეგს. მანქანური თარგმანები ზოგადად ნაკლები ხარისხისაა ჩვენს AI თარგმანებთან შედარებით, თუმცა ისინი უზრუნველყოფენ სწრაფ საწყის პასუხს.

იმავე დროს, ჩვენ ვიწყებთ ასინქრონულ თარჯიმნობას თქვენი სტრინგისთვის მაღალი ხარისხის და უახლესი სტილის AI თარჯიმნის შესაქმნელად. როდესაც AI თარჯიმანი მზად იქნება, ის შეცვლის მანქანურ თარჯიმანს და გაიგზავნება ყოველი თქვენი თხოვნის დროს სტრინგების თარჯიმნების მისაღებად.

თუ თქვენ სტრიქონი ხელით ანთარგმნეთ, ამ თარგმნებს უპირატესობა ენიჭება და შეტანილი ჩაანაცვლებს მათ.

ობიექტების გამოყენება

TacoTranslate პროექტები შეიცავს იმას, რასაც ჩვენ ვეძახით origin-ებს. წარმოიდგინეთ ისინი როგორც შესასვლელი წერტილები, ფოლდერები ან ჯგუფები თქვენი ტექსტებისთვის და თარჯიმნებისთვის.

import {TacoTranslate} from 'tacotranslate/react';

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

ორჯინები საშუალებას გაძლევთ სტრიქონები მნიშვნელოვნად დაყოფილ კონტეინერებად გადაანაწილოთ. მაგალითად, შეგიძლიათ ჰქონდეთ ერთი ორჯინი დოკუმენტაციისთვის და მეორე თქვენი მარკეტინგული გვერდისთვის.

უფრო დეტალური კონტროლის მისაღწევად, შესაძლებელია ორიგინების დაყენება კომპონენტის დონეზე.

ამის მისაღწევად, განიხილეთ საკუთარი პროექტის ფარგლებში რამდენიმე TacoTranslate პროვაიდერის გამოყენება.

გთხოვთ გაითვალისწინოთ, რომ ერთი და იგივე სტრიქონი შეიძლება სხვადასხვა ორიგინში სხვადასხვა თარგმანი მიიღოს.

ბოლოს და ბოლოს, როგორ გაყოფთ სტრიქონებს ორიგინებად, ეს თქვენს და თქვენს საჭიროებებზეა დამოკიდებული. თუმცა, გაითვალისწინეთ, რომ ერთი ორიგინში ბევრი სტრიქონის ყოფნა შეიძლება გაზარდოს დატვირთვის დრო.

პარამეტრების მართვა

დYNAMIC კონტენტისთვის ყოველთვის უნდა გამოიყენოთ ცვლადები, როგორიცაა მომხმარებლის სახელები, თარიღები, ელ-ფოსტის მისამართები და სხვა.

სტრიქონებში ცვლადები აღწერილია ორმაგი ფრჩხილებით, როგორიცაა {{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}});
}

HTML შინაარსის მართვა

წარმოედგენა, Translate კომპონენტი მხარს უჭერს და ათავსებს HTML კონტენტს. თუმცა, შეგიძლიათ ამ ქცევიდან უარი თქვათ, გამოაცხადოთ useDangerouslySetInnerHTML როგორც false.

არასასურველია HTML-ის რენდერზე გამორთვა დაუჯერებელი შინაარსის, მაგალითად, მომხმარებლის მიერ გენერირებული კონტენტის თარგმნისას.

ყველა გამომავალი ყოველთვის მუშავდება უსაფრთხოების მიზნით sanitize-html გამოყენებით სანამ გამოსახვა მოხდება.

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

ზემოთ მოცემული მაგალითი იქნება წარმოდგენილი როგორც სუფთა ტექსტი.

სერვერზე დაფუძნებული რენდერული

TacoTranslate-ის გამოყენება

როგორ თარგმნება სტრიქონები

ობიექტების გამოყენება

პარამეტრების მართვა

HTML შინაარსის მართვა