Question

Blockly 支持可以本地化为用户语言的块定义。通过使用字符串表，JSON 块定义中的消息字符串可以调整输入，字段和标签，以反映语言的词汇，单词排序和方向。

所有这些情况都共享相同的 JSON 块定义：

// Block for creating a list with one element repeated.
{
  "type": "lists_repeat",
  "message0": "%{BKY_LISTS_REPEAT_TITLE}",
  "args0": [
    {
      "type": "input_value",
      "name": "ITEM"
    },
    {
      "type": "input_value",
      "name": "NUM",
      "check": "Number"
    }
  ],
  "output": "Array",
  "colour": "%{BKY_LISTS_HUE}",
  "tooltip": "%{BKY_LISTS_REPEAT_TOOLTIP}",
  "helpUrl": "%{BKY_LISTS_REPEAT_HELPURL}"
}

字符串表

该 listsrepeat 示例包括几个 %{BKY...} ​字符串。其中每个都是对 Blockly.Msg 字符串表中字符串的引用。当块被实例化时，Blockly 尝试用该值替换该字符串。

例如，如果存在， %{BKY_LISTS_REPEAT_TITLE} ​则替换为值 Blockly.Msg['LISTS_REPEATTITLE'] ​。如果该值不存在，则 %{BKY...} ​表示法将保留在原位，并且 Blockly 会针对缺失的翻译发出警告。

如示例所示，符号在多个位置有效。消息和工具提示允许替换用户可见的字符串。同样，下拉字段也可以使用项目文本的表示法。可以对帮助 URL 进行本地化，以确保将用户定向到类似的本地化页面。最后，该 colour 值可以使用符号来帮助集中块的调色板。

如果您正在使用 JavaScript 实现并且不希望在运行时更改用户语言，您可能会发现使用直接引用更容易。例如，Blockly.Msg['LISTS_REPEAT_TITLE']或者 Blockly.Msg.LISTS_REPEAT_TITLE'。由于这不是有效的 JSON，因此这种语法（引用其他地方声明的变量）不适用于 Android 或 iOS

字符串表通过任何一个特定.js 于语言的文件 加载 msg/js。将相应的文件加载到您的网页中以加载正确的块转换。Blockly for iOS 运行略有不同，自动从本地化消息中选择正确的 JSON 文件 。

JSON 消息插入

message0、message1、message2 等属性是用于其中信息的标签文本。对于列表_重复块中的 LISTS_REPEAT_TITLE，英语值为：Blockly.Msg.LISTS_REPEAT_TITLE = 'create list with item %1 repeated %2 times'; 两个插值标记 %1 和 %2 标记两个输入的位置。更多详细信息在 args0 数组中提供。args1 标记相应 %message1 字符串。有关指定块输入和字段的更多详细信息，请参阅 4.3。

插值标记之间的文本将转换为未命名的 /blockly/reference/js/Blockly.FieldLabel ​。这将创建块的单词顺序及其读取方式：

// In Spanish
Blockly.Msg.LISTS_REPEAT_TITLE = "crear lista con el elemento %1 repetido %2 veces";
// In Korean
Blockly.Msg.LISTS_REPEAT_TITLE = "%1을 %2번 넣어, 리스트 생성";

从右到左语言翻译时，消息字符串以可视顺序编写，并且不应包含 Unicode 方向命令：

// In Arabic. Note how %2 is left of %1, since it read right to left.
Blockly.Msg.LISTS_REPEAT_TITLE = "إنشئ قائمة مع العنصر  %1 %2 مرات";

重建字符串表

构建字符串表的 .js ​ 文件是 build.py 脚本的一部分。该脚本使用 msg / messages.js ​ 中的标识符键和英文翻译来创建新的 en.json。然后，结合其他 JSON 文件中找到的所有翻译，它将为所有语言（包括新的 en.js）重新创建更新的 JavaScript 字符串表。非英语 JSON 文件来自 TranslateWiki 的合作伙伴。有关如何提供帮助的详细信息，请参见翻译说明。