<html>
<head>
<title>XML::XSLT Homepage</title>
<base href="http://www.sci.kun.nl/sigma/Persoonlijk/egonw/xslt/index.html">
<style>
A { color: orange }
A.ID { color: navy }
</style>
</head>
<body bgcolor="white">
<table>
<tr><td width="200" valign=top>
<P>
<table bgcolor="silver" border="0">
<tr><td rowspan="9" bgcolor="navy" width="5">
<tr><td><a href="#support"><li><font color="black" face="arial,cotton">Supported commands</font></a><br>
<tr><td><a href="#action"><li><font color="black" face="arial,cotton">Action!</font></a><br>
<tr><td><a href="#options"><li><font color="black" face="arial,cotton">Script options</font></a><br>
<tr><td><a href="#download"><li><font color="black" face="arial,cotton">Download</font></a><br>
<tr><td><a href="#bug"><li><font color="black" face="arial,cotton">Bugs</font></a><br>
<tr><td><a href="#next"><li><font color="black" face="arial,cotton">What's Next</font></a><br>
<tr><td><a href="#links"><li><font color="black" face="arial,cotton">Links</font></a><br>
</table>
<P>
Send comment and bugs to:<br>
<center>
<a href="mailto:gjosten@sci.kun.nl">Geert Josten</a> and<br>
<a href="mailto:egonw@sci.kun.nl">Egon Willighagen</a>
</center>
<p>
<p><i>last modified on January 25th 2000.</i>
<p><hr color="navy" width="80%" align="center">
<p>
<a href="http://www.garshol.priv.no/download/xsa/">XSA</a> doc:
<a href="xslt-parser.xsa">xslt-parser.xsa</a>.
<hr>
<p>
<!-- Begin ListBot Code -->
<form method="post" action="http://www.listbot.com/cgi-bin/subscriber">
<table border=0><tr><td colspan=2>
Join our mailing list!<br>
Enter your email address below,<br>
then click the 'Join List' button:<br>
</td></tr><tr><td>
<input type=text name="e_mail">
<input type=hidden name="list_id" value="xmlxslt">
<input type=hidden name="Act" value="subscribe_list">
</td><td>
<input type=image src="http://www.listbot.com/subscribe_button.gif" border=0 width=88 height=31 alt="Click here to join our mailing list!">
</td></tr><tr><td colspan=2>
<font size=1 face="arial"><a href="http://www.listbot.com/" target="_top">Powered by ListBot</a></font><br>
</td></tr></table>
</form>
<!-- End ListBot Code -->
<p>This discussion list is archived at
<a href="http://xmlxslt.listbot.com/">http://xmlxslt.listbot.com/</a>.
</td>
<td>
<table bgcolor="black" width="100%" border="0">
<tr><td align="center"><h1><font color="white" face="arial,cotton">XML::XSLT Homepage</font></h1>
</table>
<h3><font color="navy" face="arial,cotton"><a class="id" name="xslt">XSLT</a></font></h3>
<p>You wrote some XML, and have a XSL Template. You want
to use this on your website, but want to use Perl with your webserver.
No Problem!
<ul>
<p><i>Remember that this project is Work in Progress! Rome wasn't build in
one day! Any comment is welcome! Any programming effort as well! This
modules *is* great stuff, but it isn't finished yet! However, if you need
a xsl command urgently, please email us your request and place it in our
high priority to-do list.</i>
<p align="right"><i>Egon</i></P>
</ul>
<p>XML::XSLT will
convert the XML doc on basis of the template. It is written in Perl
and works. Not all xsl commands are implemented yet. Nor is it fast. But meanwhile
it works: watch it
<a href="/cgi-bin-sigma/persoonlijk/egonw/xslt/action/xslt-parser?agenda">in action</a>.
At this moment we need a lot of input. So try this script and give us
your comment on it. Missing/needed xsl elements, bugs, anything...
<p>This document gives some explanation on this project. Other
Stuff to read is the Specification of XSLT and the
XSL(T)-by-example page (see <a href="#links">links</a>). Below, given
is a list of XSLT-command's that are supported.
<h3><font color="navy" face="arial,cotton"><a class="id" name="support">Supported XSLT commands</a></font></h3>
<!--p>At this moment the xslt-parser commands are out of focus with the
XSL-T draft. The stylesheet files it accepts are not even valid XML
conform the XSL Working Draft. At this moment at least.
<P>Each element the script encounters that doesn't start with xsl: (or
are in the xsl namespace) are regarded to be markup and handled as is.
But from version 0.11 the module accepts the <xsl:stylesheet> command
so valid XSL files will be accepted.-->
<P>The list of commands that are supported by XML::XSLT has been moved to the
<a href="/cgi-bin-sigma/persoonlijk/egonw/xslt/pod2html.pl">online manpage</a>.
To see what to upcoming version has to offer, have a look at the
<a href="/cgi-bin-sigma/persoonlijk/egonw/xslt/pod2html.pl?nextrelease">manpage</a>
of the next version.
<h3><font color="navy" face="arial,cotton"><a class="id" name="action">Action!</a></font></h3>
<p>Oke, let's see it work. The script takes a project name
<project>. The files <project>.xml and <project>.xsl are
read and converted to an internal object tree with XML::DOM. Then the
XSL template is parsed against the XML tree, which results in a new doc
that is redirected to STDOUT. That's all.
<p>Ofcourse, it need not be HTML. With XSLT you can convert any XML document
with any XSL doc you like.
<p><b>NB!</b> These are the updated examples. They only work with version
0.13 or higher.
<p>This is the CML project:
<ul>
<li>This project makes old CML files of the
<a href="http://www.sci.kun.nl/woc/">Dictionary
on Organic Chemistry</a> conform the newest CML DTD.
<li><a href="examples/91-22-5.cml">91-22-5.cml</a> (old cml file)
<li><a href="examples/cml2cml.xsl">cml2cml.xsl</a> (for cml to cml conversion)
<li>resulting <a href="examples/91-22-5.xml">91-22-5.xml</a>
<li>Please note that is you use IE 5.0 to view the result you
it gets parsed by the IE XSL parser for a XML2HTML conversion
due to the xsl stylesheet below. If so, use right mouse button
and <i>view source</i> to see the underlying xml file when viewing
the xml file with the stylesheet.
<li><a href="examples/cml.xsl">cml.xsl</a>
<li>The rest of the new CML files are served at the Dictionary
on Organic Chemistry project as Physical Properties
(<a href="http://www.sci.kun.nl/cgi-bin-woc/view?azijnzuur">example</a>)
and at <a href="http://www.xmltree.com/resource/detail.cfm/DDC/547/L/3/ResourceID/161">xmltree.com</a>.
</ul>
<p>The Agenda project:
<ul>
<li><a href="examples/agenda.dtd">agenda.dtd</a>
<li><a href="examples/agenda.xml">agenda.xml</a>
<li><a href="examples/agenda.xsl">agenda.xsl</a>
<li><a href="examples/agenda.html">agenda.html</a>
</ul>
<h3><font color="navy" face="arial,cotton"><a class="id" name="options">Script options</a></font></h3>
<p>The script can be used as an CGI script, but also as a command-line
utility. Also accepts a XSL Template other than <project>.xsl.
These behaviours are selected with some options. Run <i>xslt-parser</i>
without options or parameters at the commandline to view its syntax.
<p><b>the -n option</b><br>
When a script is to be used with a web-server, its output must be preceeded
with a <i>Content-type</i> line. The xslt-parser script does this by default.
It can be turned off with the -n(oweb) option.
<p><b>the -s option</b><br>
By default the script uses the <project>.xsl XSLT template. With the
-s(tylesheet) <template.xsl> option other templates can be used.
<h3><font color="navy" face="arial,cotton"><a class="id" name="download">Download</a></font></h3>
<p>The latest release is <a href="dist/XML-XSLT-0.21.tar.gz">v0.21</a>
which needs as always testing (see changelog and manpage).
Required are
the modules XML::Parser (version 2.23 or higher) and XML::DOM (version 1.25 or higher)
which can be obtained from <a href="http://www.perl.com/CPAN">CPAN</a>. Our module also depends on
the module LWP::UserAgent as was pointed out by a user. This module can also be downloaded from
CPAN.
<p>A <a href="changelog.html">changelog</a> is also available. Older version can be downloaded
from this page.
<h3><font color="navy" face="arial,cotton"><a class="id" name="bug">Bugs</a></font></h3>
<ul>
<li>xsl:template matching is improved, but predicates are not supported yet
<li>xsl:value-of selecting is limited, no functions are supported (not even
name() or position())
</ul>
<p>Submit new bugs at the on-line bug-report list <a href="/cgi-bin-sigma/htplp?xslt-bugs">here</a>!
<h3><font color="navy" face="arial,cotton"><a class="id" name="next">What's Next?</a></font></h3>
<p>To do:
<ul>
<li>parser options stating how to process comments, pi's and cdata
<li>better document source detection (preferable fully automatic)
<li>proper implementation of xsl:param/xsl:variable/xsl:with-param
<li>mode attribute support for xsl:template and xsl:apply-templates
<li>SVC file
<li>debugging ofcourse
<li>integration of the new XPath module (?)
<li>implementation of predicate testing in template matches and node-set
selections
<li>implementation of function support in value selections
<li>and at the end full support of XSL-T
</ul>
<h3><font color="navy" face="arial,cotton"><a class="id" name="links">Links</a></font></h3>
<p><b>XSL-T</b>
<ul>
<li><a href="http://msdn.microsoft.com/msdn-online/workshop/xml/xslguide/patterns-xsl.asp">http://msdn.microsoft.com/msdn-online/workshop/xml/xslguide/patterns-xsl.asp</a>
<li><a href="http://www.xmlsoftware.com/articles/xsl-by-example.html">http://www.xmlsoftware.com/articles/xsl-by-example.html</a>
<li><a href="http://www.xml.com/xml/pub/1999/04/holman/xsl.html">http://www.xml.com/xml/pub/1999/04/holman/xsl.html</a>
<li><a href="http://www.w3.org/TR/xslt">W3C Recommendation on XSL Transform</a>
<li><a href="http://www.xmlsoftware.com/xslt/">XSLT engines at XMLSoftware.com</a>
<li><a href="http://www.xmlinfo.com/xsl/">XMLInfo on XSL</a>
<li><a href="http://www.mulberrytech.com/xsl/xsl-list/index.html">XSL Maillinglist</a>
</ul>
<p><b>Other</b>
<ul>
<li><a href="http://www.xml.com/xml/pub/98/09/xml-perl.html">Perl and XML</a>
<li><a href="http://wwwx.netheaven.com/~coopercc/xmlparser/Parser.html">XML::Parser</a>
<li><a href="http://www.w3.org/TR/REC-DOM-Level-1/">W3C Recommendation on DOM</a>
<li><a href="http://www.perlmonth.com/columns/perl_xml/perl_xml.html?issue=6&id=942343222">PerlMonth article on XML::DOM</a>
</ul>
</TD>
</table>
</body>
</html>