[Ohrrpgce] XML Documentation

[Mike Caron]

The idea with XSLT is that any processor will do. But, thanks! Always
glad to help.

On 5/24/05, Bob the Hamster <Bob at hamsterrepublic.com> wrote:
> 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
> _______________________________________________
> 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