[Debian-handbook-translators] Fwd: Merge request from Weblate

[Raphael Hertzog]

Hi,

On Mon, 20 May 2013, Matías Bellone wrote:
> 1- When making references, the text displays as "Section X, "TITLE"
> (page Y)". The text is indeed translated to Spanish and the "page Y"
> does use the translated template in the XSL. But the text itself is
> wrong, to start with the title should be within angular quotes («»)
> instead of double quotes ("").

http://www.sagehill.net/docbookxsl/CustomGentext.html
http://www.sagehill.net/docbookxsl/CustomXrefs.html

Here's the doc on how you can customize those generated texts. I already
use them a bit to fix references to sidebars as you noticed. You should
be able to fix other generated texts.

> 2- More importantly, in that same text, the text is missing a
> connector. The original text is something like "see <xref ...>" that
> results in "see Section...", when I translate it to Spanish I kept the
> same structure "revise <xref ...>", but when that results in "revise
> Sección.." it is wrong and should be "revise la Sección..." but that
> is only because it starts that way, if only the title was used it
> "revise «title»" would be correct.
> 
> I know that I can change the translation itself (adding "la" before
> the xref), but I'd rather it was a translateable template, just as the
> sidebars.Mostly in case that text or format changes in the future
> ("revise la «title»" would be wrong). Not sure if that is possible
> though.

It's not possible. You should fix the translations. I ensured that we are
always consistent in always using the same form of links starting with
Section or Chapter for such references... both for the HTML and the PDF
version.

> 3- Sidebar references have an extra space in them. While the XSL
> states "«%t»" all references have a space between the « and the title
> itself :S

This is a LaTeX problem however. I'm not quite sure how to fix it. In
theory the babel modules are supposed to do the right thing in regards
to typography...

Cheers,
-- 
Raphaël Hertzog ◈ Debian Developer

Get the Debian Administrator's Handbook:
→ http://debian-handbook.info/get/