Skip to content

例 ​

GitHub の examples/ にある実行可能なプロジェクト — それぞれに独自の構成、コミットされたロケール出力、および README があります。API キーなしで翻訳済みファイルを探索できます。翻訳を再実行するにはプロバイダーキーが必要です(プロバイダーとモデル)。

スタンドアロンで実行 (npx degit) ​

リポジトリ全体をクローンせずに、例を1つコピーします。

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ファイルは同じ4つのディレクトリで構成されています。これは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を使用して翻訳します。インストール — クローンしたモノレポを参照してください。

.NET の例 ​

dotnet-console と dotnet-resx には package.json がありません。以下の表にある degit コマンドは有効です。GitHub Release から ai-i18n-tools-dotnet-examples.zip をダウンロードすることもできます。その zip には、同じ 2 つのディレクトリと 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 は 1 つのディレクトリをコピーし、assets/dotnet を含みません。これらのコンパイルリンクは、フルクローンで、または zip を展開した後に解決されます。

どの例がプロジェクトに合致しますか? ​

例のリスト ​

例最適な用途degit でコピー実行
console-appt() 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-docsDocusaurus ドキュメントサイトのみ (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 シェル、さらに1つの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, ドットパーサー)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: ロケールごとに1ページ、ローカライズされた画像、hreflangnpx degit wsj-br/ai-i18n-tools/examples/plain-html-docs plain-html-docspnpm dev (:3092)
multi-providerLLM プロバイダーを選択またはベンチマーク (-P / --provider)npx degit wsj-br/ai-i18n-tools/examples/multi-provider multi-providerai-i18n-tools translate-docs -P openai --force
test-markdownMarkdown / 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-translateIntlayer を維持し、不足しているロケールをその場で埋める(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 と .mo を更新しますnpx degit wsj-br/ai-i18n-tools/examples/python-gettext python-gettextpython3 app.py --lang es
dotnet-consoleI18n.cs の xUnit チェック: 埋め込み JSON、カルチャフォールバック、{0}、複数形、および Configurenpx degit wsj-br/ai-i18n-tools/examples/dotnet-console dotnet-consoledotnet test
dotnet-resxI18nResx.cs とソース文字列 .resx サテライトの xUnit チェックnpx degit wsj-br/ai-i18n-tools/examples/dotnet-resx dotnet-resxdotnet test

各例の名前は、完全なセットアップ、コマンド、プロジェクトレイアウトが記載された GitHub README にリンクしています。または、リポジトリの例のインデックス を参照してください。

Node.js の例では、pnpm install の後に npm から CLI をインストールします。4 つの Python の例では、venv と pip (python-gettext は標準ライブラリのみを使用) および翻訳用の スタンドアロン実行可能ファイル を使用します。2 つの .NET の例は xUnit プロジェクトです。これらを dotnet test で実行します。これらは GitHub Release の ai-i18n-tools-dotnet-examples.zip にも含まれています。


免責事項

製品名およびアイコンは各所有者に帰属しており、識別目的でのみ使用されています。本ソフトウェアは、これらのブランドと提携しておらず、また推奨も受けていません。

MITライセンスの下で公開されています。