由于WordPress原生的翻譯僅支持PHP而不支持JS，因此本主題使用的翻譯方法是主題開發(fā)者自己發(fā)明的。因此，本主題中的翻譯可同時支持JS和PHP并且無需使用翻譯編輯器來進行編譯，直接編寫json文件即可實現(xiàn)

國際化

本主題使用了主題專用的?_t8()?_t8n()?_et8()?_et8n()?來實現(xiàn)文本的翻譯。
并配合?語言名稱.json?翻譯文件來實現(xiàn)頁面上的文本替換。下面介紹翻譯方法和原理。

主題翻譯

主題默認使用“WordPress后臺設置選擇的語言”，在不修改WordPress默認語言的前提下，也可使用主題的翻譯功能強制修改主題語言。詳見PHP過濾器：pf_get_translation部分。

開始翻譯
假定：當前已經(jīng)將WordPress切換到英文語言（或：在 pf_get_translation 過濾波器中返回”en_US”）。以此來翻譯主題的英文版
步驟：在R\pandastudio_plugins\public_translation\lang文件夾中將主題默認的default.json翻譯文件復制一份，命名為en_US.json，然后對文件中的JSON對象進行翻譯即可
注意：翻譯時務必注意JSON文件格式，不要出現(xiàn)JSON格式錯誤的情況。

代碼實現(xiàn)

在二次開發(fā)的過程中，無論是 Javascript 還是 PHP 都可能出現(xiàn)文本，那么這些文本在 Javascript 和 PHP 中是怎么實現(xiàn)翻譯的呢？

簡單翻譯

_t8("待翻譯的文字",多個替換參數(shù));

t8表示：translate，t后面有8個字符，因此被簡化為t8
待翻譯的文字中可使用{{number}}來替換參數(shù)，參數(shù)可有多個，將一一對應替換

使用示例

_t8("{{2}}班有{{1}}個學生", 53, 3);

默認顯示時，將第一個替換參數(shù) 53 替換到{{1}}的位置，第二個替換參數(shù) 3 替換到{{2}}的位置。默認語言顯示結(jié)果為：“3班有53個學生”。

若此時有翻譯文件內(nèi)容如下：

{    "{{2}}班有{{1}}個學生": "There are {{1}} students in class {{2}}"}

則參數(shù) 53 將替換到 {{1}} 的位置，參數(shù) 3 將替換到 {{2}} 的位置。翻譯結(jié)果為：“There are 53 students in class 3”

單復數(shù)翻譯

_t8n("待翻譯的單數(shù)文字","待翻譯的復數(shù)文字",多個替換參數(shù));

在上面的例子中我們看到了：當出現(xiàn)數(shù)量為單數(shù)時，students的翻譯明顯是錯誤的。因此引入單復數(shù)識別的翻譯。在原有的t8名稱后加上了n。單復數(shù)識別僅識別第一個替換參數(shù)，若第一個替換參數(shù)為1，則顯示單數(shù)翻譯，否則使用復數(shù)翻譯。類似于：

if (number <= 1) {    _t8("單數(shù)內(nèi)容");} else {    _t8("復數(shù)內(nèi)容");}

使用示例

_t8n(    "{{2}}班有{{1}}個學生{{備注：單數(shù)}}",    "{{2}}班有{{1}}個學生{{備注：復數(shù)}}",    1,    3);

我們可以看到，中間加入了雙花括號的備注來進行區(qū)分，在顯示時，備注將自動去除。若此時有語言文件JSON內(nèi)容如下：

{    "{{2}}班有{{1}}個學生{{備注：單數(shù)}}": "There is only {{1}} student in class {{2}}",    "{{2}}班有{{1}}個學生{{備注：復數(shù)}}": "There are {{1}} students in class {{2}}"}

由于學生數(shù)量1是單數(shù)，因此在翻譯時候?qū)⑹褂脝螖?shù)翻譯，翻譯結(jié)果為：“There is only 1 student in class 3”

若調(diào)用時參數(shù)仍然為53：

_t8n(    "{{2}}班有{{1}}個學生{{備注：單數(shù)}}",    "{{2}}班有{{1}}個學生{{備注：復數(shù)}}",    53,    3);

則翻譯結(jié)果為：“There are 53 students in class 3”

其他

上述_t8()與_t8n()方法在自定義JS與自定義PHP中均有效。且翻譯文件不存在時，將自動回退為代碼中的語言。因此，在編寫完二次開發(fā)的 Javascript 或 PHP 代碼后，應手動將待翻譯的字符串添加到 JSON 語言文件中，才可以實現(xiàn)翻譯。

PHP獨有

在PHP中存在顯示文字的情況（echo），為方便使用，在上述兩個方法前加上e來進行標識。如：_et8()與_et8n()，使用方法一致。

關于備注
替換參數(shù)僅識別 {{number}} 的情況。凡是待翻譯內(nèi)容 、翻譯內(nèi)容中的雙花括號，都被識別為備注，將默認去除。備注可為翻譯者提供翻譯幫助，如語言文件JSON翻譯為：

{    "編輯{{名詞}}": "Editor",    "編輯{{動詞}}": "Edit",}

如何翻譯/文本替換

翻譯功能不僅可以用于真正的某種語言，還可以用于文本替換。原理：將主題語言定義為當前地區(qū)使用的語言，再次進行翻譯

例：對中文語言本身實現(xiàn)文本替換：

1. 復制lang文件夾的default.json，并重命名為當前WP后臺選中的當?shù)卣Z言：zh_CN.json
2. 對內(nèi)容進行翻譯，例如將 “閱讀全文” 翻譯為 “去看看”

這樣就實現(xiàn)了主題的翻譯/文本替換。

注：翻譯時請嚴格按照 JSON 格式編輯，任何格式錯誤都將導致翻譯失敗或報錯！

附：語言文件名稱一覽表