From b3361f1f0e795fc9287d78edb1cc2a6dc5fc2334 Mon Sep 17 00:00:00 2001
From: David Cramer <david@thingbag.net>
Date: Sat, 11 Jan 2003 22:19:29 +0000
Subject: [PATCH] Initial checkin of customization of htmlhelp xsls to generate
 cross-platform help using applets

---
 contrib/xsl/applethelp/README              |  73 ++++++
 contrib/xsl/applethelp/applethelp.xsl      | 253 +++++++++++++++++++++
 contrib/xsl/applethelp/images/cntidx.gif   | Bin 0 -> 961 bytes
 contrib/xsl/applethelp/images/cnttab.gif   | Bin 0 -> 999 bytes
 contrib/xsl/applethelp/images/indexcnt.gif | Bin 0 -> 1001 bytes
 contrib/xsl/applethelp/images/indextab.gif | Bin 0 -> 969 bytes
 6 files changed, 326 insertions(+)
 create mode 100644 contrib/xsl/applethelp/README
 create mode 100755 contrib/xsl/applethelp/applethelp.xsl
 create mode 100755 contrib/xsl/applethelp/images/cntidx.gif
 create mode 100755 contrib/xsl/applethelp/images/cnttab.gif
 create mode 100755 contrib/xsl/applethelp/images/indexcnt.gif
 create mode 100755 contrib/xsl/applethelp/images/indextab.gif

