ファイルインポートの設定

.MD / .MDX - Markdown および MDX (TMS)

本コンテンツはPhrase Language AIの機械翻訳により、英語から翻訳されています。

ファイル形式

  • .MD

  • .MARKDOWN

  • .MDX

インポートオプション

  • フィルタ 

    ファイルのインポート時にパーサーが使用する Markdown 方言を選択します。これは、インポートおよびエクスポート時に自動的にエスケープ/アンエスケープされる文字にも影響します。

    • プレーン

      基本的な Markdown 構造(見出し、段落、リスト、基本的な強調)のみを解析します。

    • PHP/Python Markdown Extra

      PHP Markdown Extra / Python-Markdown "Extra" 方言を使用して解析し、テーブル、定義リスト、脚注、略語、属性リストのサポートを追加します。

    • GitHub Flavored Markdown

      GitHub Flavored Markdown (GFM) 仕様を使用して解析し、テーブル、タスクリスト、取り消し線、自動リンクのサポートを追加します。

    • MDX

      ファイルを MDX として解析します:Markdown に JSX コンポーネント、JSX 式 ({...})、および ESM import/export ステートメントを追加したものです。テーブル、タスクリスト、取り消し線、自動リンクは GitHub Flavored Markdown と同様に機能します。インデントされたコードブロックと山括弧の自動リンク (<url>) はサポートされていません。これは、MDX がインデントを使用してコンポーネントをネストし、それらの構造を解析しないためです。

      MDX は JSX で拡張された Markdown であるため、コンテンツにコンポーネントや JavaScript 式を埋め込むことができます(例:Docusaurus や Next.js で構築されたドキュメント)。MDX フィルターが自動的に選択されることはありません。.MDX ファイルおよび MDX 構文を含む .MD ファイルの両方について、ファイルインポート設定で選択する必要があります。ファイル拡張子やコンテンツによる検出は行われません。

      備考

      MDX サポートを組織で有効にする必要があります。フィルター リストに MDX が表示されない場合は、カスタマーサクセスマネージャーまたは Phrase サポートにお問い合わせください。

      注意

      既存のプロジェクトを別の Markdown フィルターから MDX に切り替えると、コンテンツのセグメント化方法が変わります。切り替え後は、翻訳メモリのレバレッジが一度だけ低下することをご了承ください。

  • 強制改行で新しいセグメントを作成する 

    ハード改行ごとに新しいセグメントを開始します。

  • 空白箇所を維持 

    ターゲットドキュメント内の空白構造(スペース、改行など)を維持します。

  • YAMLヘッダを処理 

    ファイル上部の YAML フロントマターを処理します。選択すると、.YAMLインポート設定が適用されます。

  • コードブロックをインポート 

    翻訳のためにコードブロックの内容を抽出します。MDXフィルターを使用すると、これはJSXコンポーネント内にネストされたフェンス付きコードブロックにも適用されます(例: <CodeGroup> 内)。

  • コード要素を除外 

    このオプションを選択すると、コード要素が単一のPhrase TMSタグとしてインポートされます。

  • URLを翻訳可能にする

    URLを翻訳対象にします。

  • Phrase TMSタグに変換する 

    正規表現を使用して、指定されたテキストをタグに変換。

    注意

    タグに関する問題は、エクスポートエラーの一般的な原因です。ファイルをエクスポートする前に、必ず品質保証チェックを実行して、タグと書式が正しいことを確認してください。

  • カスタム要素(Phraseタグに変換) 

    タグに変換するファイル内の要素を定義します。

  • 翻訳不要ブロック 

    インポートしないファイル内のセクションを定義します。

    例:

    要素名: notrans。

    コード: <notrans>Chrysler</notrans> entered three factory-prepared <notrans>Dodge Shadows</notrans> to the event in 1985.All three vehicles retired in the first day of the three-day <notrans>Olympus</notrans> rally.

    結果:Chrysler は、1985年に工場で準備された3台の Dodge Shadows に参加しました。3台の車両はすべて3日間の Olympus ラリーの初日にリタイアしました。

  • 文字のエスケープ処理を行わない 

    完成したファイル内でエスケープすべきではない文字のリスト(例: #、-、[、<、\、`、![、](、:)。

    MDXフィルターを使用する場合、翻訳されたテキストではデフォルトで < と { の両方がエスケープされます。これは、ターゲット内でエスケープされていない < や { が存在すると、MDX構文が壊れてしまうためです。エスケープされていない生の文字が特に出力に必要である場合にのみ、ここに追加してください。

MDX固有のオプション

以下の4つのオプションは、フィルターでMDXが選択されている場合にのみ利用可能です。

  • 翻訳可能なタグ属性

    HTMLフィルターの翻訳可能な属性設定と同じtag/attribute形式で、翻訳対象にするJSXタグと属性の組み合わせを追加指定します。例えば、Figure/titleではFigureコンポーネントのtitle属性のみが翻訳対象になりますが、title(スコープなし)ではすべてのタグのtitle属性が翻訳対象になります。

    カスタムコンポーネント(<Figure>のように大文字で始まるタグ名)には、デフォルトで翻訳可能な属性がないため、ここに明示的にリストしてください。小文字/HTMLスタイルのタグ(<img>、<a>など)には、標準の翻訳対象属性がデフォルトで設定されています。

  • デフォルトで翻訳可能な属性をインポート

    デフォルトで有効になっています。

    翻訳可能な属性に指定した属性に加えて、小文字のHTML形式のタグには標準の翻訳対象属性(例:<img>のalt、<a>のtitle)も適用します。カスタムコンポーネントは、この設定に関係なく、これらのデフォルトを受け取りません。カスタムコンポーネントの属性は、翻訳可能な属性に追加した場合にのみ翻訳対象になります。

    無効にすると、小文字のタグであっても、翻訳可能な属性に指定した属性のみが翻訳対象になります。

  • 要素をデフォルトで翻訳可能に設定

    デフォルトで有効になっています。

    JSXコンポーネント内のテキストをデフォルトで翻訳可能にするかどうかを設定します。

    • 有効にした場合:<Tabs>や<Note>など、どのコンポーネント内のテキストも、そのコンポーネントがデフォルトの翻訳可否を上書きする要素に指定されていない限り、翻訳対象になります。

    • 無効にした場合:コンポーネントがデフォルトの翻訳可否を上書きする要素に指定されていない限り、コンポーネント内のテキストは翻訳対象になりません。

  • デフォルトの翻訳可能性を上書きする要素

    デフォルトで要素を翻訳可能にする設定とは逆の扱いが適用されるコンポーネント名を、カンマ区切りで指定します。

    ここにリストされたコンポーネントは全体として切り替えられます。その内部にネストされたコンポーネントを含むコンテンツ全体がオーバーライドに従い、個別に評価されることはありません。オーバーライドによってコンポーネントが翻訳不可になった場合、そのコンテンツは記述された通りに保持されます。このリストを使用して、以下を行います。

    • Make elements translatable by defaultが有効な場合に、散文を含まないコンポーネント(例:CodeGroup、Mermaid)をいくつか除外するか、

    • その設定が無効な場合に、散文を含むコンポーネントをいくつか許可リストに追加します。

JSXコンテンツの処理方法

これは、FilterでMDXが選択されている場合に適用されます。

  • JSXタグ(<Component>、<Component attr="value" />)ならびにタグ名と属性名は、決して翻訳されません。要素のコンテンツと、明示的に設定された属性の値のみが翻訳可能です。

  • 波括弧内の式({...})、JavaScript式、スプレッド属性({...props})、およびコメント({/* comment */})は、決して翻訳されません。これらは、属性内、テキストの途中、または独立した行など、どこに出現しても、記述された通りに正確に保持されます。

  • importおよびexportステートメントは、ファイル内のどこに出現しても、常に翻訳から除外されます。

この記事は役に立ちましたか?
★ ★ ★ ★ ★

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.