Skip to content

範例 ​

GitHub 上 examples/ 下的可執行專案 — 每個專案都有自己的設定、已提交的地區設定輸出和 README。您無需 API 金鑰即可探索翻譯檔案;重新執行翻譯需要提供者金鑰(提供者和模型)。

獨立執行 (npx degit) ​

在不複製完整儲存庫的情況下複製一個範例。

Node.js 範例 ​

每個 Node.js 範例都會宣告一個與當前套件版本相符的已發布插入符號範圍 ai-i18n-tools,並從 npm 安裝 CLI:

bash
npx degit wsj-br/ai-i18n-tools/examples/<name> <name>
cd <name>
pnpm install

Python 範例 ​

python-streamlit、python-flask、python-fastapi 和 python-gettext 沒有 package.json。下表中的 degit 指令均有效。您也可以從 GitHub Release 下載 ai-i18n-tools-python-examples.zip。該 zip 檔案包含相同的四個目錄。它不屬於 npm 套件的一部分,也不在獨立執行檔內。

python-streamlit、python-flask 和 python-fastapi 使用 virtualenv 和 pip install -r requirements.txt。python-gettext 僅使用標準函式庫。請使用 獨立執行檔 進行翻譯。

bash
npx degit wsj-br/ai-i18n-tools/examples/python-streamlit python-streamlit
cd python-streamlit
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

在 Windows 上,請啟用 .venv\Scripts\activate。

如果您改為複製了 整個 ai-i18n-tools 儲存庫,請在儲存庫根目錄執行 pnpm install 和 pnpm run build,然後執行 cd examples/<name>。工作區 (Node.js) 範例透過其 pnpm run i18n:* 指令碼使用本機 CLI,或在 PATH 設定 後直接使用 ai-i18n-tools …。該檢出中的 Python 範例在建置後使用 node ../../bin/ai-i18n-tools.mjs 進行翻譯。請參閱 安裝 — 複製的 monorepo。

.NET 範例 ​

dotnet-console 和 dotnet-resx 沒有 package.json。下表中的 degit 命令有效。您也可以從 GitHub Release 下載 ai-i18n-tools-dotnet-examples.zip。該 zip 檔案包含相同的兩個目錄以及 assets/dotnet,專案透過 ../../assets/dotnet 編譯。它不是 npm 套件的一部分,也不在獨立執行檔中。在該 zip 檔案之前發佈的版本不包含它。

兩者都是 xUnit 專案。dotnet-console 檢查 I18n.cs。dotnet-resx 檢查 I18nResx.cs 和 .resx 附屬檔案。兩者都不呼叫翻譯 API。在該目錄中執行 dotnet test。從完整複製的專案中,儲存庫根目錄下的 pnpm test:dotnet 會執行兩者,並在 dotnet 不在 PATH 上時跳過。

解壓縮 ai-i18n-tools-dotnet-examples.zip,然後從範例目錄執行檢查。該壓縮檔將 examples/ 和 assets/dotnet 並排放置,這是專案編譯的路徑:

bash
cd examples/dotnet-console
dotnet test

degit 複製一個目錄,但不包含 assets/dotnet。這些編譯連結在完整複製的專案中,或解壓縮 zip 檔案後解析。

哪個範例符合我的專案? ​

範例清單 ​

