Sync translations for zh-CN from official

b9d295f Add explanation for Component and ComponentContents (#4)

Signed-off-by: src_resources <[email protected]>

i18n/zh-CN/docusaurus-plugin-content-docs/current/concepts/internationalization.md

@@ -44,7 +44,7 @@ Block、Item和其他一些Minecraft类都内置了用于显示其名称的翻
 :::danger
     一个常见的问题是让服务端为客户端进行本地化。服务端只能在自己的语言设置中进行本地化，这不一定与所连接的客户端的语言设置相匹配。
 
-    为了尊重客户端的语言设置，服务端应该让客户端使用`TranslatableComponent`或其他保留语言中性翻译键的方法在自己的语言设置中本地化文本。
+    为了尊重客户端的语言设置，服务端应该让客户端使用`TranslatableContents`或其他保留语言中性翻译键的方法在自己的语言设置中本地化文本。
 :::
 
 ### `net.minecraft.client.resources.language.I18n` (仅客户端)
@@ -57,13 +57,15 @@ Block、Item和其他一些Minecraft类都内置了用于显示其名称的翻
 
 `TranslatableContents`是一个经过惰性的本地化和格式化的`ComponentContents`。它在向玩家发送消息时非常有用，因为它将在玩家自己的语言设置中自动本地化。
 
-`TranslatableContents(String, Object...)`构造函数的第一个参数是翻译键，其余参数用于格式化。唯一支持的格式说明符是`%s`和`%1$s`、`%2$s`、`%3$s`等。格式化参数可能是将插入到格式化结果文本中并保留其所有属性的`Component`。
+`TranslatableContents(String, Object...)`构造函数的第一个参数是翻译键，其余参数用于[格式化][formatting]。
 
-通过传入`TranslatableContents`的参数，可以使用`Component#translatable`创建`MutableComponent`。它也可以使用`MutableComponent#create`通过传入`ComponentContents`本身来创建。
+通过传入`TranslatableContents`的参数，可以使用`Component#translatable`创建`MutableComponent`。它也可以使用`MutableComponent#create`通过传入`ComponentContents`本身来创建。阅读[组件][components]以了解更多详细信息。
 
 ### `TextComponentHelper`
 
-- `createComponentTranslation(CommandSource, String, Object...)`根据接收者创建本地化并格式化的`MutableComponent`。如果接收者是一个原版客户端，那么本地化和格式化就很容易完成。如果没有，本地化和格式化将使用包含`TranslatableContents`的`Component`惰性地进行。只有当服务端允许原版客户端连接时，这才有用。
+- `createComponentTranslation(CommandSource, String, Object...)`对于在客户端和服务器之间发送消息非常有用。如果接收者是一个原版客户端，则该方法将急切地将所提供的翻译键本地化并格式化为发送方的语言环境，如果未加载语言环境，则为美式英语；加载了模组的服务端可能允许原版客户端加入，并且它们将缺少本地化消息本身所需的本地化数据。否则，该方法将创建具有`TranslatableContents`的组件。
 
 [langs]: https://minecraft.wiki/w/Language#Languages
 [converter]: https://tterrag.com/lang2json/
+[formatting]: ../misc/components.md#text-formatting
+[components]: ../misc/components.md

i18n/zh-CN/docusaurus-plugin-content-docs/current/misc/components.md

@@ -1,71 +1,71 @@
-Text Components
-==================
+文本组件
+========
 
-A `Component` is a holder for text which can be formatted and chained with other components via its subtype `MutableComponent`. A component can be created using one of the available static helpers:
+`Component`是一个文本持有者，可以通过其子类型`MutableComponent`对其进行格式化并与其他组件链接。可以使用以下可用静态辅助方法之一创建组件：
 
-| Method Name    | Description                                                                                                                        |
+| 方法名称        | 描述                                                                                                                               |
 |----------------|------------------------------------------------------------------------------------------------------------------------------------|
-| `literal`      | it creates a component which simply wraps the passed in text.                                                                      |
-| `nullToEmpty`  | it's the same as `#literal` except it creates an empty component if null has been passed                                           |
-| `translatable` | it creates a component which is represented as localized text to user, read [internationalization] for more details.               |
-| `empty`        | it creates an empty component                                                                                                      |
-| `keybind`      | it creates a component which is represented as the name of current keyboard key of the passed [key mapping][keymapping].           |
-| `nbt`          | it creates a component for representing nbt data specified by `path` inside `dataSource`                                           |
-| `score`        | it creates a component for representing the `objective`'s score of an entity specified by the [entity selector][selectors] `name`. |
-| `selector`     | it creates a component for displaying the list of names of entities selected by the [entity selector][selectors] `pattern`.        |
+| `literal`      | 其创建一个组件，该组件简单地封装传入的文本。                                                                                           |
+| `nullToEmpty`  | 其与`#literal`相同，只是当传递null时，其会创建一个空组件                                                                               |
+| `translatable` | 其创建一个组件，该组件以本地化文本的形式展示给用户，请阅读[国际化][internationalization]了解更多详细信息。                                |
+| `empty`        | 其创建一个空组件                                                                                                                    |
+| `keybind`      | 其创建一个组件，该组件表示为传递的[键盘布局][keymapping]中的当前键盘键的名称。                                                           |
+| `nbt`          | 其创建一个组件，用于表示由`dataSource`内部的`path`指定的nbt数据                                                                        |
+| `score`        | 其创建一个组件，用于表示由[实体选择器][selectors]`name`指定的实体的`objective`的分数。                                                  |
+| `selector`     | 其创建一个组件，用于显示由[实体选择器][选择器]`pattern`选择的实体的名称列表。                                                            |
 
-A component's text contents are represented by `ComponentContents`. Notably, the subtype `TranslatableContents` not only supports [localization][internationalization] but also [text formatting][formatting].
+组件的文本内容由`ComponentContents`表示。值得注意的是，其子类型`TranslatableContents`不仅支持[本地化][internationalization]，还支持[文本格式化][formatting]。
 
-Applying Style
---------------
+应用格式
+--------
 
-Components can be formatted (e.g., bold, click actions, color) via `Style`s. `Style`s are immutable, creating a new `Style` each time when modified. The empty style `Style#EMPTY` can be used as a base for configuration.
+组件可以通过`Style`进行格式化（例如，粗体、单击操作、颜色）。`Style`是不可变的，每次修改时都会创建一个新的`Style`。空样式`Style#EMPTY`可以用作配置的基础。
 
-Multiple styles can be merged together with `#applyTo(Style other)`; `other` will override all non-configured of the current object.
+可以使用`#applyTo(Style other)`将多个样式合并在一起；`other`将覆盖当前对象的所有未配置项。
 
-After configuring a style, it can be applied to a component with either `MutableComponent#setStyle` for overwriting, or `#withStyle` for merging:
+配置样式后，可以将其应用于具有`MutableComponent#setStyle`用于覆盖的组件，或具有`#withStyle`用于合并的组件：
 ```java
-// Creates MutableComponent wrapping literal "Hello!"
+// 创建MutableComponent以包装文本"Hello!"
 MutableComponent text = Component.literal("Hello!");
 
-// Copies empty style and sets color to blue and makes it italic
+// 复制空样式并将颜色设置为蓝色并使其变为斜体
 Style blueItalic = Style.EMPTY
         .withColor(0x0000FF)
         .withItalic(true);
 
-// Copies empty style and sets color to red
+// 复制空样式并将颜色设置为红色
 Style red = Style.EMPTY 
         .withColor(0xFF0000);
 
-// Copies empty style and makes it bold
+// 复制空样式并使其变为粗体
 Style bold = Style.EMPTY
         .withBold(true);
 
-// Copies empty style and makes it both underlined and strikethrough
+// 复制空样式并使其同时带下划线和删除线
 Style doubleLines = Style.EMPTY
         .withUnderlined(true)
         .withStrikethrough(true);
 
-// Sets style of the text to be blue and italic
+// 将文本的样式设置为蓝色和斜体
 text.setStyle(blueItalic);
 
-// Overwrites blue and italic style to be red, bold, underlined, and strikethrough
+// 将蓝色和斜体覆盖为红色、粗体、下划线和删除线
 text.withStyle(red).withStyle(bold).withStyle(doubleLines);
 ```
-This creates a red, bold text with two lines:
+这将创建一个带有两行的红色粗体文本：
 ![red_hello]
 
-Chaining Components
--------------------
+链接组件
+--------
 
-`MutableComponent#append` can chain multiple components together. Chained components can be retrieved with `MutableComponent#getSiblings`.
+`MutableComponent#append`可以将多个组件链接在一起。可以使用`MutableComponent#getSiblings`检索链接的组件。
 
-`Component` stores its siblings like a tree and is traversed in preorder; the parent style is merged with those of its siblings.
+`Component`像树一样存储其同级，并按预定顺序遍历；父样式与其同级样式合并。
 ![tree]
 
-The code below will create a component with the same structure in the above example:
+下面的代码将创建一个具有与上例中相同结构的组件：
 ```java
-// Create text only components
+// 创建仅文本组件
 MutableComponent first = Component.literal("first ");
 MutableComponent second = Component.literal("second ");
 MutableComponent third = Component.literal("third ");
@@ -74,32 +74,32 @@ MutableComponent fifth = Component.literal("fifth ");
 MutableComponent sixth = Component.literal("sixth ");
 MutableComponent seventh = Component.literal("seventh ");
 
-// Create components with style
+// 创建带有样式的组件
 MutableComponent red = Component.litearl("red ").withStyle(Style.EMPTY.withColor(0xFF0000));
 MutableComponent blue = Component.literal("blue ").withStyle(Style.EMPTY.withColor(0x0000FF));
 MutableComponent bold = Component.literal("bold ").withStyle(Style.EMPTY.withBold(true));
 
-// Structure created components in the same way as the image
+// 以与下图相同的方式为所创建的组件组织结构
 red.append(first).append(blue).append(seventh);
 blue.append(second).append(third).append(bold);
 bold.append(fourth).append(fifth).append(sixth);
 ```
 ![style_annotated]
 
-Text Formatting
----------------
+文本格式化
+----------
 
-Text formatting is the process of inserting data as text into predefined larger text. It can be used for displaying coordinates, showing unit measurements, etc. **Format specifiers** are used for indicating where a text can be inserted.
+文本格式化是将数据作为文本插入到预定义的较大文本中的过程。它可以用于显示坐标、显示单位测量值等。**格式说明符**用于指示文本可以插入的位置。
 
-`TranslatableContents` allows two types of format specifiers: `%s` and `%n$s`. The component uses the second parameter onwards, denoted as `args` , for holding what object to insert in place of a format specifier.
+`TranslatableContents`允许两种类型的格式说明符：`%s`和`%n$s`。该组件使用第二个参数，表示为`args`，用于保存要插入以代替格式说明符的对象。
 
-`%s` is replaced with elements of `args` in order they appear, i.e., the first `%s` is replaced with the first element of `args`, and so on.
-`%n$s` is positional specifier; each positional specifier can denote which element in `args` will replace the specifier via the number `n`.
-* Formatting `x:%s y:%s z:%s` with `[1, 2, 3]` as `args` results in `x:1 y:2 z:3`
-* Formatting `Time: %1$s ms` with `17` as `args` results in `Time: 17 ms`
-* Formatting `Player name: %2$s, HP: %1$s` with `[10.2, Dev]` as `args` results in `Player name: Dev, HP: 10.2`
+`%s`按其出现的顺序被替换为`args`的元素，即，第一个`%s`被替换为`args`的第一个元素，依此类推。
+`%n$s`是位置说明符；每个位置说明符可以通过数字`n`表示`args`中的哪个元素将替换说明符。
+* 使用`[1, 2, 3]`作为`args`格式化`x:%s y:%s z:%s`将得到`x:1 y:2 z:3`
+* 使用`17`作为`args`格式化`Time: %1$s ms`将得到`Time: 17 ms`
+* 使用`[10.2, Dev]`作为`args`格式化`Player name: %2$s, HP: %1$s`将得到`Player name: Dev, HP: 10.2`
 
-Any `Component` element within `args` will be transformed into a formatted text string.
+`args`中的任何`Component`元素都将转换为格式化的文本字符串。
 
 [internationalization]: ../concepts/internationalization.md
 [selectors]: https://minecraft.wiki/w/Target_selectors