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

classic Classic list List threaded Threaded
4 messages Options
sophie sophie
Reply | Threaded
Open this post in threaded view
|

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


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

--
Sophie Gautier [hidden email]
GSM: +33683901545
IRC: sophi
Release coordinator
The Document Foundation

--
To unsubscribe e-mail to: [hidden email]
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
Olivier Hallot-4 Olivier Hallot-4
Reply | Threaded
Open this post in threaded view
|

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

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


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: [hidden email]
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
Németh László-2 Németh László-2
Reply | Threaded
Open this post in threaded view
|

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 <[hidden email]>:

> 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: [hidden email]
> 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: [hidden email]
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
Mihail Balabanov Mihail Balabanov
Reply | Threaded
Open this post in threaded view
|

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

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

--
To unsubscribe e-mail to: [hidden email]
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