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: 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
parameter use.id.as.filename=1:

  <chapter id="installation">

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

  Jirka Kosek  	                     
  e-mail: jirka@kosek.cz

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

Powered by eList eXpress LLC