Mafi kyawun mafita don ƙulla aikace‑aikacen React zuwa harsuna da yawa (i18n)

Yadda yake aiki

Shigar da kunshin TacoTranslate ta amfani da npm:

npm install tacotranslate

Da zarar an shigar da module ɗin, za ku buƙaci ƙirƙirar asusun TacoTranslate, wani aikin fassara, da makullin API masu alaƙa. Ƙirƙiri asusu anan. Kyauta ne, kuma ba lallai ba ne ku saka katin bashi.

A cikin UI na aikace‑aikacen TacoTranslate, ƙirƙiri wani aikin, sannan ka je zuwa tab ɗin maɓallan API ɗinsa. Ƙirƙiri maɓalli ɗaya read da maɓalli ɗaya read/write. Za mu adana su a matsayin canje‑canjen muhalli. Maɓallin read shi ne abin da muke kira public, kuma maɓallin read/write shi ne secret. Misali, za ka iya ƙara su cikin fayil ɗin .env a tushen aikin ka.

Haka kuma, kuna buƙatar ƙara wasu canje-canje na muhalli guda biyu: TACOTRANSLATE_DEFAULT_LOCALE da TACOTRANSLATE_ORIGIN.

• TACOTRANSLATE_DEFAULT_LOCALE: Lambar tsohuwar wurin madadin yare. A cikin wannan misalin, za mu saita ta zuwa en don Turanci.
• TACOTRANSLATE_ORIGIN: "Folda" inda za a ajiye rubutunku, kamar URL na gidan yanar gizonku. Karanta ƙarin bayani game da origins anan.

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

Ka tabbata kada ka taba fallasa sirrin read/write mabuɗin API ga muhalli na samarwa a ɓangaren abokin ciniki.

Saitawa TacoTranslate

Saita TacoTranslate a cikin aikace-aikacen React ɗinku ta hanyar nade aikace-aikacenku cikin mai ba da mahallin (context provider) na 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>
	);
}

Yanzu za ku iya amfani da Translate sashi a ko'ina cikin aikace-aikacenku don nuna rubutu da aka fassara! Tabbatar ku duba takardunmu don ƙarin bayani, da jagororin aiwatarwa na musamman ga saitin ku.

import {Translate} from 'tacotranslate/react';

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

Fa'idodin amfani da TacoTranslate

• Ajiye lokaci: Yana sarrafa aikin da ke wahala na daidaita harshe da tattara ƙirtani ta atomatik, yana maka tanadin lokaci mai mahimmanci.
• Mai araha: Yana rage buƙatar fassara ta hannu, yana rage farashin daidaita harshe.
• Ingantaccen daidaito: Fassarorin da AI ke tallafawa suna tabbatar da sakamako mai daidaito bisa mahallin magana da inganci mai kyau.
• Magani mai iya faɗaɗa: Ƙara goyon bayan sabbin harsuna cikin sauƙi yayin da aikace-aikacenku da yawan masu amfani ke ƙaruwa.

Fara a yau!

Aikace-aikacen React ɗinku za a fassara ta atomatik lokacin da kuka ƙara kowanne rubutu a cikin Translate sashi. Lura cewa sai mahalli waɗanda ke da izinin read/write a kan maɓallin API su ne za su iya ƙirƙirar sababbin rubutu don a fassara.

Muna ba da shawarar ku sami mahalli na gwaji (staging) wanda yake rufe kuma mai tsaro, inda za ku iya gwada aikace-aikacen ku na samarwa, kuna ƙara sababbin rubutu kafin ya fara aiki a bainar jama'a. Wannan zai hana kowa satar maɓallin API ɗinku na sirri, kuma zai hana yiwuwar ƙara yawan rubutu marasa amfani da kuma ƙara girman aikin fassarar ku ba tare da bukata ba.

Be sure to check out the complete examples over at our GitHub profile. If you encounter any problems, feel free to reach out, and we’ll be more than happy to help.

TacoTranslate lets you automatically localize your React applications quickly to and from over 75 languages. Translate for free!