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

import {TacoTranslate} from 'tacotranslate/react';

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

Origins საშუალებას გაძლევთ სტრიქონები meaningful კონტეინერებად გაიყოთ. მაგალითად, შეგიძლიათ ერთი origin გქონდეთ დოკუმენტაციისთვის და მეორე თქვენი მარკეტინგული გვერდისთვის.

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

ამის მისაღწევად, განიხილეთ მასთან მრავალი 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 კონტენტის მართვა