属性本地化

最近更新时间：2023-09-18

概述

本文档介绍了如何使用属性本地化编辑界面修改属性译文，并完成属性本地化的相关内容。

打开属性本地化编辑界面

在组件编辑器中，依次点击菜单栏工具（Tool） -> 属性本地化（Property Localization），打开属性译文编辑（Property Translation Edit）窗口。

属性译文编辑（Property Translation Edit）窗口：

编号	名称	说明
1	搜索栏	在对应的搜索框中，输入模块名称（Module Name）、属性文本键（Property Text Key）、参考译文（Reference Translation）和可编辑译文（Editable Translation）后，可检索出相关属性。
2	译文分类	在该下拉框中可选择不同完成状态的译文，从而进行分类筛选。
3	参考译文（Reference Translation）语言	选择参考译文（Reference Translation）的语言种类。
4	可编辑译文（Editable Translation）语言	选择可编辑译文（Editable Translation）的语言种类。
5	模块名称（Module Name）	显示属性的模块名称（Module Name），不可编辑。
6	属性文本键（Property Text Key）	显示属性的属性文本键（Property Text Key），不可编辑。
7	参考译文（Reference Translation）	显示属性的参考译文（Reference Translation）。选择原始（Raw）后，不可编辑。
8	可编辑译文（Editable Translation）	显示属性的可编辑译文（Editable Translation）。选择原始（Raw）后，不可编辑。
9	可编辑文本（Editable Text）	选择一个可编辑译文（Editable Translation）后，在该输入框中可修改对应属性的译文。
10	填充未完成的英文译文（Fill Not Completed English）	填充所有未翻译的英文译文（只有英文语言种类被选择后才填充）。

编辑属性译文

在属性译文编辑（Property Translation Edit）窗口中，从可编辑译文（Editable Translation）下拉列表框中选择需要编辑的语言。

在可编辑译文（Editable Translation）这一列中，选中一个单元格后，在可编辑文本（Editable Text）中输入该属性对应的译文。

按Enter键完成编辑。

添加超链接

在可编辑译文（Editable Translation）的下拉框中选择超链接（Hyperlink），找到需要添加超链接的属性条目，选中对应的可编辑译文（Editable Translation）单元格，在可编辑文本（Editable Text）中输入链接，按Enter键完成编辑。

编辑完成：

关闭属性译文编辑（Property Transition Edit）窗口后，在弹出的对话框中选择是（Yes）进行保存，此时重启编辑器，即可看到跳转链接。

在组件编辑器中，将鼠标移动到添加了超链接的属性上，按Ctrl+Shift键后，可在弹出的控件上点击超链接（Hyperlink）跳转到对应的网页上。

生成API文本

依次点击菜单栏工具（Tool） -> 生成API文本（Generate API Text）后，可看到四个子菜单项。

菜单项	说明
生成编辑器API文本（Generate Editor API Text）	增量生成暴露给脚本的、编辑器可见的类型、属性和方法的译文Key，并提取C++中的注释作为原生（Raw）译文。
重新生成编辑器API文本（Regenerate Editor API Text）	全量生成暴露给脚本的、编辑器可见的类型、属性和方法的译文Key，并提取C++中的注释作为原生（Raw）译文。
生成公共API文本（Generate Public API Text）	增量生成满足文档注释格式的类型、属性和方法的译文Key，并提取C++中的注释作为原生（Raw）译文。
重新生成公共API文本（Regenerate Public API Text）	全量生成满足文档注释格式的类型、属性和方法的译文Key，并提取C++中的注释作为原生（Raw）译文。

查找和替换

注：查找与替换均在可编辑译文（Editable Transition）中进行。

查找

打开属性译文编辑（Property Translation Edit）窗口（支持查找的界面），目前窗口不支持设置焦点，需再选择一个子控件。

按快捷键Ctrl + F，即可打开查找（Find）界面。

