techtonik Sun Nov 14 09:28:25 2004 EDT
Modified files:
/phpdoc/xsl htmlhelp.xsl
Log:
add some comments (save state)
http://cvs.php.net/diff.php/phpdoc/xsl/htmlhelp.xsl?r1=1.17&r2=1.18&ty=u
Index: phpdoc/xsl/htmlhelp.xsl
diff -u phpdoc/xsl/htmlhelp.xsl:1.17 phpdoc/xsl/htmlhelp.xsl:1.18
--- phpdoc/xsl/htmlhelp.xsl:1.17 Wed Nov 10 15:40:03 2004
+++ phpdoc/xsl/htmlhelp.xsl Sun Nov 14 09:28:25 2004
@@ -3,7 +3,7 @@
HTML Help specific stylesheet
- $Id: htmlhelp.xsl,v 1.17 2004/11/10 20:40:03 techtonik Exp $
+ $Id: htmlhelp.xsl,v 1.18 2004/11/14 14:28:25 techtonik Exp $
-->
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform";
@@ -12,6 +12,30 @@
xmlns:set="http://exslt.org/sets";
version="1.0"
exclude-result-prefixes="doc exsl set">
+<!--
+ xCHM HTMLHELP customizations include:
+ - output directory for HH files is 'htmlhelp/html/'
+ - DOCTYPE in output HTML defines DOM standard for browser to handle JS
correctly
+ - project files for HTML Help are written into 'htmlhelp/html/'
+ - open ulinks in _blank window
+ - CHM buttons settings
+ - custom .hhk file with index.html split in two files (titlepage and toc)
+ - custom .hhc file with same changes
+ - .hhk and .hhc are processed in html mode unlike native DocBook XSL
templates
+ - proper escaping in .hhk and .hhc to reflect transition from text to html
mode
+ - strip <link> tags from HTML headers
+ - add javascript handlers in body attributes
+ - header off, footer on (also custom with some js handlers and custom ids)
+ - turn on function index page building (in appendixes) and turn off ToC for
it
+ - output formal object titles enclosed in <h3> tags
+ (abstract title, examples, tables, ...?)
+ - simple bold text for admonitions (note|important|warning|caution|tip)
+ - custom tables attributes
+ - special reference page - drop out "description" title, proper rendering
for
+ "seealso", move <refname> along with function prototype to page header and
+ render it appropriately
+ TODO: need convenient reference page skeleton
+-->
<!-- - BASED ON 1.66.1 HTMLHELP.XSL DOCBOOK XSL STYLESHEET - -->
@@ -496,8 +520,7 @@
<xsl:apply-templates/>
</xsl:template>
-<!-- Do not generate ToC for index page : temporary FIX until a more
appropriate
- solution will come from dobook-apps -->
+<!-- Do not generate ToC for index page -->
<!-- Copy of native DocBook template with "if" inserted -->
<xsl:template name="component.toc">
<xsl:param name="toc-context" select="."/>
