HTML for help.ubuntu.com/11.04 (Re: Custom Mallard XSLT)

[Shaun McCance]

On Thu, 2011-04-28 at 23:34 +0100, Matthew East wrote:
> On 16 April 2011 20:43, Shaun McCance <shaunm at gnome.org> wrote:
> > At Jim's request, I cooked up some XSLT/CSS customization for the
> > yelp-xsl Mallard stylesheets. These are designed to create HTML
> > that fits with the overall Ubuntu look for the web. Probably a
> > fair amount of work needs to be done yet to integrate this into
> > help.ubuntu.com. I don't know how to do that off-hand.
> 
> I've done some work on this, with quite a lot more hand-holding from
> Shaun, and pushed it to the natty branch. To test it, run "make
> gnome-help" from the "libs" directory in the branch.
> 
> The output is here:
> 
> http://doc.ubuntu.com/~mdke/natty/
> 
> It's pretty much ready to go. To-do items include:
> 
> 1. On the index page, the mouseover images are not working. They did
> in Shaun's version so I have screwed something up. I can't immediately
> figure out why this is happening so anyone with some html/css/xsl
> knowledge would be very helpful if they could take a look. All the
> code is in libs/ubuntu.xsl.

So the CSS attributes on the body element in yelp-xsl 3.0.0
were kind of crap, and they caused weirdness in the positions
of the mouseovers. And because I did the mouseovers in a mad
rush in Toronto, with Jim and Phil standing over me yelling
"Code! Code! Code! Code!", I hacked around the weirdness with
some crap JavaScript instead of addressing the CSS problem.

I fixed that:
http://git.gnome.org/browse/yelp-xsl/commit/?id=134770554701befbff0f6f6a2476ca5c7345d25a

You'll also notice you don't have proper titles on some of
the topic links. This is because the cache-making code was
failing to make a plain link title when there's a link title
with a role. Also fixed:
http://git.gnome.org/browse/yelp-xsl/commit/?id=25000a8808bbe80f64a25dfb93a5ae9e18195e93

Both of these fixes are in yelp-xsl 3.0.1. If it's at all
possible for you to do your builds with 3.0.1 instead, it
will save you a lot of headache.

--
Shaun