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