>> Message: 3 > >> Date: Tue, 6 Dec 2016 17:05:37 +0500 > >> From: "David T." <sunfis...@yahoo.com> > >> To: "David T. via gnucash-devel" <gnucash-devel@gnucash.org> > >> Subject: XML Parse error on Local Build > >> Message-ID: <117685e8-ee9b-44e2-b3b3-6179f5a08...@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 > >> > > > > On Dec 7, 2016, at 3:32 AM, Chris Good <chris.g...@ozemail.com.au> > wrote: >> > 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
> -----Original Message----- > From: David T. [mailto:sunfis...@yahoo.com] > Sent: Wednesday, 7 December 2016 2:42 PM > To: Chris Good <chris.g...@ozemail.com.au> > Cc: gnucash-devel@gnucash.org; frank.h.ellenber...@gmail.com > Subject: Re: XML Parse error on Local Build > > Chris, > > Thanks for the response. Initially, I thought that I had accidentally inserted > duplicate entries in the glossary; however, the errors persisted even after I > changed them all in my file. Further examination of the long chain of errors > shows me that they encompass all areas of the documentation—including > ones that I did not touch at all. > > I suspect that there is some simple aspect to the process that I am missing, > and somewhere on my system is a second instance that the command finds > and barks about. Over and over and over again. But like the young wizards in > an adventure tale, I don’t fully understand the content of the incantations I > invoke before I make them, and I think I need a Dumbledore to explain to > me the errors of my ways… > > Thanks, > David > Hi David, Are you sure you're running 2 separate commands: xmllint --valid --noout gnucash-guide.xml and xsltproc -o ../../../output_html/guide/ ../../xsl/general-customization.xsl gnucash- guide.xml They seem to have been joined together (maybe just by mail). Maybe doing from the guide/C directory: grep -n invest-split1 *.xml will help identify the problem (-n means print the line no's in the file(s) where the string is found). Id 'invest-split1' must only be defined once in all xml files in the directory but it can be linked to multiple times like: <xref linkend="invest-split1" /> Regards, Chris Good
smime.p7s
Description: S/MIME cryptographic signature
_______________________________________________ gnucash-devel mailing list gnucash-devel@gnucash.org https://lists.gnucash.org/mailman/listinfo/gnucash-devel
