[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