Internationalization/translation function - Revision history

Trosim: Changed escape character

2006-06-08T15:20:53Z

Changed escape character

Trosim: /* An example */ Fixes escape character

2006-06-06T13:38:36Z

‎An example: Fixes escape character

Trosim: Changed argument and return types, proposed escape character

2006-06-06T13:37:40Z

Changed argument and return types, proposed escape character

Trosim: Cosmetics

2006-06-06T13:33:55Z

Cosmetics

Etienner at 06:11, 3 June 2006

2006-06-03T06:11:00Z

Carlo: counting lists

2006-06-01T14:37:17Z

counting lists

Carlo: /* Additional things */

2006-06-01T14:34:59Z

‎Additional things

Carlo: small but important detail

2006-06-01T14:34:29Z

small but important detail

Carlo: /* Introduction */

2006-06-01T14:32:00Z

‎Introduction

Etienner: added page to our category

2006-05-31T16:51:12Z

added page to our category

@@ Line 42: / Line 42: @@
 With this solution, the programmer should write composit strings as (or in a similar way) he would do for the C ''printf'' function. The composit string above would be something like this:
-<code>[eiffel,N] i18n_comp("A string composed by \1 strings, like this or \2%N", [count, a_string])
+<code>[eiffel,N] i18n_comp("A string composed by $1 strings, like this or $2%N", [count, a_string])
 </code>
