Appendix I. 本地化
本地化是Bash的一个未文档化的特征.
对于一个本地化的shell脚本来说, 它的输出都会使用本地系统所定义的语言. 对于一个德国柏林的Linux用户来说, 他的脚本会输出德文, 而对于他在马里兰的堂兄来说, 同样运行这个脚本, 输出就是英文.
为了创建一个本地化的脚本, 可以使用下面的模版来编写所有的用户消息(错误消息, 提示符, 等等.).
1 #!/bin/bash
2 # localized.sh
3 # 此脚本由Stephane Chazelas编写,
4 #+ Bruno Haible进行了修改, Alfredo Pironti修正了bug.
5
6 . gettext.sh
7
8 E_CDERROR=65
9
10 error()
11 {
12 printf "$@" >&2
13 exit $E_CDERROR
14 }
15
16 cd $var || error "`eval_gettext \"Can\'t cd to \\\$var.\"`"
17 # $var前面之所以需要三个反斜线(转义)
18 #+ "因为在变量值还没被替换之前,
19 #+ eval_gettext需要一个字符串."
20 # -- per Bruno Haible
21 read -p "`gettext \"Enter the value: \"`" var
22 # ...
23
24
25 # ------------------------------------------------------------------
26 # Alfredo Pironti注释:
27
28 # 这个脚本已经被修改,
29 #+ 使用"`gettext \"...\"`"语法形式替换了$"..."语法形式.
30 # 这么做没问题, 但是在新的localized.sh程序中,
31 #+ 命令"bash -D filename" and "bash --dump-po-string filename"
32 #+ 将不会产生输出
33 #+ (因为那些命令只会搜索$"..."字符串)!
34 # 从新文件中提取字符串的唯一方法就是使用'xgettext'程序.
35 # 然而, xgettext程序存在许多bug.
36
37 # 注意'xgettext'还有一个bug.
38 #
39 # shell片断:
40 # gettext -s "I like Bash"
41 # 将会被正确的提取, 但是 . . .
42 # xgettext -s "I like Bash"
43 # . . . 失败!
44 # 'xgettext'将会提取"-s"
45 #+ 因为这个命令仅仅会提取
46 #+ 'gettext'后边的第一个参数.
47
48
49 # 转义字符:
50 #
51 # 为了本地化一个句子, 就像
52 # echo -e "Hello\tworld!"
53 #+ 你必须使用
54 # echo -e "`gettext \"Hello\\tworld\"`"
55 # `t'前边的"双转义字符"是必须的,
56 #+ 因为'gettext'将会搜索那些字符串(就像'Hello\tworld')
57 # 这是因为gettext将会读取一个字符`\')
58 #+ 并将输出一个字符串(就像"Bonjour\tmonde"),
59 #+ 所以'echo'命令将会正确的显示消息.
60 #
61 # 你可能不想使用
62 # echo "`gettext -e \"Hello\tworld\"`"
63 #+ 因为我们上面解释的xgettext的bug.
64
65
66
67 # 让我们本地化下面的shell片断:
68 # echo "-h display help and exit"
69 #
70 # 首先, 可以用:
71 # echo "`gettext \"-h display help and exit\"`"
72 # 这样'xgettext'工作正常,
73 #+ 但是'gettext'程序将会把"-h"当作选项来读取!
74 #
75 # 一个解决方法是
76 # echo "`gettext -- \"-h display help and exit\"`"
77 # 这样'gettext'工作正常,
78 #+ 但是'xgettext'将会提取"--", 就像上边那样.
79 #
80 # 为了获得这个本地化的字符串, 你可能使用的变通方法就是:
81 # echo -e "`gettext \"\\0-h display help and exit\"`"
82 # 我们已经在这句的开头添加了\0 (NULL).
83 # 这样'gettext'能够正确工作, 就像'xgettext'一样.
84 # 此外, NULL字符将不会修改
85 #+ 'echo'命令的行为.
86 # ------------------------------------------------------------------ |
bash$ bash -D localized.sh "Can't cd to %s." "Enter the value: " |
-D选项将会列出以$为前缀,
并且使用双引号引用起来的字符串, 而不会执行这个脚本.)
bash$ bash --dump-po-strings localized.sh #: a:6 msgid "Can't cd to %s." msgstr "" #: a:7 msgid "Enter the value: " msgstr "" |
--dump-po-strings选项与-D选项很相似,
但使用gettext "po"格式.
 | Bruno Haible指出: 以gettext-0.12.2开始, xgettext -o - localized.sh被推荐代替bash --dump-po-strings localized.sh, 因为xgettext . . . 1. 了解命令gettext和eval_gettext(而bash --dump-po-strings只认识它的$"..."语法) 2. 可以提取程序中的注释, 进而可以被翻译者读取. 这个脚本将不再被特定于Bash, 它与Bash 1.x和其他的/bin/sh实现, 都使用相同的方式工作. |
现在, 为每种脚本需要被转换的语言都建立一个language.po文件, 指定msgstr. Alfredo Pironti给出了下面的例子:
fr.po:
1 #: a:6 2 msgid "Can't cd to $var." 3 msgstr "Impossible de se positionner dans le repertoire $var." 4 #: a:7 5 msgid "Enter the value: " 6 msgstr "Entrez la valeur : " 7 8 # 这个字符串和变量名被打印, 没有%s语法, 9 #+ 与C程序很像. 10 #+ 如果程序员使用有意义的变量名, 11 #+ 那么这将会是一个非常酷的特点! |
然后, 运行msgfmt.
msgfmt -o localized.sh.mo fr.po
将文件localized.sh.mo的结果放到/usr/local/share/locale/fr/LC_MESSAGES目录下, 并且在脚本的开头插入如下行:
1 TEXTDOMAINDIR=/usr/local/share/locale 2 TEXTDOMAIN=localized.sh |
如果法文系统上的用户运行这个脚本, 那么她将得到法文消息.
| 在老本的Bash或其他shell中,
本地化需要使用
|
变量TEXTDOMAIN和TEXTDOMAINDIR需要被设置,
并且需要export到环境变量中.
这应该在脚本中完成.
---
此附录由Stephane Chazelas编写, Alfredo Pironti, 和Bruno Haible给出了一些建议, 是GNUgettext的维护者.