Index: openacs-4/packages/acs-core-docs/www/i18n-introduction.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/i18n-introduction.html,v diff -u -r1.18.2.4 -r1.18.2.5 --- openacs-4/packages/acs-core-docs/www/i18n-introduction.html 31 Dec 2015 15:12:52 -0000 1.18.2.4 +++ openacs-4/packages/acs-core-docs/www/i18n-introduction.html 9 Jun 2016 08:44:50 -0000 1.18.2.5 @@ -1,5 +1,5 @@ -How Internationalization/Localization works in OpenACS

How Internationalization/Localization works in OpenACS

+How Internationalization/Localization works in OpenACS

How Internationalization/Localization works in OpenACS

This document describes how to develop internationalized OpenACS packages, including writing new packages with internationalization and converting old packages. Text that @@ -54,7 +54,7 @@

The advantage of the short syntax is that it's short. It's as simple as inserting the value of a variable. Example: - #forum.title# + <span>#</span>forum.title#

  • The verbose: <trn key="package_key.message_key" @@ -197,9 +197,9 @@

    Here are a couple of examples. Say we have the following two parameters, taken directly from the dotlrn package. -

    Parameter NameParameter Value
    class_instance_pages_csv#dotlrn.class_page_home_title#,Simple 2-Column;#dotlrn.class_page_calendar_title#,Simple 1-Column;#dotlrn.class_page_file_storage_title#,Simple 1-Column
    departments_pretty_name#departments_pretty_name#

    +

    Parameter NameParameter Value
    class_instance_pages_csv<span>#</span>dotlrn.class_page_home_title#,Simple 2-Column;<span>#</span>dotlrn.class_page_calendar_title#,Simple 1-Column;<span>#</span>dotlrn.class_page_file_storage_title#,Simple 1-Column
    departments_pretty_name<span>#</span>departments_pretty_name#

    Then, depending on how we retrieve the value, here's what we get: -

    Command used to retrieve ValueRetrieved Value
    parameter::get -localize -parameter class_instances_pages_csvKurs Startseite,Simple 2-Column;Kalender,Simple 1-Column;Dateien,Simple 1-Column
    parameter::get -localize -parameter departments_pretty_nameAbteilung
    parameter::get -parameter departments_pretty_name#departments_pretty_name#

    +

    Command used to retrieve ValueRetrieved Value
    parameter::get -localize -parameter class_instances_pages_csvKurs Startseite,Simple 2-Column;Kalender,Simple 1-Column;Dateien,Simple 1-Column
    parameter::get -localize -parameter departments_pretty_nameAbteilung
    parameter::get -parameter departments_pretty_name<span>#</span>departments_pretty_name#

    The value in the rightmost column in the table above is the value returned by an invocation of parameter::get. Note that for localization to happen you must use the -localize flag.