DocBook - xml questions

Bengt Thuree bengt at thuree.com
Fri Apr 14 01:04:48 EDT 2006



Ok, I do not know much about DocBook, so this might be some stupid questions.

1) Why do we not have the DOCTYPE DTD in each chapter.xml? That is the
following heading from TOC.xml
<?xml version="1.0"?>
2 	<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
3 	    "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
4 	]>

2)We should still follow the guidelines in HACKING?

a. Avoid using the XML empty tag, specify the closing tag.
	        e.g. <para></para> instead of </para />

===> <imagedata fileref="figures/XXXX" srccredit="YYY ZZZ" format="PNG"/>
===> ends with a /> in every chapter file.

b. Avoid a newline after <entry> tags.
	        e.g. <entry><para> instead of <entry>\n<para>

c. Avoid underscores in id attribute values.
 	        e.g. id="getting-started" instead of id="getting_started"
===>  <sect2 id="invest_custom2">
===> Found that sect2 in every chapter have id="xxxx_"

d. Use <chapter> and <sect1>.



More information about the gnucash-devel mailing list