GETTEXT Howto
승윤
이
INZEN
sylee (at) inzen.com
$Date $
$Revision : $
2002
Copyright
이 문서는 GNU Free
Documentation License 버전 1.1 혹은 자유 소프트웨어 재단에서
발행한 이후 판의 규정에 따르며 저작권에 대한 본 사항이 명시되는 한
어떠한 정보 매체에 의한 본문의 전재나 발췌도 무상으로 허용됩니다.
2.0
2002년 11월 5일
sylee
버젼 2.0
gettext 소개와 간단한 사용법
gettext 소개
사용자의 locale 에 따라 특정 message output 에 대한 다국어 처리를 할 수 있는 gettext 에 대해 살펴본다.
이를 위해 먼저 메세지가 처리될 프로그램을 작성하는 법을 shell script, C code 에서 살펴보고,
그 후에 변환될 메세지를 작성하는 방법을 살펴본다.
shell script 에서의 gettext 사용
shell 에서의 사용법을 살펴 본다.
예제 프로그램으로 Hello 라는 shell script 를 작성한다.
단순히 Hello 와 World! 라고 출력하게 되어 있다.
이를 locale 에 따라 출력하기 위해 gettext 로 둘러싸서 echo 시키고 있다.
shell script 에서 특별히 다른 부분은 소스첫 부분에 TEXTDOMAINDIR 과 TEXTDOMAIN 을
전체 환경변수로 export 시킨다는 것이다.
#! /bin/sh
# Hello
TEXTDOMAINDIR=/usr/local/share/locale
TEXTDOMAIN=Hello
export TEXTDOMAINDIR
export TEXTDOMAIN
echo "$(gettext -s "Hello")"
echo "$(gettext -s "World!")"
C code 에서의 gettext 사용
C code 에서의 사용법을 살펴본다.
예제 프로그램으로 Hello.c 라는 C code 를 작성한다.
이 프로그램은 Greeting, Hello, World 라고 출력을 하는데 각각의 message 들을
gettext 를 이용하여 사용자 locale 에 따라 출력토록 한다.
#include <libintl.h>
#include <locale.h>
#include <stdio.h>
int
main(void)
{
/* 현재 호스트의 locale 을 사용한다. */
setlocale(LC_ALL,"");
/* Hello 의 message table 을 /usr/local/share/locale 아래에서 찾도록 한다. */
bindtextdomain("Hello", "/usr/local/share/locale");
textdomain("Hello");
printf("original message : %s\n", "Greeting");
printf("gettext trans : %s\n", gettext("Greeting"));
printf("original message : %s\n", "Hello");
printf("gettext trans : %s\n", gettext("Hello"));
printf("original message : %s\n", "World!");
printf("gettext trans : %s\n", gettext("World!"));
return 0;
}
string 을 gettext 로 둘러싸게 되면 둘러싸인 message 가 해당 locale에 해당하는
message table 을 참조하여 출력하게 된다. 여기서 참조할 message table 을 프로그램에 연결시키기 위해서
bindtextdomain 을 사용하였다. 위 예제에서는 위 코드를 Hello 라는 이름으로 빌드하고, 이의 message table 은
/usr/local/share/locale 아래에서 textdomain 에서 지정한 Hello 프로그램의 message table 을 참조하도록
한것이다.
만약 해당하는 message table 이 없거나 정의된 값이 없을 경우에는 변환 없이 원래 message가 출력된다.
gettext message table 작성법
gettext 를 통해 변환될 message 들을 담는 message table 을 작성하는 요령을 살펴본다.
gettext는 정해진 message 를 미리 정해진 message 로 바꾸어 주는 역할을 할 뿐이다.
따라서 원본 message 와 이것이 어떤 message 로 변환될 지를 나타내어 주는 table 이 필요하다.
이의 초안이 되는 것이 *.po 에 해당하는 파일이다.
이 초안을 직접 작성할 수도 있지만 xgettext 라는 프로그램이 그 초안을 만들어 준다.
# shell script
xgettext Hello
# C code
xgettext Hello.c
xgettext 를 사용하고 나면 messages.po 라는 파일이 생성된다.
이는 GNU version 의 gettext 인지 아닌지에 따라 약간 다르지만 뼈대는 비슷하다.
이 po 파일은 보통의 text 파일이고, msgid 와 msgstr 의 짝으로 이루어져 있으며,
msgid 가 위 예제 프로그램 속에서 gettext 로 둘러싸인 message 들이다.
그리고 msgstr 이 변환될 메세지를 담게 된다.
xgettext 를 하고 나면 msgid 들이 모두 추출되며, 사용자는 단지 msgstr 부분의 빈곳만 채워주면 된다.
다음과 같이 채워보자.
앞 절의 프로그램들에서 Hello 와 World! 를 gettext 가 변환하기 위해서는 아까 생성된 po 파일의 msgstr부분을 아래처럼
수정하면 된다.
msgid "Hello"
msgstr "헬로"
msgid "World!"
msgstr "월드!"
이제 이렇게 작성된 파일을 msgfmt 라는 프로그램을 이용하여 gettext 가 이해할 수 있는 파일인 mo파일로 변환한다.
이 mo파일은 binary 형식의 파일이다.
msgfmt -o Hello.mo messages.po
출력 파일 이름을 Hello.mo 라 한 이유는 생성될 mo 파일의 이름을 프로그램의 이름과 같이 하기 위해서이다.
이제 이를 /usr/local/share/locale/ko/LC_MESSAGE/ 아래에 넣어 두면 된다.
한국어로 locale 이 설정되어 있다면 ...locale/ko/ 아래를 참조하게 된다.
만약 프랑스어로 message translation 을 하고자 할 경우에는 해당 .po 파일의 msgstr 을 불어로 작성한다.
그리고 이를 msgfmt 로 Hello.mo 로 만든 후 만들어진 mo 파일을 /usr/local/share/locale/fr/LC_MESSAGE/ 아래에 넣어 두면 된다.
시스템 로케일에 따라 영어, 한국어, 혹은 불어 message 가 출력된다.
Non GNU vs GNU
GNU version 의 gettext 인지 아닌지에 따라 차이점이 있다고 언급했다.
실제로는 이 차이 때문에 message 변환이 안 되기도 한다.
그 차이점은 messages.po 파일의 format 에 있다.
non GNU version 의 gettext 를 사용하게 될 때면 앞 절에서 작성한 것처럼 msgid, msgstr 의 쌍으로도 충분하다.
그렇지만 GNU version 의 gettext 에서는 위 처럼 해서는 원하는 결과를 얻을 수 없다.
xgettext 로 만들어진 messages.po 를 보자
non GNU messages.po
domain "messages"
# File:Hello.c, line:22, textdomain("Hello");
msgid "Greeting"
msgstr
msgid "Hello"
msgstr
msgid "World!"
msgstr
GNU messages.po
# 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.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2002-11-13 15:09+0900\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=CHARSET\n"
"Content-Transfer-Encoding: 8bit\n"
#: Hello.c:26
msgid "Greeting"
msgstr ""
#: Hello.c:29
msgid "Hello"
msgstr ""
#: Hello.c:32
msgid "World!"
msgstr ""
GNU messages.po 에서는 사용자가 수정해 주어야 할 사항들이 몇 가지 더 있다.
기본 정보 이외에 CHARSET 을 지정해 주어야 한다. 한국어일 경우는 euc-KR 로 지정해 주어야 안전하다.
GNU 이냐 아니냐에 따라 작성법은 그다지 다르지 않다. 중요한 것은 빌드 방법이다.
GNU gettext 를 사용한다면 xgettext, msgfmt 도 GNU version 을 사용하여야 한다.
non GNU gettext 를 사용한다면 역시 xgettext, msgfmt 도 gettext 와 같은 것을 사용하여야 한다.
그리고 C code 일 경우에는 빌드할 때 링크될 라이브러리를 직접 명시해 주는 것이 안전하다.
(GNU 일때는 GNU 라이브러리, non GNU 라이브러리일 때는 해당 라이브러리)
# example
shell> gcc Hello.c -o Hello -lintl
실행결과
이제 Hello 라는 프로그램이 실행될 때 실행되고 있는 환경의 locale에 따라 xgettext, msgfmt 에 의해 만들어진,
Hello.mo 를 참조할 것인지 혹은 그냥 메세지를 출력할 것인지를 결정하게 된다.
설정했던 message 가 출력되게 된다. C program 의 실행 예이다.
original message : Greeting
gettext trans : Greeting
original message : Hello
gettext trans : 헬로
original message : World!
gettext trans : 월드!
Greeting 은 message table 에 존재하지 않으므로 그냥 Greeting 이 찍히게 된다. 나머지
message 들은 message table 에 정의된 msgstr 값을 참조하여 출력하고 있다.
Miscellaneous
환경변수 중 LC_MESSAGES 가 C 로 정의되어있다면 메세지 전환이 이루어지지 않는다.
이를 변환하고자 하는 locale 로 바꾸어 주는 것이 좋다. setlocale(LC_MESSAGES, "ko_KR");
non GNU 일 때의 *.po 는 msgid, msgstr 의 쌍으로만 직접 작성하여도 된다.
GNU gettext 를 사용할 때에는 흔히 gettext(String) 을 _(String) 으로 define 해서 사용한다.
이때에는 xgettext -k_ test.c로 po파일을 생성하면 된다.