Skip to content

共有ラスター ​

すべてのロケールで単一の画像が共有される場合(ロケールごとのバリアントがない場合)に使用します。

  • docsOutput.style = "flat" — フラットリンク書き換えツールは出力ファイルごとに深さプレフィックスを計算するため、ソースファイルの隣にある相対アセット(例: docs/page.mdからfigure.pngとして参照されるdocs/figure.png)は、すべての翻訳された出力で正しく解決されます。postProcessing.regexAdjustmentsルールは不要です。ソースファイルがサブディレクトリにある場合は、出力パスがソースツリーを保持するようにflatPreserveRelativeDir: trueを有効にします(ファイルごとの深さプレフィックスを参照)。
  • docsOutput.style = "vitepress"(およびリンク正規化機能を持つ他のドキュメントシステムプリセット)— /translation-dashboard.pngのようなサイトルート絶対パスは、URLがすべてのロケールで同一である場合、変更されません。regexAdjustmentsルールは不要です。

フラットの例: あるプロジェクトが docs/guide/quick-start.md を translated-docs/docs/guide/quick-start.<locale>.md に翻訳します。これは flatPreserveRelativeDir: true を前提としており、docs/guide/quick-start.md は translated-docs/docs/guide/quick-start.<locale>.md に出力されます(translated-docs/quick-start.<locale>.md ではありません)。隣接する画像 docs/translation-dashboard.png は quick-start.md から ../translation-dashboard.png として参照されます。リライターは出力ファイルのディレクトリからソースディレクトリまでのファイルごとのプレフィックス(../../docs/)を計算し、../../docs/translation-dashboard.png を生成します。translated-docs/docs/guide/ からは、docs/translation-dashboard.png に正しく解決されます。

postProcessingルールは、次の場合に依然として必要です。

  • アセットがdocsOutput.style = "flat"で絶対URLを介して参照されている場合(例: /img/figure.png)— フラット書き換えツールは相対パスのみを処理します
  • その他の理由でアセットのURLを変更したい場合(例: CDNへの切り替え)

実装例 ​

このリポジトリ自身のドキュメントは、共有画像の絶対URLバリアントを使用しています: 翻訳ダッシュボードガイドはスクリーンショットを ![Translation Dashboard](/translation-dashboard.png) として参照しています — これは docs/public/translation-dashboard.png から配信される絶対のサイトルートパスです。URLはすべてのロケールで同一であるため、postProcessing.regexAdjustments ルールは不要です。

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