what is it ---------- An application to produce documentation for XSLT files in XHTML format, similar to what javadoc does for Java files. changes since the last release ------------------------------ * new options -v, --verbose show more detailed information while generarating the documentation --helpfile show the information of a ReST .txt file on the help page. Default is ``./HELP.txt``. --windowtitle browser window title for the documenation * documentation of xsl:namespace-alias shows prefixes with connected URIs now. (thanks to Jarno Elovirta) * parameters of named templates are commented now and properly linked from index page * id and class attributes are filtered out of ReST XHTML to not interfere with pyXSLdocs own CSS classes * removed unused "deprecated" tab from navigation * updated to Pyana 0.9, should still work with Pyana 0.8 though * code documentation, refactoring and simplification (not all though ;) * lots of bugfixes and small changes see http://cthedot.de/pyxsldoc/README.txt for a complete list of changes license ------- pyXSLdoc is published under the LGPL. download -------- download pyXSLdoc v0.62 - 040626 from http://cthedot.de/pyxsldoc/ pyXSLdoc needs * Python 2.3 (tested with Python 2.3.4 on Windows XP only) * Pyana (tested with Pyana 0.9 only) * Docutils (tested with Docutils 0.3 only) usage ----- Copy the XSLT files to document in a directory below pyXSLdoc (you could also give the complete path to your files but that would end up like that in the documentation). Then start the documentation process with

python xsldoc.py DIRNAMES FILENAMES [options]

DIRNAMES directories with XSLT files to document,e.g. dir1 dir2 All directories and XSLT files below a given directory will be processed, so you can just use your XSLT package main directory name (new from v0.50). FILENAMES single XSLT files to document, e.g. file1.xsl path/file2.xsl options ~~~~~~~ -h, --help show this help message and exit -sSOURCEPATH, --sourcepath=SOURCEPATH sourcepath to XSLTs, all XSLT files under this path will be documented and SOURCEPATH/overview.txt will be used for the overview. You might also simply list all dirs and XSLT files as parameters. -j, --javadoc, --htmldocs process comments in Javadoc style (HTML and @tags), default style is reStructuredText (ReST) -dDOCPATH, --docpath=DOCPATH documentation target directory, default is ./_xsldoc -oOVERVIEW, --overview=OVERVIEW show the information of this ReST .txt file on the overview page --helpfile=HELPFILE show the information of this ReST .txt file on the help page. Default is "./HELP.txt". --windowtitle=WINDOWTITLE browser window title for the documentation, text only, no tags -r, --removedocs remove all comments from given XSLTs and save results in COMMENTSTRIPPEDPATH. present files will be OVERWRITTEN! -cCOMMENTSTRIPPEDPATH, --commentstrippedpath=COMMENTSTRIPPEDPATH path where XSLTs will be saved after removing of all docs. Only used when option "-r" is given. Default directory is ./_optimized. -v, --verbose show more detailed information while generating the documentation thanks for the interest. any comment is appreciated christof hoeke http://cthedot.de <P><A HREF="http://cthedot.de/pyxsldoc/">pyXSLdoc 0.62</A> - generate XSLT documentations (26-Jun-04)