diff --git a/zh-hans/extensions/version-mapping.md b/zh-hans/extensions/version-mapping.md new file mode 100644 index 0000000..a06f609 --- /dev/null +++ b/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 | \ No newline at end of file diff --git a/zh-hans/get-started/1.install.md b/zh-hans/get-started/1.install.md new file mode 100644 index 0000000..1644905 --- /dev/null +++ b/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 +``` diff --git a/zh-hans/get-started/2.create-project.md b/zh-hans/get-started/2.create-project.md new file mode 100644 index 0000000..eeedd77 --- /dev/null +++ b/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 只会在输出时使用这里指定的采样率,而在预览播放时不会使用。_ + +点击 __[新建]__ 即可创建项目。 + diff --git a/zh-hans/get-started/3.project-structure.md b/zh-hans/get-started/3.project-structure.md new file mode 100644 index 0000000..92f690a --- /dev/null +++ b/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 +} +``` diff --git a/zh-hans/get-started/4.add-element.md b/zh-hans/get-started/4.add-element.md new file mode 100644 index 0000000..8a91a4e --- /dev/null +++ b/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) diff --git a/zh-hans/get-started/5.edit-element.md b/zh-hans/get-started/5.edit-element.md new file mode 100644 index 0000000..fb3d0f0 --- /dev/null +++ b/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). +
+ +How to identify in the UI + +How to identify in the UI +
+ +## 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. diff --git a/zh-hans/get-started/README.md b/zh-hans/get-started/README.md new file mode 100644 index 0000000..81a86b6 --- /dev/null +++ b/zh-hans/get-started/README.md @@ -0,0 +1,6 @@ +--- +title: 开始 +type: auto +--- + +内容尚未完善! \ No newline at end of file diff --git a/zh-hans/get-started/_images/1.install/macos-gatekeeper.jpg b/zh-hans/get-started/_images/1.install/macos-gatekeeper.jpg new file mode 100644 index 0000000..9d79003 Binary files /dev/null and b/zh-hans/get-started/_images/1.install/macos-gatekeeper.jpg differ diff --git a/zh-hans/get-started/_images/2.create-project/menu.png b/zh-hans/get-started/_images/2.create-project/menu.png new file mode 100644 index 0000000..fc3978e Binary files /dev/null and b/zh-hans/get-started/_images/2.create-project/menu.png differ diff --git a/zh-hans/get-started/_images/2.create-project/name-location.png b/zh-hans/get-started/_images/2.create-project/name-location.png new file mode 100644 index 0000000..1be97c5 Binary files /dev/null and b/zh-hans/get-started/_images/2.create-project/name-location.png differ diff --git a/zh-hans/get-started/_images/2.create-project/options.png b/zh-hans/get-started/_images/2.create-project/options.png new file mode 100644 index 0000000..8e62b6d Binary files /dev/null and b/zh-hans/get-started/_images/2.create-project/options.png differ diff --git a/zh-hans/get-started/_images/2.create-project/start.png b/zh-hans/get-started/_images/2.create-project/start.png new file mode 100644 index 0000000..4716195 Binary files /dev/null and b/zh-hans/get-started/_images/2.create-project/start.png differ diff --git a/zh-hans/get-started/_images/4.add-element/file-drag-and-drop.mp4 b/zh-hans/get-started/_images/4.add-element/file-drag-and-drop.mp4 new file mode 100644 index 0000000..22212fb Binary files /dev/null and b/zh-hans/get-started/_images/4.add-element/file-drag-and-drop.mp4 differ diff --git a/zh-hans/get-started/_images/4.add-element/timeline-drag-and-drop.mp4 b/zh-hans/get-started/_images/4.add-element/timeline-drag-and-drop.mp4 new file mode 100644 index 0000000..b87c6e5 Binary files /dev/null and b/zh-hans/get-started/_images/4.add-element/timeline-drag-and-drop.mp4 differ diff --git a/zh-hans/get-started/_images/4.add-element/timeline-right-click.mp4 b/zh-hans/get-started/_images/4.add-element/timeline-right-click.mp4 new file mode 100644 index 0000000..cf50a68 Binary files /dev/null and b/zh-hans/get-started/_images/4.add-element/timeline-right-click.mp4 differ diff --git a/zh-hans/get-started/ffmpeg-install.md b/zh-hans/get-started/ffmpeg-install.md new file mode 100644 index 0000000..b8c77af --- /dev/null +++ b/zh-hans/get-started/ffmpeg-install.md @@ -0,0 +1,120 @@ +--- +title: 安装 FFmpeg +description: Beutl 需要 FFmpeg 来进行视频编解码,此文档将说明 FFmpeg 的安装方法 +--- + +在安装 FFmpeg 之前,您需要先确认 FFmpeg 的许可证。 +https://www.ffmpeg.org/legal.html + +## 手动安装 + +**由于 FFmpeg 可能会有更新的版本,下列教程中的文件名可能会有所不同。** + +### 64位 Windows +请从以下页面下载 `ffmpeg-n6.0-latest-win64-gpl-shared-6.0.zip`。 +https://github.com/BtbN/FFmpeg-Builds/releases + +解压下载的文件,将 `ffmpeg-n6.0-latest-win64-gpl-shared-6.0\bin\` 中的文件放置到以下的位置: + +``` +C:\Users\(你的用户名)\.beutl\ffmpeg +┣━ avcodec-60.dll +┣━ avdevice-60.dll +┣━ avfilter-9.dll +┣━ avformat-60.dll +┣━ avutil-58.dll +┣━ ffmpeg.exe +┣━ ffplay.exe +┣━ ffprobe.exe +┣━ postproc-57.dll +┣━ swresample-4.dll +┗━ swscale-7.dll +``` + +### 基于 Linux 的操作系统 +**通过包管理器安装的 FFmpeg 可能因版本差异而无法正常工作,所以可以按照与 Windows 相同的方法来手动安装。** + +请从以下页面下载 `ffmpeg-n6.0-latest-linux64-gpl-shared-6.0.tar.xz`。 +https://github.com/BtbN/FFmpeg-Builds/releases + +解压下载的文件,将 `bin/` 和 `lib/` 中的文件放置到以下的位置: + +``` +/home/(你的用户名)/.beutl/ffmpeg +┣━ ffmpeg +┣━ ffplay +┣━ ffprobe +┣━ libavcodec.so +┣━ libavcodec.so.60 +┣━ libavdevice.so +┣━ libavdevice.so.60 +┣━ libavfilter.so +┣━ libavfilter.so.9 +┣━ libavformat.so +┣━ libavformat.so.60 +┣━ libavutil.so +┣━ libavutil.so.58 +┣━ libpostproc.so +┣━ libpostproc.so.57 +┣━ libswresample.so +┣━ libswresample.so.4 +┣━ libswscale.so +┣━ libswscale.so.7 +┣━ libavcodec.so.60.x.xxx +┣━ libavdevice.so.60.x.xxx +┣━ libavfilter.so.9.x.xxx +┣━ libavformat.so.60.x.xxx +┣━ libavutil.so.58.x.xxx +┣━ libpostproc.so.57.x.xxx +┣━ libswresample.so.4.x.xxx +┗━ libswscale.so.7.x.xxx +``` + +注意:后缀为 `x.xxx` 的文件为符号链接。 + +### macOS + +> [!IMPORTANT] +> 此方法从版本 `1.0.0-preview.6` 开始可用。 + +> [!WARNING] +> 请不要使用 Rosetta 来转译运行。 + +首先需要在终端(使用聚焦搜索 “Terminal” 或者 “终端” 并打开)执行下列命令来安装 Homebrew: +```sh +/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" +``` + +然后执行以下命令来安装 FFmpeg: +```sh +brew install ffmpeg@6 +``` + +## 使用 [FFmpeg 配置工具](https://beutl.beditor.net/store/packages/Beutl.Extensions.FFmpegLocator) + +从版本 `1.0.0-preview4` 开始,可以使用 [FFmpeg 配置工具](https://beutl.beditor.net/store/packages/Beutl.Extensions.FFmpegLocator) 来自动安装 FFmpeg。 + +> [!TIP] +> 执行此方法需要 Beutl 账户。 + +1. 在菜单中打开扩展功能页面。 +2. 在左上角的搜索框中输入 `"Beutl.Extensions.FFmpegLocator"` 并按回车。 +3. 点击 __"FFmpeg 配置工具"__。 +4. 点击安装。 +5. 关闭 Beutl。 +6. 安装对话框将显示,请按照指示继续。 +7. 打开 Beutl。 +8. 从侧边栏打开 __"FFmpeg 配置工具"__。 +9. 点击 __安装__,FFmpeg 的安装将开始。 +10. 安装完成后,重新启动 Beutl 完成配置。 + +> [!TIP] +> 完成此操作后,您可以选择卸载 __"FFmpeg 配置工具"__。 + +## 故障排除 + +### FFmpeg 版本问题 +如果安装后仍显示 __"请确认 FFmpeg 已安装。"__,可能是 FFmpeg 版本错误。 +请从 [版本对照表](../extensions/version-mapping.md) 中确认正确版本。 + +如果您在使用 FFmpeg 配置工具的情况下仍收到该消息,请 [在此处](https://github.com/b-editor/Beutl.Extensions.FFmpegLocator/issues) 反馈。