Merge pull request #900 from misitebao/synchronize-chinese-documents

docs: synchronize chinese documents

website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/about.md

@@ -10,7 +10,7 @@ sidebar_position: 1
 
 Wails 是一个可让您使用 Go 和 Web 技术编写桌面应用的项目。
 
-将它看作为轻量快速的 “Electron for Go”。 您可以使用 Go 的灵活性和强大功能，结合丰富的现代前端，轻松的构建应用程序。
+将它看作为 Go 的轻量级和快速的 Electron 替代品。 您可以使用 Go 的灵活性和强大功能，结合丰富的现代前端，轻松的构建应用程序。
 
 Wails 一点也不弱！这是 [xbar](https://xbarapp.com) - 一个使用 Wails 编写的 MacOS 桌面应用。它使用 Mac 的系统原生菜单，支持浅色和深色桌面主题，主窗口使用半透明，使其具有原生应用的
 “冰霜” 效果。
@@ -31,13 +31,13 @@ Wails 自动使您的 Go 方法可用于 Javascript，因此您可以从前端
 
 ## 运行时库
 
-Wails 为 Go 和 Javascript 提供了一个运行时库，可以处理现代应用程序需要的很多东西，比如事件、日志记录、对话框等。
+Wails 为 Go 和 Javascript 提供了一个运行时库，可以处理现代应用程序需要的很多东西，比如事件、日志、对话框等。
 
 ## 实时开发体验
 
 ### 自动重新构建
 
-当您在“dev”模式下运行您的应用程序时，Wails 会将您的应用程序构建为原生桌面应用程序，但会从磁盘读取您的资源。它将检测您的 Go 代码的任何更改，并自动重新构建和重新启动您的应用程序。
+当您在“dev“模式下运行您的应用程序时，Wails 会将您的应用程序构建为原生桌面应用程序，但会从磁盘读取您的资源。它将检测您的 Go 代码的任何更改，并自动重新构建和重新启动您的应用程序。
 
 ### 自动重新加载
 
@@ -47,7 +47,7 @@ Wails 为 Go 和 Javascript 提供了一个运行时库，可以处理现代应
 
 如果您更喜欢在浏览器中调试和开发，那么 Wails 可以满足您的需求。正在运行的应用程序还有一个网络服务器，它将在连接到它的任何浏览器中运行您的应用程序。当您的资源在磁盘上发生变化时，它会刷新。
 
-## 生成原生二进制文件
+## 可用于生产的原生二进制文件
 
 当您准备好完成应用程序的最终构建时，CLI 会将其编译为单个可执行文件，并将所有资源打包到其中。在 Windows 和 MacOS
 上，可以创建用于分发的原生包。使用打包工具后生成的资源（图标、info.plist、清单文件等）是您项目的一部分，可以自定义，让您完全控制应用程序的构建方式。

website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/community/links.mdx

@@ -11,7 +11,7 @@ sidebar_position: 2
 - [Gophers Slack Channel](https://gophers.slack.com/messages/CJ4P9F7MZ/)
 - [Gophers Slack Channel Invite](https://invite.slack.golangbridge.org/)
 - [Github Issues](https://github.com/wailsapp/wails/issues)
-- [v2 Beta Discussion Board](https://github.com/wailsapp/wails/discussions/828)
+- [v2 测试版讨论板](https://github.com/wailsapp/wails/discussions/828)
 
 ## 社交媒体
 

website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/community/templates.mdx

@@ -23,3 +23,7 @@ sidebar_position: 1
 - [wails-template-vue](https://github.com/misitebao/wails-template-vue) - 基于 Vue 和 Vue-Router 的 Wails 模板
 - [wails-vite-vue-ts](https://github.com/codydbentley/wails-vite-vue-ts) - 使用 Vite 的 Vue 3 TypeScript(以及添加功能的说明)
 - [wails-vite-vue-the-works](https://github.com/codydbentley/wails-vite-vue-the-works) - 使用 Vite, Vuex, Vue Router, Sass, 和 ESLint + Prettier 的 Vue 3 TypeScript
+
+## Angular
+
+- [wails-angular-template](https://github.com/TAINCER/wails-angular-template) - 带有 TypeScript, Sass, 热重载, 代码拆分和 i18n 的 Angular

website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/credits.mdx

@@ -20,6 +20,9 @@ sidebar_position: 99
 <a href="https://github.com/snider" style="width:100px;">
   <img src="https://github.com/snider.png?size=100" width="100"/>
 </a>
+<a href="https://github.com/codydbentley" style="width:100px">
+  <img src="https://github.com/codydbentley.png?size=100" width="100"/>
+</a>
 <br/>
 <br/>
 <a href="https://github.com/matryer" style="width:100px">
@@ -58,15 +61,27 @@ sidebar_position: 99
 <a href="https://github.com/jugglingjsons" style="width:50px">
   <img src="https://github.com/jugglingjsons.png?size=50" width="50"/>
 </a>
-<a href="https://github.com/marcus-crane" style="width:50px">
-  <img src="https://github.com/marcus-crane.png?size=50" width="50"/>
-</a>
-<a href="https://github.com/codydbentley" style="width:65px">
-  <img src="https://github.com/codydbentley.png?size=65" width="65"/>
+<a href="https://github.com/marcus-crane" style="width:65px">
+  <img src="https://github.com/marcus-crane.png?size=65" width="65"/>
 </a>
 <a href="https://github.com/bbergshaven" style="width:45px">
   <img src="https://github.com/bbergshaven.png?size=45" width="45"/>
 </a>
+<a href="https://github.com/Gilgames000" style="width:45px">
+  <img src="https://github.com/Gilgames000.png?size=45" width="45"/>
+</a>
+<a href="https://github.com/ilgityildirim" style="width:50px">
+  <img src="https://github.com/ilgityildirim.png?size=50" width="50"/>
+</a>
+<a href="https://github.com/ondoki" style="width:65px">
+  <img src="https://github.com/ondoki.png?size=65" width="65"/>
+</a>
+<a href="https://github.com/questrail" style="width:50px">
+  <img src="https://github.com/questrail.png?size=50" width="50"/>
+</a>
+<a href="https://github.com/DonTomato" style="width:45px">
+  <img src="https://github.com/DonTomato.png?size=45" width="45"/>
+</a>
 `,
   }}
 />

website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/gettingstarted/firstproject.mdx

@@ -46,6 +46,6 @@ Wails 项目具有以下布局：
 
 `frontend`目录没有特定于 Wails 的内容，可以是您选择的任何前端项目。
 
-`build`目录在构建过程中使用。这些文件可以更新以自定义您的构建。如果文件从构建目录中删除，将重新生成默认版本。
+`build`目录在构建过程中使用。这些文件可以修改以自定义您的构建。如果文件从构建目录中删除，将重新生成默认版本。
 
 `go.mod`中的默认模块名称是“changeme”。您应该将其更改为更合适的内容。

website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/gettingstarted/installation.mdx

@@ -30,7 +30,7 @@ Wails 有许多安装前需要的常见依赖项：
 
 从[Node 下载页面](https://nodejs.org/en/download/)下载 Npm。最好使用最新版本，因为这是我们通常会测试的版本。
 
-运行 `npm --version` 进行校验。
+运行 `npm --version` 进行验证。
 
 ## 平台指定依赖关系
 

website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/application-development.mdx

@@ -146,3 +146,15 @@ Wails v2 处理资源的方式的伟大之处在于它没有！您唯一需要
 第一个，如果有给定，将在`frontend`目录中执行以安装 node 模块。第二个，如果有给定，将在`frontend`目录中执行以构建前端项目。
 
 如果没有给出这两个字段，那么 Wails 不会对前端做任何操作。它仅仅被用作`embed.FS`。
+
+## 内置开发服务器
+
+TODO: 待同步
+
+## 外部开发服务器
+
+TODO: 待同步
+
+## Go 模块
+
+默认的 Wails 模板会生成一个包含模块名称“changeme”的`go.mod`文件。您应该在项目生成后将其更改为更合适的内容。

website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/overscroll.mdx

@@ -0,0 +1,9 @@
+# 滚动超出
+
+[Overscroll](https://developer.mozilla.org/zh-CN/docs/Web/CSS/overscroll-behavior) 是当您滚动超出页面内容边界时有时会获得的“弹跳效果”。这在移动应用程序中很常见。这可以使用 CSS 禁用：
+
+```css
+body {
+  overscroll-behavior: none;
+}
+```

website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/howdoesitwork.mdx

@@ -17,7 +17,7 @@ Wails 应用程序是一个带有一个 webkit 前端的标准的 Go 应用程
 
 ### 概述
 
-主应用程序由对`wails.Run()`的调用组成. 它接受描述应用程序窗口大小、窗口标题、要使用的资源等的应用程序配置。基本应用程序可能如下所示：
+主应用程序由对`wails.Run()`的调用组成. 它接受描述应用程序窗口大小、窗口标题、要使用的资源等应用程序配置。基本应用程序可能如下所示：
 
 ```go title="main.go"
 package main
@@ -85,7 +85,7 @@ func (b *App) Greet(name string) string {
 #### 资源
 
 `Assets` 选项是必须的，因为您不能拥有没有前端资源的 Wails 应用程序。这些资源可以是您希望在 Web 应用程序中找到的任何文件 - html、js、css、svg、png 等。
-**不需要生成资源包**- 纯文件即可。当应用程序启动时，它将尝试从您的资源中加载`index.html`，并且那时起前端基本上将作为浏览器工作。值得注意的是 embed.FS，
+**不需要生成资源包**- 纯文件即可。当应用程序启动时，它将尝试从您的资源中加载`index.html`，并且那时起前端基本上将作为浏览器工作。值得注意的是`embed.FS`，
 文件所在的位置没有要求。嵌入路径很可能使用了相对于您的主应用程序代码的嵌套目录，例如 `frontend/dist`：
 
 ```go title="main.go"
@@ -95,10 +95,10 @@ var assets embed.FS
 
 启动时，Wails 将遍历嵌入的文件，寻找包含的`index.html`. 所有其他资源将相对于该目录加载。
 
-由于生产二进制文件使用中包含在`embed.FS`的文件，因此应用程序不需要附带任何外部文件。
+由于可用于生产的二进制文件使用包含在`embed.FS`中的文件，因此应用程序不需要附带任何外部文件。
 
 当使用`wails dev`命令在”dev“模式下，资源从磁盘加载，任何更改都会导致“实时重新加载”。资源的位置需要使用`-assetdir`传递给`wails dev`命令，并且很可能与嵌入路径相同。
-希望`embed.FS`将来我们可以从它本身计算出来。更多细节可以在[应用程序开发指南](/docs/guides/application-development)中找到。
+希望将来我们可以从`embed.FS`本身计算出来。更多细节可以在[应用程序开发指南](/docs/guides/application-development)中找到。
 
 #### 应用程序生命周期回调
 

website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/cli.mdx

@@ -14,13 +14,13 @@ Wails CLI 有许多用于管理项目的命令。所有命令都以此方式运
 `wails init` 用于生成项目。
 
 | 标志               | 描述                                                                                | 默认    |
-| :----------------- | :------------------------------------------------------------------ | :------ |
+| :----------------- | :---------------------------------------------------------------------------------- | :------ |
 | -n "project name"  | 项目名. **强制必填**.                                                               |         |
 | -d "project dir"   | 要创建的项目目录                                                                    | 项目名  |
 | -g                 | 初始化 git 存储库                                                                   |         |
 | -l                 | 可用项目模板列表                                                                    |         |
 | -q                 | 禁止输出到控制台                                                                    |         |
-| -t "template name" | 要使用的项目模板。这可能是在 github 上托管的远程模板的 URL 的名称。 | vanilla |
+| -t "template name" | 要使用的项目模板。这可能是默认模板的名称或在 github 上托管的远程模板的 URL 的名称。 | vanilla |
 | -ide               | 生成 IDE 项目文件                                                                   |         |
 | -f                 | 强制构建应用                                                                        | false   |
 
@@ -29,9 +29,11 @@ Wails CLI 有许多用于管理项目的命令。所有命令都以此方式运
 
 这将在 "mytestproject" 目录生成一个名为 "test" 的项目，初始化 git，生成 vscode 项目文件并静默执行。
 
+可以在[此处](/docs/guides/ides)找到有关在 Wails 中使用 IDE 的更多信息。
+
 ### 远程模板
 
-支持远程模板（托管在 GitHub 上）并且可以使用模板的项目 URL 进行安装。
+支持远程模板（托管在 GitHub 上）并且可以使用模板项目的 URL 进行安装。
 
 示例： `wails init -n test -t https://github.com/leaanthony/testtemplate`
 
@@ -66,6 +68,10 @@ Wails CLI 有许多用于管理项目的命令。所有命令都以此方式运
 
 如果您更喜欢使用标准 Go 工具进行构建，请参阅[手动构建](/docs/guides/manual-builds)指南。
 
+示例：
+
+`wails build -clean -o myproject.exe`
+
 ## 诊断检查
 
 `wails doctor` 将运行诊断程序以确保您的系统已准备好进行开发。
@@ -111,23 +117,25 @@ Your system is ready for Wails development!
 - 所有应用程序资源都从磁盘加载。如果它们被更改，应用程序将自动重新加载（而不是重新构建）。所有连接的浏览器也将重新加载
 - 生成的 JS 模块提供以下内容：
   - 带有自动生成的 JSDoc 的 Go 方法的 Javascript 包装器，提供代码提示
-  - 的 Go 结构体的 TypeScript 版本，可以构造并传递给您的后端方法
+  - 您的 Go 结构体的 TypeScript 版本，可以构造并传递给您的 Go 方法
 - 生成第二个 JS 模块，为运行时提供包装器 + TS 声明
 
 | 标志                         | 描述                                                  | 默认                     |
-| :--------------------------- | :---------------------------------------------------- | :-------------------------- |
-| -assetdir "./path/to/assets" | 编译资源的路径                                        | Value in `wails.json`       |
-| -browser                     | `http://localhost:34115`在启动时打开浏览器            |                             |
+| :--------------------------- | :---------------------------------------------------- | :----------------------- |
+| -assetdir "./path/to/assets" | 编译资源的路径                                        | `wails.json`中的值       |
+| -browser                     | 在启动时打开浏览器到`http://localhost:34115`          |                          |
 | -compiler "compiler"         | 使用不同的 go 编译器来构建，例如 go1.15beta1          | go                       |
-| -e                           | 触发重建的扩展（逗号分隔）                            | go                          |
+| -e                           | 触发重新构建的扩展（逗号分隔）                        | go                       |
 | -ldflags "flags"             | 传递给编译器的额外 ldflags                            |                          |
 | -tags "extra tags"           | 构建标签以传递给编译器（引号和空格分隔）              |                          |
 | -loglevel "loglevel"         | 要使用的日志级别 - Trace, Debug, Info, Warning, Error | Debug                    |
 | -noreload                    | 资源更改时禁用自动重新加载                            |                          |
 | -v                           | 详细级别 (0 - silent, 1 - standard, 2 - verbose)      | 1                        |
-| -wailsjsdir                  | 生成生成的 Wails JS 模块的目录                        | Value store in `wails.json` |
+| -wailsjsdir                  | 生成生成的 Wails JS 模块的目录                        | `wails.json`中的值       |
+| -debounce                    | 检测到资源更改后等待重新加载的时间                    | 100 (毫秒)               |
+| -devserverurl "url"          | 使用第 3 方开发服务器 url, 例如 Vite                  | "http://localhost:34115" |
 
-如果在命令行上提供了`-assetdir`或`-wailsjsdir`标志，它们将保存在`wails.json`中，并成为后续调用的默认值。
+如果在命令行上提供了`-assetdir`，`-wailsjsdir`，`debounce`或`devserverurl`标志，它们将保存在`wails.json`中，并成为后续调用的默认值。
 
 示例：
 
@@ -136,10 +144,12 @@ Your system is ready for Wails development!
 此命令将执行以下操作：
 
 - 构建应用程序并运行它（更多细节在[这里](/docs/guides/manual-builds)）
-- 生成 Wails JS 模块 ``./frontend/src`
-- 注意文件的更新`./frontend/dist`并在任何更改时重新加载
+- 在`./frontend/src`中生成 Wails JS 模块
+- 监听`./frontend/dist`中文件的更新并在更改时重新加载
 - 打开浏览器并连接到应用程序
 
+[此处](/docs/guides/application-development)提供了有关将此功能与现有框架脚本一起使用的更多信息。
+
 ## 生成
 
 ### 模板

website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/options.mdx

@@ -155,6 +155,14 @@ func main() {
 
 该值是默认设置窗口的 RGBA 值。默认值：0xFFFFFFFF。
 
+### 窗口固定在最顶层
+
+名称：AlwaysOnTop
+
+类型：bool
+
+窗口在失去焦点时应保持在其他窗口之上。
+
 ### 资源
 
 名称：Assets
@@ -219,7 +227,7 @@ func main() {
 
 定义需要绑定到前端的方法的一部分结构实例。
 
-### 窗口
+### Windows
 
 名称：Windows
 

website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/project-config.mdx

@@ -11,13 +11,16 @@ sidebar_position: 5
   "name": "[项目名称]",
   "assetdir": "[资源目录的相对路径]",
   "frontend:install": "[安装node依赖的命令，在frontend目录下运行 - 通常是 `npm install`]",
+  "frontend:dev": "[此命令在“Wails dev”上的单独进程中运行。适用于第三方观察者]",
   "frontend:build": "[构建资源的命令，在frontend目录下运行 - 通常是 `npm run build`]",
   "wailsjsdir": "[自动生成的JS模块将被创建的目录的相对路径]",
   "version": "[项目配置版本]",
-  "outputfilename": "[二进制文件的名称]"
+  "outputfilename": "[二进制文件的名称]",
+  "debounceMS": 100, // 在检测到资源更改时，开发服务器等待重新加载的时间
+  "devserverurl": "[用于服务本地资源的开发服务器URL。默认：http://localhost:34115]"
 }
 ```
 
 该文件将在运行`wails build`或`wails dev`时，由 Wails CLI 读取。
 
-`wails build/dev`命令中的`assetdir`和`wailsjsdir`标志将覆盖项目配置并作为后续运行的默认值。
+`wails build/dev`命令中的`assetdir`,`wailsjsdir`,`debounceMS`和`devserverurl`标志将覆盖项目配置并作为后续运行的默认值。

website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/runtime/dialog.mdx

@@ -5,6 +5,8 @@ sidebar_position: 5
 
 # 对话框
 
+TODO: 待同步
+
 ## 概述
 
 运行时的这一部分提供对原生对话框的调用，例如文件选择器和消息框。上下文