[GNC-dev] Git Questions With Documentation

[Frank H. Ellenberger]

Am 14.09.18 um 00:38 schrieb David T.:
> Updated as requested. My commit message includes the full output of "xmllint --valid --noout gnucash-guide.xml”
>   
> BTW, this sort of experience is yet another example of why I find this overall process to be inordinately painful. Some docbook guru will probably know immediately why this fails, but I sure as heck don’t, and having to muck around with this detracts from actually editing the text to be helpful.
>   
> David

At first there is a typo:
warning: failed to load external entity
"/home/frank/git/gnucash-docs/guide/C/ch_txnss.xml"

guide/C/gnucash-guide.xml:15
-<!ENTITY chapter2b SYSTEM "ch_txnss.xml">
+<!ENTITY chapter2b SYSTEM "ch_txns.xml">

After that fix, I get

ch_txns.xml:1570: parser error : chunk is not well balanced
</chapter>
^

That means you can not close a tag, which was already opened outside of
 the chunk(file)

There are several approachs:

1.
ch_basics.xml:
<chapter id="chapter_basics">
  <title>The Basics</title>
:
</sect1>
&chapter2a;
&chapter2b;
</chapter>

2. like with parts
gnucash-guide.xml:
:
ch_basics.xml:
<chapter id="chapter_basics">
&chapter2;
&chapter2a;
&chapter2b;
</chapter>

3. test XInclude

Currently I tend to 2. to keep all
<!ENTITY chapterN SYSTEM "...">
&chapterN;
at one place.

Regards
Frank