Merge pull request #235 from Weichenleeeee123/master

Update Chinese wiki docs

Author: miroiu

docs/localization/zh-CN/_Sidebar.md

@@ -39,6 +39,19 @@
 - [预备连接](连接概述#预备连接)
 
 [连接器概述](连接器概述)
+- [NodeInput 和 NodeOutput](连接器概述#NodeInput和NodeOutput)
+
+[剪切线概述](剪切线概述)
+
+- [启用预览](剪切线概述#启用预览)
+- [自定义连接](剪切线概述#自定义连接)
+- [自定义外观](剪切线概述#自定义外观)
+
+[小地图概述](小地图概述)
+
+- [移动视口](小地图概述#移动视口)
+- [缩放](小地图概述#缩放)
+- [自定义外观](小地图概述#自定义外观)
 
 [API 参考](API-Reference)
 

docs/localization/zh-CN/剪切线概述.md

@@ -0,0 +1,63 @@
+## 目录
+
+- [启用预览](#启用预览)
+- [自定义连接](#自定义连接)
+- [自定义外观](#自定义外观)
+
+`CuttingLine` 控件是一个自定义控件，用于移除与其相交的连接线。
+
+默认的剪切启动手势是 `SHIFT+ALT+左键单击` ，可以通过设置 `EditorGestures.Editor.Cutting` 手势进行配置。剪切操作可以通过按下 `Escape` 键或右键取消，右键的配置同样可以通过设置 `EditorGestures.Editor.CancelAction` 手势进行配置。
+
+在 `NodifyEditor` 中可用的相关命令有：:
+
+- CuttingStartedCommand
+- CuttingCompletedCommand
+- RemoveConnectionCommand - 当剪切操作完成时，对每个相交的连接线调用
+
+### 启用预览
+
+若希望连接线在与剪切线相交时改变样式，需要将 `NodifyEditor.EnableCuttingLinePreview` 设置为 `true`。
+
+> [!警告]
+> 根据连接线数量及其几何复杂度，此操作可能对性能造成较大影响。
+
+![cutting](https://github.com/user-attachments/assets/22f705c8-3bf1-466b-8bbd-da007f30deb2)
+
+## 自定义连接
+
+若希望剪切自定义连接线，需要将连接类型添加到 `NodifyEditor.CuttingConnectionTypes`:
+
+```csharp
+// 示例：将 Line 形状添加到可剪切的连接类型中
+NodifyEditor.CuttingConnectionTypes.Add(typeof(System.Windows.Shapes.Line));
+```
+
+可以如下自定义与剪切线相交的自定义连接线样式：
+
+```xml
+<Style TargetType="Line">
+    <Style.Triggers>
+        <Trigger Property="nodify:CuttingLine.IsOverElement" Value="True">
+            <Setter Property="Opacity"
+                    Value="0.4" />
+        </Trigger>
+    </Style.Triggers>
+</Style>
+```
+
+## 自定义外观
+
+可使用 `CuttingLineStyle` 自定义剪切线的样式：
+
+```xml
+<Style x:Key="CuttingLineStyle"
+       TargetType="{x:Type nodify:CuttingLine}"
+       BasedOn="{StaticResource {x:Type nodify:CuttingLine}}">
+    <Setter Property="StrokeDashArray"
+            Value="1 1" />
+    <Setter Property="StrokeThickness"
+            Value="2" />
+</Style>
+
+<nodify:NodifyEditor CuttingLineStyle="{StaticResource CuttingLineStyle}" ... />
+```

docs/localization/zh-CN/小地图概述.md

@@ -0,0 +1,79 @@
+## 目录
+
+- [目录](#目录)
+- [移动视口](#移动视口)
+- [缩放](#缩放)
+- [自定义外观](#自定义外观)
+
+`Minimap` 控件是一个自定义控件，旨在为 `NodifyEditor` 提供同步的缩略视图。
+它继承自 `ItemsControl`，通过 `ItemsSource` 属性显示项目。每个项目都包装在 `MinimapItem` 容器中，需在 `ItemContainerStyle` 中设置：
+
+
+> [!TIP]
+> 若希望在小地图中实时移动节点，需要将 `NodifyEditor.EnableDraggingContainersOptimizations` 设置为 `false`。
+
+此外，该控件还会显示一个表示编辑器可见区域的视口矩形，需要设置 `ViewportLocation` 和 `ViewportSize` 属性。
+
+```xml
+<nodify:Minimap
+    ItemsSource="{Binding ItemsSource, ElementName=Editor}"
+    ViewportLocation="{Binding ViewportLocation, ElementName=Editor}"
+    ViewportSize="{Binding ViewportSize, ElementName=Editor}"
+    Zoom="OnMinimapZoom">
+    <nodify:Minimap.ItemContainerStyle>
+        <Style TargetType="nodify:MinimapItem">
+            <Setter Property="Location" Value="{Binding MyItemLocation}" />
+        </Style>
+    </nodify:Minimap.ItemContainerStyle>
+</nodify:Minimap>
+```
+
+```csharp
+private void OnMinimapZoom(object sender, ZoomEventArgs e)
+{
+    Editor.ZoomAtPosition(e.Zoom, e.Location);
+}
+```
+
+> [!IMPORTANT]
+> `Width` 和 `Height` 应由父容器限制，或在 `Minimap` 上设置为常量值，以防止其根据内容大小改变。
+
+## 移动视口
+
+按住鼠标点击并拖动即可移动视口（平移）。若将 `IsReadOnly` 属性设置为 `true`，则无法移动。
+
+在平移过程中，`ViewportLocation` 会更新，因此需要进行双向绑定（默认即为双向绑定）。
+
+平移手势可通过设置 `EditorGestures.Mappings.Minimap.DragViewport` 为所需手势进行配置。
+
+## 缩放
+
+滚动鼠标滚轮即可进行缩放。若将 `IsReadOnly` 属性设置为 `true` 或未处理 `Zoom` 事件，则无法缩放。
+
+
+缩放时的修饰键可通过设置 `EditorGestures.Mappings.Minimap.ZoomModifierKey` 为所需值进行配置。
+
+## 自定义外观
+
+可使用 `ViewportStyle` 自定义视口矩形的样式，例如：
+
+```xml
+<Style x:Key="MyViewportStyle" TargetType="Rectangle">
+    <Setter Property="Fill" Value="Transparent"/>
+    <Setter Property="Stroke" Value="White"/>
+    <Setter Property="StrokeThickness" Value="3"/>
+</Style>
+
+<nodify:Minimap ViewportStyle="{StaticResource MyViewportStyle}" ... />
+```
+
+`MaxViewportOffset` 属性用于限制在 [移动视口](#移动视口) 时，视口可偏离项目的最大距离。
+
+`ResizeToViewport` 属性用于改变小地图的缩放行为。
+若设置为 `true`，则小地图会始终与项目一起缩放，以显示视口。
+
+![scale-with-viewport](https://github.com/user-attachments/assets/7a8887bf-f3f4-44d7-8311-6d9ba7869d78)
+
+如果设置为 `false`，则小地图仅显示项目，视口可以超出项目范围。
+
+![viewport-out-of-bounds](https://github.com/user-attachments/assets/5d3b388e-8e40-4bfe-af3b-4c12fb47548d)