8–19 インクルード

インクルード

インクルードは外部のテキストファイルを取り込む機能です。たとえば、プログラムのソースファイルなどをそのまま出版物の中に取り込むときに利用すると便利です。

インクルードはブロック要素なので、マークアップの前後に空行が必要です。
インクルードテキスト内のマークアップも評価されます。
インクルードにはオプションをつけてインクルードしたファイルの解釈を変更できます。
- 'pre' オプションを指定すると、インクルードテキスト内容は「8–17 整形済みブロック」として扱われ、CAS記法の評価はされません。
- インクルード機能を利用してCSV（カンマ区切り）形式の表を取り込むことができます。表として取り込む場合は 'table'オプションが必要です。詳細は次の項目を参照してください。

関　連

インクルード対象ファイルの形式

インクルードする対象ファイルの形式は次のようになります。

(1) CAS記法

include-test.txt の内容

本文の中に取り込まれるためのテキストです。

* インクルード対象ファイル形式は**テキストファイル**のみです。

pre オプションのないインクルード

<<include include-test.txt >>

pre オプションのあるインクルード

<<include include-test.txt pre>>

include-test.txt の内容

---ここから>

本文の中に取り込まれるためのテキストです。

* インクルード対象ファイル形式は**テキストファイル**のみです。
<ここまで----

(2) 表示例

preオプションのないインクルード

本文の中に取り込まれるためのテキストです。

インクルード対象ファイル形式はテキストファイルのみです。

preオプションのあるインクルード

本文の中に取り込まれるためのテキストです。

* インクルード対象ファイル形式は**テキストファイル**のみです。

関　連