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

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

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

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

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

ცვლადები სტრინგებში घोषितებულია ორმაგი ფრჩხილების საშუალებით, მაგალითად {{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-ის რენდერული მექანიზმის გამორთვა განსაკუთრებით რეკომენდირებულია არასანდო, მაგალითად მომხმარებლის მიერ შექმნილი, კონტენტის თარგმნისას.

ყველა შედეგი ყოველთვის_SANITIZED_HTML_sanitize-html მსგავსი უსაფრთხოების მიზნით_SANITIZED_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 კონტენტის მართვა