插件

.i18n/conf.yml中可以配置插件，如：

addon:
  - i18n.addon/toc

官方插件

• i18n.addon/toc: 目錄索引 根據TOC生成目錄索引的json，默認啟用

• i18n.addon/mouse: 鼠標特效

文件名約定

插件都是npm的包。

上面i18n.addon/toc對應的包是 https://www.npmjs.com/package/@i18n.addon/toc。

插件默認使用最新版本，并每周檢查更新。

如果想固定版本, 可以寫i18n.addon/[email protected]。

翻譯命令行i18n.site會安裝插件包的約定文件，然后執行。

約定的文件名如下

htmIndex.js

htmIndex.js會注入到.i18n/htm/index.js結尾。

其中__CONF__會被替換為当前配置的名字(比如dev或者ol)。

afterTran.js

會在翻譯完成之后調用，傳入的參數如下。

• lang_li: 語言列表，第一個語言為源語言
• changed: 修改過的文件
• root: 項目根目錄

返回值為一個字典，比如

{
  file:{
    //  path: txt, for example :
    // "_.json": "[]"
  }
}

file為輸出的文件清單，path為文件路徑，txt為文件內容。

內置函數

內置的js運行時基于 boa 二次開发，內置函數如下 :

• wPath(path, txt): 寫入文件
• rTxt(path): 讀取文本文件
• rBin(path): 讀取二進制文件
• rDir(dirpath): 讀取目錄，返回值為一個數組 : 目錄列表, 文件列表

開发指南

插件開发可以參考 https://github.com/i18n-site/addon