翻訳

Docsbookは、ドキュメントを15の言語コードで公開します。翻訳ファイルを作成、保存、管理する必要はありません。言語を有効にすると、DocsbookはリポジトリにすでにあるMarkdownからページを直接翻訳し、各言語をそれぞれ独自のURLパスで公開します。また、コミットによってページが変更されると、そのページを再翻訳します。

機械翻訳されたドキュメントは、通常、負担になります。コード識別子が壊れたり、ページごとに用語が揺れたり、ソースの更新後に翻訳がひそかに劣化したり、ロケールURLが検索での存在感を高めるどころか損なったりするためです。このセクションの残りでは、Docsbookのパイプラインがこれらの問題をそれぞれどのように処理するのか、そして依然として対応できていない点について説明します。

言語を開くことで得られるもの#

具体的には3つあります。どれも自分で確認できます。

その言語のクエリで、そもそもマッチ対象にできる別のURLセット。 各言語はそれぞれ異なるURLパスで、静的HTMLとしてレンダリングされ、サイトマップに記載され、独自の hreflang エントリが付与されます。英語のみのページは、どれほど高くランクされてもスペイン語のクエリにはマッチできませんが、スペイン語のページならマッチできます。Google自身のガイダンスでも、翻訳ページによってそのオーディエンスの対象になるのであって、重複コンテンツの問題ではないとされています。Docsbookはサイト単位ではなくページ単位で hreflang クラスターを構築するため、公開するクラスターはGoogleが受け入れるものになります。この仕組みと、注意せずに実装した場合にどのように失敗するかについては、翻訳品質とSEOで説明しています。

読者の言語で機能するサイト内検索。 ページが翻訳されると、翻訳されたテキストは英語の原文だけでなく、その言語コードに基づいて全文検索用にインデックス登録されます。ドイツ語で検索する読者には、ドイツ語のページがマッチします。

アシスタントがその言語で引用できるドキュメント。 クローラーが読み取るのと同じ静的HTMLを、AIアシスタントが取得します。翻訳によって、開いた言語へのGEOのカバレッジが拡大します。これは、引用できるその言語のページが存在するようになるためです。

かかるコスト#

手間。 言語を有効にするには、チェックボックスをオンにして確認ダイアログで確定するだけです。エクスポートの手順も、.po ファイルも、キーも、ベンダーアカウントも必要ありません。後から特定の文を修正する場合は、翻訳パネルで編集するか、upload_translation を呼び出します — 修正の流れをご覧ください。

費用。 翻訳にはプロジェクトの AI 残高が使われます。すでに翻訳済みのページを読者に提供する際に費用はかかりません。ページはコンテンツハッシュをキーとするセクションに分割されるため、段落を1つ編集すると、そのセクションだけが再翻訳され、残りはキャッシュから再利用されます。Docsbook では、実行を確定する前に料金を提示し、残高がなくなった場合は使いすぎずに停止します。自動翻訳と翻訳ワークフローツールは有料プランの一部です — 料金をご覧ください。

注意力。 これは、ほとんどのチームが過小評価するコストです。技術文書の機械翻訳は公開できる程度には十分ですが、無視できるほど十分ではありません。用語の揺れや、専門分野の用語まで過剰に翻訳してしまうことが、文書化されている失敗パターンです。また、Google のスパムポリシーでは、レビューされていない機械翻訳を中立的な行為ではなく、サイトへのリスクとして扱っています。翻訳品質と SEOでは、Docsbook が測定するもの、測定しないもの、そして確認すべき事項を説明しています。

このセクション#

制限事項と未解決の問題#

• 言語コードは15個で、これらに限られます。 en, es, fr, de, pt, it, ru, zh, ja, ko, ar, hi, tr, pl, nl. そのうち1つはプロジェクト独自のソース言語であり、翻訳対象にはなりません。したがって、英語のプロジェクトでは対象言語は14個です。地域バリアント（pt-BR と pt-PT、zh-Hans と zh-Hant）は別個の選択肢ではありません。
• Docsbookは翻訳品質スコアを公開していません。 ページに対するBLEU、COMET、または人による評価の数値は存在せず、このドキュメントもそのような数値を主張していません。プロダクトが測定するのは、カバレッジと鮮度、つまり各言語で何ページ存在するか、そしてソースの現行バージョンから何ページが翻訳されたかです。「翻訳が良い」かどうかは、翻訳品質とSEOに示された根拠に基づいて、あなた自身で判断してください。
• 自動翻訳は有料機能であり、それに関連する言語設定も有料です。 無料プロジェクトでは設定を確認でき、接続時にソース言語が自動検出されますが、有効な言語やソース言語を変更したり、翻訳モードを設定したり、翻訳を実行したりすることはできません。料金をご覧ください。
• このパイプラインは、リポジトリ内のMarkdownページを翻訳します。 UI文字列のローカライズシステムではなく、OpenAPI仕様のフィールド説明も翻訳しません。

関連項目#

• SEO — 翻訳の有無にかかわらず、Docsbook がすべてのページで検索エンジン向けに出力するもの
• GEO — ランク付けされるのではなく、AI アシスタントに引用されること
• 訪問者の国別レポート — まだ翻訳していない地域からどの地域の訪問者が来ているか
• コンテンツ & セットアップ — そもそもページがどのように Docsbook に追加されるか