例
GitHub の examples/ にある実行可能なプロジェクト — それぞれに独自の構成、コミットされたロケール出力、および README があります。API キーなしで翻訳済みファイルを探索できます。翻訳を再実行するにはプロバイダーキーが必要です(プロバイダーとモデル)。
スタンドアロンで実行 (npx degit)
リポジトリ全体をクローンせずに、例を1つコピーします。
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ファイルは同じ4つのディレクトリで構成されています。これは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.txtWindowsでは、.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 を並べて保持します。これはプロジェクトがコンパイルするパスです。
cd examples/dotnet-console
dotnet testdegit は 1 つのディレクトリをコピーし、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 シェル、さらに1つの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, ドットパーサー) | 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: ロケールごとに1ページ、ローカライズされた画像、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 | I18n.cs の xUnit チェック: 埋め込み JSON、カルチャフォールバック、{0}、複数形、および Configure | npx degit wsj-br/ai-i18n-tools/examples/dotnet-console dotnet-console | dotnet test |
| dotnet-resx | I18nResx.cs とソース文字列 .resx サテライトの xUnit チェック | npx degit wsj-br/ai-i18n-tools/examples/dotnet-resx dotnet-resx | dotnet 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 にも含まれています。
免責事項
製品名およびアイコンは各所有者に帰属しており、識別目的でのみ使用されています。本ソフトウェアは、これらのブランドと提携しておらず、また推奨も受けていません。