[Ohrrpgce] XML Documentation

[Bob the Hamster]

It is in subversion now. I made one tiny change to the xml file, just 
fixing "find hero"'s <shortname> tag.

Rather than using Saxon, I tested with xsltproc, which comes as a 
standard package on Debian. It is written in C++, so I don't have to 
fight with Java. (I dislike Java)

The output produced by xsltproc seems to be the same as the output 
produced by saxon.

These XML docs are really, really cool. Good work!

---
Bob the Hamster

On Tue, May 24, 2005 at 04:42:15PM -0400, Mike Caron wrote:
> I'm ready if you are. :)
> 
> To make the HTML version, you need to download Saxon
> (http://saxon.sf.net, or more specifically,
> http://prdownloads.sourceforge.net/saxon/saxonb8-4.zip)
> 
> Then you need to run this command in the folder with the XML file:
> (note: This works on windows 2000, it may need to be changed for
> different platforms)
> 
> java -jar path/to/saxon/saxon8.jar -novw -o plotdictionary.html
> plotdict.xml htmlplot.xsl
> 
> Except, change path/to/saxon to, er, the path to saxon. It'll complain
> about running a Version 1.0 stylesheet through a 2.0 processor, but
> you can safely ignore it. I think there's a switch to suppress that,
> but I forget what it is.
> 
> You may want to put that command line into a batch file or script or
> whatever, since it's kinda unweildy.
> 
> On 5/24/05, Bob the Hamster <Bob at hamsterrepublic.com> wrote:
> > The XML documentation is spiffylicious! Are you ready for it to be
> > checked into subversion?
> > 
> > And how do I generate the html file from the xml file?
> > 
> > ---
> > Bob the Hamster
> > 
> > On Tue, May 24, 2005 at 11:38:35AM -0400, Mike Caron wrote:
> > > Ok, I've done it. Everything works perfectly in HssEd, and I've fixed
> > > all sorts of problems and what not. Only problem is that the new
> > > plotdictionary.html is about a jillion times bigger. Oh well, there's
> > > always a price to pay for ease of use...
> > >
> > > On 5/24/05, Mike Caron <caron.mike at gmail.com> wrote:
> > > > I can see what that problem is. Was playing around with it, and
> > > > accidentally un-closed a self-closing tag. My bad.
> > > >
> > > > I've also determined that the green text is because browsers are being
> > > > stupid in the treatment of <a name="whatever" /> tags, insisting on <a
> > > > name="whatever"></a>. I'll upload a fixed version.
> > > >
> > > > On 5/24/05, Simon Bradley <neworiginal at gmail.com> wrote:
> > > > > Yes, I get the same error in FF 1.04 under W98. It looks like maybe
> > > > > there is an earlier tag not being closed? Not quite sure why that
> > > > > should matter.
> > > > >
> > > > > With the pre-built HTML version, I also see odd colour changes. I
> > > > > suspect it is because the "normal" text is not in any sort of HTML tag
> > > > > (no <P>s or anything) and is just picking up settings from something
> > > > > earlier in the page.
> > > > >
> > > > > Looks promising though. Don't let us put you off! :-)
> > > > >
> > > > >
> > > > > Simon
> > > > >
> > > > > On 5/24/05, Adam Perry <arperry at cox.net> wrote:
> > > > > > Also, error in Firefox, Win2k:
> > > > > >
> > > > > > XML Parsing Error: mismatched tag. Expected: </xsl:value-of>.
> > > > > > Location: http://ohr.finalfantasyq.com/htmlplot.xsl
> > > > > > Line Number 109, Column 64:   <h4><a name="about-{@id}" /><xsl:value-of
> > > > > > select="cannon"></a></h4>
> > > > > >
> > > > > > (an arrow points to the phrase "value-of")
> > > > > >
> > > > > > ----- Original Message -----
> > > > > > From: "Michael Kidder" <mkidder at gmail.com>
> > > > > > To: <ohrrpgce at lists.motherhamster.org>; "Mike Caron" <caron.mike at gmail.com>
> > > > > > Sent: Tuesday, May 24, 2005 1:04 AM
> > > > > > Subject: Re: [Ohrrpgce] XML Documentation
> > > > > >
> > > > > >
> > > > > > It throws up an error when I try to view it with IE6 SP2, WinXP
> > > > > >
> > > > > > "The stylesheet does not contain a document element. The stylesheet
> > > > > > may be empty, or it may not be a well-formed XML document"
> > > > > >
> > > > > >
> > > > > > _______________________________________________
> > > > > > Ohrrpgce-motherhamster.org mailing list
> > > > > > ohrrpgce at lists.motherhamster.org
> > > > > > http://lists.motherhamster.org/listinfo.cgi/ohrrpgce-motherhamster.org
> > > > > >
> > > > > _______________________________________________
> > > > > Ohrrpgce-motherhamster.org mailing list
> > > > > ohrrpgce at lists.motherhamster.org
> > > > > http://lists.motherhamster.org/listinfo.cgi/ohrrpgce-motherhamster.org
> > > > >
> > > >
> > > >
> > > > --
> > > > Mike Caron
> > > > Final Fantasy Q
> > > > http://finalfantasyq.com
> > > >
> > >
> > >
> > > --
> > > Mike Caron
> > > Final Fantasy Q
> > > http://finalfantasyq.com
> > > _______________________________________________
> > > Ohrrpgce-motherhamster.org mailing list
> > > ohrrpgce at lists.motherhamster.org
> > > http://lists.motherhamster.org/listinfo.cgi/ohrrpgce-motherhamster.org
> > _______________________________________________
> > Ohrrpgce-motherhamster.org mailing list
> > ohrrpgce at lists.motherhamster.org
> > http://lists.motherhamster.org/listinfo.cgi/ohrrpgce-motherhamster.org
> > 
> 
> 
> -- 
> Mike Caron
> Final Fantasy Q
> http://finalfantasyq.com
> _______________________________________________
> Ohrrpgce-motherhamster.org mailing list
> ohrrpgce at lists.motherhamster.org
> http://lists.motherhamster.org/listinfo.cgi/ohrrpgce-motherhamster.org