Re: Using conditional expressions in Gnome documentations

[Gabor Kelemen <kelemeng gnome hu>]

2012-12-05 22:00 keltezéssel, Shaun McCance írta:
> On Wed, 2012-12-05 at 21:32 +0100, Gabor Kelemen wrote:
> > Hi
> >
> > I have just filed a bug[1] that can be solved by using conditional
> > expressions in the xml. I saw several places in the 3.6 branch where
> > these were used to include Ubuntu-specific changes, so I thought it is a
> > good idea to add one more.
> >
> > But now I see that the number of such conditional expressions was
> > recently reduced[2], so I started to wonder why did this happen?
> >
> > Was this reduction intentional for some technical reason, or was this
> > just an oversight and I should file a bug about it?
>
> We stripped the Unity conditionals out of gnome-help because it
> doesn't get used under Unity. If you're running Unity, you'll
> see ubuntu-help instead.

I see, thanks for the explanation. I hoped that the forking madness can 
come to an end, looks like this was unfounded :(.

> It makes sense for standalone application help.

Okay, I'll submit patches :).

> Two notes:
>
> 1) You can actually use help: links inside xref. That leaves
> href available to provide an http: link.
>
> <link xref="help:gnome-help/a11y"
> href="http://library.gnome.org/users/gnome-help/stable/a11y.html";>
> Universal Access Help</link>

Thanks, I'll use this.

> The href will be used by straight HTML builds, such as on
> library.gnome.org.

There was also a bug about the ghelp: links not working on l.g.o, maybe 
that could be solved better this way?
https://bugzilla.gnome.org/show_bug.cgi?id=655643

> 2) We're really making translators lives unpleasant by having
> nearly identical duplicate strings, where the only difference
> is a URL they shouldn't change anyway. We could do something
> like this:

I'm in to reduce the number of strings. However, this doesn't seem to 
work for me:

<p>Read the <link xref="help:ubuntu-help/a11y" 
href="http://library.gnome.org/users/gnome-help/stable/a11y.html"; 
xmlns:its="http://www.w3.org/2005/11/its"; its:withinText="yes">Universal 
Access Help</link></p>

Running itstool on the above results in this:

#: C/index.page:25(when/p)
msgid "Read the <link xref=\"help:ubuntu-help/a11y\" 
href=\"http://library.gnome.org/users/gnome-help/stable/a11y.html\"; 
withinText=\"yes\">Universal Access Help</link>"

What am I doing wrong?

> I'm not sure what sucks more for translators.

My vote is on the largely identical strings.

Regards
Gabor