查看“如何进一步汉化FreePBX界面”的源代码

'''手动汉化FreePBX 中文界面'''

FreePBX 自从 FreePBX 2.5 以后已经包括了gettext包支持i18n 中文汉化. 用户可以在本地对FreePBX 进行汉化处理，汉化FreePBX 需要经过以下几个步骤：

'''找到相关汉化文件'''

在每个模块文件夹下面有一个 module_名称/i18n, 这个路径下有各种语言的POT文件，当然包括了zh_CN的文件，具体的文件路径是模块名称/i18n/zh_CN/LC_MESSAGES/模块名称.po 文件。
这些文件支持每个具体的模块界面汉化。

'''注意:'''core 文件夹不包括 i18n路径，主界面的中文汉化包存放在 admin/i18n/''zh_CN''/LC_MESSAGES/amp.po。

'''如何实现Elastix界面汉化'''

Elastix 核心界面还是基于FreePBX，模块路径，文件都一样。具体的elastix 汉化文档，请访问[http://www.hiastar.com/index.php/2011-04-19-19-01-04/asterisk-elastix-freeswitch-doc Elastix不同版本汉化包]

'''对PO文件进行汉化'''

举例，我们现在要对backup 模块中的po 文件进行汉化，用户使用POedit工具，在用户电脑打开PO文件，然后文件，用户根据文件中的提示可以一一对应进行汉化。在文件中用户会看到 "msgid" 和 "msgstr" 一对对应的值。 "msgid" 是英文的原始条目， "msgstr" 就是中文的含义，这里有一个例子:
<pre>
<nowiki>#: amp_conf/htdocs/admin/modules/core/page.routing.php:275</nowiki>

<nowiki>#: amp_conf/htdocs/admin/modules/core/page.did.php:141</nowiki>

<nowiki>#, php-format</nowiki>

msgid "Delete Route %s"

msgstr "删除路由 %s"
</pre>

在linux 环境下的编译工具是 KBabel ，当然用户也可以拷贝到Windows 环境下，使用[http://www.poedit.net/ Poedit]来编辑。

'''完成翻译以后，保存编译PO文件'''

这里的.po 文件需要编译保存成一个.mo 文件，系统才能显示中文，执行:

'''注意:''' KBabel或者Poedit 可以点击保存，如果所有语法正确的话，工具会在相应的文件路径下保存一个同样文件名的mo后缀文件。用户可以把这个文件存放回i18n/''zh_CN''/LC_MESSAGES 目录下的 文件夹中。 当然用户也可以在linux 命令进行文件转换：

<pre>msgfmt -v backup.po -o backup.mo </pre>


'''测试汉化效果'''

为了支持中文界面的显示，我们必须在语言选择界面添加中文选项。打开文件 /var/www/html/admin/views/menu.php (默认是CentOS 安装)，其他环境可能在不同的路径。

'''/var/www/html/admin/views/menu.php''' 
<pre>
<nowiki>if($amp_conf['SHOWLANGUAGE']) {</nowiki>

        $out .= '&lt;a id="language-menu-button" '

       . 'class="button-right ui-widget-content ui-state-default"&gt;' . _('Language') . '&lt;/a&gt;';

        $out .= '&lt;ul id="fpbx_lang" style="display:none;"&gt;';

        $out .= '&lt;li data-lang="en_US"&gt;&lt;a href="#"&gt;'. _('English') . '&lt;/a&gt;&lt;/li&gt;';

        $out .= '&lt;li data-lang="bg_BG"&gt;&lt;a href="#"&gt;' . _('Bulgarian') . '&lt;/a&gt;&lt;/li&gt;';

        $out .= '&lt;li data-lang="zh_CN"&gt;&lt;a href="#"&gt;' . _('Chinese') . '&lt;/a&gt;&lt;/li&gt;';  // 这里已经支持了中文zh_CN

        $out .= '&lt;li data-lang="de_DE"&gt;&lt;a href="#"&gt;' . _('German') . '&lt;/a&gt;&lt;/li&gt;';

        $out .= '&lt;li data-lang="fr_FR"&gt;&lt;a href="#"&gt;' . _('French') . '&lt;/a&gt;&lt;/li&gt;';

        $out .= '&lt;li data-lang="he_IL"&gt;&lt;a href="#"&gt;' . _('Hebrew') . '&lt;/a&gt;&lt;/li&gt;';

        $out .= '&lt;li data-lang="hu_HU"&gt;&lt;a href="#"&gt;' . _('Hungarian') . '&lt;/a&gt;&lt;/li&gt;';

        $out .= '&lt;li data-lang="it_IT"&gt;&lt;a href="#"&gt;' . _('Italian') . '&lt;/a&gt;&lt;/li&gt;';

        $out .= '&lt;li data-lang="pt_PT"&gt;&lt;a href="#"&gt;' . _('Portuguese') . '&lt;/a&gt;&lt;/li&gt;';

        $out .= '&lt;li data-lang="pt_BR"&gt;&lt;a href="#"&gt;' . _('Portuguese (Brasil)') . '&lt;/a&gt;&lt;/li&gt;';

        $out .= '&lt;li data-lang="ru_RU"&gt;&lt;a href="#"&gt;' . _('Russian') . '&lt;/a&gt;&lt;/li&gt;';

        $out .= '&lt;li data-lang="sv_SE"&gt;&lt;a href="#"&gt;' . _('Swedish') . '&lt;/a&gt;&lt;/li&gt;';

        $out .= '&lt;li data-lang="es_ES"&gt;&lt;a href="#"&gt;' . _('Spanish') . '&lt;/a&gt;&lt;/li&gt;';

        $out .= '&lt;/ul&gt;';

}
</pre>

'''查看翻译状态'''

'''languagestatus'''模块可以帮助开发人员参考语言翻译的状态，执行以下步骤安装此工具:

* 点击admin， 然后选择 Module Admin, 然后确认Unsupported is checked，点击 Updates，安装 languagestatus

成功安装后，管理员菜单中会显示一个语言状态的菜单。如果安装后没有显示，用户需要点击:

* 点击 Settings，选择 Advanced Settings， 设置 Show Language setting 为True。

如果用户希望参与FreePBX中文汉化，可以登录官方网站进行进一步操作：

参与官方中文汉化，请登录：

http://wiki.freepbx.org/display/FOP/Translating+FreePBX+with+Weblate