技巧教程 教你如何汉化XF插件

[kemili]

我们都知道XF插件基本上全是英文的，直接安装后，后台显示的全是英文，关于插件的设置等基本看不懂，那么如何汉化呢？
汉化模式有2中：内置汉化和导入语言包
1、内置汉化
下载一个英文版插件，打开，目录为：
upload\src\addons\...\

我们打开_data文件夹，如下

可以看到有许多文件，重点来了，汉化内容一般包含2个文件，optios.xml和phrases.xml文件
phrases.xml文件汉化：将<![CDATA[待汉化的文本]]>中“待汉化的文本”汉化即可。不同文件行数不同，有的9千多行。

optios.xml文件汉化：由于optios.xml文件是插件后台选项的设置文件，一般是需要选择的文本项（点选，不是选择框）。汉化时需要根据后台的英文内容汉化，不能随便汉化。
以上汉化完毕后，需要更改addon.json和hashes.json文件。
addon.json文件是插件信息，包含插件名称、描述等。


hashes.json文件包含了插件各个文件的hashes值，因xf论坛有文件对比机制，如果文件更改了，后台会有记录，如导入语言包，原来的短语文本标识会变成红色。
由于上面更改了3个文件，需要通过工具获取新文件的hashes值，替换到hashes.json文件里。
最后将更改的文件打包替换，xf后台安装插件即可，安装的插件在后台插件列表中直接显示中文，无需额外导入中文包。
至此，一个完整的汉化中文插件完成。

2、导入语言包模式
复制一份上面汉化的phrases.xml文件，名字随意命名，一般为：language-简体中文-插件英文名.xml
汉化的phrases.xml文件打开，替换

<?xml version="1.0" encoding="utf-8"?>
<phrases>

为：

<?xml version="1.0" encoding="utf-8"?>
<language title="简体中文" date_format="Y-m-d" time_format="H:i" currency_format="{symbol}{value}" week_start="0" decimal_point="." thousands_separator="," label_separator=":" comma_separator=", " ellipsis="…" parenthesis_open="(" parenthesis_close=")" language_code="zh-CN" text_direction="LTR" addon_id="XF" base_version_id="2010270" export_version="2">

更改：addon_id是原始文件里的addon_id值，base_version_id值是原始文件里的version_id值。打开phrases.xml从第3行还是可查看。

最后一行替换</phrases>为</language>即可，确定在xml文件里是包含闭合的。

后台导入插件中文语言包：
前提：安装了英文的插件；安装了XF中文语言包并使用激活
后台—>外观—>语言—>导入语言—>选择制作好的汉化语言xml文件，导入到覆盖语言[简体中文]。

附说明：

• 文件的hashes值 是取的文件SHA2-256值
• 也可以先安装插件后，在 后台—>外观—>语言，选择中文语言包，导出，选择“要导出的插件”，勾选“ 未更改的短语 ”，这样就保留了插件语言包的特性，对xml文件的CDATA进行翻译即可。
• 注意：一定要加上addon_id="插件位置"，"插件位置"是插件zip安装包中的“\upload\src\addons\DBTech\Credits\_data”中的“DBTech\Credits”，如果没有addon_id，当卸载插件时，会冗余插件短语。

如：

addon_id="DBTech\Credits" version_id="1000000" version_string="1.0.0"

 

[kemili]

说一下，文件的hashes值 是取的文件SHA2-256值

 

[小关]

支持此教程！

 

[weifang521]

学到了很多