OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: Re: [docbook-apps] webhelp.xsl customizations

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.



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

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


Yeah, that had occurred to me too.

(2)<link rel="stylesheet" type="text/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
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"

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



That's about it for the moment. :-)

Thanks, and have a great weekend!


Version: GnuPG v1.4.11 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/


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


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

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]