Returns the MIME charset name corresponding to a locale.

Parameters:

locale - Name of a locale, as language_COUNTRY using ISO 639 and ISO 3166

Returns:

IANA MIME character set name

Author:

Henry Minsky <hqm@mit.edu>

Partial Call Graph (max 5 caller/called nodes):

Testcases:

test_get_locales

Internationalising of Attributes. This is done by storing the attribute with its acs-lang key

Switches:

-locale

(defaults to "en_US") (optional)

-package_key

(defaults to "acs-translations") (optional)

-message_key

(optional)

-prefix

(optional)

-text

(required)

-object_id

(optional)

bind the newly created message key to this acs_object id. Upon object's deletion, the message key will be deleted as well.

Partial Call Graph (max 5 caller/called nodes):

Testcases:

lang_test__convert_to_i18n, group_localization

Returns an enabled default locale for a language. If a language only has one locale then that locale is returned. If no locale could be found the empty string is returned.

Parameters:

language - Name of a country, using ISO-3166 two letter code

Returns:

Default locale

Author:

Henry Minsky <hqm@mit.edu>

Partial Call Graph (max 5 caller/called nodes):

Testcases:

default_locale_from_lang

Generates the URL to edit a message key.

Switches:

-message

(required)

key with or without hashes, such as \#acs-admin.Actions\# or acs-admin.Actions.

-package_key

(defaults to "acs-translations") (optional)

must correspond to that in the message key.

Returns:

a local URL or the empty string when no URL can be generated.

Partial Call Graph (max 5 caller/called nodes):

Testcases:

test_edit_lang_key_url

Returns a list of two element lists containing the start and end indices of a #message_key# match in the multilingual string. This proc is used by the localize proc.

Parameters:

multilingual_string

Author:

Peter marklund <peter@collaboraid.biz>

Partial Call Graph (max 5 caller/called nodes):

Testcases:

util__get_hash_indices

Returns the label (name) of locale

Parameters:

locale - Code for the locale, eg "en_US"

Returns:

String containing the label for the locale

Author:

Bruno Mattarollo <bruno.mattarollo@ams.greenpeace.org>

Partial Call Graph (max 5 caller/called nodes):

Testcases:

test_get_locales

Return a list of locales know to the system

Partial Call Graph (max 5 caller/called nodes):

Testcases:

test_get_locales

Given the contents of an adp file return the indices of the start and end chars of embedded message keys on the syntax: <#package_key.message_key Some en_US text#>

Parameters:

adp_file_string

Author:

Peter marklund <peter@collaboraid.biz>

Partial Call Graph (max 5 caller/called nodes):

Testcases:

util__replace_temporary_tags_with_lookups

Returns the ISO-639-2 code for a language.

Switches:

-language

(required)

Language, using ISO-639 code (2 or 3 chars)

Returns:

The ISO-639-2 terminology code for the language

Partial Call Graph (max 5 caller/called nodes):

Testcases:

test_get_locales

Returns the ISO-639-2 code for a locale.

Switches:

-locale

(required)

Locale to get the language ISO-639-2 code for

Returns:

The ISO-639-2 language code for the locale

Partial Call Graph (max 5 caller/called nodes):

Testcases:

test_get_locales

Each locale can have a different alphabetical sort order. You can test this proc with the following data:

    insert into lang_testsort values ('lama');
    insert into lang_testsort values ('lhasa');
    insert into lang_testsort values ('llama');
    insert into lang_testsort values ('lzim');
    

Parameters:

field - Name of Oracle column
locale (optional) - Locale for sorting. If locale is unspecified just return the column name

Returns:

Language aware version of field for Oracle ORDER BY clause.

Author:

Jeff Davis <davis@xarg.net>

See Also:

• https://www.postgresql.org/docs/current/collation.html
• https://docs.oracle.com/cd/B14117_01/server.101/b10759/functions089.htm

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Returns the ISO-639 label for a language code.

Switches:

-language

(required)

Language, using ISO-639 code (2 or 3 chars)

Returns:

The ISO-639 label for the language

Partial Call Graph (max 5 caller/called nodes):

Testcases:

test_get_locales

Takes a string with embedded message keys on the format #message_key_name# and returns the same string but with the message keys (and their surrounding hash marks) replaced with the corresponding value in the message catalog. Message lookup is done with the locale of the request. If message lookup fails for a certain key then a translation missing message will be used instead.

