gettingStarted language

多语言包

什么是多语言

作为嵌入式形态存在的多语言包分为前端及服务端两种模式,前端使用L.getText,服务端要使用L::getText 框架配置preloaded加入"of_base_language_packs"启动

语言包的配置

框架配置_of.language为本站的语言包选项

1. path : 语言包所在路径
2. match : 局部翻译匹配规则, 注意需兼容js, 第一个不为空的子组作为翻译文本, 匹配失败时, 开发模式报错, 其它模式备忘
3. default : 默认加载的语言,base=基础包

多语言实现流程

1. 在debug模式或默认语言为base时, 使用L::getText或L.getText生成默认语言包到base文件夹
2. 将default设置成语言包文件夹名,或改变COOKIE[of_base_language][name]值来切换不同语言
3. 局部翻译默认规则是 没有特殊字符的英文数字 | 没有英文数字 | 以半角": "分隔之前 | 以半角".!?"结尾的句子, 参数mode控制此特性, of::work(int, str)的str尤其注意
4. 访问 框架目录/index.php?c=of_base_language_tool 制作不同语言包
   

php多语言的使用

L::getText(string $str[, array $params])

• $strstring
  指定需要翻译的文本
• $paramsarray
  相关复选参数,该项都是选加
  • keystring
    翻译区分标识符, 默认=""[因情况而定,如果可显示区的长度一样,便可以不加]
  • filestring
    指定调用磁盘路径, 绝对路径
  • traceint
    调用跟踪文件定位(默认0=调用此方法文件, 1=0的父方法, ...)
  • modeint
    翻译模式, 0=全部翻译, 1=按_of.language.match规则局部翻译
  • typestring
    读取页面的类型,php=js读取,js=js读取不推荐

<?php                                           //下面两种方法都可以调用语言包
echo L::getText('加载默认语言中的该字符串');    //推荐
echo L::getText('加载默认语言中的该字符串', array('key' => '这一个关键字'));
echo L::getText('被翻译的部分: 不翻译部分', array('mode' => 1));    //默认第一个": "后的内容不被翻译

Javascript多语言的使用

window.L.getText(string str[,object params])

• strstring
  指定需要翻译的文本
• paramsobject
  相关复选参数,该项都是选加,但推荐都加上
  • keystring
    一个文件中出现一次以上该文本时应传入此参数[因情况而定,如果可显示区的长度一样,便可以不加]
  • modeint
    翻译模式, 0=全部翻译, 1=按_of.language.match规则局部翻译

<script>
document.write(L.getText('加载JS端语言包翻译')+'<br/>');
document.write(L.getText('加载JS端语言包翻译: const', {'mode' : 1});
document.write(L.getText('IE下开发加载JS端语言包翻译', {'key' : '关键字'}));
</script>