編輯“Gallery:本地化”

= Localizing Gallery 2 =

== Overview ==

Gallery is internationalized.  Instead of containing language specific
text messages, it tracks text in a special way so that it can be
extracted and translated into other languages.  Users will see a
version of the text that has been converted into their own language.

In order for the users to see a localized version of Gallery's text,
somebody must first translate the text messages that Gallery is going
to display.  This process is called "localization".

Here we try to outline how you can create and maintain localization
files for the content in G2.  It's not a particularly difficult thing
to do but it requires us to keep the various files up to date whenever
the underlying content changes.  Luckily we have tools that will aid
in this process.

== Requirements ==

In order to really do this effectively, you need to have a few tools
installed on your machine.  I've only tested this process on a FreeBSD
box, but my guess is that you won't have too much difficulty on Linux,
Solaris, or other Unix variants.  You may have difficulties following
along on Windows, but it should be possible.
The following should be installed and in your PATH:

; gettext : http://www.gnu.org/software/gettext/
; gmake (or make): http://www.gnu.org/software/make/make.html
; php binary : http://php.net
; perl : http://perl.com

'''Note''': if you're using FreeBSD then you want to use ''gmake'' instead of ''make'' since FreeBSD's default make is not GNU compatible.

You also need the current G2 files to create up-to-date translations.  It is best to work from current SVN or a nightly snapshot.  The developer version of the latest G2 release will also work, but some of the strings for translation may be out of date.

== Creating a new localization ==

Look around the Gallery distribution and you'll find a bunch of directories called "po".  ("po" is a gettext term that stands for "portable object").  Here's one way to find them:

<pre>
find . -type d -name po			<-- you type this

./themes/matrix/po	          	<-- you see this
./lib/tools/po
./modules/core/po
./modules/comment/po
./modules/netpbm/po

** Ignore the "lib/tools/po" directory.
</pre>

These directories contain translation source files.  You're going to
create new files with an appropriate language code, and then fill them
with translated text.  The first thing to do is to identify the
correct codes from the following two tables:

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

; Country codes:
: 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)

