Yelp front page

[Don Scorgie]

Back again.

On Tue, 2006-04-04 at 16:36 +0100, Matthew East wrote: 
> On Tue, 2006-04-04 at 15:12 +0100, Don Scorgie wrote:
<snip> 
> 
> Thanks so much for this. One thing I'm slightly concerned about is that
> it means that if (in a future release) the series ID changes or new
> documents appear, we need to remember to maintain this patch. Do you
> consider this problematic?

On IRC, Matt asked me to look at adding a description to categories in
the Yelp TOC, whch I've now done in the attached patch.  A screenshot of
this can be found at:
http://www.donscorgie.pwp.blueyonder.co.uk/Yelp-with-desc.png

I've tried to distinguish a little between topics and documents by not
adding a bit of space before them (if this makes sense).  This is all
done in CSS in the stylesheet, so its easily changed if desired.

Sorry for the every-growing size of the patch, but I'm (rather
foolishly) making all the changes in one copy of the source tree, so
this (as before) includes all the previous changes:
* Ubuntu docs are now at the top
* Message added before categories
* Sorting docs in alphabetical order
* categories have description

Other things:
The category descriptions are all translatable.  I've only added the 4
visible on the screenshot (i.e. the 4 on the front page) but others can
be easily added.  As can be seen, I've used PLACEHOLDER strings as I
don't really know what text to add to each category.  All the strings to
be changed are in data/toc.xml.in except the "Command Line Help"
description, which is in src/yelp-toc-pager.c (look for PLACEHOLDER).

As for the question of the series ID changing, ye, it is probably a bad
thing however hopefully the table of content might be redesigned in
(GNOME) 2.15 to make this patch obsolete (at least that's one of my
current goals for 2.15, when I'm not being sidetracked into doing
patches for Ubuntu ;) ).  I don't know of a better way of doing this
using the omf files but if someone does (i.e. a property that we can
abuse to keep a score in) I'd be happy to hack this into the code.  I've
left this part in for now.

Enjoy
Don
-------------- next part --------------
A non-text attachment was scrubbed...
Name: yelp-toc-with-desc.patch
Type: text/x-patch
Size: 8815 bytes
Desc: not available
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20060404/36cdbddd/attachment.bin>