Re: [docbook-apps] webhelp.xsl customizations

[Stefan Hinz <stefan.hinz@oracle.com>]

Hi Denis,

> 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.

Implicit CSS precedence, fair enough. :-) You could also use explicit 
precedence, i.e. setting things !important that shouldn't be overridden. 
In that case, the sequence in which CSS files are included wouldn't matter.

Cheers,

Stefan

> 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
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org


--
Cheers,

Stefan Hinz <stefan.hinz@oracle.com>, MySQL Documentation Manager

Phone: +49-30-82702940, Fax: +49-30-82702941, http://dev.mysql.com/doc

ORACLE Deutschland B.V.&  Co. KG
Registered Office: Riesstr. 25, 80992 Muenchen, Germany
Commercial Register: Local Court Of Munich, HRA 95603
Managing Director: Jürgen Kunz

General Partner: ORACLE Deutschland Verwaltung B.V.
Hertogswetering 163/167, 3543 AS Utrecht, Niederlande
Register Of Chamber Of Commerce: Midden-Niederlande, No. 30143697
Managing Directors: Alexander van der Ven, Astrid Kepper, Val Maher