言語変数のサポート

AEM Guidesには、言語変数を使用する機能が用意されています。 言語変数を使用して、PDF出力にローカライズされた文字列を定義したり、出力テンプレートに静的テキストをローカライズしたりできます。 CSS スタイルを使用して、CSS から取得する文字列をローカライズすることができます。

PDF出力での言語変数の使用

PDF変数を使用して、標準提供のラベルのローカライズ版を定義できます（メモ、注意、警告、静的テキストなど）。 変数名はすべての言語で同じですが、様々な言語で異なる値を持つことができます。 これらの変数の値を 1 つ以上のPDFで更新すると、ローカライズされた値が言語の出力で自動的に選択されます。

例えば、PDF出力にラベル Note を表示するには、次の方法があります。

{width="550"}

英語、フランス語、ドイツ語のサンプルノート。

言語変数のタイプ

AEM Guidesは、アプリケーション変数とユーザー変数の 2 種類の変数をサポートしています。

アプリケーション変数

AEM Guidesには、事前定義済みまたは標準のアプリケーション変数のセットが用意されています。 これらの事前定義済みの変数を使用して、AEM Guidesに固有のドキュメントに関する情報を追加できます。 例えば、ページに chapter-number 変数を含めると、そのページが属する章番号が表示されます。 author-label 変数には、ドキュメント作成者の名前が表示されます。

ユーザー変数

また、新しい言語変数を作成することもできます。 例えば、ドキュメントのパブリッシャーのラベルとしてユーザー変数 Publisher を作成できます。

{width="550"}

選択した言語の言語変数を追加および表示します。

新しい言語変数を追加

言語変数の書き出しと読み込み

Experience Manager Guidesでは、選択した言語に存在する言語変数を書き出しおよび読み込むことができます。 すべての言語変数を、定義済みの値と共に簡単に書き出すことができます。 これには、アプリケーション変数とユーザー変数の両方が含まれます。 書き出したファイルを使用して、必要な変更を値に加えたり、他の言語にローカライズしたりできます。

また、言語変数を含む XML ファイルを読み込むこともできます。 Experience Manager Guidesでは、application 変数と user 変数の両方を含め、既に定義されている言語変数のみが読み込まれます。 まだ定義されていない変数は読み込まれません。

言語変数の書き出し

言語の言語変数を書き出すには、ドロップダウンから言語を選択して、「書き出し」を選択します {width="25"} などの相対リンクにすることも可能です。
language_variable_<ln> という形式の XML ファイルが作成されます。<ln> は選択された言語のコードです。 例えば、英語は language_variable_en.xml、フランス語は language_variable_fr.xml です。

NOTE

言語変数に未保存の変更がある場合、それらを書き出すことはできません。 変更を保存して、有効な 書き出し を表示します {width="25"} アイコン。

言語変数の読み込み

言語変数を読み込むには：

<?xml version="1.0" encoding="UTF-8"?>
<variables>
<variable id="note-important">Important: </variable>
<variable id="note-caution">Avertir: </variable>
<variable id="image-with-text">Text and image &lt;img src=&quot;/content/dam/assets/images/image_with_text.png&quot; /&gt; </variable>
</variables>

ファイルを読み込むと、同じ ID を持つ変数が読み込まれます。 選択した言語の変数の値が XML ファイルの変数の値で更新されます。 更新された変数の数に関するメッセージが表示されます。

言語変数のオプション

変数にポインタを合わせると、その オプション メニューが表示されます。

{width="550"}

オプション ​メニューを使用して、言語変数を削除、プレビューまたは複製します。

アプリケーション変数とユーザー変数の両方をプレビューできます。 変数の値が出力にどのように表示されるかを確認するには、選択した変数の オプション メニューから プレビュー を選択します。
ユーザー変数として 削除 または 複製 を選択することもできます。 ある言語から変数を削除すると、すべての言語から自動的に削除されます。

アプリケーション変数を編集または元に戻す

また、アプリケーション変数の値を編集することもできます。 後で、アプリケーション変数を元の値に戻すことができます。 変数を復帰 {width="25"} は、値が変更されたアプリケーション変数に対して表示されます。

出力テンプレートでの言語変数の使用

ローカライズしたドキュメントには、言語変数を追加する必要があります。 これらの言語変数は、ローカライズされたドキュメントの異なるページに表示されるページレイアウト内に挿入できます。 例えば、ページレイアウトのヘッダー領域（またはフッターや本文などの他の部分）に表示される author-name ージの言語変数を追加できます。

{width="550"}

フランス語用に生成されたPDF出力にローカライズされた作成者とブランド名。

ヘッダー領域に copyright-label などの言語変数を挿入するには、次の手順を実行します。

{width="550"}

ヘッダー領域に追加された copyright-label。

言語変数へのコンテンツスタイルの適用

HTML変数に割り当てた値の他に、言語タグを使用して変数値を特定の形式で表示することもできます。 例えば、publisher-label の値を太字で表示することができます。

同様に、ページレイアウトのフィールドの挿入機能にリストされている言語変数を追加し、その他のフィールドを書式設定することができます。 フィールドの追加について詳しくは、 フィールドとメタデータの追加を参照してください。

CSS スタイルを使用して文字列をローカライズする

CSS スタイルを使用すると、チャプター、セクション、図、テーブルなど、自動番号で使用する文字列をローカライズすることもできます。 これらの文字列は CSS ファイルから得られるので、言語変数を使用してローカライズすることはできません。 これらの文字列をローカライズするには、文字列をローカライズする言語ごとに CSS スタイルを作成します。
例えば、次の CSS を使用して、チャプターのプレフィックスと対応する数値形式を様々な言語で表示できます。
例えば、次の CSS を使用して、チャプターをドイツ語で Hoofdstuk として表示し、チャプター番号を 10 進数形式で表示することができます。 日本語の場合は、日本語の表示形式を使用して、目次にチャプター番号を表示できます。

// for English
h1:before {
  counter-increment: h11;
  content: "Chapter " counter(h11, decimal)".";
}

// for German
:root:lang(de) h1:before {
  content: "Hoofdstuk " counter(h11, decimal)".";
}

// for Japanese
:root:lang(ja) h1:before {
  content: "章 " counter(h11, japanese-formal)".";
}

次のスクリーンショットは、ドイツ語出力および日本語PDF出力にローカライズされた文字列を示しています。

{width="550"}

{width="550"}

プレフィックスのフォーマット

CSS スタイルを使用すると、接頭辞の書式設定も可能です。 例えば、様々な言語のPDF出力で赤で表示されるようにラベル Note を書式設定できます。

.note .prefix-content
{
color: red;
}