[PHP-DOC] cvs: phpdoc / README.xsl
gobaSun Oct 21 08:27:34 2001 EDT Removed files: /phpdoc README.xsl Log: No need for this file, all the things are in the HOWTO now
[PHP-DOC] cvs: phpdoc / README.xsl bightml.xsl.in chunk-filename.xsl configure.in html.xsl.in htmlhelp.xsl.in
jkj Mon Aug 13 11:11:06 2001 EDT Removed files: /phpdoc chunk-filename.xsl Modified files: /phpdoc README.xsl bightml.xsl.in configure.in html.xsl.in htmlhelp.xsl.in Log: Update XSL stuff to reflect latest XSL DocBook stylesheets. Index: phpdoc/README.xsl diff -u phpdoc/README.xsl:1.4 phpdoc/README.xsl:1.5 --- phpdoc/README.xsl:1.4 Sun Aug 5 05:24:09 2001 +++ phpdoc/README.xsl Mon Aug 13 11:11:06 2001 @@ -62,12 +62,6 @@ For getting PDF from FO file you must run some FO processor on FO file. -Current HTML Help support uses slightly updated version of HTML Help -stylesheets. Download file http://www.kosek.cz/temp/htmlhelp.zip and -place its content over directory contrib/htmlhelp in standard -stylesheets distribution. In near future, this modification will be -part of standard XSL stylesheet distribution. - PERFORMANCE COMMENTS: - @@ -82,9 +76,9 @@ Not all customization from DSSSL are backported to XSL, so some things -does not work for now. Hope, this will change in the near future. +as pretty as in DSSSL output. Hope, this will change in the near future. Jirka Kosek [EMAIL PROTECTED] -Last modified $Date: 2001/08/05 09:24:09 $ +Last modified $Date: 2001/08/13 15:11:06 $ Index: phpdoc/bightml.xsl.in diff -u phpdoc/bightml.xsl.in:1.2 phpdoc/bightml.xsl.in:1.3 --- phpdoc/bightml.xsl.in:1.2 Sun Feb 11 16:51:24 2001 +++ phpdoc/bightml.xsl.in Mon Aug 13 11:11:06 2001 @@ -2,15 +2,17 @@ HTML specific stylesheet - $Id: bightml.xsl.in,v 1.2 2001/02/11 21:51:24 jkj Exp $ + $Id: bightml.xsl.in,v 1.3 2001/08/13 15:11:06 jkj Exp $ -- xsl:stylesheet xmlns:xsl=http://www.w3.org/1999/XSL/Transform; -version=1.0 +version=1.0 +xmlns:saxon=http://icl.com/saxon; + extension-element-prefixes=saxon xsl:import href=@DOCBOOKXSL_BIGHTML@/ xsl:include href=html-common.xsl/ -xsl:output method=html encoding=@ENCODING@/ +xsl:output method=html encoding=@ENCODING@ +saxon:character-representation=native/ /xsl:stylesheet Index: phpdoc/configure.in diff -u phpdoc/configure.in:1.73 phpdoc/configure.in:1.74 --- phpdoc/configure.in:1.73Sat Aug 11 11:54:05 2001 +++ phpdoc/configure.in Mon Aug 13 11:11:06 2001 @@ -1,4 +1,4 @@ -dnl $Id: configure.in,v 1.73 2001/08/11 15:54:05 goba Exp $ +dnl $Id: configure.in,v 1.74 2001/08/13 15:11:06 jkj Exp $ AC_INIT(global.ent) @@ -108,7 +108,7 @@ if test -d $dir; then DOCBOOKXSL_BIGHTML=$dir/html/docbook.xsl DOCBOOKXSL_HTML=$dir/html/chunk.xsl -DOCBOOKXSL_HTMLHELP=$dir/contrib/htmlhelp/htmlhelp.xsl +DOCBOOKXSL_HTMLHELP=$dir/htmlhelp/htmlhelp.xsl DOCBOOKXSL_PRINT=$dir/fo/docbook.xsl AC_MSG_RESULT(autodetected: $dir) @@ -119,7 +119,7 @@ if test -z $DOCBOOKXSL_BIGHTML; then DOCBOOKXSL_BIGHTML=../phpdoc-tools/xsl/html/docbook.xsl DOCBOOKXSL_HTML=../phpdoc-tools/xsl/html/chunk.xsl -DOCBOOKXSL_HTMLHELP=../phpdoc-tools/xsl/contrib/htmlhelp/htmlhelp.xsl +DOCBOOKXSL_HTMLHELP=../phpdoc-tools/xsl/htmlhelp/htmlhelp.xsl DOCBOOKXSL_PRINT=../phpdoc-tools/xsl/fo/docbook.xsl AC_MSG_RESULT(not found, defaulting) fi Index: phpdoc/html.xsl.in diff -u phpdoc/html.xsl.in:1.3 phpdoc/html.xsl.in:1.4 --- phpdoc/html.xsl.in:1.3 Sun Feb 11 16:53:17 2001 +++ phpdoc/html.xsl.in Mon Aug 13 11:11:06 2001 @@ -2,19 +2,18 @@ HTML specific stylesheet - $Id: html.xsl.in,v 1.3 2001/02/11 21:53:17 jkj Exp $ + $Id: html.xsl.in,v 1.4 2001/08/13 15:11:06 jkj Exp $ -- xsl:stylesheet xmlns:xsl=http://www.w3.org/1999/XSL/Transform; version=1.0 xsl:import href=@DOCBOOKXSL_HTML@/ -xsl:import href=chunk-filename.xsl/ xsl:include href=html-common.xsl/ -xsl:output method=html encoding=@ENCODING@/ - xsl:param name=base.dir select='html/'/ xsl:param name=use.id.as.filename select=1/ +xsl:param name=default.encoding select='@ENCODING@'/ +xsl:param name=saxon.character.representation select='native'/ /xsl:stylesheet Index: phpdoc/htmlhelp.xsl.in diff -u phpdoc/htmlhelp.xsl.in:1.1 phpdoc/htmlhelp.xsl.in:1.2 --- phpdoc/htmlhelp.xsl.in:1.1 Mon Feb 19 06:52:11 2001 +++ phpdoc/htmlhelp.xsl.in Mon Aug 13 11:11:06 2001 @@ -2,24 +2,19 @@ HTML Help specific stylesheet - $Id: htmlhelp.xsl.in,v 1.1 2001/02/19 11:52:11 jkj Exp $ + $Id: htmlhelp.xsl.in,v 1.2 2001/08/13 15:11:06 jkj Exp $ -- xsl:stylesheet xmlns:xsl=http://www.w3.org/1999/XSL/Transform; -xmlns:saxon=http://icl.com/saxon; -extension-element-prefixes=saxon version=1.0 xsl:import href=@DOCBOOKXSL_HTMLHELP@/ -xsl:import href=chunk-filename.xsl/ xsl:include href=html-common.xsl/ -xsl:output method=html encoding=@HTMLHELP_ENCODING@ -saxon:character-representation=native/ - xsl:param name=base.dir
[PHP-DOC] cvs: phpdoc / README.xsl
jah Sun Aug 5 04:47:50 2001 EDT Modified files: /phpdoc README.xsl Log: Found out that saxons' homepage has moved. Index: phpdoc/README.xsl diff -u phpdoc/README.xsl:1.2 phpdoc/README.xsl:1.3 --- phpdoc/README.xsl:1.2 Mon Feb 19 06:52:11 2001 +++ phpdoc/README.xsl Sun Aug 5 04:47:50 2001 @@ -11,7 +11,7 @@ XSLT processors: XT: http://www.jclark.com/xml/xt.html - Saxon: http://users.iclway.co.uk/mhkay/saxon/ + Saxon: http://saxon.sourceforge.net/ Xalan: http://xml.apache.org/xalan/ XSL DocBook Stylesheets: @@ -87,4 +87,4 @@ Jirka Kosek [EMAIL PROTECTED] -Last modified $Date: 2001/02/19 11:52:11 $ +Last modified $Date: 2001/08/05 08:47:50 $
[PHP-DOC] cvs: phpdoc / README.xsl
jah Sun Aug 5 05:24:09 2001 EDT Modified files: /phpdoc README.xsl Log: Another changed link... Index: phpdoc/README.xsl diff -u phpdoc/README.xsl:1.3 phpdoc/README.xsl:1.4 --- phpdoc/README.xsl:1.3 Sun Aug 5 04:47:50 2001 +++ phpdoc/README.xsl Sun Aug 5 05:24:09 2001 @@ -12,7 +12,7 @@ XSLT processors: XT: http://www.jclark.com/xml/xt.html Saxon: http://saxon.sourceforge.net/ - Xalan: http://xml.apache.org/xalan/ + Xalan: http://xml.apache.org/xalan-j/ XSL DocBook Stylesheets: http://www.nwalsh.com/docbook/xsl/index.html @@ -87,4 +87,4 @@ Jirka Kosek [EMAIL PROTECTED] -Last modified $Date: 2001/08/05 08:47:50 $ +Last modified $Date: 2001/08/05 09:24:09 $
[PHP-DOC] cvs: phpdoc / README.xsl bightml.xsl.in html-common.xsl
jkj Sun Feb 11 13:51:24 2001 EDT Added files: /phpdoc README.xsl html-common.xsl Modified files: /phpdoc bightml.xsl.in Log: - improved formatting of functions and function reference - added brief information about using XSL stylesheets Index: phpdoc/bightml.xsl.in diff -u phpdoc/bightml.xsl.in:1.1 phpdoc/bightml.xsl.in:1.2 --- phpdoc/bightml.xsl.in:1.1 Thu Feb 8 04:45:29 2001 +++ phpdoc/bightml.xsl.in Sun Feb 11 13:51:24 2001 @@ -2,13 +2,14 @@ HTML specific stylesheet - $Id: bightml.xsl.in,v 1.1 2001/02/08 12:45:29 jkj Exp $ + $Id: bightml.xsl.in,v 1.2 2001/02/11 21:51:24 jkj Exp $ -- xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0" xsl:import href="@DOCBOOKXSL_BIGHTML@"/ +xsl:include href="html-common.xsl"/ xsl:output method="html" encoding="@ENCODING@"/ Index: phpdoc/README.xsl +++ phpdoc/README.xsl THIS README FILE CONTAINS NOTES ON USING XSL STYLESHEETS TO FORMAT PHP DOCUMENTATION REQUIRED PACKAGES: -- In order to successfully use XSL support you must have some XSLT processor and XSL DocBook Stylesheets. This is sufficient for generating HTML version of documentation. If you also want to create version suitable for print, you will additionally need FO processor. XSLT processors: XT: http://www.jclark.com/xml/xt.html Saxon: http://users.iclway.co.uk/mhkay/saxon/ Xalan: http://xml.apache.org/xalan/ XSL DocBook Stylesheets: http://www.nwalsh.com/docbook/xsl/index.html FO processors: PassiveTeX: http://users.ox.ac.uk/~rathz/passivetex/ FOP: http://xml.apache.org/fop/ XEP: http://www.renderx.com/ USAGE: -- At this time there are no XSL specific targets in Makefile. This is because there are not standardized ways to invoke XSLT processor. To use XSL stylesheets you must run configure script and tell it, where is placed your copy of XSL DocBook Stylesheets. Majority of XSLT processor require URL instead of filename, so be sure to prepend file:/// schema before path: autoconf ./configure --with-xsl=file:///path/to/docbook/xsl/styles Configure will create three files html.xsl, bightml.xsl and print.xsl among others. These files can be used to generate desired output. html.xsl generates set of small files, bightml.xsl generates one large file and print.xsl generates file with FO object suitable for further processing with some FO processor. Invocation of XSLT processor is processor dependent, for now suppose that you have shell script called saxon which is able to invoke Saxon processor. Run: mkdir html saxon manual.xml html.xsl - to get HTML version of documentation saxon -o bigmanual.html manual.xml bightml.xsl - to get whole documentation in one large HTML file saxon -o manual.fo manual.xml print.xsl - to get FO file For getting PDF from FO file you must run some FO processor on FO file. PERFORMANCE COMMENTS: - Generating bigmanual.html with Saxon (under JDK 1.3) takes about two minutes on Celeron 400 computer. Generating FO files takes about two times more + plus time required to run FO processor. Generating chunked version of manual is on my machine approximately two times slower than with Jade. LIMITATIONS: Not all customization from DSSSL are backported to XSL, so some things does not work for now. Hope, this will change in the near future. Jirka Kosek [EMAIL PROTECTED] Last modified $Date: 2001/02/11 21:51:24 $ Index: phpdoc/html-common.xsl +++ phpdoc/html-common.xsl !-- Common HTML customizations $Id: html-common.xsl,v 1.1 2001/02/11 21:51:24 jkj Exp $ -- xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0" xsl:param name="funcsynopsis.style"ansi/xsl:param xsl:param name="funcsynopsis.decoration"1/xsl:param xsl:param name="refentry.generate.name"0/xsl:param !-- We do not want semicolon at the end of prototype -- xsl:template match="paramdef" xsl:variable name="paramnum" xsl:number count="paramdef" format="1"/ /xsl:variable xsl:if test="$paramnum=1"(/xsl:if xsl:choose xsl:when test="$funcsynopsis.style='ansi'" xsl:apply-templates/ /xsl:when xsl:otherwise xsl:apply-templates select="./parameter"/ /xsl:otherwise /xsl:choose xsl:choose xsl:when test="following-sibling::paramdef" xsl:text, /xsl:text /xsl:when xsl:otherwise xsl:text)/xsl:text /xsl:otherwise /xsl:choose /xsl:template !-- Enclose functions in links, add parenthesis -- xsl:template match="function" xsl:choose xsl:when test="name(parent::*)!='funcdef'" xsl:choose xsl:when
