Re: [Po4a-devel] [help-texinfo] @xref best practices for i18n/l10n
On Fri, Sep 22, 2017 at 06:48:18AM +0900, Jean-Christophe Helary wrote:
I'm working on a manual written in texinfo and I found a string
similar to this:
@xref{node name} and following.
Once compiled, the document becomes ???See "node name" and following???.
When translating to a language that puts the verb at the end, like Japanese (and I guess
German and others would have the same issue) the final document must be rendered as:
???"node name" and following See???
My understanding of @xref is that it is not possible, so we should avoid to put stuff
after "node name".
Use @ref instead of @xref if you need to be flexible with the word
order.
Also, does makeinfo use "translation tables" to create the
proper localized string for such devices as xref?
Yes, that's right. Use the @documentlanguage command for this.