diff --git a/src/site/apt/building.apt b/src/site/apt/building.apt index 7301c0ba2..0b26ef81d 100644 --- a/src/site/apt/building.apt +++ b/src/site/apt/building.apt @@ -153,15 +153,23 @@ $ mvn -P snapshots dependency:tree the docbook format. Also look at existing examples in Spring Batch and in the Core Spring Framework source code. - N.B. there is no need to explicitly create section numbers in the + [N.B.] there is no need to explicitly create section numbers in the XML - this is done for you by the build when everything is stitched together into a book. - N.B. you put docbook .xml source files in a subdirectory called + [N.B.] you put docbook .xml source files in a subdirectory called <<>>, but they are moved to the top level when the site is built. Thus <<>> becomes <<>>. + [N.B.] If you use {{{http://www.xmlmind.com}XmlMind}} to edit the + reference guide add the following line to + <<</addon/config/docbook/common.incl>>>: + ++--- + ++--- + ** Adding a new chapter to the Reference Guide Here is a skeleton chapter including the DTD to get you started on a