編輯“Gallery:本地化”（章節(jié)）

== 本地化的新建 ==

瀏覽一下Gallery就能發(fā)現(xiàn)不少名為"po"的目錄。（"po"是一gettext術(shù)語，即"可移植對象（portable object）"）。以下為找到它們的一個方法：

<pre>
find . -type d -name po			<-- 輸入這個

./themes/matrix/po	          	<-- 會看到這個
./lib/tools/po
./modules/core/po
./modules/comment/po
./modules/netpbm/po

** 忽略"lib/tools/po"目錄。
</pre>

這些目錄還有翻譯源文件。你要
使用合適的語言代碼來新建文件，接著在它們之中
添入經(jīng)過翻譯的文本。首先要做的就是從
下面的兩個表格中識別出正確的代碼：

; 語言代碼:
: http://www.gnu.org/software/gettext/manual/html_mono/gettext.html#SEC221
: (or http://ftp.ics.uci.edu/pub/ietf/http/related/iso639.txt)

; 國家代碼:
: http://www.gnu.org/software/gettext/manual/html_mono/gettext.html#SEC222
: (or http://www.iso.ch/iso/en/prods-services/iso3166ma/02iso-3166-code-lists/list-en1.html)

在大多數(shù)情況下，你只需要語言代碼即可，如德語就是"de"。要為多個國家中提供特定國家語言的翻譯，你可以使用這樣的代碼格式，xx_XX，例如"pt_BR"表示葡萄牙語/巴西。如果你確定該用哪一個，包括語言和國家。如果你發(fā)現(xiàn)已有你使用語言的翻譯的話，請接著看 [[#本地化的維護(hù)|本地化的維護(hù)]]。

一旦選好了代碼，就需要為你的代碼新建一個.po
文件。假定你選擇是的"de"。那么對各po目錄，
你需要做的是：

<pre>
make de.po
</pre>

這將找到該本地化標(biāo)記的所有文本（tpl文件中的[[Gallery:Tpl_Reference#Gallery_Custom_Tags|{g->text}]]，php代碼中的translate()或i18n()），并創(chuàng)建一個即將進(jìn)行翻譯的po文件。

有關(guān)文本編輯器。
* 有一些工具可以處理.po文件：
** [http://poedit.sourceforge.net/ poEdit]（多平臺）
** [http://i18n.kde.org/tools/kbabel/ KBabel]（Unix KDE）
** [http://gtranslator.sourceforge.net/ GTranslator]（Unix Gnome）
** [http://www.gnu.org/software/emacs/emacs.html Emacs with po-mode]（多平臺）
** [http://www.vim.org/ Vim] with [http://www.vim.org/scripts/script.php?script_id=695 PO plug-in]（多平臺）
我比較喜歡用XEmacs，因此我會
在下面的例子中拿XEmacs做例子。如果你有其他編輯器
的使用指導(dǎo)，請分享一下。XEmacs的主要模式被稱為"po-模式"，如果你安裝了它，在編輯.po文件時就會
自動轉(zhuǎn)入。我在這里不準(zhǔn)備這么做，但
你可以嘗試一下。

現(xiàn)在我們來編輯de.po。在其頂部應(yīng)有Gallery的證書。你需要對以下值做自定義：

; Last-Translator
:將你的名字及email以此格式輸入："FirstName LastName &lt;email@address&gt;"
; Language-Team
: 輸入語言及-翻譯郵件列表，如"German &lt;gallery-translations@lists.sourceforge.net&gt;"
; Content-Type
: 將此設(shè)置給"Content-Type：text/plain; charset=UTF-8\n"
: 我們希望你使用UTF-8字符集。因為它允許我們在同一頁面上對多個語言進(jìn)行渲染，這對某一語言站點頁面上其他語言的用戶評論是有好處的。

這里有[http://cvs.sourceforge.net/viewcvs.py/gallery/gallery2/modules/core/po/de.po?rev=1.13&view=auto modules/core/po/de.po]的完整的header樣例。注意編寫者是如何維護(hù)前任翻譯者名單的。
<pre>
# 前任翻譯者（迄今所知，如有脫漏，請在此添加）：
# - Jens Tkotz <jens@peino.de>
# - Ernesto Baschny <ernst@baschny.de>
...
#
msgid ""
msgstr ""
"Project-Id-Version: Gallery: Core 1.0.32\n"
"POT-Creation-Date: 2003-02-11 03:09-0800\n"
"PO-Revision-Date: 2006-03-05 02:25+0000\n"
"Last-Translator: Frederik Kunz <frederik.kunz@web.de>\n"
"Language-Team: German <gallery-devel@lists.sourceforge.net>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
</pre>

如果你的語言中不包含復(fù)數(shù)詞用法，如漢語或土耳其語，就得修改以下語句：

<pre>
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
    -> Change to "Plural-Forms: nplurals=1; plural=0;\n".
</pre>
這樣，你只需翻譯msgstr[0]并注釋掉或移除msgstr [1].

接著來看看Gallery證書下的語句行：

<pre>
#, fuzzy
msgid ""
msgstr ""
</pre>

模糊的關(guān)鍵詞告知你區(qū)塊的翻譯
不完整。但一旦更新了administration entry，就
可以移除"#, fuzzy"這一行以允許稍后翻譯的
編譯。

接下來你會看到一系列區(qū)塊：

<pre>
#, c-format		(<-- 在某些語句行中僅能看到這個)
msgid "a message in english, with %d or %s tags in it"
msgstr ""
</pre>

你需要將英語消息的翻譯置入
msgstr區(qū)塊中，用引號括起來，例如：

<pre>
#, c-format
msgid "a message in english, with %d or %s tags in it"
msgstr "eine Anzeige auf englisch, mit %d oder %s etikettiert in ihr"
</pre>

某些msgid值含有有助于進(jìn)行翻譯的提示信息：

<pre>
#. HINT: Button label for Bold
msgid "B"
msgstr "F"
</pre>
注意提示內(nèi)容不應(yīng)翻譯或包括在msgstr文本中。你可以使用[http://sourceforge.net/tracker/?func=browse&group_id=7130&atid=582564 翻譯追蹤器（Translations Tracker）]為特殊字串請求額外的提示文本。指定模塊/外觀主題以及msgid。注意<tt>strings.raw</tt>文件列出了用到msgid的文件。

在編輯這些消息之前，你確實應(yīng)當(dāng)將編輯器設(shè)為UTF-8模式，
這樣編輯器才能使用正確的字符集。
如果你由于某種原因無法在UTF-8模式中進(jìn)行編輯，
請考慮使用GNU的"recode"程序，在提交翻譯內(nèi)容給我們之前，
將其轉(zhuǎn)為UTF-8（或者直接發(fā)給我們也許，我們會進(jìn)行重新編碼）。

如果你使用XEmacs的MULE（即多語言支持（MULtilanguagE）），你可以將一下內(nèi)容添加到
~/.xemacs/init.el中去

<pre>
; Enable Unicode support (via Mule-UCS)
;
(require 'un-define)
(set-coding-priority-list '(utf-8))
(set-coding-category-system 'utf-8 'utf-8)
</pre>

當(dāng)你編輯UTF-8的文件時，會有一些"u"
出現(xiàn)在屏幕底部狀態(tài)條左側(cè)。使用現(xiàn)有的
.po文件來看一看。

在進(jìn)行一些翻譯之后，來看看效果。運行：

<pre>
make install PO=de
</pre>

它會將你的.po文件編譯到一個.mo文件中，并將其安裝到合適的位置。在修改.po文件之后，對各目錄都要重復(fù)此步驟。如果你在創(chuàng)建locale目錄時發(fā)生錯誤，請在運行make之前建立目錄結(jié)構(gòu)（如：modules/mymodule/locale/de/LC_MESSAGES）。

最后，你需要編輯modules/core/classes/GalleryTranslator.class，并在函數(shù)getLanguageData中加入如下語句：

<pre>
/* German */
$this->_supportedLanguages['de']['DE']['description'] = 'Deutsch';
$defaultCountry['de'] = 'DE';
</pre>
批注應(yīng)為該語言的英語說法；語言
'描述'則應(yīng)是該語言的本土說法。

現(xiàn)在登入G2，在用戶偏好（你可能需要
通過站點管理對用戶進(jìn)行編輯）中，你應(yīng)能在下拉列表中看到
German。而如果你選擇了它，并以剛才那個用戶的身份登入的話，
就能看到消息被翻譯為該語言了。你還可以將語言選擇器區(qū)塊
添加到站點中，使用外觀主題設(shè)定就可以做到。

'''注：''' 如果語言修改沒有起效，請回顧一下[[Gallery:Language_Settings|語言設(shè)定]]的優(yōu)先級（會話語言（Session language） > 用戶偏好（user preferences） > 站點范圍的默認(rèn)語言（site wide default language））。如果有疑慮的話，可以使用語言區(qū)塊或在用戶偏好中反復(fù)嘗試。