範例
GitHub 上 examples/ 下的可執行專案 — 每個專案都有自己的設定、已提交的地區設定輸出和 README。您無需 API 金鑰即可探索翻譯檔案;重新執行翻譯需要提供者金鑰(提供者和模型)。
獨立執行 (npx degit)
在不複製完整儲存庫的情況下複製一個範例。
Node.js 範例
每個 Node.js 範例都會宣告一個與當前套件版本相符的已發布插入符號範圍 ai-i18n-tools,並從 npm 安裝 CLI:
npx degit wsj-br/ai-i18n-tools/examples/<name> <name>
cd <name>
pnpm installPython 範例
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 僅使用標準函式庫。請使用 獨立執行檔 進行翻譯。
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 並排放置,這是專案編譯的路徑:
cd examples/dotnet-console
dotnet testdegit 複製一個目錄,但不包含 assets/dotnet。這些編譯連結在完整複製的專案中,或解壓縮 zip 檔案後解析。
哪個範例符合我的專案?
- JS/TS 應用程式:console-app (最小) 或 nextjs-app。指南:為 JS/TS 應用程式新增 i18n。
- Python 應用程式:python-streamlit、python-flask 或 python-fastapi。指南:為 Python 應用程式新增 i18n。
- Django 或 GNU gettext 應用程式:python-gettext (gettext 命令列工具;沒有 Django 範例目錄)。指南:為 Django / Python gettext 應用程式新增 i18n。
- .NET 輔助工具:dotnet-console (
I18n.cs) 或 dotnet-resx (I18nResx.cs和.resx附屬檔案)。指南:為 .NET 應用程式新增 i18n 和 為 .NET ResourceManager 應用程式新增 i18n。 - 網站或文件網站:docusaurus-docs、vitepress-docs、astro-docs、nextra-docs、fumadocs-docs、astro-website、plain-html 或 plain-html-docs。指南:為網站或文件網站新增 i18n。
- 應用程式旁的儲存庫 README:console-app 或 nextjs-app (nextjs 範例也有文件網站)。指南:為您的 README 和 Markdown 文件新增 i18n。
- 其他:multi-provider、test-markdown 和 intlayer-migration。
範例清單
| 範例 | 最適合 | 使用 degit 複製 | 執行 |
|---|---|---|---|
| console-app | 最小的工作應用程式,包含 t() UI 字串 + README 翻譯 | npx degit wsj-br/ai-i18n-tools/examples/console-app console-app | pnpm start |
| nextjs-app | React / Next.js + 複數 + 儀表板;巢狀 Docusaurus 文件 + 扁平 README + SVG 資源 | npx degit wsj-br/ai-i18n-tools/examples/nextjs-app nextjs-app | pnpm dev (應用 :3030;cd docs-site && pnpm start 用於文件 :3040) |
| docusaurus-docs | 僅 Docusaurus 文件網站(docusaurus 預設) | npx degit wsj-br/ai-i18n-tools/examples/docusaurus-docs docusaurus-docs | pnpm start (:3100;建置 + 服務,語系選單可運作) |
| astro-website | Astro 登陸頁面:全頁 HTML + t() 混合 | npx degit wsj-br/ai-i18n-tools/examples/astro-website astro-website | pnpm dev |
| astro-docs | Astro Starlight 文件網站 | npx degit wsj-br/ai-i18n-tools/examples/astro-docs astro-docs | pnpm dev (:3050) |
| vitepress-docs | VitePress 文件網站 + 主題 JSON (pt-BR, zh-Hans) | npx degit wsj-br/ai-i18n-tools/examples/vitepress-docs vitepress-docs | pnpm run docs:dev (:3060) |
| nextra-docs | Nextra 4 MDX + _meta.ts / 字典 .ts shell,加上一個 t() 伺服器元件 (pt-BR、zh-Hans) | npx degit wsj-br/ai-i18n-tools/examples/nextra-docs nextra-docs | pnpm run dev (:3070) |
| fumadocs-docs | Fumadocs 4 MDX + meta.json / UI 目錄 (pt, zh, dot 解析器) | npx degit wsj-br/ai-i18n-tools/examples/fumadocs-docs fumadocs-docs | pnpm run dev (:3080) |
| plain-html | 純 HTML + data-i18n* 標記;靜態語系 JSON(儀表板式 UI) | npx degit wsj-br/ai-i18n-tools/examples/plain-html plain-html | pnpm dev (:3090) |
| plain-html-docs | 作為文件的純 HTML:每個語系一個頁面、本地化圖片、hreflang | npx degit wsj-br/ai-i18n-tools/examples/plain-html-docs plain-html-docs | pnpm dev (:3092) |
| multi-provider | 選擇或基準測試 LLM 提供者 (-P / --provider) | npx degit wsj-br/ai-i18n-tools/examples/multi-provider multi-provider | ai-i18n-tools translate-docs -P openai --force |
| test-markdown | 回歸測試 Markdown / CJK 翻譯 (天城文, MDX) | npx degit wsj-br/ai-i18n-tools/examples/test-markdown test-markdown | pnpm build |
| intlayer-migration | Intlayer .content.ts → t() (migrate-intlayer, 重置 + AI 代理報告) | npx degit wsj-br/ai-i18n-tools/examples/intlayer-migration intlayer-migration | pnpm 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-translate | pnpm reset && pnpm translate (pnpm dev :3093) |
| python-streamlit | Streamlit 儀表板,t() / _(),來源字串 JSON | npx degit wsj-br/ai-i18n-tools/examples/python-streamlit python-streamlit | python3 -m venv .venv && pip install -r requirements.txt && streamlit run app.py |
| python-flask | Flask + Jinja,t() / _(),來源字串 JSON | npx degit wsj-br/ai-i18n-tools/examples/python-flask python-flask | python3 -m venv .venv && pip install -r requirements.txt && flask --app app run |
| python-fastapi | FastAPI、ContextVar 語系,t() / _(),來源字串 JSON | npx degit wsj-br/ai-i18n-tools/examples/python-fastapi python-fastapi | python3 -m venv .venv && pip install -r requirements.txt && uvicorn app:app |
| python-gettext | 現有的 GNU gettext CLI;extract / translate-ui 重新整理 .po 與 .mo | npx degit wsj-br/ai-i18n-tools/examples/python-gettext python-gettext | python3 app.py --lang es |
| dotnet-console | xUnit 對 I18n.cs 的檢查:嵌入式 JSON、文化特性回退、{0}、複數形式和 Configure | npx degit wsj-br/ai-i18n-tools/examples/dotnet-console dotnet-console | dotnet test |
| dotnet-resx | xUnit 對 I18nResx.cs 和原始字串 .resx 附屬檔案的檢查 | npx degit wsj-br/ai-i18n-tools/examples/dotnet-resx dotnet-resx | dotnet 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 中。
免責聲明
產品名稱與圖示均屬於其各自的所有者,僅供識別之用。本軟體與上述品牌無任何關聯,亦未獲其背書或認可。