TacoTranslate
/
說明文件定價
 
2025年5月04日

React 應用程式國際化(i18n)的最佳解決方案

您是否想將您的 React 應用擴展到新市場?TacoTranslate 讓本地化 React 應用變得非常簡單,讓您能輕鬆觸及全球受眾,免除繁瑣步驟。

為什麼要為 React 選擇 TacoTranslate?

  • 無縫整合:專為 React 應用設計,TacoTranslate 能輕鬆整合進您現有的工作流程。
  • 自動字串收集:不再需要手動管理 JSON 檔案。TacoTranslate 會自動從您的程式碼庫中收集字串。
  • AI 驅動的翻譯:利用 AI 的力量提供符合語境且貼合應用語氣的準確翻譯。
  • 即時語言支援:只要點擊即可新增語言支援,讓您的應用程式能夠全球存取。

運作方式

透過 npm 安裝 TacoTranslate 套件:

npm install tacotranslate

當您安裝好模組後,您需要建立一個 TacoTranslate 帳戶、一個翻譯專案,以及相關的 API 金鑰。在此建立帳戶。 這是免費的,並且不需要您提供信用卡資訊。

在 TacoTranslate 應用程式的 UI 中,建立一個專案,並前往其 API 金鑰分頁。建立一個 read 金鑰,以及一個 read/write 金鑰。我們會把它們儲存為環境變數。read 金鑰就是我們所稱的 public,而 read/write 金鑰則為 secret。例如,你可以將它們新增到專案根目錄的 .env 檔案中。

您還需要新增兩個環境變數:TACOTRANSLATE_DEFAULT_LOCALETACOTRANSLATE_ORIGIN

  • TACOTRANSLATE_DEFAULT_LOCALE:預設的回退語系代碼。在此範例中,我們會將其設為 en(英語)。
  • TACOTRANSLATE_ORIGIN:存放字串的「資料夾」,例如您網站的 URL。在此閱讀更多關於 origins 的資訊。
.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

在您的 React 應用程式中,透過將應用程式包裹在 TacoTranslate 的上下文提供者(context provider)中來初始化 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 的好處

  • 節省時間:自動化繁瑣的本地化和字串收集流程,為您節省寶貴的時間。
  • 具成本效益:減少人工翻譯的需求,降低您的在地化成本。
  • 提升準確度:由 AI 驅動的翻譯可確保語境準確且品質高的結果。
  • 可擴充的解決方案:隨著應用程式和客戶群成長,輕鬆新增語言支援。

立即開始!

當您在 Translate 元件中新增任何字串時,您的 React 應用程式將會自動被翻譯。請注意,只有在 API 金鑰上具有 read/write 權限的環境,才能建立要翻譯的新字串。

我們建議建立一個封閉且安全的暫存環境,在那裡您可以測試生產應用程式,並在上線前新增字串。這可以防止任何人盜用您的秘密 API 金鑰,並避免透過新增惡意字串來使您的翻譯專案膨脹。

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!

來自 Nattskiftet 的產品挪威製造