techtonik Tue Nov 2 14:12:50 2004 EDT
Modified files:
/phpdoc/xsl htmlhelp.xsl
Log:
make it more clear that every page consists of titlepage (or page header)
and content.. in htmlhelp format reference info goes into page header
omit word "description" in new xml format references
render seealso sections in such files
http://cvs.php.net/diff.php/phpdoc/xsl/htmlhelp.xsl?r1=1.8&r2=1.9&ty=u
Index: phpdoc/xsl/htmlhelp.xsl
diff -u phpdoc/xsl/htmlhelp.xsl:1.8 phpdoc/xsl/htmlhelp.xsl:1.9
--- phpdoc/xsl/htmlhelp.xsl:1.8 Tue Nov 2 08:20:16 2004
+++ phpdoc/xsl/htmlhelp.xsl Tue Nov 2 14:12:48 2004
@@ -3,7 +3,7 @@
HTML Help specific stylesheet
- $Id: htmlhelp.xsl,v 1.8 2004/11/02 13:20:16 techtonik Exp $
+ $Id: htmlhelp.xsl,v 1.9 2004/11/02 19:12:48 techtonik Exp $
-->
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform";
@@ -455,16 +455,18 @@
<!-- Special REFERENCE PAGE formatting for HH -->
-<!-- We need <refnamediv> to be in page title or header (also called titlepage
- in templates).
+<!-- REFERENCE PAGE TITLE or REFERENCE TITLEPAGE -->
+<!-- We need <refname> to be in page title (page header which also called
+ titlepage in templates).
Native <refentry> template calls "refentry.titlepage" template to display
- page header. refentry.titlepage is generated automatically as described in
- http://www.sagehill.net/docbookxsl/HtmlCustomEx.html#HTMLTitlePage
- and by default do not produces titlepage content for <refname>, which is
- rendered by "refentry.title" in html/refentry.xsl
+ page header. "refentry.titlepage" is generated automatically as described
+ in http://www.sagehill.net/docbookxsl/HtmlCustomEx.html#HTMLTitlePage
+
+ Default template doesn't produce titlepage content for <refname>, but
+ <refname> can be rendered with "refentry.title" in html/refentry.xsl
FIX: replace autogenerated template with ours custom as we don't have
- mechanizm for automatic generation of titlepage templates for now
+ template for automatic generation of titlepage templates
-->
<xsl:template name="refentry.titlepage">
<div class="titlepage">
@@ -498,11 +500,12 @@
<type>int</type><methodname>preg_match_all</methodname>
<methodparam><type>string</type><parameter>pattern</parameter></methodparam>
<methodparam><type>string</type><parameter>subject</parameter></methodparam>
- <methodparam><type>array</type><parameter>matches</parameter></methodparam>
+ <methodparam><type>array</type><parameter
role="reference">matches</parameter></methodparam>
<methodparam
choice="opt"><type>int</type><parameter>flags</parameter></methodparam>
</methodsynopsis>
This overrides common.xsl templates
+ TODO: <parameter role="reference">
-->
<!-- Print out the return type, the method name, then the parameters.
Close all the optional signs opened and close the prentheses -->
@@ -539,9 +542,23 @@
</span>
</xsl:template>
+
+<!-- REFERENCE PAGE CONTENTS -->
+
<!-- Drop out constant "Description" -->
-<xsl:template match="refsect1/title"/>
-<xsl:template match="refsect1/refpurpose"/>
+<xsl:template match="[EMAIL PROTECTED] = 'description']/title"/>
+<!-- FIX: try to drop out "Description" in old format until we move to a
+ new format completely (will not work for other language) -->
+<xsl:template match="refsect1/title[.='Description']"/>
+
+<!-- Render "See also section" -->
+<!-- FIX: old format by the same reason -->
+<xsl:template match="[EMAIL PROTECTED] = 'seealso']/title | refsect1/title[.='See
also']">
+ <xsl:value-of select="."/>
+</xsl:template>
+<!-- Do not process methodsynopsis node as we've rendered it explicitly in
+ reference titlepage above -->
+<xsl:template match="methodsynopsis"/>
</xsl:stylesheet>
