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

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

Georgian

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

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

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

import {Translate} from 'tacotranslate/react';

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

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

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

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

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

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

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

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

ცვლადების მართვა

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

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

ყველა უერთ output ყოველთვის გაიწმინდება 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 საკონტენტო მართვა