Comment 11 for bug 76944

Revision history for this message
Matthew East (mdke) wrote : Re: [Bug 76944] Re: Improve yelp index layout

On Thu, February 1, 2007 2:40 pm, Don Scorgie wrote:
> ... and here's where the delicate surgery possibly comes in (sorry!).
> The current 06 patch has various things in it to reorder the front page
> (in yelp-toc-pager.c). Not sure if these docs will be visible anywhere
> in the new TOC structure (Matt?).

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.

> Having said that, I think it might be better to get the links in the
> patch working properly first. Right now, they all point to
> "placeholder" which will break things nicely.
>
> Also, another comment: If the links are pointing to ghelp uris, they
> don't need to be translated as yelp will take care of them. This means
> they can be removed from toc.xml.in and hard-coded into the XSLT. This
> saves confusing translators and cuts down on potential translation
> errors. I'll try and update the patch somewhat today.

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.

Matt
--
http://www.mdke.org
gnupg pub 1024D/0E6B06FF