カスタム HTML または PDF テンプレートの作成

既定の HTML、単一ファイルの HTML、または PDF テンプレートで使用される書式スタイルをカスタマイズするには、テンプレートをコピーし、そのコピーにスタイル定義の変更や追加を行います。

テンプレートのコピー

既定のテンプレートをコピーして、カスタムテンプレートの基礎として使用できます。レポートエクスプローラーで既定のテンプレートをコピーできます。または、mlreportgen.dom.Document.createTemplate を使用してテンプレートをプログラムによって作成することもできます。

レポートエクスプローラーで、[ツール] 、 [ドキュメント変換テンプレートの編集] を選択します。
ライブラリペインで、コピーするテンプレートを選択します。たとえば、[Default HTML Template] を選択します。
プロパティペインで、[テンプレートのコピー] をクリックします。
ファイルブラウザーで、テンプレートファイルを保存する場所に移動します。
MATLAB^® パス上にあるパス (ホームフォルダーの MATLAB フォルダー内など) を選択します。
HTML テンプレート用 (.htmtx)、単一ファイルの HTML テンプレート用 (.htmt)、または PDF テンプレート用 (.pdftx) の既定のファイル拡張子を使用して、ファイル名を指定します。[保存] をクリックします。
テンプレートのリストからテンプレートのコピーを選択します。
ダイアログボックスの [テンプレート ID] ボックスおよび [表示名] ボックスで、テンプレートの一意の ID と表示名を指定します。
表示名は、レポートエクスプローラーのテンプレートのリストに表示される名前です。テンプレート ID を使用して、コード内でテンプレートを識別します。テンプレートのプロパティの設定を参照してください。
入力したテンプレートプロパティを保存するには、プロパティペインの外側をクリックします。

HTML または PDF テンプレートの編集

テンプレートは、既定のページを定義するメインパーツ (root.html) と、ドキュメントパーツテンプレート (docpart_templates.html) で構成されます。単一ファイルの HTML テンプレートでは、テンプレートのすべてのパーツが .htmt 拡張子の単一ファイルに含まれます。HTML テンプレートまたは PDF テンプレートでは、テンプレートのパーツは、それぞれ .htmtx または .pdftx の拡張子をもつ 1 つのファイルにパッケージ化された個別のファイルになります。レポートエクスプローラーで HTML テンプレートまたは PDF テンプレートを編集するときに、レポートエクスプローラーによってテンプレートが解凍されます。テンプレートファイルを編集して保存した後は、zipTemplate を使用してテンプレートファイルを単一のテンプレートファイルにパッケージ化しなければなりません。

Word テンプレートの場合と同様の変更を、HTML テンプレートおよび PDF テンプレートで行うことができます。Microsoft Word コンポーネントテンプレートのカスタマイズを参照してください。

レポートエクスプローラーの HTML テンプレートと PDF は似ていますが、以下の例外があります。

PDF テンプレートはページのレイアウト (ページヘッダー、ページフッターなど) を定義します。これらのレイアウト要素のドキュメントパーツテンプレートを変更できます。PDF テンプレートでは、この目的で提供された一連の DOM API HTML タグを使用できます。DOM API HTML 要素を参照してください。
PDF テンプレートは、標準の HTML 要素のサブセットのみを使用できます。標準の HTML 要素を参照してください。

HTML テンプレートおよび PDF テンプレートは、DOM API HTML タグを使用し、その内部のドキュメントパーツライブラリとドキュメントパーツテンプレートを定義します。<dplibrary> 要素はライブラリを定義します。テンプレートは、<dplibrary> タグを 1 つだけ含むことができます。このタグは既定のテンプレートに配置されています。<dptemplate> 要素はドキュメントパーツを定義します。これは名前に引数を取ります。例:

 <dptemplate name="rgChapter">

いくつかの例については、テンプレートの docpart_templates.html ファイルを参照してください。

テンプレートを編集するには、以下のようにします。

中央のペインにあるテンプレートのリストから、編集するテンプレートを選択します。
ヒント
レポートエクスプローラーの中央のペインにテンプレートのリストが表示されていない場合は、[ツール] 、 [ドキュメント変換テンプレートの編集] を選択します。
右側のペインで、[テンプレートを開く] をクリックします。
HTML エディターでテンプレートを編集し、保存します。
HTML テンプレートまたは PDF テンプレートを編集した場合は、MATLAB コマンドラインで関数 zipTemplate を使用して、テンプレートファイルを単一のテンプレートファイルにパッケージ化します。

テンプレートの HTML または PDF スタイルの編集

HTML または PDF テンプレートの書式スタイルをカスタマイズまたは追加できます。カスケードスタイルシート (CSS) を使用して、スタイルを編集します。

HTML テンプレートの場合、任意の CSS プロパティまたはセレクターを使用できます。PDF の場合、サブセットを使用できます。PDF スタイルシートを参照してください。XSL 書式設定オブジェクト (FO) を使用して PDF テンプレートの要素を書式設定することもできます。ただし、コードを簡略化および合理化するため、CSS で定義できないプロパティにのみ FO を使用するようにします。

中央のペインにあるテンプレートのリストから、編集するテンプレートを選択します。
ヒント
レポートエクスプローラーの中央のペインにテンプレートのリストが表示されていない場合は、[ツール] 、 [ドキュメント変換テンプレートの編集] を選択します。
右側のペインで、[スタイルシートを開く] をクリックします。
HTML エディターで CSS を編集します。
カスケードスタイルシートの編集の詳細については、W3Schools.com の CSS Tutorial などのドキュメンテーションを参照してください。
スタイルシートを保存します。
HTML テンプレートまたは PDF テンプレートを編集した場合は、MATLAB コマンドラインで関数 zipTemplate を使用して、テンプレートファイルを単一のテンプレートファイルにパッケージ化します。

テンプレートをレポートに割り当て

テンプレートをレポートエクスプローラーのレポートに割り当てることができます。

レポートエクスプローラーで、[Report Generator] ノードを選択します。
レポートのリストから、テンプレートを割り当てるレポートを選択します。
[レポートオプション] ダイアログボックスで、[ファイル形式] をいずれかの (テンプレートを使用) オプションに設定します。リストからテンプレートを選択します。

HTML エディターの選択

既定では、HTML または PDF スタイルシートを編集する場合、スタイルシートは MATLAB エディターに表示されます。

別のエディターを使用するには、以下のようにします。

レポートエクスプローラーで、[ファイル] 、 [基本設定] を選択します。
[HTML コマンドの編集] で、使用する HTML エディターを開く MATLAB 式を入力します。例:
```
system('Dreamweaver %<FileName> &')
```
HTML スタイルシートを開くと、レポートエクスプローラーによって FileName が選択したテンプレートに置き換えられます。アンパサンド (&) はエディターをバックグランドで開きます。