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_LOCALE 和 TACOTRANSLATE_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，方法是將您的應用程式包裹在 TacoTranslate 的 context provider 中：

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 權限的環境才能建立新的要翻譯的字串。

我們建議設置一個封閉且安全的預備（staging）環境，在上線前於該環境中測試你的生產應用並新增字串。這可以防止任何人竊取你的祕密 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!