React აპებისთვის i18n-ის საუკეთესო გადაწყვეტილება

გსურთ თქვენი React აპლიკაციის გაფართოება ახალ ბაზრებზე? TacoTranslate წარმოუდგენლად მარტივს ხდის React აპლიკაციების ლოკალიზაციას და საშუალებას გაძლევთ მიაღწიოთ გლობალურ აუდიტორიას ყოველგვარი პრობლემების გარეშე.

რატომ აირჩიოთ TacoTranslate React-ისთვის?

გლუვი ინტეგრაცია: დააპროექტებულია სპეციალურად React აპლიკაციებისთვის, TacoTranslate მარტივად ინტეგრირდება თქვენს არსებულ სამუშაო პროცესში.
სტრიქონების ავტომატური შეგროვება: აღარ მოგიწევთ JSON ფაილების ხელით მართვა. TacoTranslate ავტომატურად აგროვებს სტრიქონებს თქვენი კოდის ბაზიდან.
ხელოვნური ინტელექტის მიერ გაძლიერებული თარგმანები: გამოიყენეთ ხელოვნური ინტელექტი, რათა მიიღოთ კონტექსტუალურად ზუსტი თარგმანები, რომლებიც შეესაბამებიან თქვენი აპლიკაციის ტონს.
მყისიერი ენის მხარდაჭერა: დაამატეთ მხარდაჭერა ახალ ენებზე მხოლოდ ერთი დაწკაპუნებით და გახადეთ თქვენი აპლიკაცია გლობალურად ხელმისაწვდომი.

როგორ მუშაობს

აინსტალირეთ TacoTranslate პაკეტი npm-ის საშუალებით:

npm install tacotranslate

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

TacoTranslate აპლიკაციის UI-ში შექმენით პროექტი და გადადით მისი API გასაღებების ჩანართზე. შექმენით ერთი read გასაღები და ერთი read/write გასაღები. ჩვენ მათ გარემოს ცვლადებად შევინახავთ. read გასაღები არის ის, რასაც ვუწოდებთ public, ხოლო read/write გასაღები არის secret. მაგალითად, შეგიძლიათ ისინი დაამატოთ თქვენს პროექტის ძირითადი საქაღალდეში მოთავსებულ .env ფაილში.

ასევე დაგჭირდებათ ორი დამატებითი გარემოს ცვლადი: TACOTRANSLATE_DEFAULT_LOCALE და TACOTRANSLATE_ORIGIN.

TACOTRANSLATE_DEFAULT_LOCALE: ნაგულისხმევი (fallback) ლოკალის კოდი. ამ მაგალითში ჩვენ დავაყენებთ მას en-ად ინგლისურისთვის.
TACOTRANSLATE_ORIGIN: “ფოლდერი”, სადაც თქვენი სტრინგები შეინახება, მაგალითად თქვენი ვებსაიტის URL. ორიგინების შესახებ დაწვრილებით წაიკითხეთ აქ.

.env

TACOTRANSLATE_PUBLIC_API_KEY=123456
TACOTRANSLATE_SECRET_API_KEY=789010
TACOTRANSLATE_DEFAULT_LOCALE=en
TACOTRANSLATE_ORIGIN=your-website-url.com

დარწმუნდით, რომ არასოდეს გაამჟღავნოთ საიდუმლო read/write API გასაღები კლიენტური მხარის წარმოების გარემოში.

TacoTranslate-ის დაყენება

დააინიციალეთ TacoTranslate თქვენს React აპლიკაციაში, გახვიეთ თქვენი აპლიკაცია TacoTranslate-ის კონტექსტის პროვაიდერში:

import React, {useState} from 'react';
import TacoTranslate, {Translate} from 'tacotranslate/react';

const tacoTranslate = createTacoTranslateClient({
	apiKey: 'YOUR_API_KEY',
});

export default function App() {
	const [locale, setLocale] = useState('en');

	return (
		<TacoTranslate client={tacoTranslate} locale={locale}>
			<Translate string="Hello, world!"/>
		</TacoTranslate>
	);
}

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

import {Translate} from 'tacotranslate/react';

export default async function Component() {
	return (
		<Translate string="Hello? This is TacoTranslate speaking." />
	);
}

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

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

დაიწყეთ დღესვე!

თქვენი React აპლიკაცია ავტომატურად გაითარგმნება, როცა Translate კომპონენტში დაამატებთ ნებისმიერ სტრიქონს. გაითვალისწინეთ, რომ მხოლოდ ის გარემოებები, რომლებსაც აქვთ read/write ნებართვები API გასაღზე, შეძლებენ ახალი სტრიქონების შექმნას დასათარგმნელად.

ჩვენ გირჩევთ გქონდეთ დახურული და დაცული სტეიჯინგის (ტესტირების) გარემო, სადაც შეგიძლიათ გამოცადოთ თქვენი წარმოების აპლიკაცია და დაამატოთ ახალი სტრიქონები სანამ იგი საჯაროდ გამოქვეყნდება. ეს ხელს შეუშლის ვინმეს, მოიპაროს თქვენი საიდუმლო API გასაღები და, შესაბამისად, თავიდან აგარიდებთ თქვენი თარგმანის პროექტის გადაბერებას უაზრო სტრიქონების დამატებით.