查找（Find）界面：

编号	名称	说明
1	查找目标（Find Target）	输入所要查找的内容。
2	查找（Find）/查找所有（Find All）按钮	查找下一个与查找条件（查找目标（Find Target）、匹配大小写（Match Case）、模式匹配（Pattern Matching））匹配的可编辑译文(Editable Translation)条目。如果有匹配的，焦点切换到下一个匹配的条目上。
3	匹配大小写（Match Case）	查找时是否区分查找目标（Find Target）中的大小写，若勾选，则区分大小写。
4	模式匹配（Pattern Matching）	查找时是否使用模式匹配，若勾选，则使用Lua模式匹配。可参考https://www.lua.org/manual/5.1/manual.html#5.4.1。

在查找目标（Find Target）中输入要查找的内容（如：node），点击查找（Find）后，即可在属性译文编辑（Property Translation Edit）界面中定位到含输入内容的属性译文条目上。再次点击查找（Find），则会定位到下一条。

点击查找所有（Find All）按钮，即可在属性译文编辑（Property Translation Edit）界面中筛选出所有包含输入内容的属性译文条目。

替换

打开属性译文编辑（Property Translation Edit）窗口（支持替换的界面），目前窗口不支持设置焦点，需再选择一个子控件。

按快捷键Ctrl + H，即可打开替换（Replace）界面。

替换（Replace）界面：

编号	名称	说明
1	查找目标（Find Target）	输入所要替换的原内容。
2	替换为（Replace With）	输入所要替换原内容的现内容。
3	内置替换选项（Built-in Replace Option）	内置的替换条件（查找目标（Find Target）、替换为（Replace With）、匹配大小写（Match Case）、模式匹配（Pattern Matching））选项，每一个选项是一组替换条件。引擎的替换选项文件是"%EditorResource%ini/localization/replace_option.ini"。项目的替换选项文件是"%Resource%ini/localization/replace_option.ini"。
4	查找（Find）按钮	查找下一个与查找条件（查找目标（Find Target）、匹配大小写（Match Case）、模式匹配（Pattern Matching））匹配的可编辑译文（Editable Transition）条目。如果有匹配的，焦点切换到下一个匹配的条目上。
5	查找所有（Find All）按钮	查找所有与查找条件匹配的可编辑译文（Editable Transition）条目。只显示匹配的可编辑译文条目。
6	替换（Replace）按钮	将上一次匹配的条目中的查找目标（Find Target）修改为替换为（Replace With），并查找下一个。如果没有上一次匹配的条目，则只查找下一个。
7	替换所有（Replace All）按钮	查找所有与查找条件匹配的可编辑译文（Editable Transition）条目。并将匹配的条目中的查找目标（Find Target）修改为替换为（Replace With）。
8	匹配大小写（Match Case）	查找时是否区分查找目标（Find Target）中的大小写，若勾选，则区分大小写。
9	模式匹配（Pattern Matching）	查找时是否使用模式匹配，若勾选，则使用Lua模式匹配。可参考https://www.lua.org/manual/5.1/manual.html#5.4.1。

在查找目标（Find Target）中输入所要替换的内容，点击查找（Find）按钮，找到想要替换的属性译文，然后在替换为（Replace With）中输入想要替换成的内容，点击替换（Replace）按钮，即可完成替换。

替换完成后会自动查找定位到下一条。

也可一键替换所有。若想要将所有包含Actor的属性译文全部替换成Object，则可在输入查找目标（Find Target）和替换为（Replace With）的内容后，勾选匹配大小写（Match Case），点击查找所有（Find All），再点击替换所有（Replace All）。

未替换：

已替换：

使用内置替换选项（Built-in Replace Option）。在内置替换选项（Built-in Replace Option）中选择想要的替换规则，点击查找（Find）/查找所有（Find All），然后再点击替换（Replace）/替换所有（Replace All）。

未替换：

已替换：