PublishPDF出力
AEM Guidesを使用すると、個々のトピックまたはマップ ファイル全体のPDFを生成できます。 PDF形式でコンテンツを公開するには、次の 3 つの方法のいずれかを使用します。
- DITA-OT
マップ ダッシュボードからマップのPDF出力を生成するには、この方法を使用します。 マップダッシュボードで開いたマップの出力プリセットを作成することで、PDFを生成する前に公開プロパティを設定できます。 出力プリセットを作成または編集するには、AEM Guidesas a Cloud Serviceユーザーガイドの 出力プリセットについて 節を参照してください。
DITA-OT メソッドを使用してPDFを生成する方法については、DITA-OT を使用したPDFの生成を参照してください。
- FrameMaker Publishing Server（FMPS）
この方法を使用すると、DITA コンテンツだけでなく、AEM リポジトリで使用可能なFrameMaker文書（.book と.fm）からもPDF出力を生成できます。 PDFは、出力プリセットを設定することで作成でき、FrameMaker Publishing Server（FMPS）を使用して公開できます。 出力のルックアンドフィールをPDFやその他の形式に合わせて設計および設定し、それを設定ファイル（.sts）に保存できます。 この設定ファイルは、FMPS で DITA マップまたは.book ファイルの出力を生成するために使用されます。 出力プリセットを作成または編集するには、AEM Guidesas a Cloud Serviceユーザーガイドの 出力プリセットについて の節を参照してください。
FMPS の設定について詳しくは、FrameMaker文書からの出力の生成を参照してください。
- ネイティブPDFの公開
この手法を使用して、W3C CSS3 および CSS ページメディア標準に基づいた、機能豊富なPDF出力を生成します。 ネイティブPDFのパブリッシングでは、テンプレートを使用してコンテンツのレイアウトとスタイルを設定し、様々な設定を適用してPDFを微調整できます。 さらに、テンプレートエディターを使用して独自のテンプレートを変更および作成できます。
ネイティブPDFでの公開について詳しくは、 ネイティブPDFでの公開の使用を参照してください。
ネイティブPDF公開の使用 native-pdf-publishing
コンテンツをオーサリングする際には、コンテンツが表示、編集、印刷用に最適化されていることを確認することが不可欠になります。 コンテンツのスタイル設定に W3C CSS3 などの標準や、サイズ、余白、向き、改ページ、ヘッダー、フッター、ページ番号などのページ定義プロパティの CSS ページメディア標準を使用すると、PDFのドキュメントに合ったビューとレイアウトを設定して、一貫性と操作性を確保できます。 ネイティブPDFの公開機能は、これらの標準を使用してPDFを生成します。
ネイティブPDFのパブリッシングでは、定義済みのテンプレートを使用して、コンテンツのレイアウトと構造の一貫性を確保したり、スタイルシートを適用して出力のルックアンドフィールを変更したり、PDFを最適化したり、プリンターマークを設定したり、スクリーンリーダーのサポートを許可したり、PDFの準拠を設定したり、フォントを埋め込んだりできます。
ネイティブPDF公開を使用したPDFの生成には、次の 2 つの側面があります。
-
テンプレートを使用して、コンテンツにスタイルを適用したり、ページレイアウトを設定したり、様々な設定を行ってPDFを微調整したりします。 作成者は、提供されるサンプルテンプレートを使用または変更することを選択したり、カスタムテンプレートを作成したり、公開者や開発者が使用する詳細設定オプションを設定したりできます。
-
PDF設定を制御するPDF出力プリセットを作成または設定します。 PDF出力プリセットを作成したら、PDFを生成できます。
詳しくは、PDF出力の生成を参照してください。
PDF出力プリセットの作成 create-output-preset
PDF出力を生成する最初の手順は、PDF出力プリセットを作成することです。これは、マップに割り当てられた公開プロパティのコレクションです。 マップビューパネルで開いている任意のマップの出力プリセットを作成したり、既存のプリセットを設定して同じマップのPDFをすばやく生成することができます。
PDF出力プリセットから、テンプレートの選択、条件の適用、PDFとのやり取りの制御、圧縮や適合などの詳細設定を行うことができます。
PDF出力プリセットを作成または設定するには：
-
「出力」タブで、左側のサイドバーの プリセット をクリックします。
プリセットパネルが開きます。
-
出力 プリセット パネルで、次のいずれかの操作を行います。
- 事前定義済みのPDF出力プリセットをダブルクリックして表示します。
- プリセット に対して「+」アイコンをクリックし、タイプ : PDF の新しい出力プリセットを追加します。
-
既存のPDFプリセットを設定するには：
- 目的の出力プリセットの横にある オプション
「一般」、「メタデータ」、「レイアウト」、「セキュリティ」、「詳細」の各タブで、次の設定を使用してPDF出力プリセットを設定できます。
- 目的の出力プリセットの横にある オプション
一般
出力パスやPDFファイル名などの基本的な出力設定を指定するために使用します。
次の標準変数を使用して、出力パスを定義することもできます。 このオプションは、変数を 1 つまたは組み合わせて定義できます。
${map_filename}: DITA マップファイル名を使用して宛先パスを作成します。${map_title}: DITA マップのタイトルを使用して宛先パスを作成します。${preset_name}：出力プリセット名を使用して宛先パスを作成します。${language_code}：マップファイルがある言語コードを使用して、宛先パスを作成します。${map_parentpath}：マップファイルの完全パスを使用して、宛先パスを作成します。${path_after_langfolder}：言語フォルダーの後のマップファイルのパスを使用して、宛先パスを作成します。次の標準変数を使用して、PDFファイルを定義することもできます。 このオプションは、変数を 1 つまたは組み合わせて定義できます。
${map_filename}${map_title}${preset_name}${language_code}。条件付きコンテンツの場合は、次のオプションから選択し、これらの条件に基づいてPDF出力を生成します。
- 適用なし マップとソースコンテンツに条件を適用しない場合は、このオプションを選択します。
- Ditaval ファイル 条件付きコンテンツを生成する DITAVAL ファイルを選択します。 選択するには、条件プリセットに対してクリックし、ファイルを見つけます。
- 条件プリセット ドロップダウンから条件プリセットを選択し、出力の公開中に条件を適用します。 このオプションは、DITA マップファイルに条件を追加した場合に表示されます。 条件付き設定は、DITA マップコンソールの「条件プリセット」タブで使用できます。 条件プリセットについて詳しくは、「 条件プリセットの使用」を参照してください。
次のオプションを使用して、2 つのバージョン間のコンテンツの違いを示すPDFを変更バーで作成します。
- 前バージョンのベースライン 現在のバージョンまたは別のベースラインと比較するベースライン・バージョンを選択します。 変更バーがPDFに表示され、変更されたコンテンツが示されます。 変更バーは、新しいコンテンツや改訂されたコンテンツを視覚的に識別する縦線です。 変更バーは、挿入、変更または削除されたコンテンツの左側に表示されます。
注意: 「ベースラインの使用 を選択し、発行するベースラインを選択した場合、比較は選択した 2 つのベースライン・バージョン間で行われます。 例えば、「ベースラインの使用」で「ベースライン・バージョン 1.3」を選択し、「前バージョンのベースライン で「バージョン 1.1」を選択すると、ベースライン・バージョン 1.1 とベースライン・バージョン 1.3 の間で比較が行われます。 - 追加テキストを表示 挿入したテキストを緑色と下線で表示する場合に選択します。 このオプションはデフォルトで選択されています。
- 削除されたテキストを表示 選択すると、削除されたテキストが赤で表示され、取り消し線が付きます。 このオプションはデフォルトで選択されています。
注意 スタイルシートを使用して、変更バー、挿入された内容、削除された内容のスタイル設定をカスタマイズすることもできます。
メタデータ
メタデータは、コンテンツの説明または定義です。 メタデータは、コンテンツ管理に役立ち、インターネット上のファイルを検索するのに役立ちます。
「メタデータ」タブを使用して、作成者の名前、文書のタイトル、キーワード、著作権情報、PDF出力用のその他のデータフィールドなどのメタデータフィールドを設定します。 PDF出力にカスタムメタデータを追加することもできます。
このメタデータは、出力PDFーの ドキュメントのプロパティ 内にある 説明 タブのメタデータにマッピングされます。
出力プリセットから、PDF / ネイティブPDF / メタデータ を選択して、メタデータオプションを追加しカスタマイズします。
-
topicmeta に追加されたメタデータを使用
このオプションはデフォルトで選択されています。DITA マップの topicmeta 要素に追加したメタデータを使用して、PDF出力のメタデータフィールドに入力できます。
-
XMP ファイルを指定
また、XMP （Extensible Metadata Platform）ファイルを読み込んで、メタデータフィールドに直接入力することもできます。 サンプル XMP ファイルは、こちらからダウンロードできます。
または、Adobe Acrobatを使用してXMP ファイルを生成することもできます。
- Acrobatで ファイル/プロパティ をクリックします。
- 説明 の下の 追加のメタデータ をクリックします。
- 左パネルの「詳細」を選択します。
- 「保存」をクリックします。
XMP ファイルはデバイス上に保存されます。
-
メタデータの名前と値を指定
- ドロップダウンから選択して名前を追加するか、「名前」フィールドに直接入力してカスタムメタデータを追加します。
- メタデータの値を入力し、「+」アイコンをクリックします。
メタデータが、PDFのメタデータのリストに追加されます。
また、変数を使用してメタデータ値を定義することもできます。 DITA マップまたはブックマップファイル用に定義したメタデータを変数として使用できます。 メタデータは、DITA マップまたはブックマップファイルの /jcr:content/metadata ノードにあります。
変数を使用すると、その値がメタデータプロパティから選択されます。
変数を使用するには、${<variable>} 形式で定義する必要があります。
例えば、/jcr:content/metadata ノードで定義されているメタデータプロパティの 1 つは次のとおりです。dc:title。 ${dc:title} を指定できます。タイトルの値は最終的な出力で使用されます。
メタデータの定義には、変数を 1 つまたは組み合わせて使用できます。 例えば、${dc:title} ${dc:docstate} のようになります。変数と文字列の組み合わせを使用することもできます。 例えば、View ${dc:title} in ${dc:language} のように指定します。
言語変数を使用して、メタデータプロパティのローカライズ値を定義します。 選択した言語に応じて、ローカライズされた値がPDF出力で自動的に選択されます。 例えば、メタデータ値として「Author」を英語で、「Autorin」をドイツ語で印刷できます。
形式：${lng:<variable name>}。 例えば、${lng:author-label} の場合、author-label は言語変数です。
カーソルを合わせる 詳細を表示するには、オプションの近くを
レイアウト
を使用して、ページレイアウトを設定し、ページ表示やズームレベルなどのPDF出力のページビューオプションを指定します。
「テンプレートを参照 を選択することもでき す。 テンプレートを選択で
PDFを開いたときの表示方法を示す、ページビューのページ表示を使用します。 ページ表示ドロップダウンオプションからを選択して、優先する表示を選択します。
- デフォルト ユーザーのマシン上のPDFビューアのデフォルト設定に従って表示されます。
- 単一ページビュー 一度に 1 ページずつ表示します。
- 1 ページのスクロール 連続した縦列に 1 ページを表示します。
- 2 ページビュー 2 ページを左右に並べて表示します。.
- 2 ページスクロール 連続したスクロールで 2 ページを左右に並べて表示します。
PDFを開いたときの表示を示すページビューのサイズを変更する場合に選択します。
- デフォルト ユーザーのマシン上のPDFビューアのデフォルト設定どおりに表示されます
- 100% ページを実際のサイズで表示します。
- ページに合わせる ページの幅と高さが文書ウィンドウ内に収まるようにします。 .
- ページ幅に合わせる ページの幅を文書ウィンドウの幅に合わせます。
- ページの高さに合わせる ページの高さを文書ウィンドウの高さに合わせます。
セキュリティ
ファイルを開いて読み取るための制限を追加して、PDFをProtectします。 未認証のアクセスを避けるには、以下のオプションを使用します。
を選択して、ユーザーによるPDFの操作を制限します。 以下の制限設定を機能させるには、「所有者のパスワード」フィールドにパスワードを指定します。
- 印刷 PDFを印刷する場合に選択します。
- ドラフト画質の印刷 PDFをより低い解像度で印刷する場合に選択します。
- コンテンツのコピー PDFからコンテンツをコピーする場合に選択します。
- 注釈 PDFにメモやコメントを追加できるようにするには、このオプションを選択します。
- コンテンツの変更 PDFのコンテンツをユーザーが変更できるようにするには、このオプションを選択します。
- アクセシビリティのためのコンテンツコピー スクリーンリーダーがPDF内のコンテンツを読み取り、移動できるようにするには、これを選択します。
文書の組み立て PDFにページを挿入できるようにするには、このオプションをオンにします。
注意：制限事項を変更するには、Adobe Acrobatのファイル/プロパティで所有者のパスワードを入力する必要があります。
詳細
次のオプションを使用して、PDFの結合、圧縮の使用、準拠する規格の選択などの詳細設定を行います。
注意：フォントは、フォントベンダーによって埋め込みが許可されている設定が含まれている場合にのみ埋め込むことができます。 フォントを埋め込む前に、必要な設定またはライセンスがあることを確認してください。
静的テキストまたは言語変数を使用して、透かしのローカライズ版を公開します。 選択した言語に応じて、ローカライズされた値がPDF出力で自動的に選択されます。 例えば、「Publisher」を透かしとして英語で、「Auture」をフランス語で印刷することができます。
形式：
${lng:<variable name>}。 例えば、$ {lng:publisher-label} の場合、publisher-label は言語変数です。にポインタを合わせる 詳細を表示するには、オプションの近くを
dc:description、dc:language、dc:title、docstate はデフォルトのプロパティですが、カスタムプロパティとして author を指定できます。 選択したメタデータプロパティは、ネイティブPDFを使用して生成されたPDFファイルに渡されます。これらのプロパティは、
/libs/fmdita/config/metadataList に用意されている metadataList ファイルから選択されます。このファイルは
/apps/fmdita/config/metadataList でオーバーレイできます。PDF出力の生成 generate-pdf-output
出力プリセットの設定が完了したら、「プリセットの生成 機能を使用して、プリセットパネルから出力を生成でき す。
-
「オーサー」タブで、「リポジトリ ビューを選択します。
リポジトリーパネルが開きます。 -
リポジトリパネルの マップビュー で DITA マップファイルを開きます。
-
「出力」タブで「プリセット」をクリックして、プリセットパネルを表示します。
出力プリセットを作成または設定するには、PDF出力プリセットの作成を参照してください。 -
設定を保存するには、出力ビューの標準ツールバーの左上隅にある すべて保存
-
上部バーの プリセットを生成
出力プリセットパネルでは、選択した出力プリセットの横にプログレスバーが表示されます。 -
出力の生成が完了したら、上部バーの 出力を表示
画面の右下隅に 成功 ダイアログボックスが表示されます。
出力が成功しなかった場合は、次のエラーメッセージが表示されます。
エラーログを表示するには、「解除」をクリックし、選択した「プリセット」タブにマウスポインターを置いて、
ネイティブPDF出力の生成後に一時ファイルをダウンロード
詳細設定で「一時ファイルをダウンロード」オプションを選択すると、ネイティブPDF出力の生成時に作成した暫定HTMLファイルをダウンロードすることもできます。 出力を生成したら、上部のバーにある「一時ファイルをダウンロード
言語変数の使用
AEM Guidesは言語変数もサポートしています。 言語変数 を選択します。 左側のパネルで
Markdown ドキュメントのサポート
Experience Manager Guidesは、Markdown ドキュメントのサポートも提供します。 Markdown ファイルの作成は簡単で、次の利点があります
には、様々な書式設定オプションが用意されています。 方法について説明します Web エディターから Markdown ドキュメントを作成する。
Markdown トピックを DITA マップに追加し、ネイティブPDF出力プリセットを使用してPDF出力を生成できます。 PDFまたは 設定出力プリセットの作成方法を説明します。