ここでご紹介している文章のように１つのbookにドキュメントを記述していくと、 1,000行を越えたあたりから、自分はだんだん可読性が悪くなります。 なんとか分割出来ないものかと調べていましたら、book自体も複数のファイルに 分割できるんですね。

例としてdocbook.xmlというファイルを章毎に分けてみることにします。

章毎に、docbook-pre.xml,docbook-set.xml...とdocbookを作成します。 ルートは「章」になるので、chapterです。docbook-pre.xmlの中身を見てみましょう。

  		
<?xml version="1.0" encoding="UTF-8"?>
 
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" 
"../../docbook-xml-4.5CR3/docbookx.dtd">

<chapter id="docbook_pre">
	<title>必要なツールとその入手先の紹介</title>
...
</chapter>
  		
  	

次にchapterの上の要素であるbookのファイルdocbook.xmlの中を見て見ます。 ごらんのようにENTITYで宣言することで、参照をすることが出来るようになります。

  		
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" 
"../../docbook-xml-4.5CR3/docbookx.dtd"[
<!ENTITY docbook_pre       SYSTEM "docbook-pre.xml">	
<!ENTITY docbook_set       SYSTEM "docbook-set.xml">
<!ENTITY docbook_html      SYSTEM "docbook-html.xml">
<!ENTITY docbook_chunk     SYSTEM "docbook-chunk.xml">
<!ENTITY docbook_pdf       SYSTEM "docbook-pdf.xml">
<!ENTITY docbook_reference SYSTEM "docbook-reference.xml">
<!ENTITY docbook_glossary  SYSTEM "docbook-glossary.xml">
]>
<book id="docbook">
	&docbook_pre;
	&docbook_set;
	&docbook_html;
	&docbook_chunk;
	&docbook_pdf;
	&docbook_reference;
	&docbook_glossary;
</book>
  		
  	

	注意
	文章を記述する際にはDOCTYPE宣言は記述しておかないと、入力補完等の機能が使えなくなるので 入れておくと便利ですが、AntでHTML等に出力する際はコメントアウトしておいてください。