XSLTdoc - Revision history

Piotr Banski: - links to tei-c (maybe something else could replace it)

2010-03-14T12:43:25Z

- links to tei-c (maybe something else could replace it)

Stuartyeates: update url

2010-03-14T07:45:53Z

update url

Piotr Banski: a useful tool

2007-11-10T22:18:13Z

a useful tool

New page

'''XSLTdoc''' is a Javadoc-like tool for all versions of XSLT (1.0, 1.1, 2.0). It defines conventions to document XSL "code elements" directly in the source code. These "documentation elements" are then extracted by the XSLTdoc tool to build a documentation consisting of several linked HTML pages which provide easy browsing through the documentation. The XSLT source code is available with syntax highlighting. It is freely available on a GPL licence. <small>(cited from the project homepage)</small>

This is not a tool for managing TEI but rather something that helps maintain the XSLT scripts that handle your TEI – for example, Sebastian Rahtz's [http://www.tei-c.org/Tools/Stylesheets/ XSL stylesheets for TEI XML] are documented with XSLTdoc.

The software is written in XSLT 2.0 and installing it should take seconds, because all you have to do is unzip the archive. In order to configure it, you have to edit a pre-filled XML config file, setting the paths to suit your system. Documenting your XSLT is a matter of inserting <nowiki><xd:doc></nowiki> elements into your stylesheets. Then you need to run e.g. [[Saxon]] (packaged with the distribution) on <tt>xsltdoc.xsl</tt> (the root stylesheet), which produces a set of HTML files in a directory of your choice. CSS stylesheets are also provided and easily customizable.

==== Links ====
* [http://www.pnp-software.com/XSLTdoc/ XSLTdoc documentation]
* [http://sourceforge.net/projects/xsltdoc/ The SourceForge project page]
* [http://www.tei-c.org.uk/Stylesheets/teic/xsltdoc/ TEI XSLT stylesheet documentation generated with XSLTdoc (customized view)]

[[Category:Tools]]
[[Category:Administrative tools]]

@@ Line 1: / Line 1: @@
 '''XSLTdoc''' is a Javadoc-like tool for all versions of XSLT (1.0, 1.1, 2.0). It defines conventions to document XSL "code elements" directly in the source code. These "documentation elements" are then extracted by the XSLTdoc tool to build a documentation consisting of several linked HTML pages which provide easy browsing through the documentation. The XSLT source code is available with syntax highlighting. It is freely available on a GPL licence. <small>(cited from the project homepage)</small>
-This is not a tool for managing TEI but rather something that helps maintain the XSLT scripts that handle your TEI – for example, Sebastian Rahtz's [http://www.tei-c.org/Tools/Stylesheets/ XSL stylesheets for TEI XML] are documented with XSLTdoc.
+This is not a tool for managing TEI but rather something that helps maintain the XSLT scripts that handle your TEI – for example, Sebastian Rahtz's XSL stylesheets for TEI XML used to be documented with XSLTdoc.
 The software is written in XSLT 2.0 and installing it should take seconds, because all you have to do is unzip the archive. In order to configure it, you have to edit a pre-filled XML config file, setting the paths to suit your system. Documenting your XSLT is a matter of inserting <nowiki><xd:doc></nowiki> elements into your stylesheets. Then you need to run e.g. [[Saxon]] (packaged with the distribution) on <tt>xsltdoc.xsl</tt> (the root stylesheet), which produces a set of HTML files in a directory of your choice. CSS stylesheets are also provided and easily customizable.
@@ Line 8: / Line 8: @@
 * [http://www.pnp-software.com/XSLTdoc/ XSLTdoc documentation]
 * [http://sourceforge.net/projects/xsltdoc/ The SourceForge project page]
 [[Category:Tools]]
 [[Category:Administrative tools]]
 [[Category:XSLT]]