დოკუმენტაცია: 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>
	);
}

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

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