Differences

This shows you the differences between two versions of the page.

--- zh_cn:tutorial:lang [2021/11/16 11:11] – [翻译格式] solidblock
+++ zh_cn:tutorial:lang [2022/05/27 15:49] – solidblock
@@ Line 1: / Line 1: @@
 ====== 名字翻译 ======
-请注意，您的商品具有奇怪的显示名称，例如//item.tutorial.my_item//? 这是因为您的物品名称没有使用游戏选择的语言进行翻译。 翻译用于为单个字符串支持多种不同的语言。
+你有没有注意到，你的物品显示的名称比较奇怪，例如 //item.tutorial.my_item// ？这是因为您的物品名称没有使用游戏选择的语言进行翻译。翻译用于为单个字符串支持多种不同的语言。
 ===== 创建一个语言文件 =====
-你可以使用语言文件为游戏内的可翻译字符串提供翻译。你需要创建的文件的名称应当是语言代码，参见[[https://minecraft.fandom.com/zh/语言|此链接]]。英语是en_us，简体中文是zh_cn，台湾繁体中文是zh_tw，香港繁体中文是zh_hk，文言文是lzh。有了语言代码后，在 __resources/assets/模组id/lang/__ 的位置创建JSON文件，例如英文翻译的文件位置是 __resources/assets/tutorial/lang/en_us.json__。
+你可以使用语言文件为游戏内的可翻译字符串提供翻译。你需要创建的文件的名称应当是语言代码，参见[[https://minecraft.fandom.com/zh/语言|此链接]]。英语是 en_us，简体中文是 zh_cn，台湾繁体中文是 zh_tw，香港繁体中文是 zh_hk，文言文是 lzh。有了语言代码后，在 __resources/assets/模组id/lang/__ 的位置创建JSON文件，例如英文翻译的文件位置是 __resources/assets/tutorial/lang/en_us.json__。
 ===== 添加翻译 =====
@@ Line 13: / Line 13: @@
 }
 </code>
-其中第一个字符串是任何可翻译的字符串（例如物品名称或TranslatableText）。如果您按照Wiki教程进行操作，请记住将模组id更改为`tutorial`或你自己的模组的id。
+其中第一个字符串是任何可翻译的字符串（例如物品名称或 or ''<yarn class_2588>''）。如果您按照 wiki 教程进行操作，请记住将模组id更改为 `tutorial` 或你自己的模组的id。
 ===== 使用自定义可翻译文本 =====
-每当函数接受 ''Text'' 时，您可以选择提供一个''new LiteralText()''，这意味着 Minecraft 将按原样使用构造函数参数中的字符串。但是，这是不可取的，因为如果这样做，将很难将文本翻译成另一种语言。 这就是为什么每当需要 ''Text'' 对象时，都应给它一个带有翻译键的 ''new TranslatableText()''，然后在语言文件中翻译该键。例如，添加工具提示时，可在物品类的子类执行以下操作：
+每当函数接受 ''<yarn class_2561>'' 时，您可以选择提供一个 ''new <yarn class_2585>()''（1.18.2之前）或 ''Text.literal()''（1.19之后），这意味着 Minecraft 将按原样使用构造函数参数中的字符串。但是，这是不可取的，因为如果这样做，将很难将文本翻译成另一种语言。 这就是为什么每当需要 ''<yarn class_2561>'' 对象时，都应给它一个带有翻译键的 ''new <yarn class_2588>()'' 或 ''Text.translatable()''，然后在语言文件中翻译该键。例如，添加工具提示时，可在物品类的子类执行以下操作：
-<code java>
+<yarncode java>
 @Override
-public void appendTooltip(ItemStack itemStack, World world, List<Text> tooltip, TooltipContext tooltipContext) {
+public void method_9568(class_1799 itemStack, class_1937 world, List<class_2561> tooltip, class_1836 tooltipContext) {
-    tooltip.add(new TranslatableText("item.tutorial.fabric_item.tooltip"));
+    // 1.18.2 之前
+    tooltip.add(new class_2588("item.tutorial.fabric_item.tooltip"));
+    // 1.19 之后
+    tooltip.add(Text.translatable("item.tutorial.fabric_item.tooltip"));
 }
-</code>
+</yarncode>
 然后在语言文件中添加：
@@ Line 40: / Line 44: @@
 </code>
 然后我们按照在文本中出现的顺序依次传入我们使用的变量。第一个是日期，第二个是月份：
-<code java>
+<yarncode java>
 int currentDay = 4;
 int currentMonth = 7;
-tooltip.add(new TranslatableText("item.tutorial.fabric_item.tooltip", currentDay, currentMonth));
+// 1.18 之前
-</code>
+tooltip.add(new class_2588("item.tutorial.fabric_item.tooltip", currentDay, currentMonth));
+// 1.19 之后
+tooltip.add(Text.translatable("item.tutorial.fabric_item.tooltip", currentDay, currentMonth));
+</yarncode>
 然后该工具提示将会显示为“我在第4天和第7月的工具提示”。如果需要传入字符串，使用 ''%s'' 而非 ''%d''。如果需要直接显示 ''%''，使用 ''%%''。如果需要指定顺序，可以使用如 ''%1$s''、''%2%s'' 这样的语法。更多信息请参见 [[https://dzone.com/articles/java-string-format-examples|Java String.format]]。
 ==== 添加新行 ====
-由于 Mojang 的充满独特特性的代码，在工具提示中，''\n'' 不会正常工作。因此如果需要多行字符串，需要将翻译键拆分成多个键：
+由于 Mojang 的充满独特特性的代码，在工具提示中，''\n'' 不会正常生效。因此如果需要多行字符串，需要将翻译键拆分成多个键：
 <code JavaScript resources/assets/tutorial/lang/en_us.json>
 {
@@ Line 56: / Line 63: @@
 }
 </code>
-然后分别加入 ''TranslatableText'' 部分：
+然后分别加入 ''<yarn class_2588>'' 或 ''Text.translatable'' 部分：
-<code java>
-tooltip.add(new TranslatableText("item.tutorial.fabric_item.tooltip_1"));
+.18.2之前：
-tooltip.add(new TranslatableText("item.tutorial.fabric_item.tooltip_2"));
+<yarncode java>
-</code>
+tooltip.add(new class_2588("item.tutorial.fabric_item.tooltip_1"));
+tooltip.add(new class_2588("item.tutorial.fabric_item.tooltip_2"));
+</yarncode>
+.19之后：
+<yarncode java>
+tooltip.add(Text.translatable("item.tutorial.fabric_item.tooltip_1"));
+tooltip.add(Text.translatable("item.tutorial.fabric_item.tooltip_2"));
+</yarncode>
 工具提示就会显示为：
 <code>
@@ Line 68: / Line 84: @@
 ====== 翻译格式 ======
-您注册的对象的翻译键的格式为''<对象类型>.<命名空间>.<路径>''（命名空间和路径就像在 ''Identifier'' 中注册的那样）。
+您注册的对象的翻译键的格式为''<对象类型>.<命名空间>.<路径>''（命名空间和路径就像在 ''<yarn class_2960>'' 中注册的那样）。
 ^ 对象类型      ^ 格式       ^ 例子          ^
-| 方块          | ''block.<modid>.<registry-id>''     |''"block.tutorial.example_block": "Example Block"  ''       |
+| 方块          | ''block.<modid>.<registry-id>''     |''"block.tutorial.example_block": "Example Block"''       |
 | 物品    |'' item.<modid>.<registry-id> '' |'' "item.tutorial.my_item": "My Item"'' |
 | 物品组 | '' itemGroup.<modid>.<registry-id>'' | '' "itemGroup.tutorial.my_group": "My Group"''|
@@ Line 82: / Line 98: @@
 | 生物群系 | '' biome.<modid>.<registry-id> '' ||
-对于不在此列表中的类型，请参见''net.minecraft.util.registry.Registry.java''。
+对于不在此列表中的类型，请参见 ''<yarn net.minecraft.class_2378>''。