Re: [docbook-apps] How to put a link at top of generated web help page

[David Cramer <david@thingbag.net>]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On 05/25/2012 10:12 AM, Derek Van Kooten wrote:
> So, I got my build process to generate a webhelp site and a pdf document
> from my docbook document. All is looking great. I figured out how to
> change the logo  and some of the colors on the generated site. Now, last
> thing I have not figured out yet. How can I put a link on the top of all
> those generated webhelp pages to point to some location, for example, my
> pdf file. I see that this has been done already on some example sites.  
> http://wiki.docbook.org/WebHelp  
> 
> I like this
> one http://fusesource.com/docs/ide/2.0/user_guide/RiderGSEclipseRun.html# it
> has print and email buttons. Very nice!
> I would like to do the same and also a link to my generated pdf document.

So that's not currently an out-of-the-box feature, though someday it
should be. You'll have to do two things:

1. Figure out what you want the output to look like. I.e. do the webdev
work on the generated html till you're happy with the result.

2. Customize the xslts so that they produce that. You'll probably want
to add a parameter like "pdf.url" so you can pass in the name of the pdf
file name.

For #2, Bob's book is handy. It doesn't yet have information about
webhelp, but the general information about creating a customization
layer [1] applies. In fact, webhelp is a customization layer on top of
the xhtml xslts.

In your customization layer you can add the various extra things you
want: the pdf icon, calls to google analytics, some third-party
commenting system, etc. The cost is a little merge pain the next time
you upgrade the base xslts.

If #2 isn't something you're up to, you can pay someone to do it for you
[2].

David

[1] http://www.sagehill.net/docbookxsl/CustomMethods.html
[2] http://wiki.docbook.org/DocBookConsultancy
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iQEcBAEBAgAGBQJPv6cTAAoJEMHeSXG7afUhQFoH/1qCdqG1GBfSJ+MmeWfhRbDX
ms2l7hsb2CftzKajQzuSbDoecRb/JjIEmYCu5SZhQb+ZQO1+RihB3xOdiT9oC6pA
sbBhn9vqc0D7lDIIDLxMsvH+SsbX5vZ3yWX7Wq/TljL9PJcfpoTkE1GyGy2E9Idn
QMMhUozKTpSmaYpaQ66UlRRGKmihFKHnA4OJAxA0UgVk/cttqIX+f892emscm0jJ
chwN8aRK0+n2CB9P5ThJ+HoQGuWFMqPlMFLYdYngzNPCjFmEoAXB/rNdSOeJcMka
F3/t+q7nNh46vnM0rolLT4rEhQieteu1vO0WlMtxUqVkznEegMndmPBa5pgYHyg=
=gq5X
-----END PGP SIGNATURE-----