Docusaurusドキュメントを他言語に翻訳。MDXやコードには一切手を加えません
docsフォルダーをZIP圧縮してアップロードするだけで、翻訳済みファイルがそのまま手に入り、i18n/<locale>/docusaurus-plugin-content-docs/current に配置するだけで使えます。import行、Tabsなどのコンポーネント、警告ブロックのマーカー、コードブロック、リンクは元のまま保持され、タイトル、サイドバーのラベル、description、本文のみが翻訳されます。アカウント不要で最初の部分は無料。最大 1,000,000 文字のテキストで $5（一回払いのみ）です。
- import/export行およびJSXコンポーネント行をそのまま維持
- 警告ブロックマーカー（:::note、:::tipなど）を保持し、中のテキストのみを翻訳
- フロントマター：title、description、sidebar_labelを翻訳し、id、slug、sidebar_positionは保持
- {#install} などの見出しアンカーを保持し、リンク切れを防止
- 同じフォルダー構成のZIPファイルで返却、画像もそのままコピー
コピペ不要のDocusaurus国際化（i18n）
Docusaurusでは、ロケール用フォルダー内に同じファイル名で各ドキュメントの翻訳版を配置する必要があります。これを手作業で行ったり、AIチャットアシスタントで1ファイルずつ翻訳したりするのは時間がかかるうえ、MDXではミスが致命的になります。import名が勝手に翻訳されたり、propsが書き換えられたりするとビルドエラーが発生します。本ツールは読者に見える部分のみを翻訳し、それ以外はすべて元のファイルからそのままコピーします。
インラインコード、リンク先、画像パス、MDXの {式} は翻訳前にマーカーに置き換えられ、翻訳後に復元されるため、モデルに渡されることはありません。<Tabs> や <TabItem value="mac"> のようなJSXのみの行はスキップされます。コードブロックはコメントを含め丸ごとスキップされます。
ダウンロード後の手順
- ZIPを展開し、docs-<locale> フォルダーの中身を i18n/<locale>/docusaurus-plugin-content-docs/current にコピー
- JSONで管理されているテーマラベルやサイドバーのカテゴリ名を取得するため、docusaurus write-translations を実行
- --locale <locale> を付けてサイトを起動し、表示を確認
- 警告ファイル（warnings）がある場合は、記載されている段落を修正
対象外の項目
サイドバーのカテゴリラベル、ナビゲーションバー、フッターのテキストは、write-translations で生成されるJSONファイルに存在します。これらはローカライズファイル翻訳ツールで翻訳してください。ブログ記事もdocsと同様に処理できます。blogフォルダーをZIP圧縮して別の作業としてアップロードするか、docsと一緒に1つのZIPにまとめてアップロードしてください。
ツールの仕組み、料金、ファイルの扱いについてはMarkdownドキュメント翻訳のページを、全ツールの料金は料金のページをご覧ください。
最終更新日
よくある質問
ビルドは問題なく通りますか？
MDXのビルドエラーの原因になりやすいimport、コンポーネント、props、コード、リンク先は、すべて元のファイルからそのままコピーされます。ファイルを配置した後に一度ビルドを実行し、警告ファイルがあれば内容を確認してください。
警告ブロック（Admonition）は翻訳されますか？
:::note や ::: の行はそのまま保持され、その内側のテキストのみが翻訳されます。
1件の作業でどのくらいの量を処理できますか？
$5 で最大 1,000,000 文字（約 300 ページ分）のテキストを処理できます。コードやフロントマターのキー名は文字数にカウントされません。
まず数ファイルを試すことはできますか？
はい。最初の部分は無料で翻訳されて画面上に表示されます。最大 40 段落までの作業なら全体が完全無料です。