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

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

Georgian

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

ამჟამად სტრინგების თარგმნის სამი გზა არსებობს: Translate კომპონენტი, useTranslation ჰუკი ან translateEntries ხელსაწყო.

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

import {Translate} from 'tacotranslate/react';

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

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

useTranslation ჰუკის გამოყენება.
აბრუნებს თარგმნებს როგორც უბრალო სტრინგს. სასარგებლოა, მაგალითად, 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 პროექტები შეიცავენ იმას, რასაც ჩვენ ვუწოდებთ origins. წარმოიდგინეთ ისინი როგორც შესვლის წერტილები, ფოლდერები ან ჯგუფები თქვენი სტრინგებისა და თარგმებებისათვის.

import {TacoTranslate} from 'tacotranslate/react';

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

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

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

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

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

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

ცვლადებთან მუშაობა

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

სტრიქონებში ცვლადები გამოაცხადება ორმაგი ბრჭყალებით, მაგალითად {{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 კონტენტის მართვა