[GNC-dev] Git Questions With Documentation

David T. sunfish62 at yahoo.com
Thu Sep 13 20:31:03 EDT 2018


The typo came about because threw the changes back together quickly before dinner

I adopted option 1, and it seems to have worked. Not sure how this is any better.

David

> On Sep 13, 2018, at 8:05 PM, Frank H. Ellenberger <frank.h.ellenberger at gmail.com> wrote:
> 
> 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
> 
> 



More information about the gnucash-devel mailing list