-where ''\1'' is the place where the first string in the argument tuple (here ''count'') has to go. I've [[Talk:Internationalization/translation_function|'''choosen''']] that the items in the argument tuple are of type ANY, to insert them in the string we have to apply the functon ''out'' to all items.
+where ''$1'' is the place where the first string in the argument tuple (here ''count'') has to go. I've [[Talk:Internationalization/translation_function|'''choosen''']] that the items in the argument tuple are of type ANY, to insert them in the string we have to apply the functon ''out'' to all items.
 ===An example===
@@ Line 75: / Line 75: @@
 [...]
-io.put_string(i18n_comp_pl(["Remove file \1?%N",
+io.put_string(i18n_comp_pl(["Remove file $1?%N",
-                 "Delete following files? \2 there are \3 files%N"],
+                 "Delete following files? $2 there are $3 files%N"],
                  [file_name, list, list_count], n))
 [...]
@@ Line 84: / Line 84: @@
   #: A comment
-  msgid "Remove file \1?%N"
+  msgid "Remove file $1?%N"
-  msgid_plural "Delete following files? \2 there are \3 files%N"
+  msgid_plural "Delete following files? $2 there are $3 files%N"
-  msgstr[0] "Rimuovere il file \1?"
+  msgstr[0] "Rimuovere il file $1?"
-  msgstr[1] "Cancellare i seguenti file? \2 ce ne sono \3%N"
+  msgstr[1] "Cancellare i seguenti file? $2 ce ne sono $3%N"
 You might ask yourself, ''why a function for all the pluralforms''?
@@ Line 112: / Line 112: @@
 [...]
-io.put_string(i18n_comp_pl(["Remove file \1?%N",
+io.put_string(i18n_comp_pl(["Remove file $1?%N",
-                 "Delete following files? \2 there are \3 files%N"],
+                 "Delete following files? $2 there are $3 files%N"],
                  [file_name, list, list_count], list_count))
 -- A comment of the author
@@ Line 123: / Line 123: @@
   #. A comment of the author
   #. Function name, class name, file path
-  #. \1 = file_name
+  #. $1 = file_name
-  #. \2 = list
+  #. $2 = list
-  #. \3 = list_count
+  #. $3 = list_count
-  msgid "Remove file \1?%N"
+  msgid "Remove file $1?%N"
-  msgid_plural "Delete following files? \2 there are \3 files%N"
+  msgid_plural "Delete following files? $2 there are $3 files%N"
-  msgstr[0] "Rimuovere il file \1?"
+  msgstr[0] "Rimuovere il file $1?"
-  msgstr[1] "Cancellare i seguenti file? \2 ce ne sono \3%N"
+  msgstr[1] "Cancellare i seguenti file? $2 ce ne sono $3%N"

@@ Line 86: / Line 86: @@
   msgid "Remove file \1?%N"
   msgid_plural "Delete following files? \2 there are \3 files%N"
-  msgstr[0] "Rimuovere il file %a1?"
+  msgstr[0] "Rimuovere il file \1?"
   msgstr[1] "Cancellare i seguenti file? \2 ce ne sono \3%N"

@@ Line 25: / Line 25: @@
 <code>[eiffel,N]
-i18n(a_string: STRING): STRING
+i18n(a_string: STRING_GENERAL): STRING_32
-     --Function for the translation of normal strings
+     -- Function for the translation of normal strings
-i18n_pl(strings: TUPLE[STRING]; form: INTEGER): STRING
+i18n_pl(strings: TUPLE[STRING_GENERAL]; form: INTEGER): STRING_32
-     --Function for the translation of normal strings
+     -- Function for the translation of normal strings
      -- with plural form
-i18n_comp(a_string: STRING; args: TUPLE): STRING
+i18n_comp(a_string: STRING_GENERAL; args: TUPLE): STRING_32
-     --Function for the translation of composit strings
+     -- Function for the translation of composit strings
-i18n_comp_pl(strings: TUPLE[STRING]; args: TUPLE; form: INTEGER): STRING
+i18n_comp_pl(strings: TUPLE[STRING_GENERAL]; args: TUPLE; form: INTEGER): STRING_32
-     --Function for the translation of composit
+     -- Function for the translation of composit
      -- strings with plural forms
 </code>
@@ Line 42: / Line 42: @@
 With this solution, the programmer should write composit strings as (or in a similar way) he would do for the C ''printf'' function. The composit string above would be something like this:
-<code>[eiffel,N] i18n_comp("A string composed by %a1 strings, like this or %a2%N", [count, a_string])
+<code>[eiffel,N] i18n_comp("A string composed by \1 strings, like this or \2%N", [count, a_string])
 </code>
-where ''%a1'' is the place where the first string in the argument tuple (here ''count'') has to go. I've [[Talk:Internationalization/translation_function|'''choosen''']] that the items in the argument tuple are of type ANY, to insert them in the string we have to apply the functon ''out'' to all items.
+where ''\1'' is the place where the first string in the argument tuple (here ''count'') has to go. I've [[Talk:Internationalization/translation_function|'''choosen''']] that the items in the argument tuple are of type ANY, to insert them in the string we have to apply the functon ''out'' to all items.
 ===An example===
@@ Line 75: / Line 75: @@
 [...]
-io.put_string(i18n_comp_pl(["Remove file %a1?%N",
+io.put_string(i18n_comp_pl(["Remove file \1?%N",
-                 "Delete following files? %a2 there are %a3 files%N"],
+                 "Delete following files? \2 there are \3 files%N"],
                  [file_name, list, list_count], n))
 [...]
@@ Line 84: / Line 84: @@
   #: A comment
-  msgid "Remove file %a1?%N"
+  msgid "Remove file \1?%N"
-  msgid_plural "Delete following files? %a2 there are %a3 files%N"
+  msgid_plural "Delete following files? \2 there are \3 files%N"
   msgstr[0] "Rimuovere il file %a1?"
-  msgstr[1] "Cancellare i seguenti file? %a2 ce ne sono %a3%N"
+  msgstr[1] "Cancellare i seguenti file? \2 ce ne sono \3%N"
 You might ask yourself, ''why a function for all the pluralforms''?
@@ Line 112: / Line 112: @@
 [...]
-io.put_string(i18n_comp_pl(["Remove file %a1?%N",
+io.put_string(i18n_comp_pl(["Remove file \1?%N",
-                 "Delete following files? %a2 there are %a3 files%N"],
+                 "Delete following files? \2 there are \3 files%N"],
                  [file_name, list, list_count], list_count))
 -- A comment of the author
@@ Line 123: / Line 123: @@
   #. A comment of the author
   #. Function name, class name, file path
-  #. %a1 = file_name
+  #. \1 = file_name
-  #. %a2 = list
+  #. \2 = list
-  #. %a3 = list_count
+  #. \3 = list_count
-  msgid "Remove file %a1?%N"
+  msgid "Remove file \1?%N"
-  msgid_plural "Delete following files? %a2 there are %a3 files%N"
+  msgid_plural "Delete following files? \2 there are \3 files%N"
-  msgstr[0] "Rimuovere il file %a1?"
+  msgstr[0] "Rimuovere il file \1?"
-  msgstr[1] "Cancellare i seguenti file? %a2 ce ne sono %a3%N"
+  msgstr[1] "Cancellare i seguenti file? \2 ce ne sono \3%N"

@@ Line 8: / Line 8: @@
   <code>[eiffel,N] "A normal string"</code>
 * composed string
-  <code>[eiffel,N] "A string composed by "+count.out+" strings, like this or "+a_string+"%N"</code>
+  <code>[eiffel,N] "A string composed by " + count.out + " strings, like this or " + a_string + "%N"</code>
 * strings with plural form
 <code>[eiffel,N]
-  if n=1 then
+  if n = 1 then
       Result := "a string"
   else
-    Result := "strings"
+     Result := "strings"
   end
 </code>
@@ Line 25: / Line 25: @@
 <code>[eiffel,N]
-i18n (a_string : STRING) : STRING
+i18n(a_string: STRING): STRING
      --Function for the translation of normal strings
-i18n_pl (strings : TUPLE[STRING]; form : INTEGER) : STRING
+i18n_pl(strings: TUPLE[STRING]; form: INTEGER): STRING
      --Function for the translation of normal strings
      -- with plural form
-i18n_comp (a_string : STRING; args : TUPLE) : STRING
+i18n_comp(a_string: STRING; args: TUPLE): STRING
      --Function for the translation of composit strings
-i18n_comp_pl (strings : TUPLE[STRING]; args : TUPLE; form : INTEGER) : STRING
+i18n_comp_pl(strings: TUPLE[STRING]; args: TUPLE; form: INTEGER): STRING
      --Function for the translation of composit
      -- strings with plural forms
 </code>
-With this solution, the programmer should write composit strings as (or in a similar way) he would do it for the C ''printf'' function. The composit string above would be somthing like this:
+With this solution, the programmer should write composit strings as (or in a similar way) he would do for the C ''printf'' function. The composit string above would be something like this:
 <code>[eiffel,N] i18n_comp("A string composed by %a1 strings, like this or %a2%N", [count, a_string])
@@ Line 58: / Line 58: @@
 [...]
 if n = 1
-io.put_string("Remove file "+file_name.out+"?%N")
+io.put_string("Remove file " + file_name.out + "?%N")
 else
-io.put_string ("Delete following files?"+list.out+" there are "
+io.put_string ("Delete following files?" + list.out + " there are "
-                 +list.count.out+"files%N")
+                 + list.count.out + "files%N")
 end
 [...]
@@ Line 106: / Line 106: @@
 ==Additional things==
-A nice thing whe could do, when parsing the source code of a program to internationalize, is to recognize comments about the string.
+A nice thing we could do, when parsing the source code of a program to internationalize, is to recognize comments about the string.
 For example:
@@ Line 115: / Line 115: @@
                  "Delete following files? %a2 there are %a3 files%N"],
                  [file_name, list, list_count], list_count))
---A comment of the author
+-- A comment of the author
 [...]
 </code>
-woud then look like this in the PO file:
+would then look like this in the PO file:
   #. A comment of the author

← Older revision		Revision as of 06:11, 3 June 2006
Line 1:		Line 1:
−	~~[[Category:Projects]]~~
	[[Category:Internationalization]]		[[Category:Internationalization]]

@@ Line 4: / Line 4: @@
 ==Introduction==
-The problem for the translation is that we need a way to translate tree different types of string:
+The problem for the translation is that we need a way to translate three different types of string:
 * normal strings
@@ Line 19: / Line 19: @@
 </code>
-An other problem is that not all languages have the same rule for plural forms, see below and [[internationalization/plural_forms|here]] for more details.
+Another problem is that not all languages have the same rules for plural forms, see below and [[internationalization/plural_forms|here]] for more details.
 ==Possible solution==

← Older revision		Revision as of 16:51, 31 May 2006
Line 1:		Line 1:
		+	[[Category:Projects]]
		+	[[Category:Internationalization]]
		+
	==Introduction==		==Introduction==