Parameters:

string_with_hashes
locale (optional)

Author:

Peter marklund <peter@collaboraid.biz>

Partial Call Graph (max 5 caller/called nodes):

Testcases:

lang_test__lang_user_site_wide_locale, localize, test_localize_list_of_lists, ad_context_bar_multirow, object_type_hierarchy

localize the elements of a list_of_lists

Switches:

-list

(optional)

Partial Call Graph (max 5 caller/called nodes):

Testcases:

test_localize_list_of_lists

Regular expression for recognizing message keys in the form #package_name.key#.

See Also:

• lang::util::message_tag_regexp

Partial Call Graph (max 5 caller/called nodes):

Testcases:

test_message_regexp

The regexp expression used by proc get_temporary_tags_indices and elsewhere to extract temporary message catalog tags (<#...#>) from ADP and Tcl files. The first sub match of the expression is the whole tag, the second sub match is the message key, and the third sub match is the message text in en_US locale.

Author:

Peter marklund <peter@collaboraid.biz>

See Also:

• lang::util::message_key_regexp

Partial Call Graph (max 5 caller/called nodes):

Testcases:

test_message_regexp

Returns the nls_language name for a language

Parameters:

language - Name of a country, using ISO-3166 two letter code

Returns:

The nls_language name of the language.

Author:

Henry Minsky <hqm@mit.edu>

Partial Call Graph (max 5 caller/called nodes):

Testcases:

test_get_locales

Prepares an .adp-file for localization by inserting temporary hash-tags around text strings that looks like unlocalized plain text. Needless to say this is a little shaky so not all plain text is caught and the script may insert hash-tags around stuff that should not be localized. It is conservative though. There are two modes the script can be run in: - report : do *not* write changes to the file but return a report with suggested changes. - write : write changes in the file - it expects a list of keys and will insert them in the order implied by the report - a report is also returned.

Parameters:

file_name - The name of the adp file to do replacements in.
mode - Either report or write.
keys (optional) - A list of keys to use for the texts that may be provided in write mode. If the keys are not provided then autogenerated keys will be used. If a supplied key is the empty string this indicates that the corresponding text should be left untouched.

Returns:

The report is list of two lists: The first being a list of pairs (key, text with context) and the second is a list of suspious looking garbage. In report mode the keys are suggested keys and in write mode the keys are the keys supplied in the keys parameter.

Authors:

Christian Hvid

Peter Marklund

Jeff Davis

Partial Call Graph (max 5 caller/called nodes):

Testcases:

util__replace_adp_text_with_message_tags

Modify the given ADP or Tcl files by replacing occurencies of message keys with message lookups (i.e. #package_key.message_key# for ADP files and [_ "package_key.message_key"] for Tcl files) and create entries in the catalog file for each of these keys. If the short hand form <#_ Some en_US text#> is used then the key will be auto-generated based on the text. Returns the number of replacements done. This procedure only reads from and writes to the catalog file specified (the en_US catalog file per default) of the package that the files belong to, the database is not accessed in any way.

Parameters:

file_list - A list of paths to .adp or .tcl files to do replacements in. The paths should be relative to $::acs::rootdir. All files must belong to the same package.

Author:

Peter marklund <peter@collaboraid.biz>

Partial Call Graph (max 5 caller/called nodes):

Testcases:

util__replace_temporary_tags_with_lookups

Whether translator mode is enabled for this session or not. Translator mode will cause all non-translated messages to appear as a link to a page where the message can be translated, instead of the default "not translated" message.

Returns:

1 if translator mode is enabled, 0 otherwise. Returns 0 if there is no HTTP connection.

Author:

Lars Pind <lars@collaboraid.biz>

Created:

October 24, 2002

See Also:

• lang::util::translator_mode_set

Partial Call Graph (max 5 caller/called nodes):

Testcases:

test_translator_mode

Sets whether translator mode is enabled for this session or not.

Parameters:

translator_mode_p - 1 if you want translator mode to be enabled, 0 otherwise.

Author:

Lars Pind <lars@collaboraid.biz>

Created:

October 24, 2002

See Also:

• lang::util::translator_mode_p

Partial Call Graph (max 5 caller/called nodes):

Testcases:

test_translator_mode