This is the mail archive of the mailing list .

Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]

Re: HTML Help (htmlhelp.xsl) topic ids

"Bradford, Denis" wrote:

> htmlhelp.dsl's chunking algorithm generates HTML files using names based on
> the node number in some tree. From the point of view of creating context
> help, the names may as well be random: one day a topic is named c25.html,
> and the next time I do a transform, the same topic is c19.html.
> Maybe this doesn't matter if you want to use HTML Help as a standalone
> browser. But it seems an impediment to using it for application help. In
> order for us to maintain links from an application to specific help topics,
> I think the generated files names need to be keyed to something meaningful,
> or at least predictable  - say, an id attribute or an external data file.
> Is the solution a style sheet customization, as you say? Either way, I don't
> know from dsssl (still trying to get htmlhelp.xsl working), so any light on
> the subject would be most welcome. Worst case, I know you're looking at
> DocBook's use for online applications, maybe this is an RFE worth looking
> at.

If you wan to get reasonable filenames of HTML chunks using XSL HTML
Help stylesheet you can do it two ways:

1. Add special processing instruction right after each start tag which
should produce chunk with some specific name:

  <?dbhtml filename="installation.html"?>

2. Add filenames as IDs to your document and then call stylesheet with

  <chapter id="installation">

  saxon document.xml .../path/to/htmlhelp/htmlhelp.xsl

  Jirka Kosek  	                     

Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]