範例最適合使用 degit 複製執行
console-app最小的工作應用程式,包含 t() UI 字串 + README 翻譯npx degit wsj-br/ai-i18n-tools/examples/console-app console-apppnpm start
nextjs-appReact / Next.js + 複數 + 儀表板;巢狀 Docusaurus 文件 + 扁平 README + SVG 資源npx degit wsj-br/ai-i18n-tools/examples/nextjs-app nextjs-apppnpm dev (應用 :3030;cd docs-site && pnpm start 用於文件 :3040)
docusaurus-docs僅 Docusaurus 文件網站(docusaurus 預設)npx degit wsj-br/ai-i18n-tools/examples/docusaurus-docs docusaurus-docspnpm start (:3100;建置 + 服務,語系選單可運作)
astro-websiteAstro 登陸頁面:全頁 HTML + t() 混合npx degit wsj-br/ai-i18n-tools/examples/astro-website astro-websitepnpm dev
astro-docsAstro Starlight 文件網站npx degit wsj-br/ai-i18n-tools/examples/astro-docs astro-docspnpm dev (:3050)
vitepress-docsVitePress 文件網站 + 主題 JSON (pt-BR, zh-Hans)npx degit wsj-br/ai-i18n-tools/examples/vitepress-docs vitepress-docspnpm run docs:dev (:3060)
nextra-docsNextra 4 MDX + _meta.ts / 字典 .ts shell,加上一個 t() 伺服器元件 (pt-BR、zh-Hans)npx degit wsj-br/ai-i18n-tools/examples/nextra-docs nextra-docspnpm run dev (:3070)
fumadocs-docsFumadocs 4 MDX + meta.json / UI 目錄 (pt, zh, dot 解析器)npx degit wsj-br/ai-i18n-tools/examples/fumadocs-docs fumadocs-docspnpm run dev (:3080)
plain-html純 HTML + data-i18n* 標記;靜態語系 JSON(儀表板式 UI)npx degit wsj-br/ai-i18n-tools/examples/plain-html plain-htmlpnpm dev (:3090)
plain-html-docs作為文件的純 HTML:每個語系一個頁面、本地化圖片、hreflangnpx degit wsj-br/ai-i18n-tools/examples/plain-html-docs plain-html-docspnpm dev (:3092)
multi-provider選擇或基準測試 LLM 提供者 (-P / --provider)npx degit wsj-br/ai-i18n-tools/examples/multi-provider multi-providerai-i18n-tools translate-docs -P openai --force
test-markdown回歸測試 Markdown / CJK 翻譯 (天城文, MDX)npx degit wsj-br/ai-i18n-tools/examples/test-markdown test-markdownpnpm build
intlayer-migrationIntlayer .content.ts → t() (migrate-intlayer, 重置 + AI 代理報告)npx degit wsj-br/ai-i18n-tools/examples/intlayer-migration intlayer-migrationpnpm reset && pnpm dev (:3091)
intlayer-translate保留 Intlayer,就地填補缺少的語系 (translate-intlayer;en + pt-BR 已提供,es + zh-Hans 缺少)npx degit wsj-br/ai-i18n-tools/examples/intlayer-translate intlayer-translatepnpm reset && pnpm translate (pnpm dev :3093)
python-streamlitStreamlit 儀表板,t() / _(),來源字串 JSONnpx degit wsj-br/ai-i18n-tools/examples/python-streamlit python-streamlitpython3 -m venv .venv && pip install -r requirements.txt && streamlit run app.py
python-flaskFlask + Jinja,t() / _(),來源字串 JSONnpx degit wsj-br/ai-i18n-tools/examples/python-flask python-flaskpython3 -m venv .venv && pip install -r requirements.txt && flask --app app run
python-fastapiFastAPI、ContextVar 語系,t() / _(),來源字串 JSONnpx degit wsj-br/ai-i18n-tools/examples/python-fastapi python-fastapipython3 -m venv .venv && pip install -r requirements.txt && uvicorn app:app
python-gettext現有的 GNU gettext CLI;extract / translate-ui 重新整理 .po 與 .monpx degit wsj-br/ai-i18n-tools/examples/python-gettext python-gettextpython3 app.py --lang es
dotnet-consolexUnit 對 I18n.cs 的檢查:嵌入式 JSON、文化特性回退、{0}、複數形式和 Configurenpx degit wsj-br/ai-i18n-tools/examples/dotnet-console dotnet-consoledotnet test
dotnet-resxxUnit 對 I18nResx.cs 和原始字串 .resx 附屬檔案的檢查npx degit wsj-br/ai-i18n-tools/examples/dotnet-resx dotnet-resxdotnet test

每個範例名稱都連結到其 GitHub README,其中包含完整的設定、命令和專案佈局 — 或者瀏覽儲存庫中的範例索引。

Node.js 範例在 pnpm install 之後從 npm 安裝 CLI。這四個 Python 範例使用 venv 和 pip (python-gettext 僅使用標準函式庫) 以及 獨立執行檔 進行翻譯。這兩個 .NET 範例是 xUnit 專案。使用 dotnet test 執行它們。它們也位於 GitHub Release 的 ai-i18n-tools-dotnet-examples.zip 中。


免責聲明

產品名稱與圖示均屬於其各自的所有者,僅供識別之用。本軟體與上述品牌無任何關聯,亦未獲其背書或認可。

採用 MIT 授權條款釋出。