a WIP translation of zh-hans

zh-hans/extensions/version-mapping.md

@@ -0,0 +1,15 @@
+---
+title: 版本对照表
+description: 列举了 Beutl 各个版本对应的工具、运行库的版本。
+---
+
+下方列举了 Beutl 各个版本对应的工具、运行库的版本。  
+
+| Beutl           | .NET | [Avalonia](https://github.com/AvaloniaUI/Avalonia) | FFmpeg |
+| --------------- | ---- | -------------------------------------------------- | ------ |
+| 1.0.0-preview.6 | 8.0  | 11.0.10                                            | 6.0    |
+| 1.0.0-preview.5 | 8.0  | 11.0.9                                             | 6.0    |
+| 1.0.0-preview.4 | 8.0  | 11.0.5                                             | 6.0    |
+| 1.0.0-preview.3 | 7.0  | 11.0.4                                             | 6.0    |
+| 1.0.0-preview.2 | 7.0  | 11.0.4                                             | 6.0    |
+| 1.0.0-preview.1 | 7.0  | 11.0.4                                             | 6.0    |

zh-hans/get-started/1.install.md

@@ -0,0 +1,62 @@
+---
+title: 安装
+description: 说明 Beutl 的安装方法
+---
+
+这篇文章将以版本为 `{version}` 的 Beutl 为例，说明 Beutl 的安装方法。  
+
+## 安装前的准备
+请先安装 [.NET 8 运行时](https://dotnet.microsoft.com/zh-cn/download/dotnet/8.0)。  
+
+> [!TIP]  
+> 请根据要安装的 Beutl 版本确定 .NET 的版本。  
+> [版本对照表](../extensions/version-mapping.md)  
+
+## 安装 Windows 版本
+
+### 使用安装程序
+1. 下载并运行 `beutl-setup.exe`。  
+2. 按照屏幕上的指示进行安装。  
+3. 请参考 [安装 FFmpeg](./ffmpeg-install.md) 中的方法，安装 FFmpeg。  
+4. 运行 `Beutl.exe`。  
+
+### 手动安装
+1. 下载并解压 `beutl-win-x64-{version}.zip`。  
+2. 请参考 [安装 FFmpeg](./ffmpeg-install.md) 中的方法，安装 FFmpeg。  
+3. 运行 `Beutl.exe`。  
+
+## 为 Ubuntu 22.04 安装
+
+### 从 Debian 包安装
+
+> [!TIP]  
+> 此方法仅从 `1.0.0-preview.5` 开始可用。  
+
+1. 下载 `beutl_1.0.0-285ubuntu22.04_amd64.deb`。  
+2. 执行以下命令：
+```sh
+sudo apt update
+sudo apt install ./beutl_1.0.0-285ubuntu22.04_amd64.deb
+```
+3. 安装完成。
+
+### 手动安装
+1. 下载并解压 `beutl-linux-x64-{version}.zip`。  
+2. 请参考 [安装 FFmpeg](./ffmpeg-install.md) 中的方法，安装 FFmpeg。  
+3. 使用 `chmod` 使 `Beutl`, `Beutl.ExceptionHandler`, `Beutl.PackageTools`, `Beutl.WaitingDialog` 可执行。  
+4. 启动 `Beutl`。  
+
+> [!IMPORTANT]  
+> 如果要安装 `1.0.0-preview.5` 以下的版本，请参考 [这里](https://github.com/shimat/opencvsharp#ubuntu) 的方法来构建 `libOpenCvSharpExtern`。  
+
+## 安装 macOS 版本
+
+下载并解压 `Beutl.osx_arm64.app.zip` 或 `Beutl.osx_x64.app.zip`。  
+您应该会看到如下警告：  
+![](./_images/1.install/macos-gatekeeper.jpg)
+
+因为 Beutl 没有进行数字签名，所以会出现这个警告。  
+需要执行以下命令来绕过数字签名：
+```sh
+xattr -rc Beutl.app
+```

zh-hans/get-started/2.create-project.md

@@ -0,0 +1,22 @@
+---
+title: 创建新的项目
+description: Beutlでのプロジェクトの作成方法と生成されるファイルについてを説明します
+---
+
+在窗口菜单中选择 __文件 > 新建 > 项目__，或者点击  
+![从菜单中新建项目](_images/2.create-project/menu.png)
+
+在启动屏幕中点击 __新建 > 新建项目__。  
+![从启动屏幕中新建项目](_images/2.create-project/start.png)
+
+为新建的项目命名，并确定项目的保存位置。  
+![项目名称和位置](_images/2.create-project/name-location.png)
+
+点击 __[下一步]__。
+
+指定帧率、采样率、初始场景的分辨率。  
+![设置](_images/2.create-project/options.png)  
+_注意：Beutl 只会在输出时使用这里指定的采样率，而在预览播放时不会使用。_
+
+点击 __[新建]__ 即可创建项目。
+

zh-hans/get-started/3.project-structure.md

@@ -0,0 +1,93 @@
+---
+title: 项目的结构
+description: 说明 Beutl 项目的文件结构
+---
+
+译者注：这一篇文章的内容较为高级，主要面向于开发者。如果您不是开发者，应该可以忽略这部分内容。  
+
+这一篇章主要说明 Beutl 项目的文件结构。  
+Beutl 中的文件都使用 JSON 格式进存储，因此您可以使用文本编辑器来编辑这些文件。  
+
+例如，当您创建了名为 `MyProject` 的项目，Beutl 会生成下列的目录结构：
+```
+MyProject
+┣━ MyProject.bproj
+┗━ MyProject
+    ┗━ MyProject.scene
+```
+
+## `MyProject.bproj` 文件
+这个文件存储了项目包含的场景、Beutl的版本和一些参数（例如帧率和采样率这些）。  
+例如：
+```json
+{
+  "appVersion": "1.0.0",
+  "minAppVersion": "1.0.0",
+  "items": [
+    "MyProject/MyProject.scene"
+  ],
+  "variables": {
+    "framerate": "30",
+    "samplerate": "44100"
+  }
+}
+```
+
+## `MyProject.scene` 文件
+这个文件存储了场景的分辨率、时长、编辑器中的时间和场景中的元素。  
+例如:
+```json
+{
+  "Id": "{unique object Id}",
+  "Name": "MyProject",
+  "Width": 1920,
+  "Height": 1080,
+  "Duration": "00:16:32",
+  "CurrentFrame": "00:00:00",
+  "Elements": {
+      "Include": "**/*.belm"
+  }
+}
+```
+
+----
+随着这个软件的使用, 会生成如 `.beutl` 和 `*.belm` 的文件或目录.
+
+## `.beutl` 目录
+这个目录存储了编辑器中的 UI 布局等，如果 UI 布局乱了，删除这个目录也许能使其恢复原状。  
+
+
+## `*.belm` 文件
+这个文件存储了场景中元素的信息，如开始时间、长度、层数和内容等。  
+
+例如:
+```json
+{
+  "Id": "{unique object Id}",
+  "Name": "Rectangle",
+  "Start": "00:00:00",
+  "Length": "00:05:00",
+  "ZIndex": 0,
+  "AccentColor": "#FF008080",
+  "IsEnabled": true,
+  "Operation": {
+    "Id": "{unique object Id}",
+    "Name": "",
+    "Children": [
+      {
+        "Id": "{unique object Id}",
+        "Name": " ",
+        "Properties": [
+        ],
+        "$type": "[Beutl.Operators].Source:RectOperator"
+      }
+    ]
+  },
+  "NodeTree": {
+    "Id": "{unique object Id}",
+    "Name": "",
+    "Nodes": [ ]
+  },
+  "UseNode": false
+}
+```

zh-hans/get-started/4.add-element.md

@@ -0,0 +1,24 @@
+---
+title: 添加元素
+description: 解释如何添加如视频、图像或文本这些元素到场景中
+---
+
+下列列出了几种添加元素的方法。
+
+## 法一
+- 直接从库中拖拽元素到你想放置的地方。
+
+![](_images/4.add-element/timeline-drag-and-drop.mp4)
+
+## 法二
+- 在时间线上右键你想放置元素的地方。
+- 点击 __添加元素__。
+
+![](_images/4.add-element/timeline-right-click.mp4)
+
+这个方法会创建一个空元素，所以你需要从库中把素材拖放到其中或者修改其属性。
+
+## 法三
+- 直接将视频、图像等素材拖拽到时间线上.
+
+![](_images/4.add-element/file-drag-and-drop.mp4)

zh-hans/get-started/5.edit-element.md

@@ -0,0 +1,56 @@
+---
+title: 编辑元素
+description: 解释如何修改一个元素或者进行更多的操作
+---
+
+*WIP*
+
+这篇文章将会解释如何修改一个元素或者对其进行更多的操作。  
+
+## 基础概念
+
+This page uses terms such as __Source Operations__ and __Drawing Objects__. For more details, please refer to [this document](../advanced/1.rendering-process.md).
+<details>
+<summary>
+How to identify in the UI
+</summary>
+<img alt="How to identify in the UI" src="https://raw.githubusercontent.com/b-editor/beutl-docs/main/ja/get-started/_images/5.edit-element/ui.webp"></img>
+</details>
+
+## Adding Effects
+First, select the element you want to add an effect to on the timeline. The properties of the selected element will be displayed in the __Source Operations__ tab on the right side.
+
+To add an effect directly to a drawing object, click the `+` button in __Filter Effects__ and choose the effect you want to add.  
+![](_images/5.edit-element/add-effect-in-property-editor.mp4)
+
+Alternatively, you can drag and drop the effect you want to add from the library to __Filter Effects__.  
+![](_images/5.edit-element/add-effect-via-library.mp4)
+
+Dragging and dropping elsewhere will add the effect as a source operation.  
+![](_images/5.edit-element/add-effect-as-source-operator.mp4)
+
+## Transformations
+Using transformations, you can express movement, rotation, scaling, distortion, and more.
+
+To set a transformation directly on a drawing object, click the `+` button in __Transform__ and choose the type of transformation you want to add.
+
+For the move transformation only, you can move it with the mouse from the preview screen. However, move transformations added as effects (or source operations) cannot be moved with the mouse.
+
+![](_images/5.edit-element/add-transform.mp4)
+
+## Editing Element Timing
+You can edit the start time and duration of elements by dragging them with the mouse on the timeline.
+
+To simplify editing in Beutl, elements will snap to the timing of other layers during dragging. To temporarily disable this feature, hold down the `Alt` key while dragging. This feature __cannot be permanently disabled__ in the settings.
+
+![](_images/5.edit-element/move-element.mp4)
+
+## Splitting Elements
+You can split elements by right-clicking the element you want to split on the timeline and clicking the split button in the menu. You can also use the `Ctrl + K` shortcut to split the selected element at the current frame.
+
+![Splitting Elements](_images/5.edit-element/split-element.webp)
+
+## Making Elements Easier to Identify
+In Beutl, you can change the color and name of elements. These can be changed from the right-click menu.
+
+You can change the name by pressing the `F2` key or double-clicking the element.

zh-hans/get-started/README.md

@@ -0,0 +1,6 @@
+---
+title: 开始
+type: auto
+---
+
+内容尚未完善！