Re: [docbook-apps] webhelp.xsl customizations

[Denis Bradford <denis.bradford@verizon.net>]

I didn't realize the jquery css file was intended for overrides, either. 
So my solution was to add a link to my custom CSS style sheet at the end 
of the user.head.content template, after all the stock css and js files. 
That way, my CSS rules take precedence.

- Denis

On 01/28/2012 10:35 AM, Kasun Gajasinghe wrote:
> > > (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