Re: [docbook-apps] webhelp.xsl customizations

[Kasun Gajasinghe <kasun.gajasinghe@gmail.com>]

>> (1) <style type="text/css">: I'd suggest to put that in a CSS file.
>> The template already links 3 CSS files, so adding another one
>> shouldn't be an issue.

Two points.

First, all the css styles in the latter part of the <style> section of
webhelp.xsl are there to over-ride some styles in defined in
jquery-ui-1.8.2.custom.css. The point is, the said jquery css file is
'untouched' meaning you can upgrade it easily without hassle. (All
these over-ride css starts with .ui* which makes it easier to
identify.)

Second, if you think there's a better to do the said over-riding,
please consider moving these into the positioning.css file. That's a
better option rather than adding another http request. The naming of
the file may not be exact on its purpose, but that's where all the
docbook webhelp related styles reside.

Glad to hear that you are interested in docbook webhelp Stefan. BTW,
the best place to send contributions is to use the DocBook tracker for
patches at sourceforge. [1]

[1] http://sourceforge.net/tracker/?group_id=21935&atid=373749

Regards,
--Kasun

>
> Yeah, that had occurred to me too.
>
>> (2) <link rel="stylesheet" type="text/css"
>> href="../common/jquery/theme-redmond/jquery-ui-1.8.2.custom.css"/>:
>> As said before, this is probably high on anyone's list of things to
>> be customized.
>>
>> (3) <script type="text/javascript"
>> src="../common/jquery/jquery-1.4.2.min.js"> and <script
>> type="text/javascript"
>> src="../common/jquery/jquery-ui-1.8.2.custom.min.js">: This should
>> be configurable because it contains version numbers. Hard-coding
>> makes it harder to upgrade jQuery JavaScript.
>
> Ok, that's easy enough to parameterize those two.
>
>> (4) <script type="text/javascript"
>> src="{concat('search/stemmers/',$webhelp.indexer.language,'_stemmer.js')}">:
>>
>>
> While the integrated jQuery search works great for simple searches, I
>> hear that the stemmer-based search isn't really useful ATM, so
>> that would be a candidate for stuff to turn off.
>
> So the stemmer has been improved recently to fix some bugs, so check
> it out again. To disable stemming, just set the indexer language to an
> unsupported langauge, e.g.:
>
> webhelp.indexer.language=zz
>
> David
>
>> That's about it for the moment. :-)
>>
>> Thanks, and have a great weekend!
>>
>> Cheers,
>>
>> Stefan
> -----BEGIN PGP SIGNATURE-----
> Version: GnuPG v1.4.11 (GNU/Linux)
> Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/
>
> iQEcBAEBAgAGBQJPI+nrAAoJEMHeSXG7afUhGCkH/0+YYcsC2fpwd/KHeG6tBXTD
> JGt4s1qQjQFRTUwz9tDF6R5rtVDW1h06jWwxwxRCBe2wdHbD5d+8nLVXD7rm3seJ
> yuuCgiaSyNKcG0XvpRLmeSUNXw5P6uLImIZwUohBq6CnRdOQMO6vDXKmkVIPBLlp
> mMxmzXbDhy2KSKdsu/jUFcLAI9l3SBveTyslVoa6Nh2Wg9u6J3nBo76lnm4JipgF
> oT9uO6FAuwHPwD+mJGuQoA/lwFKpnYKMZnBT6+nWSUwHOQF0caeR9j6ph0y7RhwI
> KzbPiGvrI5qutEB5KYcUVy9dQNSjwtW8Lktg9XuulQXCUy4f7AHZEFK6ZzDef1E=
> =CJKM
> -----END PGP SIGNATURE-----
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
>

-- 
~~~*******'''''''''''''*******~~~
Kasun Gajasinghe,
University of Moratuwa,
Sri Lanka.
Blog: http://kasunbg.blogspot.com
Twitter: http://twitter.com/kasunbg