Re: Some customisation features for htmlhelp/htmlhelp-common.xsl

["W. Borgert" <debacle@debian.org>]

[sorry, if this mail is duplicated - the reqest/subscribe
address on the oasis-open web page is wrong, so I'm not sure
whether my posting has been dropped]

Hello,

I had to customise the output for CHM a little bit and had to
add some new variables in htmlhelp/htmlhelp-common.xsl of the
DocBook XSL stylesheets.  I don't even understand the meaning
of most bits - I'm not an expert on MS htmlhelp and just got
the correct values from people who know :-)  It would be nice
to have this customisation features in the official docbook-xsl
distribution.  What can I do to get into the main line?

Thanks in advance!

Cheers, WB

This is in my custom XSL file:

  <xsl:variable name="my.decomp">Enhanced decompilation=Yes</xsl:variable>
  <xsl:variable name="my.somearray">[160,64,992,704]</xsl:variable>
  <xsl:variable name="my.someglob">$global_(narsec)="Protocol Tester
Video",,,,,,,,,,,0x0,[263,270,813,734],,,,,,,0
$global_(w95sec)="My Video",,,,,,,,,,,0x0,[170,45,915,733],,,,,,,0
$global_(widsec)="My Video",,,,,,,,,,,0x0,[118,70,984,751],,,,,,,0
$global_(maxsec)="My
Video",,,,,,,,,,,0x0,[180,6,921,748],,,,,,,0</xsl:variable>
  <xsl:variable name="my.someint">256</xsl:variable>
  <xsl:variable name="my.progress">No</xsl:variable>
  <xsl:variable name="my.show.unknown">458816</xsl:variable>

This is the patch to htmlhelp/htmlhelp-common.xsl:

--- docbook-xsl-1.60.1htmlhelp/htmlhelp-common.xsl Sat Oct 19 20:53:33 2002
+++ docbook-xsl-my/htmlhelp/htmlhelp-common.xsl Tue Apr 29 10:08:02 2003
@@ -100,6 +100,7 @@
   <xsl:call-template name="toHex">
     <xsl:with-param name="n" select="9504 + $htmlhelp.show.menu * 65536
                                           + $htmlhelp.show.advanced.search *
131072
+                                          + $my.show.unknown
                                           + $htmlhelp.show.favorities *
4096"/>
   </xsl:call-template>
 </xsl:variable>
@@ -139,7 +140,7 @@
 </xsl:text></xsl:if>
 <xsl:text>Default topic=</xsl:text><xsl:value-of select="$default.topic"/>
 <xsl:text>
-Display compile progress=Yes
+Display compile progress=</xsl:text><xsl:value-of
select="$my.progress"/><xsl:text>
 Full-text search=Yes
 </xsl:text>
 <xsl:if test="$generate.index">
@@ -170,6 +171,9 @@
       <xsl:value-of select="$htmlhelp.title"/>
     </xsl:otherwise>
   </xsl:choose>
+<xsl:text>
+</xsl:text>
+<xsl:value-of select="$my.decomp"/>
 
 <xsl:if test="$htmlhelp.hhp.window != ''">
   <xsl:text>
@@ -177,7 +181,7 @@
 [WINDOWS]
 </xsl:text>
 <xsl:value-of select="$htmlhelp.hhp.window"/>
-<xsl:text>=,"</xsl:text><xsl:value-of select="$htmlhelp.hhc"/>
+<xsl:text>="</xsl:text><xsl:value-of
select="normalize-space(//title[1])"/><xsl:text>","</xsl:text><xsl:value-of
select="$htmlhelp.hhc"/>
 <xsl:text>",</xsl:text>
 <xsl:if test="$generate.index">
   <xsl:text>"</xsl:text>
@@ -220,15 +224,34 @@
   <xsl:text>"</xsl:text>
   <xsl:value-of select="$htmlhelp.button.jump2.title"/>
   <xsl:text>"</xsl:text>
-</xsl:if>
-<xsl:text>,</xsl:text>
-<xsl:value-of select="$xnavigation"/>
-<xsl:text>,,</xsl:text>
-<xsl:value-of select="$xbuttons"/>
-<xsl:text>,,,,,,,,0
+      </xsl:if>
+      <xsl:text>,</xsl:text>
+      <xsl:value-of select="$xnavigation"/>
+      <xsl:text>,</xsl:text><xsl:value-of select="$my.someint"/>
+      <xsl:text>,</xsl:text>
+      <xsl:value-of select="$xbuttons"/>
+      <xsl:text>,</xsl:text>
+      <xsl:value-of select="$my.somearray"/>
+      <xsl:text>,,,,,,,0
 </xsl:text>
-</xsl:if>
-
+    </xsl:if>
+    <xsl:text>search="</xsl:text>
+    <xsl:value-of select="normalize-space(//title[1])"/>
+    <xsl:text>","toc.hhc","index.hhk","</xsl:text>
+    <xsl:value-of select="$root.filename"/>
+    <xsl:text>.html","</xsl:text>
+    <xsl:value-of select="$root.filename"/>
+    <xsl:text>.html",,,,,</xsl:text>
+    <xsl:value-of select="$xnavigation"/>
+    <xsl:text>,</xsl:text>
+    <xsl:value-of select="$my.someint"/>
+    <xsl:text>,</xsl:text>
+    <xsl:value-of select="$xbuttons"/>
+    <xsl:text>,</xsl:text>
+    <xsl:value-of select="$my.somearray"/>
+    <xsl:text>,,,,,2,,0
+</xsl:text>
+<xsl:value-of select="$my.someglob"/>
 <xsl:text>
 
 [FILES]
@@ -266,6 +289,9 @@
     </xsl:otherwise>
   </xsl:choose>
 </xsl:if>
+<xsl:if test="$my.extrafiles">
+  <xsl:value-of select="$my.extrafiles"/>
+</xsl:if>
 
 <xsl:if test="($htmlhelp.force.map.and.alias != 0) or
               ($rootid = '' and //processing-instruction('dbhh')) or
@@ -425,7 +451,7 @@
 </xsl:text>
   <xsl:if test="$htmlhelp.hhc.folders.instead.books != 0">
     <xsl:text disable-output-escaping="yes">&lt;OBJECT type="text/site
properties"&gt;
- &lt;param name="ImageType" value="Folder"&gt;
+ &lt;param name="Window Styles" value="0x800623"&gt;
 &lt;/OBJECT&gt;
 </xsl:text>
   </xsl:if>