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.17.2.1 -r1.17.2.2 --- openacs-4/packages/acs-core-docs/www/i18n-introduction.html 21 Aug 2013 10:19:22 -0000 1.17.2.1 +++ openacs-4/packages/acs-core-docs/www/i18n-introduction.html 9 Sep 2014 08:31:55 -0000 1.17.2.2 @@ -24,7 +24,7 @@ dates must use internationalized functions. All displayed numbers must use internationalized functions.

- Localizable text must be handled in ADP files, in TCL files, and + Localizable text must be handled in ADP files, in Tcl files, and in APM Parameters. OpenACS provides two approaches, message keys and localized ADP files. For ADP pages which are mostly code, replacing the message text with message key placeholders @@ -83,7 +83,7 @@ auto-generated by the APM. Example: <_ Title>

We recommend the short notation for new package development. -

Message Keys in TCL Files

+

Message Keys in Tcl Files

In adp files message lookups are typically done with the syntax \#package_key.message_key\#. In Tcl files all message lookups *must* be on either of the following formats: @@ -100,10 +100,10 @@

- Translatable texts in page TCL scripts are often found in page titles, + Translatable texts in page Tcl scripts are often found in page titles, context bars, and form labels and options. Many times the texts are enclosed in double quotes. The following is an example of grep commands - that can be used on Linux to highlight translatable text in TCL files: + that can be used on Linux to highlight translatable text in Tcl files:

 # Find text in double quotes
 find -iname '*.tcl'|xargs egrep -i '"[a-z]'
@@ -118,7 +118,7 @@
 find -iname '*.tcl'|xargs egrep -i '(ad_complain|ad_return_error)'|egrep -v '<#'
 
       

- You may mark up translatable text in TCL library files and TCL pages + You may mark up translatable text in Tcl library files and Tcl pages with temporary tags on the <#key text#> syntax. If you have a sentence or paragraph of text with variables and or procedure calls in it you should in most cases @@ -171,11 +171,11 @@ When you feel ready you may vist your package in the package manager and run the action "Replace tags with keys - and insert into catalog" on the TCL files that you've edited to + and insert into catalog" on the Tcl files that you've edited to replace the temporary tags with calls to the message lookup procedure. -

Dates, Times, and Numbers in TCL files

- Most date, time, and number variables are calculated in TCL files. Dates and times must be converted when stored in the database, +

Dates, Times, and Numbers in Tcl files

+ Most date, time, and number variables are calculated in Tcl files. Dates and times must be converted when stored in the database, when retrieved from the database, and when displayed. All dates are stored in the database in the server's timezone, which is an APM Parameter set at