ファイル形式
-
.MD
-
.MARKDOWN
-
.MDX
インポートオプション
-
ファイルのインポート時にパーサーが使用する Markdown 方言を選択します。これは、インポートおよびエクスポート時に自動的にエスケープ/アンエスケープされる文字にも影響します。
-
基本的な Markdown 構造(見出し、段落、リスト、基本的な強調)のみを解析します。
-
PHP Markdown Extra / Python-Markdown "Extra" 方言を使用して解析し、テーブル、定義リスト、脚注、略語、属性リストのサポートを追加します。
-
GitHub Flavored Markdown (GFM) 仕様を使用して解析し、テーブル、タスクリスト、取り消し線、自動リンクのサポートを追加します。
-
ファイルを MDX として解析します:Markdown に JSX コンポーネント、JSX 式 (
{...})、および ESMimport/exportステートメントを追加したものです。テーブル、タスクリスト、取り消し線、自動リンクは GitHub Flavored Markdown と同様に機能します。インデントされたコードブロックと山括弧の自動リンク (<url>) はサポートされていません。これは、MDX がインデントを使用してコンポーネントをネストし、それらの構造を解析しないためです。MDX は JSX で拡張された Markdown であるため、コンテンツにコンポーネントや JavaScript 式を埋め込むことができます(例:Docusaurus や Next.js で構築されたドキュメント)。MDX フィルターが自動的に選択されることはありません。.MDX ファイルおよび MDX 構文を含む .MD ファイルの両方について、ファイルインポート設定で選択する必要があります。ファイル拡張子やコンテンツによる検出は行われません。
備考
MDX サポートを組織で有効にする必要があります。 リストに MDX が表示されない場合は、カスタマーサクセスマネージャーまたは Phrase サポートにお問い合わせください。
注意
既存のプロジェクトを別の Markdown フィルターから MDX に切り替えると、コンテンツのセグメント化方法が変わります。切り替え後は、翻訳メモリのレバレッジが一度だけ低下することをご了承ください。
-
-
ハード改行ごとに新しいセグメントを開始します。
-
ターゲットドキュメント内の空白構造(スペース、改行など)を維持します。
-
ファイル上部の YAML フロントマターを処理します。選択すると、.YAMLインポート設定が適用されます。
-
翻訳のためにコードブロックの内容を抽出します。MDXフィルターを使用すると、これはJSXコンポーネント内にネストされたフェンス付きコードブロックにも適用されます(例:
<CodeGroup>内)。 -
このオプションを選択すると、コード要素が単一のPhrase TMSタグとしてインポートされます。
-
URLを翻訳対象にします。
-
正規表現を使用して、指定されたテキストをタグに変換。
-
タグに変換するファイル内の要素を定義します。
-
インポートしないファイル内のセクションを定義します。
例:
要素名:
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>など、どのコンポーネント内のテキストも、そのコンポーネントがに指定されていない限り、翻訳対象になります。 -
無効にした場合:コンポーネントがに指定されていない限り、コンポーネント内のテキストは翻訳対象になりません。
-
-
設定とは逆の扱いが適用されるコンポーネント名を、カンマ区切りで指定します。
ここにリストされたコンポーネントは全体として切り替えられます。その内部にネストされたコンポーネントを含むコンテンツ全体がオーバーライドに従い、個別に評価されることはありません。オーバーライドによってコンポーネントが翻訳不可になった場合、そのコンテンツは記述された通りに保持されます。このリストを使用して、以下を行います。
-
が有効な場合に、散文を含まないコンポーネント(例:
CodeGroup、Mermaid)をいくつか除外するか、 -
その設定が無効な場合に、散文を含むコンポーネントをいくつか許可リストに追加します。
-
JSXコンテンツの処理方法
これは、でMDXが選択されている場合に適用されます。
-
JSXタグ(
<Component>、<Component attr="value" />)ならびにタグ名と属性名は、決して翻訳されません。要素のコンテンツと、明示的に設定された属性の値のみが翻訳可能です。 -
波括弧内の式(
{...})、JavaScript式、スプレッド属性({...props})、およびコメント({/* comment */})は、決して翻訳されません。これらは、属性内、テキストの途中、または独立した行など、どこに出現しても、記述された通りに正確に保持されます。 -
importおよびexportステートメントは、ファイル内のどこに出現しても、常に翻訳から除外されます。