[Bug 76944] Re: Improve yelp index layout

[Don Scorgie]

Updated slightly.  Moves the "Can't find the answer" link to be
localisable.  Cleans up the XSLT somewhat.  Moves the ghelp uris to
XSLT.

> Well, I'm slightly lost, but if you're referring to the documents which
> will appear in the "Topics" in the left hand column, then yes, we'll wish
> to retain the ability to customise the order in which these appear.
> However, this can be done later. The yelp which is currently in feisty has
> not yet been updated with the new order of documents/topics.

The topics are all hand-crafted in the data file.  They can go in any
order.  I was referring to the current Ubuntu docs patch that puts the
user-guide at the top in the right hand side of the current index.

> What are you referring to here by "links"? We'll probably want to retain
> the ability for translators to localise links to support resources on the
> internet, where for example their community provides free support for that
> language.

Links pointing to internet resources can (and should) remain where they
are.  However, local links (pointing to docbook files) are referenced
using ghelp:foo#bar.  In that case, yelp does some magic to choose the
correct language to display these in [1].  They don't need to be
localised.  Its a little more pain when making changes (as 2 files need
to be edited), but saves other errors occurring.  Anyway, I've made the
changes to do that in this patch, so you can see how it works.

Don

** Attachment added: "Update"
   http://librarian.launchpad.net/6116373/yelp-update.patch

-- 
Improve yelp index layout
https://launchpad.net/bugs/76944