Language-neutral NUMBERTEXT and MONEYTEXT functions for OpenOffice.org/LibreOffice Calc

version 0.9.5 release 2 (2012-12-06)

Numbertext OOo/LibO extension,
Soros programming language specification (draft) and IDE*,
Soros interpreter in Python: pythonpath/Soros.py,
Soros interpreter in JavaScript: Soros.js*:
Soros interpreter in Java: see NUMBERTEXT.org

* Not in OpenOffice.org extension, see http://NUMBERTEXT.org for
  the full distribution.

License: LGPL/BSD dual-license, 2009-2012 (C) László Németh (nemeth at numbertext dot org)

Numbertext language data (Soros programs):

LGPL/BSD dual-license, 2009-2012 (C) László Németh et al. (see AUTHORS)

Serbian modules:

CC/LGPL/BSD tri-license, 2009 (C) Goran Rakić (grakic at devbase dot net)

* Note: for full distribution with specifications, IDE and JavaScript
  implementation, see http://NUMBERTEXT.org

Software distributed under the License is distributed on an "AS IS" basis,
WITHOUT WARRANTY OF ANY KIND, either express or implied.

= Supported languages in this version =

af-ZA	Africaans
ca-ES	Catalan
cs-CZ	Czech
da-DK	Danish
de-DE	German
el-EL	Greek
en-IN	English with Indian numbering system (lakh = 100.000, crore = 10^7)
en-US	English (USD 20.25 -> twenty dollars and twenty-five cents)
en-US-2	English variant (USD 20.25 -> twenty and 25/100 dollars)
eo	Esperanto
es-ES	Spanish
fi-FI	Finnish
fr-BE	Belgian French
fr-CH	Swiss French
fr-FR	French
he-IL	Hebrew
hu-HU	Hungarian
hu-HU_2	Hungarian (formal)
id-ID	Indonesian
it-IT	Italian
ja-JP	Japanese
ja-JP-2	Japanese (formal)
ko-KP	North-Korean
ko-KR	South-Korean
lb-LU	Luxembourgish
lt-LT	Lithuanian
lv-LV	Latvian
nl-NL	Dutch
pl-PL	Polish
pt-BR	Brazilian Portuguese
pt-PT	Portuguese
ro-RO	Romanian
ru-RU	Russian
sh-RS	Serbian
sl-SI	Slovenian
sr-RS	Serbian
sv-SV	Swedish
th-TH	Thai
tr-TR	Turkish
vi-VN	Vietnamese
zh-ZH	Chinese (simplified)
zh-ZH-2	Chinese (simplified, formal)

Old number systems:

Hung	Old Hungarian Script
Roman	Roman numbers (parenthesized variant)
Roman_2	Roman numbers (with overline, bars, and optionally special characters)
Suzhou	Chinese Suzhou numerals

= Installation in OpenOffice.org/LibreOffice =

Tools->Extension Manager->Add

= Usage =

After restarting OpenOffice.org/LibreOffice, there are two new Calc functions,
NUMBERTEXT() and MONEYTEXT().

Examples:

=NUMBERTEXT(25)
=NUMBERTEXT(25;"th-TH")
=MONEYTEXT(25)
=MONEYTEXT(25;"USD")
=MONEYTEXT(25;"CNY";"zh-ZH")

= Development =

See doc/addnewlocale.txt and doc/sorosspec.odt

For general Calc and (portable Excel) Add-In developments, see

Jan Holst Jensen's excellent Add-in example and documentation:

http://biochemfusion.com/doc/Calc_addin_howto.html

== Integrated development environment ==

There is a JavaScript/HTML IDE in this distribution:

Open web/webroot/Soros.html in a JavaScript capable browser,

or use the on-line version of the IDE (http://numbertext.org).

= Test =

make check

test/thaicheck.ods is a simple test of the equivalence of
the Soros implementation of Thai number to number name conversion
and BAHTTEXT function.

= Java jar =

Copy /data files to the /java/org/numbertext/data dictionary, and

cd java
CLASSPATH=. javac org/numbertext/Numbertext.java
jar cfm numbertext.jar Manifest.txt org
