1. GNU gettext簡介
以Ｃ語言為範例
Wen Liao

2. 目標
簡介GNU gettext 以及其用法，以Ｃ語言為範例

3. Outline
● 關於GNU gettext
● 使用gettext處理多國語言訊息
● 參考資料
● Q & A

4. 關於gettext
● 1990年代Sun推出的軟體，用於處理Unix下面
程式訊息的多國語言問題。
● 後來GNU協會也推出了GNU gettext

5. Outline
● 關於GNU gettext
● 使用gettext處理多國語言訊息
● 參考資料
● Q & A

6. 流程
● 修改程式碼
○ 告訴系統使用環境變數的語言相關設定
○ 告訴系統要吃那個目錄下面的哪個語文訊息相關檔案
■ 目錄：/aa/bb/cc/LC_MESSAGES
■ 檔案：my_prog.mo
○ 使用gettext API描述程式訊息
● 使用工具產生portable object tempate檔案
(pot)

7. 流程
● 透過pot檔案，使用工具產生需要語言版本訊
息portable object (po)檔如zh_TW.po, fr.po,
ja.po
● 開始翻譯
● 把翻譯好的po轉成平台可辨識的machine
object (mo)檔案

8. http://en.wikipedia.org/wiki/File:Gettext.svg

9. 範例 (印出訊息，支援中文和英文）
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <locale.h>
#include <libintl.h>
#define MAX_CHAR (32)
int main(int argc, char **argv)
{
char dest[MAX_CHAR];
char transport[MAX_CHAR];
gettext和設定語系
用到的header file

10. 範例 (印出訊息，支援中文和英文）
setlocale(LC_ALL, "");
bindtextdomain(PACKAGE, LOCALEDIR);
textdomain(PACKAGE);
strncpy(dest, gettext("Taipei"), MAX_CHAR);
strncpy(transport, gettext("bus"), MAX_CHAR);
printf(gettext("I will go to %s by %s.n"), dest, transport);
return 0;
}
使用環境變數設定的
語言環境 指定要吃那個目錄
的哪個語言檔案c
載入語言檔案
gettext API

11. 編譯
$ gcc -Wall -Werror -g -DPACKAGE="
test_gettext" -DLOCALEDIR="
/home/user/gettext/po" test_gettext.c -o
test_gettext
使用者自行設定語言檔
目錄和檔案。正式使用
可放在/usr/share/locale
下面對應的語系目錄。

12. po 目錄 tree view
$ tree po/
po/
└── zh_TW
└── LC_MESSAGES
└── test_gettext.mo

13. 產生pot檔
xgettext -o test_gettext.pot --add-comments=- -
k_ test_gettext.c

14. pot內容節錄
# SOME DESCRIPTIVE TITLE.
# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT
HOLDER
# This file is distributed under the same license as the
PACKAGE package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.

15. pot內容節錄
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSIONn"
"Report-Msgid-Bugs-To: n"
"POT-Creation-Date: 2014-06-04 12:36+0800n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONEn"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>n"
"Language-Team: LANGUAGE <LL@li.org>n"
"Language: n"
"MIME-Version: 1.0n"
"Content-Type: text/plain; charset=CHARSETn"
"Content-Transfer-Encoding: 8bitn"

16. pot內容節錄
#: test_gettext.c:40
msgid "Taipei"
msgstr ""
#: test_gettext.c:41
msgid "bus"
msgstr ""

17. pot內容節錄
#: test_gettext.c:44
#, c-format
msgid "I will go to %s by %sn"
msgstr ""

18. 從pot檔產生中文po檔案
● msginit --locale=zh_TW --input=test_gettext.
pot --no-translator

19. 未翻譯前po系統和手動更新部份
“POT-Creation-Date: 2014-05-30 21:18+0800n"
"PO-Revision-Date: 2014-05-30 21:18+0800n"
"Language-Team: Chinese (traditional) <zh-
l10n@linux.org.tw>n"
"Language: zh_TWn"
"MIME-Version: 1.0n"
"Content-Type: text/plain; charset=UTF-8n"

20. 更新中文po檔案
● 隨著程式持續開發會新增新的訊息，此時舊的
翻譯還在，所以需要比對新的pot檔並且合併
到原本翻譯的po檔內。
● msgmerge zh_TW.po test_gettext.pot

21. 翻譯po檔
msgid "Taipei"
msgstr "台北"
msgid "bus"
msgstr "公車"
msgid "I will go to %s by %sn"
msgstr "我搭乘%2$s到%1$s。n"
名詞順序會隨語言不同
而改變，gettext可以在翻
譯時更改順序。

22. 產生mo檔案
msgfmt zh_TW.po -o
/home/user/gettext/po/zh_TW/LC_MESSAGES/
test_gettext.mo

23. 驗收成果
$ LC_ALL=en_US.utf8 ./test_gettext
I will go to Taipei by bus
$ LC_ALL=zh_TW.utf8 ./test_gettext
我搭乘公車到台北。
en_US.uft8等資料可以
由locale -a取得

24. 同場加映, fuzzy
#, fuzzy
msgid "Taipei"
msgstr "台北"
● 產生mo後執行結果
$ LC_ALL=zh_TW.utf8 ./test_gettext
我搭乘公車到Taipei。 , fuzzy是gettext工具語法，表
示該翻譯尚未定案，所以執行
時不會使用該翻譯。

25. Outline
● 關於GNU gettext
● 使用gettext處理多國語言訊息
● 參考資料
● Q & A

26. 參考資料
● Wikipedia: gettext
○ http://en.wikipedia.org/wiki/Gettext
● gettext手冊
○ http://www.gnu.org/software/gettext/manual/gettext.
html
● C語言中使用gettext
○ http://wen00072-blog.logdown.com/posts/202230-
study-on-gettext

27. Outline
● 關於GNU gettext
● 使用gettext處理多國語言訊息
● 參考資料
● Q & A