diff --git a/contrib/xsl/applethelp/README b/contrib/xsl/applethelp/README
new file mode 100644
index 000000000..23c1d2c88
--- /dev/null
+++ b/contrib/xsl/applethelp/README
@@ -0,0 +1,73 @@
+README
+
+What is this and how do I use it?
+
+This customization of Jirka Kosek's customization of Norm
+Walsh's DocBook xsls generates a frameset with ingredients
+necessary to view an uncompiled help project in most
+browsers that support Java applets, much like the "WebHelp"
+format available from RoboHELP. You simply have to add a few
+files found in the installation directory of the HTML Help
+Workshop to the base directory of the frameset. The applet
+creates a toc and index tab (though no search or favorites
+tab) that works well in most browsers that support applets.
+The stuff added for frameset doesn't affect the chm at all.
+
+After generating your html files, copy the contents of the
+'java' folder from your HTML Help Workshop installation to
+the directory containing the frameset files. Note that you
+must copy the *contents* of C:\Program Files\HTML Help
+Workshop\java (not the folder-so HHCtrl.class etc. must be
+in the same directory as index.html, contents.pane.html, and
+index.pane.html).
+
+So when you're done, your directory will look like this
+(where build/index.html runs the frameset):
+
+build/	cntimage.gif
+		contents.pane.html
+		DialogLayout.class
+		Element.class
+		ElementList.class
+		files/*.html
+		HHCtrl.cab
+		HHCtrl.class
+		htmlhelp.hhp
+		images/	cntidx.gif
+				cntimage.gif
+				cnttab.gif
+				indexcnt.gif
+				indextab.gif
+				*.gif 
+		index.hhk
+		index.html
+		index.pane.html
+		IndexPanel.class
+		RelatedDialog.class
+		SitemapParser.class
+		toc.hhc
+		TreeCanvas.class
+		TreeView.class
+
+Note that you can still compile the htmlhelp.hhp file. The
+applets .class files are not needed or included in the chm.
+
+This stylesheet was tested with 1.55.0 of the docbook xsls,
+but probably works with more recent versions.
+
+Known Limitation: The indexterms in the index tab are
+currently not sorted. This can be fixed by tweaking the
+xsls. Also, multiple instances of the same indexterm appear
+in the index pane (in a chm, they are combined and a choice
+of terms is presented when it is double clicked). 
+
+Resources:
+http://msdn.microsoft.com/library/default.asp?url=/library/en-us/htmlhelp/html/vsconwhtsja.asp
+http://msdn.microsoft.com/library/default.asp?url=/library/en-us/htmlhelp/html/hwMicrosoftHTMLHelpDownloads.asp
+http://www.mvps.org/htmlhelpcenter/hhjapplt.htm
+
+This is a contrib file and carries no guarantee.
+
+David Cramer
+dcramer@broadjump.com
+david@thingbag.net
diff --git a/contrib/xsl/applethelp/applethelp.xsl b/contrib/xsl/applethelp/applethelp.xsl
new file mode 100755
index 000000000..1746b8cc1
--- /dev/null
+++ b/contrib/xsl/applethelp/applethelp.xsl
@@ -0,0 +1,253 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<xsl:stylesheet 
+  xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+  version="1.0">
+
+  <!-- Adjust this path as necessary -->
+  <xsl:import href="htmlhelp.xsl"/>
+
+  <!-- Five new parameters: -->
+  <!-- htmlhelp.generate.frameset turns the whole thing on and off -->
+  <xsl:param name="htmlhelp.generate.frameset" select="1"/>
+  <!-- htmlhelp.frameset.graphics.path defines the path to the images for the tabs on the nav pane -->
+  <xsl:param name="htmlhelp.frameset.graphics.path">images/</xsl:param>
+  <!-- These must be different from each other and (unless
+  you define base.dir), they also must be different from all
+  the generated chunks. -->
+  <xsl:param name="htmlhelp.frameset.start.filename">index.html</xsl:param>
+  <xsl:param name="htmlhelp.frameset.toc.pane.filename">contents.pane.html</xsl:param>
+  <xsl:param name="htmlhelp.frameset.index.pane.filename">index.pane.html</xsl:param>
+
+  <!-- Hmm. Currenly you really need to set this... -->
+  <xsl:param name="htmlhelp.default.topic" select="'index.html'"/>
+
+  <!-- This defines the directory for the html files. We
+  have to define this because we don't want the name of the
+  frameset html files to collide with the generated
+  chunks. --> 
+  <xsl:param name="base.dir" select="'files/'"/>
+
+  <!-- This is required if you want an index -->
+  <!-- The non-hhk type index doesn't work with applet help -->
+  <xsl:param name="htmlhelp.use.hhk" select="1"/>
+
+  <!-- These are just some of my preferences, they don't necessarily matter -->
+  <xsl:param name="chunk.section.depth" select="100"/>
+  <xsl:param name="htmlhelp.hhc.show.root" select="0"/>
+
+  <xsl:template name="generate.htmlhelp.frameset">
+	<xsl:variable name="topic.pane">
+	  <html>
+		<xsl:call-template name="head.content">
+		  <xsl:with-param name="node" select="/"/>
+		</xsl:call-template>
+		<!--head>
+		<meta http-equiv="Content-Type" content="text/html; charset=windows-1252"/>
+		<title>Text for title bar</title>
+	  </head-->
+		<frameset cols="250,*" framespacing="0" border="0" frameborder="0">
+		  <!-- This points to a page that contains the toc applet -->
+		  <frame name="contents" target="main" src="contents.pane.html" scrolling="auto"/>
+		  <!-- This src points to the 'default topic' html page  -->
+		  <frame 
+			name="main" 
+			scrolling="auto" 
+			noresize="noresize">
+		  <xsl:if test="$htmlhelp.default.topic != ''">
+			<xsl:attribute name="src"><xsl:value-of select="$base.dir"/><xsl:value-of select="$htmlhelp.default.topic"/></xsl:attribute>
+		  </xsl:if>
+		  </frame>
+		  <noframes>
+			<body>
+			  <p>This page uses frames, but your browser doesn't support them.</p>
+			</body>
+		  </noframes>
+		</frameset>
+	  </html>
+	</xsl:variable>
+	<xsl:variable name="contents.pane">
+	  <html>
+		<head>
+		  <meta http-equiv="Content-Type" content="text/html; charset={$chunker.output.encoding}"/>
+		  <title>Contents Pane</title>
+		  <base target="main"/>
+		</head>
+		<body topmargin="0" leftmargin="0">
+		  <div align="left">
+			<img border="0" src="{$htmlhelp.frameset.graphics.path}cnttab.gif" width="58" height="20"/>
+			<xsl:if test="$generate.index">
+			  <!-- href points to a page that contains the index applet and tabs -->
+			  <a href="{$htmlhelp.frameset.index.pane.filename}" target="_self" accesskey="n" onfocus="self.location = '{$htmlhelp.frameset.index.pane.filename}'">
+				<img border="0" src="{$htmlhelp.frameset.graphics.path}cntidx.gif" width="40" height="20"/>
+			  </a>
+			</xsl:if>
+			<!-- BEGIN HTML HELP JAVA APPLET CODE -->
+			<br/>
+			<applet code="HHCtrl.class" width="600%" height="1200" 
+			  archive="HHCtrl.zip" name="HHCtrl" style="padding-top: 0">
+			  <param name="command" value="contents"/>
+			  <param name="item1" value="{$htmlhelp.hhc}"/>
+			  <param name="cabbase" value="HHCtrl.cab"/>
+			</applet>
+			<!-- END HTML HELP JAVA APPLET CODE -->
+		  </div>
+		</body>
+	  </html>
+	</xsl:variable>
+	<xsl:variable name="index.pane">
+	  <html>
+		<head>
+		  <meta http-equiv="Content-Type" content="text/html; charset={$chunker.output.encoding}"/>
+		  <title>Index Pane</title>
+		  <base target="main"/>
+		</head>
+		<body topmargin="0" leftmargin="0">
+		  <div align="left">
+			<a href="{$htmlhelp.frameset.toc.pane.filename}" target="_self" accesskey="C" onfocus="self.location = '{$htmlhelp.frameset.toc.pane.filename}'">
+			  <img border="0" src="{$htmlhelp.frameset.graphics.path}indexcnt.gif" width="54" height="20"/>
+			</a>
+			<img border="0" src="{$htmlhelp.frameset.graphics.path}indextab.gif" width="46" height="20"/>
+			<br/>
+			<!-- BEGIN HTML HELP JAVA APPLET CODE -->
+			<applet code="HHCtrl.class" width="1200%" height="1200" 
+			  archive="HHCtrl.zip" name="HHCtrl" style="padding-top: 0">
+			  <param name="command" value="index"/>
+			  <param name="background" value="FFFFFF"/>
+			  <param name="item1" value="{$htmlhelp.hhk}"/>
+			  <param name="cabbase" value="HHCtrl.cab"/>
+			</applet>
+			<!-- END HTML HELP JAVA APPLET CODE -->
+		  </div>
+		</body>
+	  </html>
+	</xsl:variable>
+
+	<xsl:call-template name="write.chunk">
+	  <xsl:with-param name="content" select="$topic.pane"/>
+	  <xsl:with-param name="filename" select="$htmlhelp.frameset.start.filename"/>
+	</xsl:call-template>
+	<xsl:call-template name="write.chunk">
+	  <xsl:with-param name="content" select="$contents.pane"/>
+	  <xsl:with-param name="filename" select="$htmlhelp.frameset.toc.pane.filename"/>
+	</xsl:call-template>
+	<xsl:if test="$generate.index">
+	  <xsl:call-template name="write.chunk">
+		<xsl:with-param name="content" select="$index.pane"/>
+		<xsl:with-param name="filename" select="$htmlhelp.frameset.index.pane.filename"/>
+	  </xsl:call-template>
+	</xsl:if>
+
+  </xsl:template>
+
+
+  <xsl:template name="hhc-main">
+	<xsl:text disable-output-escaping="yes">&lt;HTML&gt;
+	  &lt;HEAD&gt;
+	  &lt;/HEAD&gt;
+	  &lt;BODY&gt;
+	</xsl:text>
+	<!-- Adding support for frameset style help -->
+    <xsl:text disable-output-escaping="yes">&lt;OBJECT type="text/site properties"&gt;
+	  &lt;param name="FrameName" value="main"&gt;
+	  &lt;param name="Window Styles" value="0x800025"&gt;</xsl:text>
+	<xsl:if test="$htmlhelp.hhc.folders.instead.books != 0">
+	  <xsl:text disable-output-escaping="yes">&lt;param name="ImageType" value="Folder"&gt;</xsl:text>
+	</xsl:if>
+	<xsl:text disable-output-escaping="yes">&lt;/OBJECT&gt;</xsl:text>
+	<xsl:if test="$htmlhelp.hhc.show.root != 0">
+	  <xsl:text disable-output-escaping="yes">&lt;UL&gt;
+	  </xsl:text>
+	</xsl:if>
+
+	<xsl:choose>
+	  <xsl:when test="$rootid != ''">
+		<xsl:apply-templates select="key('id',$rootid)" mode="hhc"/>
+	  </xsl:when>
+	  <xsl:otherwise>
+		<xsl:apply-templates select="/" mode="hhc"/>
+	  </xsl:otherwise>
+	</xsl:choose>
+
+	<xsl:if test="$htmlhelp.hhc.show.root != 0">
+	  <xsl:text disable-output-escaping="yes">&lt;/UL&gt;
+	  </xsl:text>
+	</xsl:if>
+	<xsl:text disable-output-escaping="yes">&lt;/BODY&gt;
+	  &lt;/HTML&gt;</xsl:text>
+  </xsl:template>
+
+
+  <xsl:template name="hhk">
+	<xsl:call-template name="write.text.chunk">
+	  <xsl:with-param name="filename" select="$htmlhelp.hhk"/>
+	  <xsl:with-param name="method" select="'text'"/>
+	  <xsl:with-param name="content"><![CDATA[<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
+		<HTML>
+		<HEAD>
+		<meta name="GENERATOR" content="Microsoft&reg; HTML Help Workshop 4.1">
+		<!-- Sitemap 1.0 -->
+	  </HEAD><BODY>
+		<OBJECT type="text/site properties">
+		<!-- Adding for frameset -->
+		<param name="FrameName" value="main">
+	  </OBJECT>
+		<UL>]]>
+		<xsl:if test="($htmlhelp.use.hhk != 0) and $generate.index">
+		  <xsl:choose>
+			<xsl:when test="$rootid != ''">
+			  <xsl:apply-templates select="key('id',$rootid)" mode="hhk"/>
+			</xsl:when>
+			<xsl:otherwise>
+			  <xsl:apply-templates select="/" mode="hhk"/>
+			</xsl:otherwise>
+		  </xsl:choose>
+		</xsl:if>
+		<![CDATA[</UL>
+	  </BODY></HTML>]]></xsl:with-param>
+	  <xsl:with-param name="encoding" select="$htmlhelp.encoding"/>
+	</xsl:call-template>
+  </xsl:template>
+
+  <xsl:template match="/">
+	<xsl:if test="$htmlhelp.only != 1">
+	  <xsl:choose>
+		<xsl:when test="$rootid != ''">
+		  <xsl:choose>
+			<xsl:when test="count(key('id',$rootid)) = 0">
+			  <xsl:message terminate="yes">
+				<xsl:text>ID '</xsl:text>
+				<xsl:value-of select="$rootid"/>
+				<xsl:text>' not found in document.</xsl:text>
+			  </xsl:message>
+			</xsl:when>
+			<xsl:otherwise>
+			  <xsl:message>Formatting from <xsl:value-of select="$rootid"/></xsl:message>
+			  <xsl:apply-templates select="key('id',$rootid)" mode="process.root"/>
+			</xsl:otherwise>
+		  </xsl:choose>
+		</xsl:when>
+		<xsl:otherwise>
+		  <xsl:apply-templates select="/" mode="process.root"/>
+		</xsl:otherwise>
+	  </xsl:choose>
+	</xsl:if>
+
+	<xsl:call-template name="hhp"/>
+	<xsl:call-template name="hhc"/>
+	<xsl:if test="($rootid = '' and //processing-instruction('dbhh')) or
+	  ($rootid != '' and key('id',$rootid)//processing-instruction('dbhh'))">
+	  <xsl:call-template name="hh-map"/>
+	  <xsl:call-template name="hh-alias"/>
+	</xsl:if>
+	<xsl:if test="$generate.index">
+	  <xsl:call-template name="hhk"/>
+	</xsl:if>
+	<xsl:if test="$htmlhelp.generate.frameset">
+	  <xsl:call-template name="generate.htmlhelp.frameset"/>
+	</xsl:if>
+  </xsl:template>
+
+
+</xsl:stylesheet>
+
diff --git a/contrib/xsl/applethelp/images/cntidx.gif b/contrib/xsl/applethelp/images/cntidx.gif
new file mode 100755
index 0000000000000000000000000000000000000000..88750d9a39544351ef3ededc06fda805d39f1215
GIT binary patch
literal 961
zcmZ?wbhEHb)L;-{_|5<V4Pe{=rW$~}hK2(`aOc3XQy>2S|6g5Qy?5{4d-v}BX8`g>
z!Dt8!wGjCIVZnkW4Gj(df$1ESh(Q#Ph9qajpDc_F415eaKv4!zo?zgZ#~{lg<FR4E
z!DbF&t(X%53!2&ml)dJ7Y<%S0$Yqpu=fuXv$NME2Ei4>1Ejc+^BY2fcC;x#{(+xtm
z^>|Kx<}+C@@!6WlPiZITYBzrR;u)0Twb-onSqW!C`sHP=3*{oTf-|oy3a(E(>Sd~W
zajoC>v|6puRpG0XW@edYi9Nl(F8TT?(dtjS*LJ5YE_1DVpnZP7&QB&ks~rXL2iwB8
J@o+F$0|176DiZ(z

literal 0
HcmV?d00001

diff --git a/contrib/xsl/applethelp/images/cnttab.gif b/contrib/xsl/applethelp/images/cnttab.gif
new file mode 100755
index 0000000000000000000000000000000000000000..61396e3366a3b422373f1a72f8ccc452c9bd544d
GIT binary patch
literal 999
zcmZ?wbhEHbv|<op_|5<V4Pe{=rW$~}hK2(`aOc3XQy>2S|6g5Qy?5{4d-v}BX8`g>
z!Dt8!wGjCIVZnkW4Gj(df$1ESh(Q#Ph9qajpDc_F415eaKv4!zo?zfO!XRrA;ILuA
z!DbF&t(YAF4-T*iD0|KE*tqCuw>YDX&4G=JkM}D$cga`^$uqEWd8~>#8MMT6if-~L
zol2ur4+aayGj}9EEj`<BWz809Ipu}deDiWK)ty_?&n{6YF1pfLoE5N=eMQ{eS0ZUw
z)(3BnJ1b?D6S^t+WStAwwZ{RgoUT4w^DAua-L3w&kC{rFzm40HxBDN@o$Utky9@Y#
xzdd256}GYNa?)Du?JpaT*%-^8UA@!Tcl|u)$E>=$OrBj@=)d?~j*$X`H2}*!JKq2R

literal 0
HcmV?d00001

diff --git a/contrib/xsl/applethelp/images/indexcnt.gif b/contrib/xsl/applethelp/images/indexcnt.gif
new file mode 100755
index 0000000000000000000000000000000000000000..d04de9efffc3bc499c92c2193290a03dc5049fcf
GIT binary patch
literal 1001
zcmZ?wbhEHbG-D89_|5<V4Pe{=rW$~}hK2(`aOc3XQy>2S|6g5Qy?5{4d-v}BX8`g>
z!Dt8!wGjCIVZnkW4Gj(df$1ESh(Q#Ph9qajpDc_F415eaKv4!zo?zfO#vscf<FR4E
z!DbF&t(X%V79MWqQu3PPv2oGSZV64kkP8bIAMaOi?vn8oTH?^h9<(av<ff&kryE4h
z%MsYT?Cfmq^hbA21}|ftqQl6+dSUYl{{>o|YI|2+NeiBC6>fLbQZ()A9Q#bKQcDxn
zz=d&B%WOY{uDQ85YC2mi*R(aax98oi`|1^*8nQL|rP*BXGL8E?D&D5WdP{7$x2xj+
zA>T^zjSr94d_UCtW=G+TZM8>NnXcaXE^>`WZ&zJr<(AB2&Hk(1WUIcuXkf4g0OgHA
AZ2$lO

literal 0
HcmV?d00001

diff --git a/contrib/xsl/applethelp/images/indextab.gif b/contrib/xsl/applethelp/images/indextab.gif
new file mode 100755
index 0000000000000000000000000000000000000000..322e4b48d4e95926a6f5239de88d1704e7bd97a0
GIT binary patch
literal 969
zcmZ?wbhEHb)MF4~_|5<V4Pe{=rW$~}hK2(`aOc3XQy>2S|6g5Qy?5{4d-v}BX8`g>
z!Dt8!wGjCIVZnkW4Gj(df$1ESh(Q#Ph9qajpDc_F415eaKv4!zo?zfu#vp4E;ILuA
z!DbF&Ef<Y~gywbuWv@9N8y~qa@bPEdIk9o^@qPu{N6ZTrIG&iS5!|OUbJNn(z1qH2
zEE6U@JKbk!f6Hd)=Viy{7-#=_!m(ws?<|HgHQ!Z*nU|L<b{E-HeQ5|<Ej`hRRnzo!
z*joSTMq6)vP7YrYe)*h^_M{~~i{m%8eT_0*6+O4`WM8S)blr=)otgiqYVP=O^N>Ej
Sa^A`c!&Arl-m<YUSOWn0p)PO$

literal 0
HcmV?d00001

-- 
2.50.1