tom Thu Mar 13 16:27:32 2003 EDT
Modified files:
/phpdoc/howto tools.xml
Log:
include new info about xsl-tools
Index: phpdoc/howto/tools.xml
diff -u phpdoc/howto/tools.xml:1.14 phpdoc/howto/tools.xml:1.15
--- phpdoc/howto/tools.xml:1.14 Tue Aug 13 12:23:49 2002
+++ phpdoc/howto/tools.xml Thu Mar 13 16:27:32 2003
@@ -401,7 +401,8 @@
<para>
This is an operating system independent section,
- as most of the tools are written in the Java
+ as most of the tools are eighter provided for several
+ operating systems, are written in the Java
language, or provide a version in Java. This means,
you can run them on virtually any operating system,
where a Java Virtual Machine is available. See the
@@ -419,8 +420,7 @@
to setup any tools mentioned here if you would
not like to play with XSL stylesheets. However
we plan to use XSL in the future for HTML
- generation, and possibly PDF generation, if we
- can manage to work out how to do it correctly.
+ generation, and possibly PDF generation.
</para>
</note>
@@ -428,32 +428,46 @@
The phpdoc <filename>Makefile</filename> has options to
generate files using the XSL sheets, but these are currently
experimental (and require xsltproc exclusively). After running
- <filename>./configure</filename> you can run <literal>make
- html_xsl</literal> to generate HTML files using XSL sheets.
- </para>
-
- <para>
- XSLT processors:
+ <filename>./configure</filename> you can run
<itemizedlist>
<listitem>
<simpara>
- Saxon: <ulink url="&url.xsl.saxon;">&url.xsl.saxon;</ulink>
+ <literal>make html_xsl</literal> to generate HTML files
</simpara>
</listitem>
<listitem>
<simpara>
- Xalan: <ulink url="&url.xsl.xalan;">&url.xsl.xalan;</ulink>
+ <literal>make bightml_xsl</literal> to generate one big HTML file
</simpara>
</listitem>
<listitem>
<simpara>
- Gnome LibXSLT (also known as xsltproc):
+ <literal>make fo</literal> to generate a FO file (Formatting
+ Objects file, which will be used by the FO processor to generate
+ e.g. pdf-files)
+ </simpara>
+ </listitem>
+ </itemizedlist>
+ using XSL sheets.
+ </para>
+
+ <para>
+ XSLT processors:
+ <itemizedlist>
+ <listitem>
+ <simpara>
+ LibXSLT (also known as xsltproc, recommended;):
<ulink url="&url.xsl.libxslt;">&url.xsl.libxslt;</ulink>,
- available as Windows binary too at:
+ available as Windows binaries too at:
<ulink url="&url.xsl.libxslt.win;">&url.xsl.libxslt.win;</ulink>,
and also included in current cygwin setups.
</simpara>
</listitem>
+ <listitem>
+ <simpara>
+ Saxon: <ulink url="&url.xsl.saxon;">&url.xsl.saxon;</ulink>
+ </simpara>
+ </listitem>
</itemizedlist>
</para>
@@ -461,7 +475,9 @@
<para>
As we tested, other XSLT processors, like XT and MSXML cannot handle
the DocBook XSL stylesheets, so these cannot be used for even
- the simplest HTML creation.
+ the simplest HTML creation. <ulink url="&url.xsl.xalan;">Xalan</ulink>
+ works with DocBook XSL stylesheets, but the sources of the PHP manual
+ currently exceed the limit of max. opened files.
</para>
</note>
@@ -475,7 +491,8 @@
</listitem>
<listitem>
<simpara>
- FOP: <ulink url="&url.xsl.fop;">&url.xsl.fop;</ulink>
+ FOP: <ulink url="&url.xsl.fop;">&url.xsl.fop;</ulink> (you need version
+ 0.20.5rc2 or higher)
</simpara>
</listitem>
<listitem>
--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
