MDX
式、インポート、コンポーネント構造を保持しながら、MDXの本文と、明示的に選択したコンポーネントプロパティのリテラル値を翻訳します。
MDXでは、記事の本文にインタラクティブなコンポーネントを組み込めます。mdxファイルハンドラーは、マークアップを保持しながら、対応している本文とコンポーネントの子要素を翻訳します。コンポーネントプロパティのリテラル値にも読者に表示する文言が含まれる場合は、そのプロパティを明示的に選択してください。テキストの検出のためにインポートや式が実行されることはありません。
本文とコンポーネントデータを分ける #
たとえば、コールアウトには、画面に表示するタイトルと動作を制御するプロパティがあります。
import Callout from "./Callout";
## Delivery options {#delivery}
<Callout title="Delivery deadline" kind="warning">
Confirm your address before checkout.
</Callout>見出しと子要素の本文は翻訳対象です。kindは、変更せずに保持するコンポーネントデータです。titleは、コンポーネントプロパティのルールで選択した場合にのみ翻訳対象になります。無関係なコンポーネントにある同名の属性をすべて翻訳するよりも、ルールの対象をCalloutとtitleに絞るほうが安全です。
文字列リテラルのプロパティに対応しています。式で値を算出するプロパティは、リテラルで記述されたメッセージと同じようには扱われません。インポート、JavaScriptの式、コードブロックは、通常の本文抽出の対象外です。コンポーネント構造は、アプリケーションのレンダラーに適合させる必要があります。
フロントマターと見出しアンカー #
ファイルハンドラーは、既定でフロントマターのtitleとdescriptionを選択します。フロントマターを翻訳しない場合は、選択対象を空にしてください。マップやシーケンスを選択すると、配下のスカラー値も対象になります。隣接するルーティング用フィールドを変更したくない場合は、seo.titleのように対象を絞ったパスを指定してください。translateFrontmatterFieldsとtranslateComponentPropsについては、CLIの設定を参照してください。
Docusaurusの見出しアンカー({#delivery}など)は、見出しのテキストが変わっても保護されます。アンカー処理では、フェンスで囲まれたコードブロックの外にある見出し行の構文を認識し、URLのスラッグは変更しません。サイト上で、レンダリング後の見出しのIDと、その見出しへのリンクを確認してください。
更新と対応関係 #
以前の原文と訳文で、テキスト単位と保護されたインライン構造が対応していれば、既存の訳文を引き継げます。対応関係が曖昧な場合、ハンドラーが再利用を拒否することがあります。構造の対応しない文書をそのまま渡すのではなく、承認済みの訳文は、対応する原文のリビジョンと対にして管理してください。
再構築後は、子要素の本文以外にある表示ラベルも含め、選択したプロパティを確認してください。そのうえで、アプリケーションのMDXプロセッサーを使って結果をビルドしてください。
MDX翻訳を設定する #
CLIは.mdxからmdxを推定します。この形式ではキースコープを使用できません。ファイルのオプションについては、CLIの設定またはGitHubを参照してください。
レンダリング後のコンポーネントを確認する #
取得したMDXを実際に使用するプロセッサーでビルドし、コンポーネントプロパティ、アンカー、変数、コード例をまとめて確認してください。MDXファイルの翻訳では、JSXを含む文書を保持します。一方、Reactのメッセージ抽出では、アプリケーションのソース内で対応する呼び出しを検出し、カタログを生成します。メッセージが記述されている場所に合ったワークフローを選んでください。