In most cases you will need just the language code, such as "de" for German.  To provide country specific translations for a language used in multiple countries you can use a code in the format xx_XX, such as "pt_BR" for Portuguese/Brazil.  If you are unsure which to use, include both language and country.  If you find a translation for your language already exists then move on to [[#Maintaining_a_localization|Maintaining a localization]].

Once you've chosen the code, you need to create a new .po file for
your code.  Let's assume that you chose "de".  For each po directory,
you need to do this:

<pre>
make de.po
</pre>

This will find all text that is marked for localization ([[Gallery2:Tpl_Reference#Gallery_Custom_Tags|{g->text}]] in tpl files, translate() or i18n() in php code) and create a po file that is ready to be translated.

A word about text editors.
* There are several tools to work with .po files:
** [http://poedit.sourceforge.net/ poEdit] (Multiplatform)
** [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] (Multiplatform)
** [http://www.vim.org/ Vim] with [http://www.vim.org/scripts/script.php?script_id=695 PO plug-in] (Multiplatform)
I personally am a fan of XEmacs so I'll be
talking about XEmacs in my examples below.  If you have instructions for
other editors, please contribute them.  XEmacs has a major mode called "po-mode" which, if you have it installed, you'll automatically wind up
in if you edit a .po file.  I'm not going to go into it here, but try
it out if you have it.

Now edit de.po.  It should have the Gallery license at the top.  You'll need to customize these values:

; Last-Translator
: Put your name and email here in the format: "FirstName LastName &lt;email@address&gt;"
; Language-Team
: Put in the language and the -translations mailing list, eg: "German &lt;gallery-translations@lists.sourceforge.net&gt;"
; Content-Type
: Set this to "Content-Type: text/plain; charset=UTF-8\n"
: We want you to use the UTF-8 character set because it allows us to render multiple languages on the same page which is nice for sites in one language that have user comments, etc in other languages.

Here's an example of a complete header from [http://cvs.sourceforge.net/viewcvs.py/gallery/gallery2/modules/core/po/de.po?rev=1.13&view=auto modules/core/po/de.po].  Note how the authors have maintained the list of all previous translators as a courtesy.
<pre>
# Previous translators (as far as known, add yourself here, please):
# - 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>

If your language doesn't have plural form like in Chinese or Turkish, you need to change the following line too:

<pre>
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
    -> Change to "Plural-Forms: nplurals=1; plural=0;\n".
</pre>
In this case, you need to translate only msgstr[0] and comment out or remove msgstr[1].

Then, look at the lines just below the Gallery license:

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

The fuzzy keyword tells you that the translation of the block is
incomplete. But once that you update the administration entries, you
can remove the "#, fuzzy" line to allow the translation to compile
later on.

Next, you'll see a series of blocks like this:

<pre>
#, c-format		(<-- you'll only see this on some lines)
msgid "a message in english, with %d or %s tags in it"
msgstr ""
</pre>

You need to put the translation for the English message into the
msgstr block, between the quotes, for example:

<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>

Some msgid values contain hints to assist in translation:

<pre>
#. HINT: Button label for Bold
msgid "B"
msgstr "F"
</pre>
Note that the hint should not be translated or included in the msgstr text.  You can request the addition of hint text for particular strings with the [http://sourceforge.net/tracker/?func=browse&group_id=7130&atid=582564 Translations Tracker].  Specify the module/theme and the msgid.  Note that the <tt>strings.raw</tt> file lists the file(s) where each msgid is used.

You really, really, really should put your editor into UTF-8 mode
before editing these messages so that your editor can use the right
character set.  If you can't edit in UTF-8 for some reason, consider
using the GNU "recode" program to convert your translation to UTF-8
before submitting it to us (or just send it anyway and we'll recode
it).

If you're using XEmacs with MULE (its MULtilanguagE support) you can
add the following to your ~/.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>

Then when you edit a file that is in UTF-8, it'll have a little "u"
in left side of the status bar at the bottom of the screen.  Try it
out with an existing .po file to see what it looks like.

After doing a few translations, try it out to see how it looks.  Run:

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

And it will compile your .po file into a .mo file and install it in the appropriate place for the module.  Repeat this for every directory where you modified a .po file.  If you get errors about creating the locale directory then try creating the directory structure before running make (example: modules/mymodule/locale/de/LC_MESSAGES).

Finally, you need to edit modules/core/classes/GalleryTranslator.class and in function getLanguageData, add lines like this:

<pre>
/* German */
$this->_supportedLanguages['de']['DE']['description'] = 'Deutsch';
$defaultCountry['de'] = 'DE';
</pre>
The comment should be the name of the language in English; the language
'description' is the name of the language in that language.

Now, log onto G2 and in the User preferences (you may need to edit the
user via the Site Administrator) you should see German appear in the
dropdown, and if you select it and log on as that user you'll see your
translated messages.  Alternatively, add the Language selector block
to your site using Theme settings.

'''Note:''' If the language change doesn't take effect, please review the precedence of the [[Gallery2:Language_Settings|language settings]] (Session language > user preferences > site wide default language). In doubt, use the language block or toggle the language in your user preferences back and forth.

== Submitting your localization ==

Now that you've got your localization created, you need to package
it up and send it to us so that we can commit it into the repository.
The best way to package it is like this:

<pre>
cd gallery2
zip de.zip `find . -name de.po`
</pre>

or:
<pre>
cd gallery2
tar czf nl.tar.gz `find . -name nl.po`
</pre>

This will make up a zipfile or tarball of just your translated files.  Obviously, use your language code instead of de or nl above.  Then, go to the [http://sourceforge.net/tracker/?func=browse&group_id=7130&atid=582564 Translations Tracker] on the Gallery project page on SourceForge and click the "Submit New" button.  Put your translation in the "Gallery 2" group and don't forget to attach the files (you must check the checkbox for attachment too!).  If your translation doesn't
get committed within a few days, jump on IRC (see [[#Where_to_go_for_help!|help section]]) and talk to us about it.

== Maintaining a localization ==

<pre>
cd po
make de.po	(using German as an example)
</pre>

This will extract all messages from the module that you're in and
update the .po file.  Look through the .po file for any blocks that
have an empty msgstr, or are marked "fuzzy" and update them.  After
they are fixed, remove the fuzzy tag.  You may find tags that look
like this:

<pre>
#, fuzzy
#~ msgid "User"
#~ msgstr "Gebruikersnaam"
</pre>

The "#, fuzzy" means that its fuzzy, but the "#~" means that the
string no longer exists in G2 (we probably deleted or changed it
significantly).  You can delete these entries.

You should do a quick check that gettext provides to validate your .po file:
 msgfmt -v -c --stat de.po

When you've got everything right, run:

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

The translation files get cached by PHP (which is why it's so fast)
so you may not see change until you restart your web server.  That's
annoying, but I haven't figured a good workaround for it yet.

See the [[#Creating_a_new_localization|Creating a new localization]] section for testing info, and submit the new files to us.

== Where to go for help! ==

If you need help, there are three places to go:

; The Gallery translations forums:
: http://gallery.menalto.com/forum/74

; The gallery-translations mailing list:
: http://codex.gallery2.org/index.php/Mailing_Lists

; The Gallery IRC channel
: #gallery on irc://chat.freenode.net

== List of Translations ==
All available Gallery 2 translations, listed alphabetically along with the maintainers / translators. Some translations are 100% up to date and complete, others are only 2% complete or out of date. See: [http://gallery.menalto.com/localization/gallery2 Localization Report]. If you have the developer package of G2, you can run {{exampleurl|/lib/tools/reports/localization.php}} to see the status of all installed translations.

{| class="gallery" style="background-color: #eee; width: 800px"
|-
! align="left" width="200px" | Language
! align="left" | Language Code
! align="left" | Last Translator
! align="left" | List of Translators
|-
|Afrikaans
Afrikaans
|af
|Renier
|Renier
|-
|???????
Arabic
|ar
|Mohammad Saleh 
|Mohammad Saleh 
|-
|Български
Bulgarian
|bg
|Bisser Dobrev
|Bisser Dobrev
|-
|Беларуская
Belarusian
|be
|Alex Lavysh
|Alex Lavysh
|-
|Català
Catalan
|ca_ES
|Roger Cervantes
|Juan Vega Aiguadé; Roger Cervantes
|-
|中國
Chinese [Simplified]
|zh_CN
|Wayne Zhang
|Wayne Zhang
|-
|臺灣
Chinese [Traditional]
|zh_TW
|Stephen Chu
|Stephen Chu
|-
|?esky
Czech
|cs
|Jan Korbel
|Jan Korbel
|-
|Dansk
Danish
|da
|Jens Hyllegaard 
|Lasse Bang Mikkelsen, Allan Beaufour, Bj?rn Graabek, Jens Hyllegaard
|-
|Deutsch
German
|de
|Andy Staudacher
|Jens Tkotz, Ernesto Baschny, Frederik Kunz, Georg Rehfeld, Bananeweizen, Moritz Stoltenburg
|-
|Ελληνικ?
Greek
|el
|Anthi Andreou
|Nikos Batsis, Anthi Andreou
|-
|English [British]
|en_GB
|Stephen Ryan
|Joan McGalliard, Alan Harder, Stephen Ryan
|-
|Espa?ol
Spanish 
|es
|Oscar Garcia Amor
|Oscar Garcia Amor
|-
|Espa?ol de Argentina
Spanish [Argentine]
|es_AR
|Alvaro Cortizo
|Alvaro Cortizo
|-
|Espa?ol de Mexico
Spanish [Mexican]
|es_MX
|Wieland E. Kublun
|Wieland E. Kublun
|-
|Eesti
Estonian
|et
|poromaan
|poromaan
|-
|Euskera
Basque
|eu
|Piarres Beobide
|Piarres Beobide
|-
|?????
Farsi
|fa
|Mohammad Samini
|Jalal Kheradmand, Pedram Hayati, Mohammad Samini
|-
|Fran?ais
French
|fr
|Arnaud MOURONVAL 
|Arnaud MOURONVAL
|-
|????? 
Hebrew
|he
|Guy Sheffer
|Guy Sheffer, Omri Amos
|-
|Irish Gaelic
Irish
|ga
|Beckett Madden-Woods
|Beckett Madden-Woods
|-
|íslenska
Icelandic
|is
|Johann S Jonsson 
|Johann S Jonsson
|-
|Italiano
Italian
|it
|Ermanno Baschiera 
|Ermanno Baschiera
|-
|日本語
Japanese
|ja
|Kennichi Uehara
|Kennichi Uehara, Yosuke Suzuki
|-
|&#xd55c;&#xad6d;&#xb9d0;
Korean
|ko
|Juice
|Juice
|-
|Latvie?u
Latvian
|lv
|Jānis Bai?a
|Jānis Bai?a
|-
|Lietuvi?
Lithuanian
|lt
|Darius ?itkevi?ius
|Darius ?itkevi?ius
|-
|Magyar
Hungarian
|hu
|Sandor Dibuz
|Gergely D?ms?di, József R.Nagy, Sandor Dibuz
|-
|Nederlands
Dutch
|nl
|Marijke van Velsen
|Marcel van Groenigen, Kees van den Broek, Arjen Gideonse, B. Scheijgrond, Marijke van Velsen
|-
|Norsk Bokm?l
Norwegian
|no
|Sverre M. Vikan
|Frode Tviberg, Sverre M. Vikan, Jon Harald Carlsen, Robin Smidsrod (sponsored by [http://www.griegmultimedia.no Grieg Multimedia AS]), Terje Dahl
|-
|Polski
Polish
|pl
|Kappana
|Sebastian Marek, Kappana
|-
|Português
Portuguese 
|pt
|Francisco Neto
|Hugo Cruz, Francisco Neto
|-
|Português Brasileiro
Portuguese [Brazilian]
|pt_BR
|Paulino Michelazzo
|Ernesto Baschny, José Ricardo, Celso Reeks, Paulino Michelazzo
|-
|Roman?
Romanian
|ro
|Serban Constantintinescu
|Serban Constantintinescu
|-
|Русский
Russian
|ru
|Ser Moro
|Konstantin Ivanov, modus, Ser Moro
|-
|Укра?нська
Ukrainian
|uk
|Anton Gladky
|Yurii Smetana, Anton Gladky
|-
|Qu?c Ng? (國語)
Vietnamese
|vi
|Trung Dong Huynh
|Trung Dong Huynh
|-
|Suomea
Finnish
|fi
|Jyrki Heinonen
|Jussi Karppanen; Erkka Hakkarainen; Jyrki Heinonen
|-
|Srpski
Serbian 
|sr
|Jozef Selesi 
|Jozef Selesi
|-
|Sloven?ina
Slovak
|sk
|Branislav Hanacek
|Branislav Hanacek
|-
|Sloven??ina
Slovenian
|sl
|Jure Babnik
|Janez Troha, Jure Babnik
|-
|Svenska
Swedish
|sv
|Anders Lindquist
|Christian Wallin, Mikael Gustafsson, Peter Liversten, Hampus Nygren, Anders Lindquist
|-
|Türk?e
Turkish
|tr
|Goker ISIK
|Goker ISIK, Roman Neumüller
|}
@@ 第1行： / 第1行： @@
-= Gallery2的本地化 =
+= Localizing Gallery 2 =
-== 綜述 ==
+== Overview ==
-Gallery是國際化的。不對特定語言文本消息的包含，
+Gallery is internationalized.? Instead of containing language specific
-取而代之地，它使用特殊的方法追蹤文本
+text messages, it tracks text in a special way so that it can be
-以進(jìn)行抽取并翻譯成其他語言。用戶則會看見
+extracted and translated into other languages.? Users will see a
-文本被翻譯成他們使用的語言版本。
+version of the text that has been converted into their own language.
-為了能夠讓用戶看到Gallery文本的本地化版本，
+In order for the users to see a localized version of Gallery's text,
-就需要先將這些Gallery要顯示的文本消息進(jìn)行
+somebody must first translate the text messages that Gallery is going
-翻譯。此過程就被稱為"本地化"。
+to display.? This process is called "localization".
-這里我們嘗試說明一下如何創(chuàng)建并維護(hù)G2中本地化
+Here we try to outline how you can create and maintain localization
-文件的內(nèi)容。這并不是特別困難的任務(wù)，
+files for the content in G2.? It's not a particularly difficult thing
-但要求無論何時基礎(chǔ)內(nèi)容有改變，我們都要保證
+to do but it requires us to keep the various files up to date whenever
-各類文件的更新度。我們挺幸運(yùn)的，因為有這樣的工具能
+the underlying content changes.? Luckily we have tools that will aid
-協(xié)助我們完成此類操作過程。
+in this process.
-== 要求 ==
+== Requirements ==
-為了能夠有效率地進(jìn)行，你需要在計算機(jī)上
+In order to really do this effectively, you need to have a few tools
-安裝一些工具。我僅在FreeBSD
+installed on your machine.? I've only tested this process on a FreeBSD
-box中做了測試，但我想如果用在Linux，Solaris或其他Unix類系統(tǒng)
+box, but my guess is that you won't have too much difficulty on Linux,
-上也不會太麻煩。在Windows上可能會有些難度，
+Solaris, or other Unix variants.? You may have difficulties following
-但也是有可能實現(xiàn)的。
+along on Windows, but it should be possible.
-以下為必須安裝，并在你的路徑中：
+The following should be installed and in your PATH:
 ; gettext : http://www.gnu.org/software/gettext/
-; gmake （或make）: http://www.gnu.org/software/make/make.html
+; gmake (or make): http://www.gnu.org/software/make/make.html
-; php二進(jìn)制: http://php.net
+; php binary : http://php.net
 ; perl : http://perl.com
-'''注'''：如果你使用FreeBSD，并希望能取代''make''而使用''gmake''，因為FreeBSD的默認(rèn)不與GNU兼容。
+'''Note''': if you're using FreeBSD then you want to use ''gmake'' instead of ''make'' since FreeBSD's default make is not GNU compatible.
-你還需要用當(dāng)前G2文件創(chuàng)建最新的翻譯。就目前的SVN或nightly快照版的運(yùn)行情況都不錯。最新的G2開發(fā)者版本也能運(yùn)行，但某些翻譯的字串可能有些過時了。
+You also need the current G2 files to create up-to-date translations.? It is best to work from current SVN or a nightly snapshot.? The developer version of the latest G2 release will also work, but some of the strings for translation may be out of date.
-== 本地化的新建 ==
+== Creating a new localization ==
-瀏覽一下Gallery就能發(fā)現(xiàn)不少名為"po"的目錄。（"po"是一gettext術(shù)語，即"可移植對象（portable object）"）。以下為找到它們的一個方法：
+Look around the Gallery distribution and you'll find a bunch of directories called "po".? ("po" is a gettext term that stands for "portable object").? Here's one way to find them:
 <pre>
-find . -type d -name po			<-- 輸入這個
+find . -type d -name po			<-- you type this
-./themes/matrix/po	? ? ? ? ? 	<-- 會看到這個
+./themes/matrix/po	? ? ? ? ? 	<-- you see this
 ./lib/tools/po
 ./modules/core/po
@@ 第49行： / 第49行： @@
 ./modules/netpbm/po
-** 忽略"lib/tools/po"目錄。
+** Ignore the "lib/tools/po" directory.
 </pre>
-這些目錄還有翻譯源文件。你要
+These directories contain translation source files.? You're going to
-使用合適的語言代碼來新建文件，接著在它們之中
+create new files with an appropriate language code, and then fill them
-添入經(jīng)過翻譯的文本。首先要做的就是從
+with translated text.? The first thing to do is to identify the
-下面的兩個表格中識別出正確的代碼：
+correct codes from the following two tables:
-; 語言代碼:
+; Language codes:
 : http://www.gnu.org/software/gettext/manual/html_mono/gettext.html#SEC221
 : (or http://ftp.ics.uci.edu/pub/ietf/http/related/iso639.txt)
-; 國家代碼:
+; Country codes:
 : 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ù)]]。
+In most cases you will need just the language code, such as "de" for German.? To provide country specific translations for a language used in multiple countries you can use a code in the format xx_XX, such as "pt_BR" for Portuguese/Brazil.? If you are unsure which to use, include both language and country.? If you find a translation for your language already exists then move on to [[#Maintaining_a_localization|Maintaining a localization]].
-一旦選好了代碼，就需要為你的代碼新建一個.po
+Once you've chosen the code, you need to create a new .po file for
-文件。假定你選擇是的"de"。那么對各po目錄，
+your code.? Let's assume that you chose "de".? For each po directory,
-你需要做的是：
+you need to do this:
 <pre>
@@ 第75行： / 第75行： @@
 </pre>
-這將找到該本地化標(biāo)記的所有文本（tpl文件中的[[Gallery:Tpl_Reference#Gallery_Custom_Tags|{g->text}]]，php代碼中的translate()或i18n()），并創(chuàng)建一個即將進(jìn)行翻譯的po文件。
+This will find all text that is marked for localization ([[Gallery2:Tpl_Reference#Gallery_Custom_Tags|{g->text}]] in tpl files, translate() or i18n() in php code) and create a po file that is ready to be translated.
-有關(guān)文本編輯器。
+A word about text editors.
-* 有一些工具可以處理.po文件：
+* There are several tools to work with .po files:
-** [http://poedit.sourceforge.net/ poEdit]（多平臺）
+** [http://poedit.sourceforge.net/ poEdit] (Multiplatform)
-** [http://i18n.kde.org/tools/kbabel/ KBabel]（Unix KDE）
+** [http://i18n.kde.org/tools/kbabel/ KBabel] (Unix KDE)
-** [http://gtranslator.sourceforge.net/ GTranslator]（Unix Gnome）
+** [http://gtranslator.sourceforge.net/ GTranslator] (Unix Gnome)
-** [http://www.gnu.org/software/emacs/emacs.html Emacs with po-mode]（多平臺）
+** [http://www.gnu.org/software/emacs/emacs.html Emacs with po-mode] (Multiplatform)
-** [http://www.vim.org/ Vim] with [http://www.vim.org/scripts/script.php?script_id=695 PO plug-in]（多平臺）
+** [http://www.vim.org/ Vim] with [http://www.vim.org/scripts/script.php?script_id=695 PO plug-in] (Multiplatform)
-我比較喜歡用XEmacs，因此我會
+I personally am a fan of XEmacs so I'll be
-在下面的例子中拿XEmacs做例子。如果你有其他編輯器
+talking about XEmacs in my examples below.? If you have instructions for
-的使用指導(dǎo)，請分享一下。XEmacs的主要模式被稱為"po-模式"，如果你安裝了它，在編輯.po文件時就會
+other editors, please contribute them.? XEmacs has a major mode called "po-mode" which, if you have it installed, you'll automatically wind up
-自動轉(zhuǎn)入。我在這里不準(zhǔn)備這么做，但
+in if you edit a .po file.  I'm not going to go into it here, but try
-你可以嘗試一下。
+it out if you have it.
-現(xiàn)在我們來編輯de.po。在其頂部應(yīng)有Gallery的證書。你需要對以下值做自定義：
+Now edit de.po.? It should have the Gallery license at the top.? You'll need to customize these values:
 ; Last-Translator
-:將你的名字及email以此格式輸入："FirstName LastName &lt;email@address&gt;"
+: Put your name and email here in the format: "FirstName LastName &lt;email@address&gt;"
 ; Language-Team
-: 輸入語言及-翻譯郵件列表，如"German &lt;gallery-translations@lists.sourceforge.net&gt;"
+: Put in the language and the -translations mailing list, eg: "German &lt;gallery-translations@lists.sourceforge.net&gt;"
 ; Content-Type
-: 將此設(shè)置給"Content-Type：text/plain; charset=UTF-8\n"
+: Set this to "Content-Type: text/plain; charset=UTF-8\n"
-: 我們希望你使用UTF-8字符集。因為它允許我們在同一頁面上對多個語言進(jìn)行渲染，這對某一語言站點頁面上其他語言的用戶評論是有好處的。
+: We want you to use the UTF-8 character set because it allows us to render multiple languages on the same page which is nice for sites in one language that have user comments, etc in other languages.
-這里有[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ù)前任翻譯者名單的。
+Here's an example of a complete header from [http://cvs.sourceforge.net/viewcvs.py/gallery/gallery2/modules/core/po/de.po?rev=1.13&view=auto modules/core/po/de.po].? Note how the authors have maintained the list of all previous translators as a courtesy.
 <pre>
-# 前任翻譯者（迄今所知，如有脫漏，請在此添加）：
+# Previous translators (as far as known, add yourself here, please):
 # - Jens Tkotz <jens@peino.de>
 # - Ernesto Baschny <ernst@baschny.de>
@@ 第120行： / 第120行： @@
 </pre>
-如果你的語言中不包含復(fù)數(shù)詞用法，如漢語或土耳其語，就得修改以下語句：
+If your language doesn't have plural form like in Chinese or Turkish, you need to change the following line too:
 <pre>
@@ 第126行： / 第126行： @@
 ?? ? -> Change to "Plural-Forms: nplurals=1; plural=0;\n".
 </pre>
-這樣，你只需翻譯msgstr[0]并注釋掉或移除msgstr [1].
+In this case, you need to translate only msgstr[0] and comment out or remove msgstr[1].
-接著來看看Gallery證書下的語句行：
+Then, look at the lines just below the Gallery license:
 <pre>
@@ 第136行： / 第136行： @@
 </pre>
-模糊的關(guān)鍵詞告知你區(qū)塊的翻譯
+The fuzzy keyword tells you that the translation of the block is
-不完整。但一旦更新了administration entry，就
+incomplete. But once that you update the administration entries, you
-可以移除"#, fuzzy"這一行以允許稍后翻譯的
+can remove the "#, fuzzy" line to allow the translation to compile
-編譯。
+later on.
-接下來你會看到一系列區(qū)塊：
+Next, you'll see a series of blocks like this:
 <pre>
-#, c-format		(<-- 在某些語句行中僅能看到這個)
+#, c-format		(<-- you'll only see this on some lines)
 msgid "a message in english, with %d or %s tags in it"
 msgstr ""
 </pre>
-你需要將英語消息的翻譯置入
+You need to put the translation for the English message into the
-msgstr區(qū)塊中，用引號括起來，例如：
+msgstr block, between the quotes, for example:
 <pre>
@@ 第158行： / 第158行： @@
 </pre>
-某些msgid值含有有助于進(jìn)行翻譯的提示信息：
+Some msgid values contain hints to assist in translation:
 <pre>
@@ 第165行： / 第165行： @@
 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的文件。
+Note that the hint should not be translated or included in the msgstr text.? You can request the addition of hint text for particular strings with the [http://sourceforge.net/tracker/?func=browse&group_id=7130&atid=582564 Translations Tracker].? Specify the module/theme and the msgid.? Note that the <tt>strings.raw</tt> file lists the file(s) where each msgid is used.
-在編輯這些消息之前，你確實應(yīng)當(dāng)將編輯器設(shè)為UTF-8模式，
+You really, really, really should put your editor into UTF-8 mode
-這樣編輯器才能使用正確的字符集。
+before editing these messages so that your editor can use the right
-如果你由于某種原因無法在UTF-8模式中進(jìn)行編輯，
+character set.? If you can't edit in UTF-8 for some reason, consider
-請考慮使用GNU的"recode"程序，在提交翻譯內(nèi)容給我們之前，
+using the GNU "recode" program to convert your translation to UTF-8
-將其轉(zhuǎn)為UTF-8（或者直接發(fā)給我們也許，我們會進(jìn)行重新編碼）。
+before submitting it to us (or just send it anyway and we'll recode
+it).
-如果你使用XEmacs的MULE（即多語言支持（MULtilanguagE）），你可以將一下內(nèi)容添加到
+If you're using XEmacs with MULE (its MULtilanguagE support) you can
-~/.xemacs/init.el中去
+add the following to your ~/.xemacs/init.el
 <pre>
@@ 第184行： / 第185行： @@
 </pre>
-當(dāng)你編輯UTF-8的文件時，會有一些"u"
+Then when you edit a file that is in UTF-8, it'll have a little "u"
-出現(xiàn)在屏幕底部狀態(tài)條左側(cè)。使用現(xiàn)有的
+in left side of the status bar at the bottom of the screen.? Try it
-.po文件來看一看。
+out with an existing .po file to see what it looks like.
-在進(jìn)行一些翻譯之后，來看看效果。運(yùn)行：
+After doing a few translations, try it out to see how it looks.? Run:
 <pre>
@@ 第194行： / 第195行： @@
 </pre>
-它會將你的.po文件編譯到一個.mo文件中，并將其安裝到合適的位置。在修改.po文件之后，對各目錄都要重復(fù)此步驟。如果你在創(chuàng)建locale目錄時發(fā)生錯誤，請在運(yùn)行make之前建立目錄結(jié)構(gòu)（如：modules/mymodule/locale/de/LC_MESSAGES）。
+And it will compile your .po file into a .mo file and install it in the appropriate place for the module.  Repeat this for every directory where you modified a .po file.? If you get errors about creating the locale directory then try creating the directory structure before running make (example: modules/mymodule/locale/de/LC_MESSAGES).
-最后，你需要編輯modules/core/classes/GalleryTranslator.class，并在函數(shù)getLanguageData中加入如下語句：
+Finally, you need to edit modules/core/classes/GalleryTranslator.class and in function getLanguageData, add lines like this:
 <pre>
@@ 第203行： / 第204行： @@
 $defaultCountry['de'] = 'DE';
 </pre>
-批注應(yīng)為該語言的英語說法；語言
+The comment should be the name of the language in English; the language
-'描述'則應(yīng)是該語言的本土說法。
+'description' is the name of the language in that language.
-現(xiàn)在登入G2，在用戶偏好（你可能需要
+Now, log onto G2 and in the User preferences (you may need to edit the
-通過站點管理對用戶進(jìn)行編輯）中，你應(yīng)能在下拉列表中看到
+user via the Site Administrator) you should see German appear in the
-German。而如果你選擇了它，并以剛才那個用戶的身份登入的話，
+dropdown, and if you select it and log on as that user you'll see your
-就能看到消息被翻譯為該語言了。你還可以將語言選擇器區(qū)塊
+translated messages.? Alternatively, add the Language selector block
-添加到站點中，使用外觀主題設(shè)定就可以做到。
+to your site using Theme settings.
-'''注：''' 如果語言修改沒有起效，請回顧一下[[Gallery:Language_Settings|語言設(shè)定]]的優(yōu)先級（會話語言（Session language） > 用戶偏好（user preferences） > 站點范圍的默認(rèn)語言（site wide default language））。如果有疑慮的話，可以使用語言區(qū)塊或在用戶偏好中反復(fù)嘗試。
+'''Note:''' If the language change doesn't take effect, please review the precedence of the [[Gallery2:Language_Settings|language settings]] (Session language > user preferences > site wide default language). In doubt, use the language block or toggle the language in your user preferences back and forth.
-== 本地化的提交 ==
+== Submitting your localization ==
-現(xiàn)在本地化就應(yīng)創(chuàng)建號了，你需要將其
+Now that you've got your localization created, you need to package
-打包并發(fā)送給我們，這樣我們就能將其添入存儲庫。
+it up and send it to us so that we can commit it into the repository.
-最好的打包方式如下：
+The best way to package it is like this:
 <pre>
@@ 第231行： / 第232行： @@
 </pre>
-你翻譯過的文件會被做成zipfile或tarball。當(dāng)然使用你自己的語言代碼取代上面的de或nl。接著瀏覽SourceForge 的Gallery項目頁面上的[http://sourceforge.net/tracker/?func=browse&group_id=7130&atid=582564 翻譯追蹤器]并點擊"Submit New"按鈕。將你的翻譯放入"Gallery 2"組中，并將文件加入附件上傳。如果你的翻譯
+This will make up a zipfile or tarball of just your translated files.? Obviously, use your language code instead of de or nl above.? Then, go to the [http://sourceforge.net/tracker/?func=browse&group_id=7130&atid=582564 Translations Tracker] on the Gallery project page on SourceForge and click the "Submit New" button.? Put your translation in the "Gallery 2" group and don't forget to attach the files (you must check the checkbox for attachment too!).? If your translation doesn't
-過了幾天還沒有被采用的話，請上IRC（參見[[#Where_to_go_for_help!|幫助部分]]）告知我們。
+get committed within a few days, jump on IRC (see [[#Where_to_go_for_help!|help section]]) and talk to us about it.
-== 本地化的維護(hù) ==
+== Maintaining a localization ==
 <pre>
@@ 第241行： / 第242行： @@
 </pre>
-這會從你所在的模塊中提取出所有消息
+This will extract all messages from the module that you're in and
-并更新.po文件。瀏覽.po文件，找到所有具有
+update the .po file.  Look through the .po file for any blocks that
-空msgstr或被標(biāo)記為"模糊（fuzzy）"的區(qū)塊并更新它們。在它們
+have an empty msgstr, or are marked "fuzzy" and update them.? After
-被修復(fù)之后，移除fuzzy標(biāo)識。你看到的標(biāo)識會是如下的
+they are fixed, remove the fuzzy tag.? You may find tags that look
-樣子：
+like this:
 <pre>
@@ 第253行： / 第254行： @@
 </pre>
-"#, fuzzy"表示它是模糊的，但"#~"表明該
+The "#, fuzzy" means that its fuzzy, but the "#~" means that the
-字串不存在于G2中（我們可能將其刪除或修改了
+string no longer exists in G2 (we probably deleted or changed it
-）。你可以刪除這些內(nèi)容.
+significantly).? You can delete these entries.
-你應(yīng)當(dāng)快速地做一次gettext提供的檢查，以驗證.po文件：
+You should do a quick check that gettext provides to validate your .po file:
 ? msgfmt -v -c --stat de.po
-當(dāng)一切都設(shè)置好后，運(yùn)行：
+When you've got everything right, run:
 <pre>
@@ 第266行： / 第267行： @@
 </pre>
-翻譯文件被PHP緩存（這就是其快速的原因）
+The translation files get cached by PHP (which is why it's so fast)
-因此在重啟web服務(wù)器之前，可能無法看到所作的修改。這是
+so you may not see change until you restart your web server.? That's
-有點麻煩，但我還沒有想出好的解決辦法。
+annoying, but I haven't figured a good workaround for it yet.
-參見[[#本地化的新建]|本地化的新建]]部分的測試信息，并向我們提交新文件。
+See the [[#Creating_a_new_localization|Creating a new localization]] section for testing info, and submit the new files to us.
-== 何處尋求幫助？==
+== Where to go for help! ==
-如果你需要幫助，有三個地方可以求助：
+If you need help, there are three places to go:
 ; The Gallery translations forums:
@@ 第285行： / 第286行： @@
 : #gallery on irc://chat.freenode.net
-== 翻譯列表 ==
+== List of Translations ==
-所有可用的Gallery2翻譯，都在此以字母表順序列出了，帶有維護(hù)者/作者名單。某些翻譯100%保持更新并且完成，某些則僅完成了2%或過期了。參見 [http://gallery.menalto.com/localization/gallery2 本地化報告]。如果你有G2的開發(fā)者整合包，就可以運(yùn)行{{exampleurl|/lib/tools/reports/localization.php}}來查看所有已安裝翻譯的狀態(tài)。
+All available Gallery 2 translations, listed alphabetically along with the maintainers / translators. Some translations are 100% up to date and complete, others are only 2% complete or out of date. See: [http://gallery.menalto.com/localization/gallery2 Localization Report]. If you have the developer package of G2, you can run {{exampleurl|/lib/tools/reports/localization.php}} to see the status of all installed translations.
 {| class="gallery" style="background-color: #eee; width: 800px"
 |-
-! align="left" width="200px" | 語言
+! align="left" width="200px" | Language
-! align="left" | 語言代碼
+! align="left" | Language Code
-! align="left" | 最后翻譯者
+! align="left" | Last Translator
-! align="left" | 翻譯者列表
+! align="left" | List of Translators
 |-
 |Afrikaans
@@ 第326行： / 第327行： @@
 |-
 |中國
-Chinese [簡體]
+Chinese [Simplified]
 |zh_CN
 |Wayne Zhang
@@ 第332行： / 第333行： @@
 |-
 |臺灣
-Chinese [繁體]
+Chinese [Traditional]
 |zh_TW
 |Stephen Chu