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

import {TacoTranslate} from 'tacotranslate/react';

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

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

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

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