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 许可证发布。