Note to translators in NatNum12 help files

l10n
#1

Hi all,

In the patch for NatNum12 function's help, there is a note for
translators that I copy and paste here (thanks Laszlo for adding it):

#2

Hi Sophie, Dear translators

I must admit I got quite confused (and the subject is confusing indeed).

The page is this one:

https://help.libreoffice.org/6.2/en-US/text/shared/01/05020301.html?&DbPAR=CALC

and my master build shows nothing when [NatNum12] is used.

Some questions:
1) Where are these XML files?
2) Is there a working example?
3) Should the help content give examples?

Help welcome, the numbertext feature is a must and deserves better
description and usage contents.

Kind regards
Olivier

#3

Hi,

Thanks, Sophie, forwarding the description. Thanks, Olivier, for the link.
There is the new NatNum12 description at the end of the page.

Hi Sophie, Dear translators

I must admit I got quite confused (and the subject is confusing indeed).

The page is this one:

https://help.libreoffice.org/6.2/en-US/text/shared/01/
05020301.html?&DbPAR=CALC

and my master build shows nothing when [NatNum12] is used.

It needs a zero at least to get a format code, for example, "[NatNum12
ordinal]0" will spell out the number as an ordinal number. Likely, it's
better to add these zeroes to the translations, and to the English
originals, according to the table header "Formatting code".

Some questions:
1) Where are these XML files?

source/text/shared/01/05020301.xhp
<https://gerrit.libreoffice.org/#/c/55708/6/source/text/shared/01/05020301.xhp>
in helpcontent2

2) Is there a working example?

I have just attached the following test document to the issue (
https://bugs.documentfoundation.org/show_bug.cgi?id=115007):

https://bugs.documentfoundation.org/attachment.cgi?id=143595

(Screenshot of the document:
https://bug-attachments.documentfoundation.org/attachment.cgi?id=143596)

3) Should the help content give examples?

The recent help content lists only the NatNum12 modifier with different
options. We need to add a format code to get a working example, ie. simply
extending them with a 0:

[NatNum12] -> [NatNum12]0
[NatNum12 ordinal-feminine] -> [NatNum12 ordinal-feminine]0
[NatNum12 USD] -> [NatNum12 USD]0
etc.

See the screenshot of the previous test document in the Format number
dialog, spell out format of a money amounts in U.S. dollars with title
case:

https://bug-attachments.documentfoundation.org/attachment.cgi?id=143596

The screenshot shows its number format code: "[NatNum12 title USD]0"

In my translator note, I tried to suggest to list the available functions
of your language, and this is possible in the last paragraph of the text.
For example, the available functions of Numbertext/NatNum12 for Brazilian
Portuguese are

feminine, masculine, ordinal-feminine, ordinal-masculine,
ordinal-number-feminine and ordinal-number-masculine.

To see these and available functions of other languages, choose menu item
"Functions (help)" in pop-up menu of the page

https://numbertext.github.io/#testimonials

If your language hasn't been supported yet, you don't need to extend the
translated text.

By the way, it's easy to add a new language based on the recent modules and
the Numbertext tutorial, so I encourage you to contribute. I will help,
also I continue to extend the list of the supported languages of
Numbertext, for example, I have just added Galician (developed by Adrián
Chaves), Albanian, Ukrainian and Norwegian Bokmål and Nynorsk.

Help welcome, the numbertext feature is a must and deserves better
description and usage contents.

Thanks again,

I am going to add more examples, test documents and screen casts to the
issue, also to the 6.1 release notes soon, and write to this list.

Best regards,
László

#4

Hi László, all,

Where are the [NatNum12 xxx]0 format specifiers supposed to work currently?
I loaded the example document from Bugzilla in 6.1.0.1, 6.1.0.2, and a
recent build of 6.2; it appeared OK at first but as long as I updated the
field, it updated to "USD -12345" (just digits, no 'spelled out' number)
and I was unable to make any NatNum12 code work in the Number Format
dialog, even the original example in the document. I tried several
languages and 'subspecifiers' (ordinal, cardinal, etc.), also changing the
language of the text containing the field to match the language of the
formatting code. Nothing worked.
Should I install an extension? Is it supposed to work in Writer, Calc, or
both?

TIA,
Mihail