From f629ad7262ed926e0f36f5597a2eaf987c821934 Mon Sep 17 00:00:00 2001
From: LoongArum <1@jindongjie.cn>
Date: Tue, 27 May 2025 10:43:57 +0800
Subject: [PATCH 1/7] Add cn trasnalte for new pages

---
 .../styling/container-queries.md              | 160 ++++++++++++++++++
 .../current/concepts/blend-modes.md           | 142 ++++++++++++++++
 .../current/concepts/image-interpolation.md   | 121 +++++++++++++
 .../current/deployment/native-aot.md          | 156 +++++++++++++++++
 .../current/tutorials/groupbox.md             |  77 +++++++++
 5 files changed, 656 insertions(+)
 create mode 100644 i18n/zh-Hans/docusaurus-plugin-content-docs/current/basics/user-interface/styling/container-queries.md
 create mode 100644 i18n/zh-Hans/docusaurus-plugin-content-docs/current/concepts/blend-modes.md
 create mode 100644 i18n/zh-Hans/docusaurus-plugin-content-docs/current/concepts/image-interpolation.md
 create mode 100644 i18n/zh-Hans/docusaurus-plugin-content-docs/current/deployment/native-aot.md
 create mode 100644 i18n/zh-Hans/docusaurus-plugin-content-docs/current/tutorials/groupbox.md

diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/basics/user-interface/styling/container-queries.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/basics/user-interface/styling/container-queries.md
new file mode 100644
index 000000000..84d2c81a3
--- /dev/null
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/basics/user-interface/styling/container-queries.md
@@ -0,0 +1,160 @@
+---
+id: container-queries
+title: 容器查询
+---
+
+# 容器查询 <MinVersion version="11.3" /> 
+
+容器查询允许根据作为容器的祖先元素的大小来激活控件的样式。
+
+:::tip
+Avalonia 的容器查询类似于 CSS 的容器查询，但功能更有限，以适应 Avalonia 支持的平台和外形样式。如果将 Toplevel 设置为容器，它们也可以像媒体查询一样工作。
+:::
+
+## 工作原理
+
+容器查询依赖于将祖先控件设置成容器。容器大小的更改会根据查询激活样式。这些查询可以检查容器的宽度或高度，或两者兼而有之。任何控件都可以是容器，但设置为容器的控件不能受链接到它的容器查询所托管的样式的影响。当查询被激活时，查询中托管的所有样式也将根据其选择器被激活。
+
+## 如何使用查询
+
+### 声明容器查询
+容器查询可以在 XAML 中定义为控件 `Styles` 属性的直接子元素，如下所示：
+
+```xml
+<StackPanel Orientation="Horizontal">
+    <StackPanel.Styles>
+      <ContainerQuery Name="container"
+                 Query="max-width:400">
+        <Style Selector="Button">
+          <Setter Property="Background"
+                  Value="Red"/>
+        </Style>
+      </ContainerQuery>
+<StackPanel>
+```
+
+它们也可以是 `ControlTheme` 样式的一部分：
+
+```xml
+<ControlTheme x:Key="{x:Type ListBox}" TargetType="ListBox">
+    ...
+  <Setter Property="Template">
+    <ControlTemplate>
+      <Border Name="border"
+              Container.Name="Test"
+              Container.Sizing="WidthAndHeight"
+              >
+        <ScrollViewer Name="PART_ScrollViewer">
+            ...
+        </ScrollViewer>
+      </Border>
+    </ControlTemplate>
+  </Setter>
+
+
+  <ContainerQuery Name="Test"
+                  Query="max-height:400">
+    <Style Selector="ScrollViewer#PART_ScrollViewer">
+      <Setter Property="Background"
+              Value="Red"/>
+    </Style>
+  </ContainerQuery>
+</ControlTheme>
+```
+`Name` 属性定义了它将附加到的容器的名称。这不是一个唯一的标识符，多个容器查询可以使用相同的名称。
+`Query` 定义了激活包含大小的规则。请参阅下面的[查询](#查询)。
+
+这使得它们在针对不同屏幕尺寸的主题，或根据其父元素中可用空间而具有不同形式的主题中非常易于使用。这带来了一些限制。
+1. 容器查询不能托管在 `Style` 元素中。
+   以下是无效的。
+```xml
+<StackPanel Orientation="Horizontal">
+    <StackPanel.Styles>
+        <Style Selector="...">
+            <ContainerQuery Name="container"
+                        Query="max-width:400">
+                <Style Selector="Button">
+                <Setter Property="Background"
+                        Value="Red"/>
+                </Style>
+            </ContainerQuery>
+        </Style>
+<StackPanel>
+```
+2. 在查询中声明的样式不能影响容器或其祖先。这与能够影响其父控件的普通 `Styles` 不同。因为容器查询依赖于容器的实际大小，让容器受到其查询激活的样式的影响可能会导致循环行为，即容器的大小被两个或多个查询连续更新。
+
+### 声明容器
+只有当作为 `ContainerQuery` 主机后代的控件被声明为容器时，容器查询才起作用。设置任何控件的 `Container.Name` 和 `Container.Sizing` 附加属性将声明该控件为容器，如下所示：
+
+```xml
+<Button
+    Container.Name="container-name"
+    Container.Sizing="container-sizing
+/>
+```
+
+`Container.Name` 定义容器的名称。它对于该容器不是唯一的，同一作用域中的多个控件可以具有相同的容器名称，并且它们都将受到相同容器查询的影响。
+
+`Container.Sizing` 定义了容器用于查询的大小调整策略。容器的最终大小取决于该值。它是一个具有以下值的枚举：
+
+* `Normal`: 不查询容器的大小。这是默认值。控件遵循正常的测量和排列。
+* `Width`: 查询容器的宽度。容器将使用其父元素允许的最大宽度，并且该值用于所有相关的容器查询。在大多数情况下，最终宽度是允许的最大宽度。
+* `Height`: 与 `Width` 相同，但仅查询容器的高度。
+* `WidthAndHeight`: 同时查询容器的宽度和高度。
+
+根据大小调整策略，容器将使用最大可用大小作为其期望大小。
+
+### 查询
+以下查询可用。
+* `min-width`: 等同于 `x >= width`
+* `min-height`: 等同于 `x >= height`
+* `max-width`: 等同于 `x <= width`
+* `max-height`: 等同于 `x <= height`
+* `height`: 等同于 `x == height`
+* `width`: 等同于 `x == width`
+
+以下是使用具有不同查询的多个容器查询的示例：
+
+```xml
+<ContainerQuery Name="uniformGrid"
+           Query="max-width:400">
+  <Style Selector="UniformGrid#ContentGrid">
+    <Setter Property="Columns"
+            Value="1"/>
+  </Style>
+</ContainerQuery>
+<ContainerQuery Name="uniformGrid"
+           Query="min-width:400">
+  <Style Selector="UniformGrid#ContentGrid">
+    <Setter Property="Columns"
+            Value="2"/>
+  </Style>
+</ContainerQuery>
+<ContainerQuery Name="uniformGrid"
+           Query="min-width:800">
+  <Style Selector="UniformGrid#ContentGrid">
+    <Setter Property="Columns"
+            Value="3"/>
+  </Style>
+</ContainerQuery>
+```
+多个查询可以使用 `,` 进行 OR 组合，或使用 `and` 进行 AND 组合。
+
+```xml
+<ContainerQuery Name="uniformGrid"
+           Query="max-width:400,min-width:300">
+  <Style Selector="UniformGrid#ContentGrid">
+    <Setter Property="Columns"
+            Value="1"/>
+  </Style>
+</ContainerQuery>
+<ContainerQuery Name="uniformGrid"
+           Query="min-width:400 and min-width:300">
+  <Style Selector="UniformGrid#ContentGrid">
+    <Setter Property="Columns"
+            Value="2"/>
+  </Style>
+</ContainerQuery>
+```
+
+这样，您可以为大小范围创建查询。
\ No newline at end of file
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/concepts/blend-modes.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/concepts/blend-modes.md
new file mode 100644
index 000000000..51059d7f1
--- /dev/null
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/concepts/blend-modes.md
@@ -0,0 +1,142 @@
+---
+title: 位图混合模式
+description: 概念
+---
+
+import BlendModeCat from '/img/concepts/blend/Cat.jpg';
+import BlendModeOverlayColor from '/img/concepts/blend/Overlay-Color.png';
+
+import BlendModeOverlay from '/img/concepts/blend/Overlay.png';
+import BlendModePlus from '/img/concepts/blend/Plus.png';
+import BlendModeSaturation from '/img/concepts/blend/Saturation.png';
+import BlendModeScreen from '/img/concepts/blend/Screen.png';
+import BlendModeSoftLight from '/img/concepts/blend/SoftLight.png';
+import BlendModeColor from '/img/concepts/blend/Color.png';
+import BlendModeColorBurn from '/img/concepts/blend/ColorBurn.png';
+import BlendModeColorDodge from '/img/concepts/blend/ColorDodge.png';
+import BlendModeDarken from '/img/concepts/blend/Darken.png';
+import BlendModeDifference from '/img/concepts/blend/Difference.png';
+import BlendModeExclusion from '/img/concepts/blend/Exclusion.png';
+import BlendModeHardLight from '/img/concepts/blend/HardLight.png';
+import BlendModeHue from '/img/concepts/blend/Hue.png';
+import BlendModeLighten from '/img/concepts/blend/Lighten.png';
+import BlendModeLuminosity from '/img/concepts/blend/Luminosity.png';
+import BlendModeMultiply from '/img/concepts/blend/Multiply.png';
+import BlendModeNothing from '/img/concepts/blend/Nothing.png';
+
+import BlendModeA from '/img/concepts/blend/A.png';
+import BlendModeB from '/img/concepts/blend/B.png';
+
+import BlendModeDestination from '/img/concepts/blend/Destination.png';
+import BlendModeDestinationAtop from '/img/concepts/blend/DestinationAtop.png';
+import BlendModeDestinationIn from '/img/concepts/blend/DestinationIn.png';
+import BlendModeDestinationOut from '/img/concepts/blend/DestinationOut.png';
+import BlendModeDestinationOver from '/img/concepts/blend/DestinationOver.png';
+import BlendModeSource from '/img/concepts/blend/Source.png';
+import BlendModeSourceAtop from '/img/concepts/blend/SourceAtop.png';
+import BlendModeSourceIn from '/img/concepts/blend/SourceIn.png';
+import BlendModeSourceOut from '/img/concepts/blend/SourceOut.png';
+import BlendModeSourceOver from '/img/concepts/blend/SourceOver.png';
+import BlendModeXor from '/img/concepts/blend/Xor.png';
+
+在屏幕上渲染位图图形时，Avalonia 支持指定渲染时使用的混合模式。混合模式会改变在现有像素（目标）上绘制新像素（源）时执行的计算。
+
+目前，Avalonia 的合成模式和像素混合模式位于一个名为 `BitmapBlendingMode` 的枚举中。
+
+合成模式枚举主要描述新像素如何根据 Alpha 通道与当前屏幕上的像素进行交互，这可用于创建例如：“切图器”、排除区域或蒙版。
+
+另一方面，像素混合模式指定新颜色将如何与当前颜色进行交互。这些模式可用于例如：特殊效果、更改色相或其他更复杂的图像合成。
+
+有关混合模式如何工作及其背后数学原理的示例，请参阅 [维基百科页面](https://zh.wikipedia.org/wiki/%E6%B7%B7%E5%90%88%E6%A8%A1%E5%BC%8F)。
+
+:::info
+目前，Avalonia 仅在使用 Skia 渲染器时支持混合模式。尝试将这些模式与 D2D 渲染器一起使用将导致与默认模式相同的行为。
+:::
+
+## 默认行为
+
+默认的混合模式是 `SourceOver`，这意味着根据 Alpha 通道，用新值替换所有像素值。这是大多数应用程序覆盖两个图像的标准方式。
+
+## 如何使用它
+
+在 XAML 中，您可以指定渲染 Image 控件时使用的混合模式。以下示例将在非常可爱的猫的图片上渲染颜色叠加层：
+
+```xml
+<Panel>
+    <Image Source="./Cat.jpg"/>
+    <Image Source="./Overlay-Color.png" BlendMode="Multiply"/>
+</Panel>
+```
+
+如果您正在创建自定义用户控件，并希望使用这些模式之一通过代码渲染位图，可以通过在控件上下文渲染选项中设置 `BitmapBlendingMode` 来实现：
+
+``` csharp
+// 在 "Render" 方法内部，像这样绘制位图：
+
+using (context.PushRenderOptions(RenderOptions with { BitmapBlendingMode = BitmapBlendingMode.Multiply }))
+{
+    context.DrawImage(source, sourceRect, destRect);
+}
+```
+
+## 位图混合模式展示
+
+Avalonia 支持多种可应用于渲染的位图混合模式：
+
+### 像素混合模式
+
+像素混合模式仅影响颜色，不考虑 Alpha 通道。
+
+这些是示例中使用的图像：
+
+| 可爱猫咪基础图像 (目标) | 色轮叠加图像 (源) |
+|:---:|:---:|
+| <img src={BlendModeCat} alt="" width="180"/> | <img src={BlendModeOverlayColor} alt="" width="180"/> |
+
+以下是 Avalonia 当前支持的所有值
+
+| 预览 | 枚举 | 描述 |
+|---|---|---|
+| <img src={BlendModeNothing} alt="" width="180"/> | `Unspecified` | 或 `SourceOver` - 默认行为。 |
+| <img src={BlendModePlus} alt="" width="180"/> | `Plus` | 显示源图像和目标图像的总和。 |
+| <img src={BlendModeScreen} alt="" width="180"/> | `Screen` | 将目标和源颜色值的补码相乘，然后对结果进行补码。 |
+| <img src={BlendModeOverlay} alt="" width="180"/> | `Overlay` | 根据目标颜色值，对颜色进行正片叠底或滤色。 |
+| <img src={BlendModeDarken} alt="" width="180"/> | `Darken` | 选择目标和源颜色中较暗的一个。 |
+| <img src={BlendModeLighten} alt="" width="180"/> | `Lighten` | 选择目标和源颜色中较亮的一个。 |
+| <img src={BlendModeColorDodge} alt="" width="180"/> | `ColorDodge` | 使目标颜色变亮以反映源颜色。 |
+| <img src={BlendModeColorBurn} alt="" width="180"/> | `ColorBurn` | 根据源颜色值，对颜色进行正片叠底或滤色。 |
+| <img src={BlendModeHardLight} alt="" width="180"/> | `HardLight` | 根据源颜色值，使颜色变暗或变亮。 |
+| <img src={BlendModeSoftLight} alt="" width="180"/> | `SoftLight` | 从两个组成颜色中较亮的颜色减去较暗的颜色。 |
+| <img src={BlendModeDifference} alt="" width="180"/> | `Difference` | 产生与差值模式类似但对比度较低的效果。 |
+| <img src={BlendModeExclusion} alt="" width="180"/> | `Exclusion` | 源颜色乘以目标颜色并替换目标。 |
+| <img src={BlendModeMultiply} alt="" width="180"/> | `Multiply` | 创建一个具有源颜色色相以及目标颜色饱和度和亮度的颜色。 |
+| <img src={BlendModeHue} alt="" width="180"/> | `Hue` | 创建一个具有源颜色色相以及目标颜色饱和度和亮度的颜色。 |
+| <img src={BlendModeSaturation} alt="" width="180"/> | `Saturation` | 创建一个具有源颜色饱和度以及目标颜色色相和亮度的颜色。 |
+| <img src={BlendModeColor} alt="" width="180"/> | `Color` | 创建一个具有源颜色色相和饱和度以及目标颜色亮度的颜色。 |
+| <img src={BlendModeLuminosity} alt="" width="180"/> | `Luminosity` | 创建一个具有源颜色亮度以及目标颜色色相和饱和度的颜色。 |
+
+### 合成混合模式
+
+合成混合模式仅影响 Alpha 通道，不影响颜色。
+
+这些是示例中使用的图像：
+
+| "A" 基础图像 (目标) | "B" 叠加图像 (源) |
+|:---:|:---:|
+| <img src={BlendModeA} alt="" width="180"/> | <img src={BlendModeB} alt="" width="180"/> |
+
+以下是 Avalonia 当前支持的所有值。请注意，此演示对 Alpha 通道敏感，因此网站背景会透过图像显示。
+
+| 预览 | 枚举 | 描述 |
+|---|---|---|
+| <img src={BlendModeSource} alt="" width="180"/> | `Source` | 仅显示源。 |
+| <img src={BlendModeSourceOver} alt="" width="180"/> | `SourceOver` | 或 `Unspecified` - 默认行为，源放置在目标之上。 |
+| <img src={BlendModeSourceIn} alt="" width="180"/> | `SourceIn` | 与目标重叠的源替换目标。 |
+| <img src={BlendModeSourceOut} alt="" width="180"/> | `SourceOut` | 源放置在目标之外的区域。 |
+| <img src={BlendModeSourceAtop} alt="" width="180"/> | `SourceAtop` | 与目标重叠的源替换目标。 |
+| <img src={BlendModeXor} alt="" width="180"/> | `Xor` | 源和目标不重叠的区域组合在一起。 |
+| <img src={BlendModeDestination} alt="" width="180"/> | `Destination` | 仅显示目标。 |
+| <img src={BlendModeDestinationOver} alt="" width="180"/> | `DestinationOver` | 目标放置在源之上。 |
+| <img src={BlendModeDestinationIn} alt="" width="180"/> | `DestinationIn` | 与源重叠的目标替换源。 |
+| <img src={BlendModeDestinationOut} alt="" width="180"/> | `DestinationOut` | 目标放置在源之外的区域。 |
+| <img src={BlendModeDestinationAtop} alt="" width="180"/> | `DestinationAtop` | 与源重叠的目标替换源。 |
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/concepts/image-interpolation.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/concepts/image-interpolation.md
new file mode 100644
index 000000000..95bc318aa
--- /dev/null
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/concepts/image-interpolation.md
@@ -0,0 +1,121 @@
+---
+title: 图像插值
+description: 概念
+---
+
+在 Avalonia 中显示图像时，尤其是在将图像缩放到与其原始分辨率不同的尺寸时，渲染质量取决于所使用的插值模式。本指南介绍了如何在 Avalonia 应用程序中控制图像插值。
+
+## 默认行为
+
+自 Avalonia 11 起，默认插值模式设置为 `LowQuality`。此设置优先考虑性能，但在缩放图像时可能会导致图像渲染不够平滑，尤其是在以远小于其原始尺寸的尺寸显示图像时。
+
+## 插值模式
+
+Avalonia 支持多种可应用于图像渲染的位图插值模式：
+
+- `None`: 无插值
+- `LowQuality`: 基本插值（默认）
+- `MediumQuality`: 平衡插值
+- `HighQuality`: 平滑插值，最适合缩小图像
+
+## 设置插值模式
+
+### 单个控件设置
+
+您可以使用 `RenderOptions.BitmapInterpolationMode` 附加属性在单个控件上设置插值模式：
+
+```xml
+<Image Source="assets/myimage.png" 
+       RenderOptions.BitmapInterpolationMode="HighQuality" />
+```
+
+这也可以应用于容器：
+
+```xml
+<Border RenderOptions.BitmapInterpolationMode="HighQuality">
+    <Image Source="assets/myimage.png" />
+</Border>
+```
+
+### 常见用例
+
+1.  **图标显示**：当显示被缩小的图标时，使用 `HighQuality` 插值可以防止出现锯齿边缘：
+```xml
+<Button>
+    <Image Source="assets/icon.png" 
+           Width="16" 
+           Height="16"
+           RenderOptions.BitmapInterpolationMode="HighQuality" />
+</Button>
+```
+
+2.  **图像展示**：对于需要高质量画面的图像展示：
+```xml
+<ItemsControl RenderOptions.BitmapInterpolationMode="HighQuality">
+    <ItemsControl.ItemTemplate>
+        <DataTemplate>
+            <Image Source="{Binding ImagePath}" />
+        </DataTemplate>
+    </ItemsControl.ItemTemplate>
+</ItemsControl>
+```
+
+## 性能考量
+
+出于性能原因，插值模式是按控件设置的。更高质量的插值需要更多的计算资源，因此请考虑以下准则：
+
+- 对以下情况使用 `HighQuality`：
+  - 重要的 UI 元素，如徽标
+  - 质量至关重要的缩小图像
+  - 照片画廊或以图像为中心的界面
+
+- 对以下情况使用默认的 `LowQuality`：
+  - 背景图像
+  - 质量不太关键的装饰元素
+  - 对性能敏感的应用程序
+
+## 创建全局设置
+
+虽然 Avalonia 没有提供内置的方法来设置全局插值模式，但您可以创建自定义附加属性或行为来在整个应用程序中管理此设置。以下是一个示例方法：
+
+```csharp
+public static class GlobalImageOptions
+{
+    public static readonly AttachedProperty<BitmapInterpolationMode> InterpolationModeProperty =
+        AvaloniaProperty.RegisterAttached<Image, BitmapInterpolationMode>(
+            "InterpolationMode",
+            typeof(GlobalImageOptions),
+            defaultValue: BitmapInterpolationMode.HighQuality);
+
+    public static void SetInterpolationMode(Image image, BitmapInterpolationMode value)
+    {
+        image.SetValue(RenderOptions.BitmapInterpolationModeProperty, value);
+    }
+}
+```
+
+然后在您的 XAML 中：
+
+```xml
+<Style Selector="Image">
+    <Setter Property="(local:GlobalImageOptions.InterpolationMode)"
+            Value="HighQuality" />
+</Style>
+```
+
+## 获得最佳效果的技巧
+
+1.  **素材准备**：
+    -   提供适合其预期显示尺寸的适当分辨率的图像
+    -   考虑为重要素材包含多种分辨率
+    -   尽可能使用矢量格式 (SVG) 以获得与分辨率无关的图形
+
+2.  **布局注意事项**：
+    -   注意原始图像尺寸与显示尺寸的关系
+    -   使用适当的容器和布局面板来管理图像缩放
+    -   考虑将 `UniformToFill` 或 `Uniform` 拉伸模式与高质量插值结合使用
+
+3.  **测试**：
+    -   在不同屏幕密度上测试图像渲染
+    -   验证在许多图像上使用高质量插值时的性能影响
+    -   检查不同插值设置下的内存使用情况
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/deployment/native-aot.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/deployment/native-aot.md
new file mode 100644
index 000000000..aad53c3ef
--- /dev/null
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/deployment/native-aot.md
@@ -0,0 +1,156 @@
+---
+id: native-aot
+title: Native AOT 部署
+---
+
+Native AOT (Ahead-of-Time) 编译允许您将 Avalonia 应用程序发布为具有本机性能特征的自包含可执行文件。本指南涵盖了 Avalonia 特定的注意事项和 Native AOT 部署的设置。
+
+## Avalonia 应用程序的优势
+
+Native AOT 编译为 Avalonia 应用程序提供了几个特别相关的优势：
+
+- 更快的应用程序启动时间，尤其有利于桌面应用程序
+- 减少资源受限环境的内存占用
+- 自包含部署，无需安装 .NET 运行时
+- 通过减少攻击面（无 JIT 编译）提高安全性
+- 与裁剪结合使用时，分发包更小
+
+## 为 Avalonia 设置 Native AOT
+
+### 1. 项目配置
+
+将以下内容添加到您的 csproj 文件中：
+
+```xml
+<PropertyGroup>
+    <PublishAot>true</PublishAot>
+    <!-- 推荐的 Avalonia Native AOT 裁剪设置 -->
+    <BuiltInComInteropSupport>false</BuiltInComInteropSupport>
+    <TrimMode>link</TrimMode>
+</PropertyGroup>
+```
+
+### 2. 裁剪配置
+
+Native AOT 需要裁剪。添加这些特定于 Avalonia 的裁剪设置：
+
+```xml
+<ItemGroup>
+    <!-- 保留 Avalonia 类型以进行反射 -->
+    <TrimmerRootAssembly Include="Avalonia.Themes.Fluent" />
+    <TrimmerRootAssembly Include="Avalonia.Themes.Default" />
+</ItemGroup>
+```
+
+## Avalonia 特定注意事项
+
+### XAML 加载
+使用 Native AOT 时，XAML 会在构建时编译到应用程序中。请确保您：
+- 在 XAML 文件中使用 `x:CompileBindings="True"`
+- 避免在运行时动态加载 XAML
+- 尽可能使用静态资源引用而不是动态资源
+
+### 资产和资源
+- 将所有资产捆绑为嵌入式资源
+- 对您的资产使用 `AvaloniaResource` 构建操作
+- 避免从外部源动态加载资产
+
+### ViewModel 和依赖注入
+- 在启动时注册您的 ViewModel
+- 使用编译时 DI 配置
+- 避免基于反射的服务定位
+
+## 发布 Avalonia Native AOT 应用程序
+
+### Windows
+```bash
+dotnet publish -r win-x64 -c Release
+```
+
+### Linux
+```bash
+dotnet publish -r linux-x64 -c Release
+```
+
+### macOS
+基于 Intel 的 macOS
+```bash
+dotnet publish -r osx-x64 -c Release
+```
+基于 Apple 芯片的 macOS
+```bash
+dotnet publish -r osx-arm64 -c Release
+```
+
+:::tip
+然后，您可以使用 Apple 的 [lipo 工具](https://developer.apple.com/documentation/apple-silicon/building-a-universal-macos-binary) 来合并 Intel 和 Apple Silicon 的二进制文件，从而使您能够发布通用二进制文件。
+:::
+
+## 故障排除常见问题
+
+### 1. 缺少 XAML 控件
+如果运行时缺少控件：
+```xml
+<ItemGroup>
+    <!-- 添加您正在使用的特定 Avalonia 控件 -->
+    <TrimmerRootAssembly Include="Avalonia.Controls" />
+</ItemGroup>
+```
+
+### 2. 反射相关错误
+对于使用反射的 ViewModel 或服务：
+```xml
+<ItemGroup>
+    <TrimmerRootDescriptor Include="TrimmerRoots.xml" />
+</ItemGroup>
+```
+
+创建一个 `TrimmerRoots.xml`：
+```xml
+<linker>
+    <assembly fullname="YourApplication">
+        <type fullname="YourApplication.ViewModels*" preserve="all"/>
+    </assembly>
+</linker>
+```
+
+## 已知限制
+
+将 Native AOT 与 Avalonia 一起使用时，请注意以下限制：
+- 动态控件创建必须在裁剪器设置中配置
+- 某些第三方 Avalonia 控件可能与 AOT 不兼容
+- 特定于平台的功能需要显式配置
+- 设计时工具中的实时预览可能受限
+
+## 平台支持
+
+| 平台 | 状态 |
+|----------|--------|
+| Windows x64 | ✅ 支持 | 
+| Windows Arm64 | ✅ 支持 | 
+| Linux x64 | ✅ 支持 | |
+| Linux Arm64 | ✅ 支持 | 
+| macOS x64 | ✅ 支持 | |
+| macOS Arm64 | ✅ 支持 | 
+| 浏览器 | ❌ 不支持 |
+
+## 最佳实践
+
+1.  **应用程序结构**
+    -   始终如一地使用 MVVM 模式
+    -   最大限度地减少反射的使用
+    -   优先选择编译时配置
+
+2.  **资源管理**
+    -   尽可能使用静态资源
+    -   捆绑所有必需的资产
+    -   在 IDisposable 中实现正确的清理
+
+3.  **性能优化**
+    -   启用绑定编译
+    -   使用已编译的绑定
+    -   为大型集合实现适当的虚拟化
+
+## 额外资源
+
+- [使用 Native AOT 的 Avalonia 示例应用程序](https://github.com/AvaloniaUI/Avalonia.Samples)
\ No newline at end of file
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/tutorials/groupbox.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/tutorials/groupbox.md
new file mode 100644
index 000000000..ef5c93bed
--- /dev/null
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/tutorials/groupbox.md
@@ -0,0 +1,77 @@
+---
+id: groupbox
+title: 使用 HeaderedContentControl 创建 GroupBox
+sidebar_label: 创建 GroupBox
+---
+
+import groupboxscreenshot from '/img/tutorials/groupbox/groupbox.png';
+
+
+虽然 Avalonia 没有内置的 `GroupBox` 控件，但您可以使用带有自定义样式的 `HeaderedContentControl` 来实现相同的功能和外观。`HeaderedContentControl` 提供了一个标题区域和内容区域，非常适合用于对相关的界面元素进行分组。
+
+<GitHubSampleLink title="自定义 GroupBox" link="https://github.com/AvaloniaUI/AvaloniaUI.QuickGuides/tree/main/GroupBox"/>
+
+## 实现
+将以下样式添加到您的应用程序资源（通常在 App.axaml 中）或需要 `GroupBox` 功能的特定 `Window` 或 `UserControl` 中：
+
+```xml title='XAML'
+<Style Selector="HeaderedContentControl">
+    <Setter Property="Template">
+        <ControlTemplate>
+            <Grid>
+                <Grid.RowDefinitions>
+                    <RowDefinition Height="Auto"/>
+                    <RowDefinition Height="*"/>
+                </Grid.RowDefinitions>
+                <Grid.ColumnDefinitions>
+                    <ColumnDefinition Width="Auto"/>
+                    <ColumnDefinition Width="*"/>
+                </Grid.ColumnDefinitions>
+        
+                <!-- Header -->
+                <Border 
+                    ZIndex="1" 
+                    Background="{DynamicResource SystemControlBackgroundAltHighBrush}" 
+                    Padding="5,0,5,0" 
+                    Margin="5,0,0,0">
+                    <TextBlock 
+                        Text="{TemplateBinding Header}" 
+                        FontWeight="Bold"/>
+                </Border>
+        
+                <!-- Content Area -->
+                <Border 
+                    Grid.RowSpan="2" 
+                    Padding="0,5,0,0"
+                    Grid.ColumnSpan="2"
+                    CornerRadius="4"
+                    Margin="0,10,0,0"
+                    BorderBrush="{DynamicResource SystemControlForegroundBaseMediumBrush}"
+                    BorderThickness="1">
+                    <ContentPresenter 
+                        Name="PART_ContentPresenter"
+                        Padding="8"
+                        Content="{TemplateBinding Content}"/>
+                </Border>
+            </Grid>
+        </ControlTemplate>
+    </Setter>
+</Style>
+```
+
+样式设置好后，您就可以在 XAML 中使用 `HeaderedContentControl` 了：
+
+```xml title='XAML'
+<HeaderedContentControl Header="Settings">
+    <StackPanel Spacing="8">
+        <TextBox Text="Sample content"/>
+        <Button Content="Click me"/>
+    </StackPanel>
+</HeaderedContentControl>
+```
+
+<img className="center" src={groupboxscreenshot} width="200"/>
+
+该样式使用 Avalonia 的主题资源来确保控件在浅色和深色主题下看起来都很合适。标题文本通过使用与窗口匹配的背景颜色，看起来像是“打破”了边框线，从而创建了经典的 `GroupBox` 外观。内容区域具有圆角和适当的内边距，呈现出现代感。
+
+此实现提供了传统 `GroupBox` 的所有视觉和功能优势，同时保持了与 Avalonia 设计模式和主题系统的一致性。
\ No newline at end of file

From 0016b34403671790f6a2cbc154bfda6ff45fd7ea Mon Sep 17 00:00:00 2001
From: LoongArum <1@jindongjie.cn>
Date: Tue, 27 May 2025 11:17:49 +0800
Subject: [PATCH 2/7] Update nativemenu.md

---
 .../current/reference/controls/nativemenu.md  | 142 +++++++++++++++---
 1 file changed, 124 insertions(+), 18 deletions(-)

diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/controls/nativemenu.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/controls/nativemenu.md
index ad6ef2877..3d255eef2 100644
--- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/controls/nativemenu.md
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/controls/nativemenu.md
@@ -1,18 +1,10 @@
----
-description: REFERENCE - Built-in Controls
----
+# NativeMenu (原生菜单)
 
-# NativeMenu 原生菜单
+`NativeMenu` 可以在 _macOS_ 和一些 Linux 发行版上显示菜单。
 
-原生菜单可以在 _macOS_ 和一些 Linux 发行版上显示菜单。
+您可以通过嵌套 `<MenuItem>` 元素来创建子菜单。
 
-:::warning
-此控件仅可用于附加到托盘图标。有关托盘图标的完整详细信息，请参阅参考资料[这里](tray-icon.md)。
-:::
-
-你可以通过嵌套 `<MenuItem>` 元素来创建子菜单。
-
-你可以通过包含一个 `<NativeMenuItemSeparator>` 元素或添加一个其标题设置为减号的菜单项来添加菜单分隔线，如下所示：
+您可以通过包含 `<NativeMenuItemSeparator>` 元素或添加一个将其 `Header` 设置为减号的菜单项来添加菜单分隔线，如下所示：
 
 ```xml
 <NativeMenuItemSeparator Header="-" />
@@ -20,13 +12,127 @@ description: REFERENCE - Built-in Controls
 
 ## 常用属性
 
-你可能最常使用这些属性：
+您可能会最常使用这些属性：
 
-<table><thead><tr><th width="204">属性</th><th>描述</th></tr></thead><tbody><tr><td><code>Header</code></td><td>菜单标题。</td></tr><tr><td><code>Command</code></td><td>用户点击菜单项时执行的命令。</td></tr></tbody></table>
+<table>
+  <thead>
+    <tr><th width="204">属性</th><th>描述</th></tr>
+  </thead>
+  <tbody>
+    <tr><td><code>Header</code></td><td>菜单标题。</td></tr>
+    <tr><td><code>Command</code></td><td>用户点击菜单项时执行的命令。</td></tr>
+    <tr><td><code>Gesture</code></td><td>与菜单项关联的键盘快捷键。</td></tr>
+  </tbody>
+</table>
 
-## 示例
+## 示例1
 
-此示例定义了一个可以附加到托盘图标的本地菜单：
+此示例修改 macOS 中的默认应用程序菜单。
+
+:::info
+更改应用程序的 `Name` 属性将导致应用程序菜单标题更改。在此示例中，它被设置为 *Sample Application*。
+:::
+
+![image](https://github.com/user-attachments/assets/d30bab47-f133-4f79-9bdb-d4fb4569ed61)
+
+```xml
+<Application xmlns="https://github.com/avaloniaui"
+             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+             x:Class="NativeMenu
+
+             xmlns:local="using:NativeMenuTest"
+             RequestedThemeVariant="Default"
+             Name="Sample Application">
+             <!-- "Default" ThemeVariant follows system theme variant. "Dark" or "Light" are other available options. -->
+
+    <Application.DataTemplates>
+        <local:ViewLocator/>
+    </Application.DataTemplates>
+
+    <NativeMenu.Menu>
+        <NativeMenu>
+            <NativeMenuItem Header="About This Application…" Click="AppAbout_OnClick" />
+            <NativeMenuItem Header="Preferences…" Click="AppPreferences_OnClick" />
+        </NativeMenu>
+    </NativeMenu.Menu>
+  
+    <Application.Styles>
+        <FluentTheme />
+    </Application.Styles>
+</Application>
+```
+
+你还需要在 code-behind 中添加正确的事件处理器
+
+```C#
+private void AppAbout_OnClick(object? sender, System.EventArgs args) {
+
+}
+
+private void AppPreferences_OnClick(object? sender, System.EventArgs args) {
+    
+}
+```
+
+## 示例2
+
+这个示例添加了 *文件* 菜单以及 *编辑* 菜单。为了说明 `NativeMenu.Menu` 元素在 XAML 中的位置上下文，此示例包含了一些其他 XML 标签；但为简洁起见，这些标签省略了应用程序正常运行所必需的属性。
+
+
+```Xml
+<Window>
+    <Design.DataContext />
+
+    <NativeMenu.Menu>
+        <NativeMenu>
+            <NativeMenuItem Header="File" IsVisible="true">
+                <NativeMenu>                    
+                    <NativeMenuItem Header="Open…" Click="FileOpen_OnClick" Gesture="Meta+O" />
+                    <NativeMenuItem Header="Save As…" Click="FileSaveAs_OnClick" Gesture="Meta+Shift+S" />
+                    <NativeMenuItem Header="Save As…" Click="FileSaveAs_OnClick" Gesture="Meta+A" />
+                </NativeMenu>
+            </NativeMenuItem>
+            <NativeMenuItem Header="Edit" IsEnabled="true">
+                <NativeMenu>
+                    <NativeMenuItem Header="Cut" Command="{Binding CutCommand}" Gesture="Meta+X" />
+                    <NativeMenuItem Header="Copy" Command="{Binding CopyCommand}" Gesture="Meta+C" />
+                    <NativeMenuItem Header="Past" Command="{Binding PasteCommand}" Gesture="Meta+V" />
+                </NativeMenu>
+            </NativeMenuItem>
+        </NativeMenu>
+    </NativeMenu.Menu>
+
+    <TextBlock Text="{Binding Greeting}" HorizontalAlignment="Center" VerticalAlignment="Center"/>
+
+</Window>
+```
+
+在 视图模型中，你还需要添加以下命令函数：
+
+```C#
+public void CutCommand() { }
+
+public void CopyCommand() { }
+
+public void PasteCommand() { }
+```
+
+### 手势格式
+
+`Gestrue` 属性是一个以 `+` 分隔的键修饰符列表，后跟一个 `+`，然后是一个单独的按键字符（该符号本身亦可能是 `+`）。允许的修饰符包括 `Alt`，`Control`，`Shift`，还有 `Meta`。如果 `Gestrue` 属性为空字符串或仅包含单个按键字符，则不会引发异常，但是该手势就不会再激活菜单项了。如果提供了键修饰符但没有提供按键，或者是属性值的格式不正确，则会引发 `ArgumentException`。有关的更多详细信息，请参阅：[`KeyGesture`](https://github.com/AvaloniaUI/Avalonia/blob/master/src/Avalonia.Base/Input/KeyGesture.cs)，[`Key`](https://github.com/AvaloniaUI/Avalonia/blob/master/src/Avalonia.Base/Input/Key.cs)，还有 [`KeyModifier`](https://github.com/AvaloniaUI/Avalonia/blob/master/src/Avalonia.Base/Input/IKeyboardDevice.cs)。
+
+
+:::info 
+请注意，如果没有代码隐藏的 `Click` 事件处理程序或使用 `Command` 属性绑定的函数，菜单项将不会启用。 
+:::
+
+:::info 
+请注意，在 macOS 上，标题为 `Edit` 的菜单栏级别 `NativeMenuItem` 默认会包含一些额外的 macOS 功能。 
+:::
+
+## 示例3
+
+此示例定义了一个可以附加到托盘图标的本机菜单：
 
 ```xml
 <NativeMenu>
@@ -44,9 +150,9 @@ description: REFERENCE - Built-in Controls
 ## 更多信息
 
 :::info
-有关此控件的完整 API 文档，请参见[这里](http://reference.avaloniaui.net/api/Avalonia.Controls/NativeMenu/)。
+有关此控件的完整API文档，请参阅 [此处](http://reference.avaloniaui.net/api/Avalonia.Controls/NativeMenu/).
 :::
 
 :::info
 在 GitHub 上查看源代码 [NativeMenu.cs](https://github.com/AvaloniaUI/Avalonia/blob/master/src/Avalonia.Controls/NativeMenu.cs)
-:::
\ No newline at end of file
+:::

From b6e4475f602b8083a0cdfd7cb2e75c53764d12ac Mon Sep 17 00:00:00 2001
From: LoongArum <1@jindongjie.cn>
Date: Tue, 27 May 2025 11:22:57 +0800
Subject: [PATCH 3/7] Update how-to-usetheme-variants.md

---
 .../guides/styles-and-resources/how-to-use-theme-variants.md  | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/styles-and-resources/how-to-use-theme-variants.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/styles-and-resources/how-to-use-theme-variants.md
index 90eb36778..5280d3d3d 100644
--- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/styles-and-resources/how-to-use-theme-variants.md
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/styles-and-resources/how-to-use-theme-variants.md
@@ -126,4 +126,8 @@ RequestedThemeVariant 属性允许覆盖主题变体并为 `Application`、`Wind
 
 ![自定义主题字典](/img/basics/user-interface/styling/custom-theme-dictionaries.png)
 
+:::warning
+注意，在 `ThemeDictionaries` 中定义的资源只能通过 `DynamicResource` 标记扩展来引用。`StaticResource` 标记扩展无法找到这些资源，如果在非 `ThemeDictionaries` 部分没有同名资源，则会在运行时抛出异常。
+:::
+
 有关使用资源的更多详细信息，请参阅 [如何使用资源](resources) 页面。
\ No newline at end of file

From ab9b2c41cd31913df0ba96b9936a74489c2dd6ec Mon Sep 17 00:00:00 2001
From: LoongArum <1@jindongjie.cn>
Date: Tue, 27 May 2025 11:32:47 +0800
Subject: [PATCH 4/7] Fix url error in cn datagrid section

---
 .../current/reference/controls/datagrid/README.md           | 4 ++--
 .../controls/datagrid/data-grid-template-columns.md         | 2 +-
 .../current/reference/controls/datagrid/datagridcolumns.md  | 6 +++---
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/controls/datagrid/README.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/controls/datagrid/README.md
index a87a89e3d..7e3fc6d28 100644
--- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/controls/datagrid/README.md
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/controls/datagrid/README.md
@@ -209,9 +209,9 @@ public class Person
 :::
 
 :::info
-有关此控件的完整API文档，请参阅[这里](http://reference.avaloniaui.net/api/Avalonia.Controls/DataGrid/)。
+有关此控件的完整API文档，请参阅[这里](https://reference.avaloniaui.net/api/Avalonia.Controls/DataGrid/)。
 :::
 
 :::info
-在 _GitHub_ 上查看源代码 [`DataGrid.cs`](https://github.com/AvaloniaUI/Avalonia/blob/master/src/Avalonia.Controls.DataGrid/DataGrid.cs)
+在 _GitHub_ 上查看源代码 [`DataGrid.cs`](https://github.com/AvaloniaUI/Avalonia.Controls.DataGrid/blob/master/src/Avalonia.Controls.DataGrid/DataGridTemplateColumn.cs)
 :::
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/controls/datagrid/data-grid-template-columns.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/controls/datagrid/data-grid-template-columns.md
index ff6285eae..b16fb40fe 100644
--- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/controls/datagrid/data-grid-template-columns.md
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/controls/datagrid/data-grid-template-columns.md
@@ -102,7 +102,7 @@ public class Person
 ## 更多信息
 
 :::info
-有关此控件的完整 API 文档，请参见[此处](http://reference.avaloniaui.net/api/Avalonia.Controls/DataGridTemplateColumn/)。
+有关此控件的完整 API 文档，请参见[此处](https://reference.avaloniaui.net/api/Avalonia.Controls/DataGridTemplateColumn/)。
 :::
 
 :::info
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/controls/datagrid/datagridcolumns.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/controls/datagrid/datagridcolumns.md
index f77935406..6851345eb 100644
--- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/controls/datagrid/datagridcolumns.md
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/controls/datagrid/datagridcolumns.md
@@ -121,13 +121,13 @@ public class Person
 :::
 
 :::info
-有关数据表格复选框列的完整 API 文档，请参阅[此处](http://reference.avaloniaui.net/api/Avalonia.Controls/DataGridCheckBoxColumn/)。
+有关数据表格复选框列的完整 API 文档，请参阅[此处](https://reference.avaloniaui.net/api/Avalonia.Controls.DataGrid/DataGridCheckBoxColumn/)。
 :::
 
 :::info
-查看 _GitHub_ 上的源代码[`DataGridTextColumn.cs`](https://github.com/AvaloniaUI/Avalonia/blob/master/src/Avalonia.Controls.DataGrid/DataGridTextColumn.cs)。
+查看 _GitHub_ 上的源代码[`DataGridTextColumn.cs`](https://github.com/AvaloniaUI/Avalonia.Controls.DataGrid/blob/master/src/Avalonia.Controls.DataGrid/DataGridTextColumn.cs)。
 :::
 
 :::info
-查看 _GitHub_ 上的源代码[`DataGridCheckBoxColumn.cs`](https://github.com/AvaloniaUI/Avalonia/blob/master/src/Avalonia.Controls.DataGrid/DataGridCheckBoxColumn.cs)。
+查看 _GitHub_ 上的源代码[`DataGridCheckBoxColumn.cs`](https://github.com/AvaloniaUI/Avalonia.Controls.DataGrid/blob/master/src/Avalonia.Controls.DataGrid/DataGridCheckBoxColumn.cs)。
 :::
\ No newline at end of file

From 290bb47d8dbebc5fcfb4e0e38bbef0161bc74634 Mon Sep 17 00:00:00 2001
From: LoongArum <1@jindongjie.cn>
Date: Tue, 27 May 2025 11:50:39 +0800
Subject: [PATCH 5/7] Translate titles for cross-fade and page slide
 transitions to Chinese

---
 .../page-transitions/cross-fade-page-transition.md              | 2 +-
 .../page-transitions/page-slide-transition.md                   | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/graphics-and-animation/page-transitions/cross-fade-page-transition.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/graphics-and-animation/page-transitions/cross-fade-page-transition.md
index d6f971e9a..0448d9894 100644
--- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/graphics-and-animation/page-transitions/cross-fade-page-transition.md
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/graphics-and-animation/page-transitions/cross-fade-page-transition.md
@@ -1,6 +1,6 @@
 ---
 id: cross-fade-page-transition
-title: Cross Fade Page Transition
+title: 跨淡入淡出页面过渡
 ---
 
 import Tabs from '@theme/Tabs';
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/graphics-and-animation/page-transitions/page-slide-transition.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/graphics-and-animation/page-transitions/page-slide-transition.md
index bc5bac5b6..b4605e6f6 100644
--- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/graphics-and-animation/page-transitions/page-slide-transition.md
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/graphics-and-animation/page-transitions/page-slide-transition.md
@@ -1,6 +1,6 @@
 ---
 id: page-slide-transition
-title: Page Slide Transition
+title: 页面滑动过渡
 ---
 
 # 页面滑动过渡

From d390b54c4ac76933de6a74286eef202436be345f Mon Sep 17 00:00:00 2001
From: LoongArum <1@jindongjie.cn>
Date: Tue, 27 May 2025 13:58:37 +0800
Subject: [PATCH 6/7] Translate titles for multi-page apps and split view pane
 guides to Chinese

---
 .../how-to-implement-multi-page-apps.md                  | 2 +-
 .../how-to-show-and-hide-a-split-view-pane-with-mvvm.md  | 9 ++++-----
 2 files changed, 5 insertions(+), 6 deletions(-)

diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/development-guides/how-to-implement-multi-page-apps.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/development-guides/how-to-implement-multi-page-apps.md
index 3d7427eb1..2bc429cfc 100644
--- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/development-guides/how-to-implement-multi-page-apps.md
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/development-guides/how-to-implement-multi-page-apps.md
@@ -1,6 +1,6 @@
 ---
 id: how-to-implement-multi-page-apps
-title: How To Implement Multi-page Apps
+title: 如何实现多页面应用
 ---
 
 
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/development-guides/how-to-show-and-hide-a-split-view-pane-with-mvvm.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/development-guides/how-to-show-and-hide-a-split-view-pane-with-mvvm.md
index 68f9ff4d5..6aa68af67 100644
--- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/development-guides/how-to-show-and-hide-a-split-view-pane-with-mvvm.md
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/development-guides/how-to-show-and-hide-a-split-view-pane-with-mvvm.md
@@ -1,18 +1,17 @@
 ---
 id: how-to-show-and-hide-a-split-view-pane-with-mvvm
-title: How To Show and Hide a Split View Pane with MVVM
+title: 如何使用 MVVM 架构显示和隐藏分割视图面板
 ---
 
 import SplitViewExpanderScreenshot from '/img/reference/controls/splitview/splitview-expander.gif';
 
-准备中的内容。
+内容准备中。
 
-您可以使用MVVM模式与分割视图控件来实现“工具窗格”样式的用户界面。
+您可以结合 MVVM 架构与分割视图控件，实现类似“工具窗格”的用户界面。
 
 :::info
-这种技术使用复杂的**binding path**来定位父视图模型。
+此方法通过复杂的 **binding path** 来定位父视图模型。
 
 TO DO
 
 <img src={SplitViewExpanderScreenshot} alt=""/>
-

From 0e35f5d0811a6f0f643ffebbf3b4aa4a6e1485c0 Mon Sep 17 00:00:00 2001
From: ar0m <1@jindongjie.cn>
Date: Tue, 27 May 2025 14:30:32 +0800
Subject: [PATCH 7/7] Update
 how-to-show-and-hide-a-split-view-pane-with-mvvm.md

---
 .../how-to-show-and-hide-a-split-view-pane-with-mvvm.md         | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/development-guides/how-to-show-and-hide-a-split-view-pane-with-mvvm.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/development-guides/how-to-show-and-hide-a-split-view-pane-with-mvvm.md
index 6aa68af67..eff25799c 100644
--- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/development-guides/how-to-show-and-hide-a-split-view-pane-with-mvvm.md
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/development-guides/how-to-show-and-hide-a-split-view-pane-with-mvvm.md
@@ -11,7 +11,7 @@ import SplitViewExpanderScreenshot from '/img/reference/controls/splitview/split
 
 :::info
 此方法通过复杂的 **binding path** 来定位父视图模型。
-
+:::
 TO DO
 
 <img src={SplitViewExpanderScreenshot} alt=""/>