RE: [docbook-apps] First post, first questions

["David Cramer" <dcramer@motive.com>]

Thomas,
The link to the applethelp stuff changed when the project switched from
cvs to svn. It hasn't been updated in a while, so may need some changes
to synch it up with the latest version of the xsls:

http://docbook.svn.sourceforge.net/viewvc/docbook/trunk/contrib/xsl/appl
ethelp/

But let's back up a bit. Depending on your needs, there might be a
better way to do it. For example, here's an example of someone using a
tree control library to do the toc pane:

http://lists.oasis-open.org/archives/docbook-apps/200804/msg00074.html
http://lists.oasis-open.org/archives/docbook-apps/200804/msg00095.html
 
The applethelp stuff gives you a toc and index tab in a nav pane, but I
don't recall (and doubt) if it gives you deep linking or synching of the
toc and suspect it would be difficult to add. 

It could be that you'd be better off starting with a javascript tree
control thingy. You could then add some code to support deep linking to
a topic (such that the toc pane still appears) and for a synch toc
button.

So first off, what features do you need?

David

> -----Original Message-----
> From: Thomas Gier [mailto:mail@thomasgier.de] 
> Sent: Wednesday, April 23, 2008 7:53 AM
> To: DocBook-Apps List
> Subject: [docbook-apps] First post, first questions
> 
> Hello list,
> 
> after 3 or 4 years of DocBook abstinence I'm now with a 
> company where they let me work out a concept and decide on 
> the tool chain. From what I read on the net I understand that 
> lots of improvements have been made on the DocBook 
> stylesheets since I last laid a hand on one and I seem to 
> have to learn quite a bit - perfect.
> 
> I'm thinking of not only publishing PDF but also WebHelp 
> using the DocBook 5 stylesheets. From this article [1] I 
> learn, that WebHelp is generally possible. Fine. 
> Unfortunately the link to SourceForge is broken in this 
> article but fortunately I found applethelp.xsl on Krugle [2]. 
> Fine again.
> 
> But anything I found regarding applethelp.xsl are comments on 
> this list from around 2004, which makes me wonder if I'm on 
> the verge of using outdated techniques. So here are my questions:
> 
> - Is there another way to create WebHelp from DocBook files?
> - Is the version of applethelp.xsl on krugle the latest?
> 
> Now I go trying to make applethelp.xsl to work unless someone 
> more knowledgeable than me stops me from trying ...
> 
> Thanks in advance for any comments.
> 
> Best regards
> Thomas Gier
> 
> --
> Technical writer
> Aachen, Germany
> 
> [1] http://www.scottnesbitt.net/techdocs/WebHelp_with_DocBook.html
> [2] http://www.krugle.org/kse/files?query=applethelp#6
> 
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: 
> docbook-apps-help@lists.oasis-open.org
> 
>