From cdfd70d3f74a911cbb5d999325570c6cc1b9f94a Mon Sep 17 00:00:00 2001 From: Misitebao Date: Fri, 4 Mar 2022 14:59:46 +0800 Subject: [PATCH] docs: improve and synchronize chinese documents (#1205) --- .../2021-09-27-v2-beta1-release-notes.mdx | 6 +++--- .../2021-11-08-v2-beta2-release-notes.mdx | 6 +++--- .../2022-02-22-v2-beta3-release-notes.mdx | 6 +++--- .../current/guides/troubleshooting.mdx | 14 ++++++++++++++ .../current/reference/project-config.mdx | 18 ++++++++++++++++-- .../current/reference/runtime/events.mdx | 4 ++-- 6 files changed, 41 insertions(+), 13 deletions(-) create mode 100644 website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/troubleshooting.mdx diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-blog/2021-09-27-v2-beta1-release-notes.mdx b/website/i18n/zh-Hans/docusaurus-plugin-content-blog/2021-09-27-v2-beta1-release-notes.mdx index 5997be0be..a3ee95776 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-blog/2021-09-27-v2-beta1-release-notes.mdx +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-blog/2021-09-27-v2-beta1-release-notes.mdx @@ -104,7 +104,7 @@ v1 的一个巨大痛点是需要将整个应用程序压缩为单个 JS 和 CSS > 那么我如何包含我的资源？ -您只需将`embed.FS`包含所有资产的单个文件传递到您的应用程序配置中。他们甚至不需要在顶级目录中——Wails 会为你解决这个问题。 +您只需将`embed.FS`包含所有资源的单个文件传递到您的应用程序配置中。他们甚至不需要在顶级目录中——Wails 会为你解决这个问题。 ### 全新的开发体验 @@ -124,10 +124,10 @@ v1 的一个巨大痛点是需要将整个应用程序压缩为单个 JS 和 CSS 它还提供了附加功能： -- 热重载 - 对前端资产的任何更改都将触发并自动重载应用程序前端 +- 热重载 - 对前端资源的任何更改都将触发并自动重载应用程序前端 - 自动重新构建 - 对 Go 代码的任何更改都将重新构建并重新启动您的应用程序 -除此之外，网络服务器将在端口 34115 上启动。这将为您的应用程序提供连接到它的任何浏览器。所有连接的 Web 浏览器都会响应系统事件，例如资产更改时的热重载。 +除此之外，网络服务器将在端口 34115 上启动。这将为您的应用程序提供连接到它的任何浏览器。所有连接的 Web 浏览器都会响应系统事件，例如资源更改时的热重载。 在 Go 中，我们习惯于在应用程序中处理结构。将结构发送到我们的前端并将它们用作我们应用程序中的状态通常很有用。在 v1 中，这是一个非常需要手动的过程，对开发人员来说有点负担。 我很高兴地宣布，在 v2 中，任何在开发模式下运行的应用程序都将自动为所有结构生成 Typescript 模型，这些结构是绑定方法的输入或输出参数。这实现了两个世界之间数据模型的无缝交换。 diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-blog/2021-11-08-v2-beta2-release-notes.mdx b/website/i18n/zh-Hans/docusaurus-plugin-content-blog/2021-11-08-v2-beta2-release-notes.mdx index 912ae2192..b94c5378b 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-blog/2021-11-08-v2-beta2-release-notes.mdx +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-blog/2021-11-08-v2-beta2-release-notes.mdx @@ -65,7 +65,7 @@ v1 的一个巨大痛点是需要将整个应用程序压缩为单个 JS 和 CSS > 那么我如何包含我的资源？ -您只需将`embed.FS`包含所有资产的单个文件传递到您的应用程序配置中。他们甚至不需要在顶级目录中——Wails 会为你解决这个问题。 +您只需将`embed.FS`包含所有资源的单个文件传递到您的应用程序配置中。他们甚至不需要在顶级目录中——Wails 会为你解决这个问题。 ### 全新的开发体验 @@ -73,10 +73,10 @@ v1 的一个巨大痛点是需要将整个应用程序压缩为单个 JS 和 CSS 它还提供了附加功能： -- 热重载 - 对前端资产的任何更改都将触发并自动重载应用程序前端 +- 热重载 - 对前端资源的任何更改都将触发并自动重载应用程序前端 - 自动重新构建 - 对 Go 代码的任何更改都将重新构建并重新启动您的应用程序 -除此之外，网络服务器将在端口 34115 上启动。这将为您的应用程序提供连接到它的任何浏览器。所有连接的 Web 浏览器都会响应系统事件，例如资产更改时的热重载。 +除此之外，网络服务器将在端口 34115 上启动。这将为您的应用程序提供连接到它的任何浏览器。所有连接的 Web 浏览器都会响应系统事件，例如资源更改时的热重载。 在 Go 中，我们习惯于在应用程序中处理结构。将结构发送到我们的前端并将它们用作我们应用程序中的状态通常很有用。在 v1 中，这是一个非常需要手动的过程，对开发人员来说有点负担。 我很高兴地宣布，在 v2 中，任何在开发模式下运行的应用程序都将自动为所有结构生成 Typescript 模型，这些结构是绑定方法的输入或输出参数。这实现了两个世界之间数据模型的无缝交换。 diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-blog/2022-02-22-v2-beta3-release-notes.mdx b/website/i18n/zh-Hans/docusaurus-plugin-content-blog/2022-02-22-v2-beta3-release-notes.mdx index 7c7eda844..eebf80b96 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-blog/2022-02-22-v2-beta3-release-notes.mdx +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-blog/2022-02-22-v2-beta3-release-notes.mdx @@ -52,7 +52,7 @@ v1 的一个巨大痛点是需要将整个应用程序压缩为单个 JS 和 CSS > 那么我如何包含我的资源？ -您只需将`embed.FS`包含所有资产的单个文件传递到您的应用程序配置中。他们甚至不需要在顶级目录中——Wails 会为你解决这个问题。 +您只需将`embed.FS`包含所有资源的单个文件传递到您的应用程序配置中。他们甚至不需要在顶级目录中——Wails 会为你解决这个问题。 ### 全新的开发体验 @@ -60,10 +60,10 @@ v1 的一个巨大痛点是需要将整个应用程序压缩为单个 JS 和 CSS 它还提供了附加功能： -- 热重载 - 对前端资产的任何更改都将触发并自动重载应用程序前端 +- 热重载 - 对前端资源的任何更改都将触发并自动重载应用程序前端 - 自动重新构建 - 对 Go 代码的任何更改都将重新构建并重新启动您的应用程序 -除此之外，网络服务器将在端口 34115 上启动。这将为您的应用程序提供连接到它的任何浏览器。所有连接的 Web 浏览器都会响应系统事件，例如资产更改时的热重载。 +除此之外，网络服务器将在端口 34115 上启动。这将为您的应用程序提供连接到它的任何浏览器。所有连接的 Web 浏览器都会响应系统事件，例如资源更改时的热重载。 在 Go 中，我们习惯于在应用程序中处理结构。将结构发送到我们的前端并将它们用作我们应用程序中的状态通常很有用。在 v1 中，这是一个非常需要手动的过程，对开发人员来说有点负担。 我很高兴地宣布，在 v2 中，任何在开发模式下运行的应用程序都将自动为所有结构生成 Typescript 模型，这些结构是绑定方法的输入或输出参数。这实现了两个世界之间数据模型的无缝交换。 diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/troubleshooting.mdx b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/troubleshooting.mdx new file mode 100644 index 000000000..fcfbe84fa --- /dev/null +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/troubleshooting.mdx @@ -0,0 +1,14 @@ +# 故障排除 + +各种故障排除技巧。 + +## 我的应用程序显示白色/空白屏幕 + +检查您的应用程序是否在正确目录中包含资源。在您的`main.go`文件中，您将拥有类似于以下代码的内容： + +```go +//go:embed frontend/dist +var assets embed.FS +``` + +检查`frontend/dist`中是否包含您的应用程序资源。 diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/project-config.mdx b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/project-config.mdx index 4167d211e..ca8a41238 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/project-config.mdx +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/project-config.mdx @@ -12,7 +12,7 @@ sidebar_position: 5 "assetdir": "[资源目录的相对路径]", "reloaddirs": "[触发重新加载的附加目录（逗号分隔），这仅用于一些重要资源配置]", "frontend:install": "[安装 node 依赖的命令，在 frontend 目录下运行 - 通常是 `npm install`]", - "frontend:build": "[构建资源的命令，在frontend目录下运行 - 通常是 `npm run build`]", + "frontend:build": "[构建资源的命令，在 frontend 目录下运行 - 通常是 `npm run build`]", "frontend:dev": "[此命令等效于开发模式中的 frontend:build，如果没有指定则只有 frontend:build]", "frontend:dev:watcher": "[此命令在 `wails dev` 上的单独进程中运行。对第 3 方观察者有用]", "wailsjsdir": "[自动生成的JS模块将被创建的目录的相对路径]", @@ -20,7 +20,21 @@ sidebar_position: 5 "outputfilename": "[二进制文件的名称]", "debounceMS": 100, // 在检测到资源更改时，开发服务器等待重新加载的时间 "devserverurl": "[用于服务本地资源的开发服务器URL。默认：http://localhost:34115]", - "appargs": "[在dev模式下以shell样式传递给应用程序的参数]" + "appargs": "[在dev模式下以shell样式传递给应用程序的参数]", + "runNonNativeBuildHooks": false, // Defines if build hooks should be run though they are defined for an OS other than the host OS. + "postBuildHooks": { + "GOOS/GOARCH": "[在构建指定的 GOOS/GOARCH 后将执行的命令：${platform} 替换为'GOOS/GOARCH'，${bin} 替换为编译后的二进制文件的路径。'GOOS/GOARCH'钩子在'GOOS/*'和'*/*'钩子之前执行。]", + "GOOS/*": "[在构建指定的 GOOS 后将执行的命令：${platform} 替换为'GOOS/GOARCH'，${bin} 替换为编译后的二进制文件的路径。'GOOS/*'钩子在'*/*'钩子之前执行。]", + "*/*": "[每次构建后将执行的命令：${platform} 替换为'GOOS/GOARCH'，${bin} 替换为编译后的二进制文件的路径。]" + }, + "info": { // 用于填充 manifests 和 version 信息的数据。 + "companyName": "[公司名称。 默认: [项目名]]", + "productName": "[产品名称。 默认: [项目名]]", + "productVersion": "[产品的版本。 默认: '1.0.0']", + "copyright": "[产品的版权。 默认: 'Copyright.........']", + "comments": "[该应用程序的简短注释。 默认: 'Built using Wails (https://wails.app)']" + }, + "nsisType": "['multiple': 每个架构一个安装程序。 'single': 适用于所有正在构建的架构的单一通用安装程序。 默认: 'multiple']" } ``` diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/runtime/events.mdx b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/runtime/events.mdx index 472056339..d93a2c42a 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/runtime/events.mdx +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/runtime/events.mdx @@ -43,8 +43,8 @@ JS 方法签名: `EventsOnMultiple(eventName string, callback function(optionalD ### 触发指定事件 -Go 方法签名: `Events(ctx context.Context, eventName string, optionalData ...interface{})` +Go 方法签名: `EventsEmit(ctx context.Context, eventName string, optionalData ...interface{})` -JS 方法签名: `Events(ctx context, optionalData function(optionalData?: any))` +JS 方法签名: `EventsEmit(ctx context, optionalData function(optionalData?: any))` 此方法触发指定的事件。可选数据可以与事件一起传递。这将触发任何事件侦听器。