OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]

Subject: RE: DOCBOOK-APPS: Generating CHM HTML Help files from DocBook?

Jirka has indeed created a nifty piece of work. I'm not much farther along
than you are, but can respond to a few items:

1. Download Microsoft's HTML Help Workshop
tml/hwMicrosoftHTMLHelpDownloads.asp . Just open the generated .hhp file in
this tool, fix the TOC and a few other things, and recompile. You could
probably use Robohelp, ForeHelp, as a front end, too.

2. Linux? Please correct me if I'm wrong, but as far as I know, HTML Help is
for Windoze only.

3. Be careful when you run htmlhelp.xsl to back up files that require
hand-tweaking, like the project file itself and external files like the TOC.
So far I've customized the stylesheet to add the alias and .h files required
for mapping topics to context-sensitive GUIs; otherwise you have to add
these to the .hhp manually each time. Now if I can just figure out how to
use the DocBook TOC elements, I'm hoping that authors can code the TOC
correctly in the XML source so that it gets generated correctly.

Hope this is helpful,

Denis Bradford 
Rational Software, 20 Maguire Road, Lexington, MA 02421
denisb@rational.com (781)676-7560
Superstition: the religion of others -- Ambrose Bierce

-----Original Message-----
From: Dan York [mailto:dyork@e-smith.com]
Sent: Wednesday, August 08, 2001 8:41 AM
To: docbook-apps@lists.oasis-open.org
Subject: DOCBOOK-APPS: Generating CHM HTML Help files from DocBook?


Now that we (e-smith) are part of Mitel Networks, I have been 
working with their documentation folks to bring our docs in line 
with what they are doing.  They turn out to mostly use tools like
RoboHelp to generate Microsoft HTML Help or RoboHelp "WebHelp" files.

Without really having a clue about what I was doing, I generated  (from
my DocBook XML source) a set of HTML Help files using Norm's htmlhelp
XSL stylesheets, zipped them up and sent them off to the folks there.
They were able to very easily generate a single ".chm" help file and 
were quite impressed with the output (although they said the TOC was
a bit funky).  So I have a couple of questions for anyone on the list
who has worked with HTML Help:

 1. Are there any free/open-source apps that can take HTML Help files
    and generate this single CHM file?  If not free/oss, are there
    any utilities that Microsoft supplies that do this?

 2. If so, are there any that run on Linux and can be scripted from
    the command line?  (I am envisioning adding another target to my
    Makefile so that "make all" builds not only HTML (chunked and
    single-page) and PDF, but also HTML Help.)

 3. Any other pointers or tips that people may have from working with
    Norm's HTML Help stylesheets?

Thanks in advance,

Dan York, Director of Training        dyork@e-smith.com
Ph: +1-613-751-4401  Mobile: +1-613-263-4312 Fax: +1-613-564-7739 
Mitel Networks Corporation Network Server Solutions Group 
150 Metcalfe St., Suite 1500, Ottawa,ON K2P 1P1 Canada
http://www.e-smith.com/            open source, open mind

To unsubscribe from this elist send a message with the single word
"unsubscribe" in the body to: docbook-apps-request@lists.oasis-open.org

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]

Powered by eList eXpress LLC