Re: [libreoffice-l10n] Note to translators in NatNum12 help files

Hi,

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


2018-07-17 14:32 GMT+02:00 Olivier Hallot <olivier.hallot@libreoffice.org>:

> 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ó


> Kind regards
> Olivier
>
>
> Em 10/07/2018 13:11, sophi escreveu:
> > 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):
> > -----------------------------------------------------------
> > tdf#115007 add NatNum12 help and ask translators for extending
> > language support in number and date formatting by extending
> > the newly integrated libnumbertext (http://www.numbertext.org)
> > and default date formats of LibreOffice:
> >
> > Translators: (1) please, modify the list of NatNum12 functions
> > according to libnumbertext language support of your language.
> > Other arguments could be ordinal-feminine, ordinal-masculine,
> > ordinal-neuter, formal, article, etc. To show the available
> > NatNum12 arguments of your language, open
> > https://numbertext.github.io/#testimonials in a browser, and
> > select "Functions (help)" in the pop-up menu.
> >
> > As you can see in the examples for NatNum12 date formats
> > and in the extended en_US.xml and hu_HU.xml locale data files, it's
> > possible to support also special number formatting needs of your
> > language, including spelling out numbers, money amounts and dates
> > with automatic selection of prepositions [like Catalan "de" or "d'"
> > before month names], articles [Hungarian "a" or "az"] and suffixes
> > [in Hungarian or likely Estonian, Finnish, Turkish etc. languages:
> > "in", "from", "to" etc. suffixes of day and month names], check
> > http://numbertext.org or write your questions on LibreOffice l10n
> > mailing list.
> > ------------------------------------------------------------
> >
> > Cheers
> > Sophie
>
> --
> Olivier Hallot
> LibreOffice Documentation Coordinator
> Comunidade LibreOffice
> Rio de Janeiro - Brasil - Local Time: UTC-03:00
> http://tdf.io/joinus
>
> --
> To unsubscribe e-mail to: l10n+unsubscribe@global.libreoffice.org
> Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-
> unsubscribe/
> Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette
> List archive: https://listarchives.libreoffice.org/global/l10n/
> Privacy Policy: https://www.documentfoundation.org/privacy

-- 
To unsubscribe e-mail to: l10n+unsubscribe@global.libreoffice.org
Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette
List archive: https://listarchives.libreoffice.org/global/l10n/
Privacy Policy: https://www.documentfoundation.org/privacy