</copyright>
<releaseinfo>$Id$</releaseinfo>
</chapterinfo>
-<title>Using XSL stylesheets to generate HTML Help</title>
+<title>Using the XSL stylesheets to generate HTML Help</title>
<?dbhtml filename="htmlhelp.html"?>
-<para>HTML Help (HH) is help-format used in newer versions of MS
-Windows and applications written for this platform. This format allows
-to pack several HTML files together with images, table of contents and
-index into single file. Windows contains browser for this file-format
-and full-text search is also supported on HH files. If you want know
-more about HH and its capabilities
look at <ulink
+<para>HTML Help (HH) is a help format used in newer versions of Microsoft
+Windows and applications written for that platform. The HTML Help format allows
+you to pack several HTML files together with images, a table of contents, and
+an index into a single file. Windows contains a browser for this file format
+and full-text search is also supported on HH files. If you want to know
+more about HH and its capabilities
, visit the Microsoft <ulink
url="http://msdn.microsoft.com/library/tools/htmlhelp/chm/HH1Start.htm">HTML
-Help pages</ulink>.</para>
+Help Start Page</ulink>.</para>
<section>
-<title>How to generate first HTML Help file from DocBook sources</title>
+<title>How to generate your first HTML Help file from DocBook sources</title>
-<para>Working with HH stylesheets is same as with other XSL DocBook
+<para>Working with the HH stylesheets is the same as with other XSL DocBook
stylesheets. Simply run your favorite XSLT processor on your document
-with stylesheet suited for HH:</para>
+with the HH stylesheet:</para>
<screen format="linespecific">saxon <replaceable>yourfile</replaceable> <replaceable>/path/to/stylesheets/</replaceable>contrib/htmlhelp/htmlhelp.xsl</screen>
-<para>If you are using XT processor, you should use stylesheet
+<para>If you are using the XT processor, you should use the stylesheet
<filename moreinfo="none">xthtmlhelp.xsl</filename> instead of
<filename moreinfo="none">htmlhelp.xsl</filename>.</para>
-<para>Stylesheet imports standard chunking stylesheet, thus set of
-HTML files is created in usual way. Other files are also created
-– <filename>htmlhelp.hhp</filename> is project file for HTML
-Help Compiler and <filename>toc.hhc</filename> holds structure of your
+<para>The stylesheet imports the standard chunking stylesheet, so a set of
+HTML files is created in the usual way. Other files are also created
+– <filename>htmlhelp.hhp</filename> is the project file for the HTML
+Help Compiler and <filename>toc.hhc</filename> holds the structure of your
document.</para>
-<para>Language identifier for whole HH file is taken from the top most
-element with <sgmltag class="attribute">lang</sgmltag> attribute in
+<para>The language identifier for the overall HH file is taken from the top-most
+element with a <sgmltag class="attribute">lang</sgmltag> attribute in
your DocBook source. This is perfectly legal for documents in only one
-language. If language is not specified in the document, US English is
-defaulted. There is one problem – MS language codes are country
-sensitive, and this information is not available in DocBook source. If
-the stylesheet selects bad code for you, edit
+language. If a language is not specified in the document, US English is
+used. There is one problem – MS language codes are country-sensitive,
+and this information is not available in the DocBook source. If
+the stylesheet selects a bad code for you, edit
<filename>langcodes.xml</filename>, and remove all entries which have
-yours language code, but are located in inappropriate country.</para>
+your language code, but are located in an inappropriate country.</para>
-<para>Title of whole HH file is taken from first title element in your
-document. Fulltext searching is automatically on. If your document
+<para>The title for the overall HH file is taken from the first title element in your
+document. Full-text searching is automatically on. If your document
contains index terms, they are automatically converted to HH ActiveX
-objects, which are recognized by HTML Help compiler.</para>
+objects, which are recognized by the HTML Help compiler.</para>
-<para>Stylesheet creates couple of files which are then used as an
-input for
HTML Help Compiler (HHC) which is part of <ulink
-url="http://msdn.microsoft.com/library/tools/htmlhelp/wkshp/download_main.htm">HTML
-Help Workshop</ulink>. If you have HHC in your path, you can start
-conversion to HH format by running command:</para>
+<para>The stylesheet creates couple other files which are then used as an
+input for
the HTML Help Compiler (HHC), which is part of <ulink
+url="http://msdn.microsoft.com/library/default.asp?url=/library/en-us/htmlhelp/html/hwMicrosoftHTMLHelpDownloads.asp"
+>HTML Help Workshop</ulink>. If you have HHC in your path, you can
+start conversion to the HH format by running this command:</para>
<screen format="linespecific">hhc htmlhelp.hhp</screen>
-<para>If you can not stand without your mouse, there is alternative
-way. Just double-click on <filename
+<para>If you cannot stand to work without using your mouse, there is alternative
+way. Just double-click on the <filename
moreinfo="none">htmlhelp.hhp</filename> file. HH Workshop will be
-launched automaticaly. Generation of HH file can be started by selecting
+launched automatically. Generation of the HH file can be started by selecting
<menuchoice moreinfo="none">
<guimenu moreinfo="none">File</guimenu> <guimenuitem
-moreinfo="none">Compile</guimenuitem> </menuchoice> from application's
+moreinfo="none">Compile</guimenuitem> </menuchoice> from the application's
menu.</para>
</section>
<section>
<title>Enabling navigation links</title>
-<para>By default, HTML Help stylesheet disables navigation links at
-the start and the bottom of each page. If you want to enable this
-
feature, start your XSLT processor with parameter <parameter
+<para>By default, the HTML Help stylesheet disables navigation links at
+the start and the bottom of each page. If you want to enable the
+
links instead, start your XSLT processor with the parameter <parameter
moreinfo="none">suppress.navigation</parameter> set to 0.</para>
<screen format="linespecific">saxon <replaceable>yourfile</replaceable> <replaceable>/path/to/stylesheets/</replaceable>contrib/htmlhelp/htmlhelp.xsl "suppress.navigation=0"</screen>
-<para>Another approach is to create driver file, which overrides
-default parameter value.</para>
+<para>Another approach is to create a driver file, which overrides
+the default parameter value.</para>
<programlisting><
projects / docbook-dsssl / commitdiff