XML Parse error on Local Build

[Chris Good]

> Message: 3
> Date: Tue, 6 Dec 2016 17:05:37 +0500
> From: "David T." <sunfish62 at yahoo.com>
> To: "David T. via gnucash-devel" <gnucash-devel at gnucash.org>
> Subject: XML Parse error on Local Build
> Message-ID: <117685E8-EE9B-44E2-B3B3-6179F5A08C9B at yahoo.com>
> Content-Type: text/plain;	charset=utf-8
> 
> Hi,
> 
> I am trying to finish a first pass at a new Glossary for the Guide. My
changes
> are focused in a new file (gnc-glossary.xml) and in gnucash-guide.xml. In
the
> latter, I have added two lines to incorporate the new file into the guide.
> 
> I have reached the point of running the commands:
> 
> xmllint --valid --noout gnucash-guide.xml xsltproc -o
> ../../../output_html/guide/ ../../xsl/general-customization.xsl gnucash-
> guide.xml
> 
> These are prescribed by the Wiki page. The first passes cleanly, but when
I
> run the second, I receive a multitude of errors along the lines of:
> 
> gnucash-guide.xml:2964: element screenshot: validity error : ID
invest-split1
> already defined
> 
> The process completes, and I am able to view the documentation, but I
> don?t know whether these errors indicate something else wrong with my
> modifications.
> 
> Can anyone advise?
> 
> Thanks,
> David
> 

Hi David,

Great to see all the documentation improvements you are doing.

The id's should be unique so you can link to them from elsewhere in the
documentation.
I think they only need to be unique within either the guide or help but
ideally should be globally unique.

Now that you mention it, I thought it would be better to not have id's
unless they are referenced from somewhere else as this may speed up the lint
and xsltproc processes (which seems to be getting much longer recently) but
Frank Ellenberger suggested they be used anyway as that seems to be the
standard. We were talking about sect rather than screenshot id's I think.
Opinions?

Regards,
Chris Good
-------------- next part --------------
A non-text attachment was scrubbed...
Name: smime.p7s
Type: application/pkcs7-signature
Size: 4817 bytes
Desc: not available
URL: <http://lists.gnucash.org/pipermail/gnucash-devel/attachments/20161207/7c38d626/attachment.p7s>