Problem localizing xref generated text in help docs
- From: Pauli Virtanen <pauli virtanen hut fi>
- To: gnome-i18n gnome org, gnome-doc-list gnome org
- Cc:
- Subject: Problem localizing xref generated text in help docs
- Date: Fri, 6 Aug 2004 03:16:00 +0300
Hello,
I am currently attempting to translate a bit of Gnome's help Docbook
documentation to Finnish, but bumped recently into a slight problem with
the <xref> tag.
In brief, the text generated by <xref> breaks Finnish sentences, and I
am not aware of any other way to create automatically numbered
cross-references.
A longer explanation. As you probably know, <xref linkend="some-figure-id"/>
generates the text
Figure 3-1
which is also a link pointing to the figure. Now, by filling up the .po
file in yelp (and by this the l10n.xml), I can translate the above to
Kuva 3-1
So far so good. However, I would also like to translate constructs such
as
... in <xref linkend="some-figure-id"/>
which in English generates
... in Figure 3-1
Now, for Finnish I would like the result to be the correct
... kuvassa 3-1
but instead I only get
... Kuva 3-1
which is not correct: first, the declination of the word is wrong.
Second, its capitalization is invalid. It might be possible to make this
look correct by rearranging the sentence in a special way, but in some
cases this results in unnatural and clunky language, and the bad
capitalization still looks ugly.
The real problem is that I do not know a way to adjust the word <xref>
generates. The tag does not seem to have any attribute which could be
used to set the word in front of the numbering. Moreover, I also browsed
the Docbook documentation, but didn't find a way to create a
cross-reference with only the numbers.
One way around this is of course to use <link> and maintain the
numbering of figures, sections, etc. manually, but this undoubtedly
would become a bit of a pain in the long run. Perhaps yelp's style
sheets could be modified to allow a way to override the default <xref>
word? However, I am not very familiar with Docbook so I don't know how
this should be done.
Do you have suggestions on how to work around this problem? Or an
obvious way (which I missed) to generate cross-references in Docbook,
but with only the numbers?
Pauli Virtanen
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]