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

Hash: SHA1

On 01/27/2012 10:01 AM, Stefan Hinz wrote:
> Hi David,
> Excuse me for being dense, but are you saying you've put that
> empty template in the SVN version of the XSL style sheets? If so,
> will that change be in the next release of the DocBook style
> sheets?

Yes, the xsls in svn but not yet part of a release are available for
evaluation as part of the snapshot builds. For now, you can use this
url to download the snapshots:


Eventually http://snapshots.docbook.org will take you there.

> Also, I wonder how user.webhelp.head.content is supposed to work.
> You're saying it's called at the end of user.head.content, so I
> would assume it becomes part of that template. But if that's
> correct, it would just *add* stuff to the user.head.content
> template, rather than replacing what's there. This wouldn't make
> much sense. Apparently, I'm missing something.

Yes, the idea is that these empty templates hooks that allow you to
add stuff. In this case it adds whatever you want to user.head.content
at the end in the same way that user.head.content adds stuff to
system.head.content in the base xsls. For example, you might want to
add your own <script> elements to support additional custom
functionality or your own css.

To modify stuff within user.head.content without overriding it, I have
to parameterize it for  you.

> You asked for things that we should be able to
> configure/customize. Here's a list:
> (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.

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



> That's about it for the moment. :-)
> Thanks, and have a great weekend!
> Cheers,
> Stefan
Version: GnuPG v1.4.11 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/


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