插件
.i18n/conf.yml
中可以配置插件,如:
addon:
- i18n.addon/toc
官方插件
文件名约定
插件都是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