i18n 中消息属性命名的正确方法是什么？

Question

我们确实有一个应该翻译成不同语言的网站。消息属性文件中的某些措辞已准备好翻译。我现在想将其余文本添加到这些文件中。

命名文本块的好方法是什么？

<view>.<type>.<name>

我们主要有网页，并且某些元素/模块在某些网站上重复。

Answer 1

据我所知，不存在“标准”。因此，很难区分什么是正确的、什么是不正确的资源键命名方式。然而，根据我的经验，我可以推荐这种方式：

property file name: <module>.properties
resource keys: <view or dialog>[.<sub-context>].<control-type>.<name>

我们可以讨论将一个模块中的每个字符串放入一个属性文件中是否是正确的方法 - 如果更新不经常发生并且没有那么频繁，那么可能是正确的很多消息。否则，您可能会考虑每个视图一个文件。

至于关键命名策略：对于翻译者来说（听起来像尊敬的州长阿诺德·S. 的电影不是吗？）有一个上下文非常重要。翻译实际上可能取决于它，即在波兰语中，如果消息是页面/对话框/任何标题，则您将以不同的方式翻译消息；如果消息是按钮上的文本，则以完全不同的方式翻译。

此类资源键的一个示例可能是：

preferences.password_area.label.username=User name

它向翻译器提供了有关其实际含义的足够提示，这可能会导致正确的翻译......

Answer 2

我们使用点表示法和驼峰式大小写提出了以下键命名约定（Java，btw）：

标签键（表单标签、页面/表单/应用程序标题等......即，不完整句子；用于多个 UI 位置）：

如果标签表示 Java 字段（即表单字段）并与表单标签匹配：label.nameOfField
其他：label.sameAsValue

示例：

• label.firstName = 名字
• label.lastName = 姓氏
• label.applicationTitle = 应用程序标题
• label.editADocument = 编辑文档

内容键：

< strong>projectName.uiPath.messageOrContentType.n.*

其中：

• projectName 是项目的短名称（或来自 Java 包的派生名称）
• uiPath是内容键
• messageOrContentType 的 UI 导航路径（例如，添加、删除、更新、信息、警告、错误、标题、内容等），应根据内容类型添加。消息示例： (1) 页面已更新。 (2) 处理您的请求时出错。
• n.* 处理以下情况：当单个页面上有多个内容区域时（例如，当内容被图像等分隔时）、当内容位于多个段落中或当内容位于（无）排序列表中 - 应附加数字标识符。示例：...content.1、...content.2

  当页面上有多个内容区域并且需要进一步分解一个或多个内容区域时（基于上面的 HTML 示例），可以将辅助数字标识符附加到键上。示例：...content.1.1、...content.1.2

示例：

• training.mySetup.myInfo.content.1 = 这是内容 1 的第一句。这是内容1的第二句。该内容将被段落标签包围。
• Training.mySetup.myInfo.content.2 = 这是内容 2 的第一句。这是内容 2 的第二句。该内容也将被段落标签包围。
• Training.mySetup.myInfo.title = 我的信息
• training.mySetup.myInfo.updated = 您的个人信息已更新。

优点/缺点：

---

+ 标签键可以轻松重复使用；位置无关紧要。
+ 对于不重复使用的内容键，在 UI 上定位页面将变得简单且合乎逻辑。

- 翻译人员可能不清楚标签键位于 UI 上的位置。对于不浏览页面的翻译人员来说，这可能不是问题，但对于开发人员来说可能仍然是一个问题。
- 如果内容键必须在 UI 上的多个位置使用（这种情况很有可能），则键名称选择在其他位置将没有意义。在我们的例子中，管理层不关心内容区域的值重复，因此在这种情况下我们将使用不同的键（以演示 UI 上的位置）。

---

对这一公约的反馈——尤其是能够改进它的反馈——将不胜感激，因为我们目前正在改进我们的资源包！ :)

Answer 3

我建议采用以下约定，

functionalcontext.subcontext.key
logicalcontext.subcontext.key

这样您就可以在超级上下文中对所有常见消息进行逻辑分组（下面示例中的 id ）。有一些东西不是特定于任何功能上下文（如姓氏等）的，您可以将其分组为逻辑上下文。

order.id=Order Id
order.submission.submit=Submit Order
name.last=Last Name

Answer 4

我个人使用过并且到目前为止我更喜欢的方法是使用句子来本地化作为关键。例如：（请根据语言将 T 替换为正确的语法）

例如：
print(T("Hello world"))

在这种情况下 T 将搜索键“Hello world”。如果没有找到则返回键，否则返回键的值。

这样，您不需要编辑消息（以您的默认语言），至少您需要使用参数......它节省了我很多开发时间