feat: New Crowdin translations (auto-merged 🤖) (#2044)

content/zh-CN/docs/api/browser-window.md

@@ -162,11 +162,11 @@ child.once('ready-to-show', () => {
     * `hidden` - Results in a hidden title bar and a full size content window. On macOS, the window still has the standard window controls (“traffic lights”) in the top left. On Windows, when combined with `titleBarOverlay: true` it will activate the Window Controls Overlay (see `titleBarOverlay` for more information), otherwise no window controls will be shown.
     * `hiddenInset` - Only on macOS, results in a hidden title bar with an alternative look where the traffic light buttons are slightly more inset from the window edge.
     * `customButtonsOnHover` - Only on macOS, results in a hidden title bar and a full size content window, the traffic light buttons will display when being hovered over in the top left of the window.  ** 注意: **此选项目前是实验性的。
-  * `trafficLightPosition` [Point](structures/point.md) (optional) - Set a custom position for the traffic light buttons in frameless windows.
-  * `roundedCorners` Boolean (optional) - Whether frameless window should have rounded corners on macOS. 默认值为 `true`。
-  * `fullscreenWindowTitle` Boolean (optional) _Deprecated_ - Shows the title in the title bar in full screen mode on macOS for `hiddenInset` titleBarStyle. 默认值为 `false`.
+  * `trafficLightPosition` [Point](structures/point.md) (可选的) - 设置控制按钮在无边框窗口中的位置。
+  * `roundedCorners` Boolean (可选) - 无框窗口是否应该在 macOS 上 圆角。 默认值为 `true`。
+  * `fullscreenWindowTitle` Boolean (可选) _已弃用_ - macOS全屏模式下，在标题栏展示标题，需要 titleBarStyle 设置 `hiddenInset` 属性。 默认值为 `false`.
   * `thickFrame` Boolean(可选)-对 Windows 上的无框窗口使用` WS_THICKFRAME ` 样式，会增加标准窗口框架。 设置为 `false` 时将移除窗口的阴影和动画. 默认值为 `true`。
-  * `vibrancy` String (可选) - 窗口是否使用 vibrancy 动态效果, 仅 macOS 中有效. 可选值为 `appearance-based`, `light`, `dark`, `titlebar`, `selection`, `menu`, `popover`, `sidebar`, `medium-light`, `ultra-dark`, `header`, `sheet`, `window`, `hud`, `fullscreen-ui`, `tooltip`, `content`, `under-window` 或 `under-page`。 Please note that `appearance-based`, `light`, `dark`, `medium-light`, and `ultra-dark` are deprecated and have been removed in macOS Catalina (10.15).
+  * `vibrancy` String (可选) - 窗口是否使用 vibrancy 动态效果, 仅 macOS 中有效. 可选值为 `appearance-based`, `light`, `dark`, `titlebar`, `selection`, `menu`, `popover`, `sidebar`, `medium-light`, `ultra-dark`, `header`, `sheet`, `window`, `hud`, `fullscreen-ui`, `tooltip`, `content`, `under-window` 或 `under-page`。 请注意： `appearance-based`, `light`, `dark`, `medium-light`, and `ultra-dark` 已被弃用，并将在即将推出的 macOS Catalina (10.15版本) 中被移除。
   * `zoomToPageWidth` Boolean (可选) - 控制 macOS 上，当选择性单击工具栏上的绿色stoplight按钮或单击 Window > Zoom menu item时的行为。 如果为 ` true `, 窗口将放大到网页的本身宽度, ` false ` 将使其缩放到屏幕的宽度。 这也会影响直接调用 ` maximize() ` 时的行为。 默认值为 `false`.
   * `tabbingIdentifier` String (可选) - 选项组卡的名称，在macOS 10.12+上可使窗口在原生选项卡中打开. 具有相同标识符的窗口将被组合在一起。 这还会在窗口的标签栏中添加一个原生的新选项卡按钮, 并允许 ` app ` 和窗口接收 ` new-window-for-tab` 事件。
   * `webPreferences` Object (可选) - 网页功能设置。
@@ -409,7 +409,7 @@ __注意__: 在 macOS 上，此事件是` move `的别名。
 const { BrowserWindow } = require('electron')
 const win = new BrowserWindow()
 win.on('app-command', (e, cmd) => {
-  // Navigate the window back when the user hits their mouse back button
+  // 当用户鼠标单击返回按钮时将自动返回上一个窗口
   if (cmd === 'browser-backward' && win.webContents.canGoBack()) {
     win.webContents.goBack()
   }
@@ -775,10 +775,10 @@ Menu.setApplicationMenu(menu)
 const { BrowserWindow } = require('electron')
 const win = new BrowserWindow()
 
-// set all bounds properties
+// 设置所有 bounds 边界属性
 win.setBounds({ x: 440, y: 225, width: 800, height: 600 })
 
-// set a single bounds property
+// 设置单一 bounds 边界属性
 win.setBounds({ width: 100 })
 
 // { x: 440, y: 225, width: 100, height: 600 }
@@ -1105,7 +1105,7 @@ Windows上句柄类型为 `HWND`，macOS 上为 `NSView*`，Linux 上为`Window`
   * `httpReferrer` (String | [Referrer](structures/referrer.md)) (可选) - HTTP 引用 url。
   * `userAgent` String (可选) - 发起请求的 userAgent.
   * `extraHeaders` String (可选) - 用 "\n" 分割的额外标题
-  * `postData` ([UploadRawData](structures/upload-raw-data.md) | [UploadFile](structures/upload-file.md))[] (optional)
+  * `postData` ([UploadRawData](structures/upload-raw-data.md) | [UploadFile](structures/upload-file.md))[] (可选)
   * `baseURLForDataURL` String (可选) - 要由数据URL加载的文件基本URL(末尾带有路径分隔符)。 仅当指定的`url`是数据url并且需要加载其他文件时，才需要此选项。
 
 返回 `Promise<void>` - 当页面完成加载后 promise 将会resolve (见 [`did-finish-load`](web-contents.md#event-did-finish-load))，如果页面加载失败，则 reject (见 [`did-fail-load`](web-contents.md#event-did-fail-load))。
@@ -1305,8 +1305,8 @@ win.loadURL('http://localhost:8000/post', {
 
 * `visible` Boolean
 * `options` Object (可选)
-  * `visibleOnFullScreen` Boolean (optional) _macOS_ - Sets whether the window should be visible above fullscreen windows.
-  * `skipTransformProcessType` Boolean (optional) _macOS_ - Calling setVisibleOnAllWorkspaces will by default transform the process type between UIElementApplication and ForegroundApplication to ensure the correct behavior. However, this will hide the window and dock for a short time every time it is called. If your window is already of type UIElementApplication, you can bypass this transformation by passing true to skipTransformProcessType.
+  * `visibleOnFullScreen` Boolean (可选) _macOS_ - 设置当前窗口是否可以在全屏窗口之上显示。
+  * `skipTransformProcessType` Boolean (可选) _macOS_ - 调用 setVisibleOnAllWorkspaces ，默认转换流程类型于 UIElementApplication 和 ForegroundApplication 之间，用来保障正常响应。 然而，当方法被调用时将短暂的隐藏窗口和图标。 如果你的窗口已经是 UIElementApplication 类似，你可以绕过这次转换通过传递 true 参数给TransformProcessType。
 
 设置窗口是否在所有工作空间上可见
 
@@ -1406,11 +1406,11 @@ Returns whether the window can be focused.
 
 * `position` [Point](structures/point.md)
 
-Set a custom position for the traffic light buttons in frameless window.
+在无框窗口中设置自定义控制按钮的位置。
 
 #### `win.getTrafficLightPosition()` _macOS_
 
-Returns `Point` - The custom position for the traffic light buttons in frameless window.
+返回 `Point` - 在无框窗口中自定义控制按钮的位置。
 
 #### `win.setTouchBar(touchBar)` _macOS_
 

content/zh-CN/docs/api/command-line-switches.md

@@ -10,7 +10,7 @@ app.commandLine.appendSwitch('remote-debugging-port', '8315')
 app.commandLine.appendSwitch('host-rules', 'MAP * 127.0.0.1')
 
 app.whenReady().then(() => {
-  // Your code here
+  // 在这里写入你的代码
 })
 ```
 

content/zh-CN/docs/api/dialog.md

@@ -23,7 +23,7 @@ console.log(dialog.showOpenDialog({ properties: ['openFile', 'multiSelections']
   * `defaultPath` String (可选) - 对话框的默认展示路径
   * ` buttonLabel ` String (可选) - 「确认」按钮的自定义标签, 当为空时, 将使用默认标签。
   * `filters` [FileFilter[]](structures/file-filter.md) (可选)
-  * `properties` String[] (optional) - Contains which features the dialog should use. 支持以下属性值:
+  * `properties` String[] (可选) - 包含对话框相关属性。 支持以下属性值:
     * `openFile` - 允许选择文件
     * `openDirectory` - 允许选择文件夹
     * ` multiSelections `-允许多选。
@@ -71,7 +71,7 @@ dialog.showOpenDialogSync(mainWindow, {
   * `defaultPath` String (可选) - 对话框的默认展示路径
   * ` buttonLabel ` String (可选) - 「确认」按钮的自定义标签, 当为空时, 将使用默认标签。
   * `filters` [FileFilter[]](structures/file-filter.md) (可选)
-  * `properties` String[] (optional) - Contains which features the dialog should use. 支持以下属性值:
+  * `properties` String[] (可选) - 包含对话框相关属性。 支持以下属性值:
     * `openFile` - 允许选择文件
     * `openDirectory` - 允许选择文件夹
     * ` multiSelections `-允许多选。
@@ -88,7 +88,7 @@ dialog.showOpenDialogSync(mainWindow, {
 
 * `canceled` Boolean - 对话框是否被取消。
 * ` filePaths ` String[] - 用户选择的文件路径的数组. 如果对话框被取消，这将是一个空的数组。
-* `bookmarks` String[] (optional) _macOS_ _mas_ - An array matching the `filePaths` array of base64 encoded strings which contains security scoped bookmark data. `securityScopedBookmarks` 必须启用才能捕获数据。 (返回值见 [这里的表格](#bookmarks-array)。)
+* `bookmarks` String[] (optional) _macOS_ _mas_ - 一个数组， `filePaths` 数组，base64编码字符串包含安全范围书签数据。 `securityScopedBookmarks` 必须启用才能捕获数据。 (返回值见 [这里的表格](#bookmarks-array)。)
 
 ` browserWindow ` 参数允许该对话框将自身附加到父窗口, 作为父窗口的模态框。
 
@@ -131,7 +131,7 @@ dialog.showOpenDialog(mainWindow, {
   * `message` String (可选) _ macOS _-显示在对话框上的消息。
   * ` nameFieldLabel ` String (可选) _ macOS _ - 文件名输入框对应的自定义标签名。
   * ` showsTagField ` Boolean (可选) _ macOS _-显示标记输入框, 默认为 ` true `。
-  * `properties` String[] (optional)
+  * `properties` String[] (可选)
     * ` showHiddenFiles `-显示对话框中的隐藏文件。
     * `createDirectory` _macOS_ -允许你通过对话框的形式创建新的目录。
     * ` treatPackageAsDirectory `_ macOS _-将包 (如 `.app ` 文件夹) 视为目录而不是文件。
@@ -156,7 +156,7 @@ dialog.showOpenDialog(mainWindow, {
   * `message` String (可选) _ macOS _-显示在对话框上的消息。
   * ` nameFieldLabel ` String (可选) _ macOS _ - 文件名输入框对应的自定义标签名。
   * `showsTagField` Boolean (可选) _macOS_ - 显示标签输入框，默认为 `true`。
-  * `properties` String[] (optional)
+  * `properties` String[] (可选)
     * ` showHiddenFiles `-显示对话框中的隐藏文件。
     * `createDirectory` _macOS_ -允许你通过对话框的形式创建新的目录。
     * ` treatPackageAsDirectory `_ macOS _-将包 (如 `.app ` 文件夹) 视为目录而不是文件。
@@ -182,7 +182,7 @@ dialog.showOpenDialog(mainWindow, {
 * `选项` 对象
   * `message` String - message box 的内容.
   * `type` String (可选) - 可以为 `"none"`, `"info"`, `"error"`, `"question"` 或者 `"warning"`. 在 Windows 上, `"question"` 与`"info"`显示相同的图标, 除非你使用了 `"icon"` 选项设置图标。 在 macOS 上, `"warning"` 和 `"error"` 显示相同的警告图标
-  * `buttons` String[] (optional) - Array of texts for buttons. 在 Windows上，一个空数组将导致按钮被标为“OK”。
+  * `buttons` String[]  (可选) - 按钮文本数组。 在 Windows上，一个空数组将导致按钮被标为“OK”。
   * `defaultId` Integer (可选) - 在 message box 对话框打开的时候，设置默认选中的按钮，值为在 buttons 数组中的索引.
   * `title` String (可选) - message box 的标题，一些平台不显示.
   * `detail` String (可选) - 额外信息.
@@ -203,7 +203,7 @@ dialog.showOpenDialog(mainWindow, {
 * `选项` 对象
   * `message` String - message box 的内容.
   * `type` String (可选) - 可以为 `"none"`, `"info"`, `"error"`, `"question"` 或者 `"warning"`. 在 Windows 上, `"question"` 与`"info"`显示相同的图标, 除非你使用了 `"icon"` 选项设置图标。 在 macOS 上, `"warning"` 和 `"error"` 显示相同的警告图标
-  * `buttons` String[] (optional) - Array of texts for buttons. 在 Windows上，一个空数组将导致按钮被标为“OK”。
+  * `buttons` String[]  (可选) - 按钮文本数组。 在 Windows上，一个空数组将导致按钮被标为“OK”。
   * `defaultId` Integer (可选) - 在 message box 对话框打开的时候，设置默认选中的按钮，值为在 buttons 数组中的索引.
   * `title` String (可选) - message box 的标题，一些平台不显示.
   * `detail` String (可选) - 额外信息.

content/zh-CN/docs/api/environment-variables.md

@@ -42,7 +42,7 @@ export NODE_OPTIONS="--no-warnings --max-old-space-size=2048"
 --use-openssl-ca
 ```
 
-`NODE_OPTIONS` are explicitly disallowed in packaged apps, except for the following:
+`NODE_OPTIONS` 在打包应用程序中明确禁止使用，以下情况除外:
 
 ```sh
 --max-http-header-size
@@ -51,33 +51,33 @@ export NODE_OPTIONS="--no-warnings --max-old-space-size=2048"
 
 ### `GOOGLE_API_KEY`
 
-Geolocation support in Electron requires the use of Google Cloud Platform's geolocation webservice. To enable this feature, acquire a [Google API key](https://developers.google.com/maps/documentation/geolocation/get-api-key) and place the following code in your main process file, before opening any browser windows that will make geolocation requests:
+Electron中的地理定位支持需要使用Google云平台的地理定位网络服务。 为了启用此功能，需获取一个 [Google API 密钥](https://developers.google.com/maps/documentation/geolocation/get-api-key) 并将以下代码放入你的主进程文件， 在打开任何 浏览器窗口之前将生成地理位置请求：
 
 ```javascript
 process.env.GOOGLE_API_KEY = 'YOUR_KEY_HERE'
 ```
 
-By default, a newly generated Google API key may not be allowed to make geolocation requests. To enable the geolocation webservice for your project, enable it through the [API library](https://console.cloud.google.com/apis/library).
+默认情况下, 可能不允许新生成的 Google API key进行地理编码请求。 要为你的项目启用地理定位网络服务，请通过 [API 库](https://console.cloud.google.com/apis/library) 启用它。
 
-N.B. You will need to add a [Billing Account](https://cloud.google.com/billing/docs/how-to/payment-methods#add_a_payment_method) to the project associated to the API key for the geolocation webservice to work.
+注： 你需要在与 API 密钥相关的项目中添加一个[计费帐户](https://cloud.google.com/billing/docs/how-to/payment-methods#add_a_payment_method)，以便地理定位网络服务工作。
 
 ### `ELECTRON_NO_ASAR`
 
-Disables ASAR support. This variable is only supported in forked child processes and spawned child processes that set `ELECTRON_RUN_AS_NODE`.
+禁用 ASAR 支持。 该变量只在设置 `ELECTRON_RUN_AS_NODE` 的派生子进程和衍生子进程中受支持。
 
 ### `ELECTRON_RUN_AS_NODE`
 
 当做普通Node.js进程启动。
 
-In this mode, you will be able to pass [cli options](https://nodejs.org/api/cli.html) to Node.js as you would when running the normal Node.js executable, with the exception of the following flags:
+在当前模式下，当运行普通可执行Node.js文件时，你可以将 [cli 选项](https://nodejs.org/api/cli.html) 传递给Node.js，但下列标志除外：
 
 * "--openssl-config"
 * "--use-bundled-ca"
 * "--use-openssl-ca",
 * "--force-fips"
 * "--enable-fips"
 
-These flags are disabled owing to the fact that Electron uses BoringSSL instead of OpenSSL when building Node.js' `crypto` module, and so will not work as designed.
+由于Electron 在构建 Node.js 的 `crypto` 模块时使用 BoringSSL 而不是 OpenSSL，因此这些标志被禁用。所以不会像设计的那样工作。
 
 ### `ELECTRON_NO_ATTACH_CONSOLE` _Windows_
 
@@ -89,7 +89,7 @@ These flags are disabled owing to the fact that Electron uses BoringSSL instead
 
 ### `ELECTRON_TRASH` _Linux_
 
-Set the trash implementation on Linux. 默认值为 `gio`.
+在 Linux 上设置垃圾回收实现。 默认值为 `gio`.
 
 选项:
 
@@ -116,13 +116,13 @@ Setting this variable is the same as passing `--log-file` on the command line. F
 
 ### `ELECTRON_DEBUG_DRAG_REGIONS`
 
-Adds coloration to draggable regions on [`BrowserView`](./browser-view.md)s on macOS - draggable regions will be colored green and non-draggable regions will be colored red to aid debugging.
+在 macOS 的 [`BrowserView`](./browser-view.md)上添加可拖动区域的颜色 - 可拖动区域将着绿色， 不可拖动区域将着红色以帮助调试。
 
 ### `ELECTRON_DEBUG_NOTIFICATIONS`
 
-Adds extra logs to [`Notification`](./notification.md) lifecycles on macOS to aid in debugging. Extra logging will be displayed when new Notifications are created or activated. They will also be displayed when common a tions are taken: a notification is shown, dismissed, its button is clicked, or it is replied to.
+在 macOS 上添加额外日志到 [`通知`](./notification.md) 生命周期以帮助调试。 当创建或激活新通知时，将显示额外日志。 They will also be displayed when common a tions are taken: a notification is shown, dismissed, its button is clicked, or it is replied to.
 
-Sample output:
+示例输出：
 
 ```sh
 Notification created (com.github.Electron:notification:EAF7B87C-A113-43D7-8E76-F88EC9D73D44)
@@ -133,7 +133,7 @@ Notification replied to (com.github.Electron:notification:EAF7B87C-A113-43D7-8E7
 
 ### `ELECTRON_LOG_ASAR_READS`
 
-When Electron reads from an ASAR file, log the read offset and file path to the system `tmpdir`. The resulting file can be provided to the ASAR module to optimize file ordering.
+当 Electron 从 ASAR 文件读取时，记录读取 offset 偏移和文件路径到系统 `tmpdir` 临时目录。 生成的文件可以提供给ASAR 模块以优化文件排序。
 
 ### `ELECTRON_ENABLE_STACK_DUMPING`
 
@@ -155,10 +155,10 @@ When Electron reads from an ASAR file, log the read offset and file path to the
 export ELECTRON_OVERRIDE_DIST_PATH=/Users/username/projects/electron/out/Testing
 ```
 
-## Set By Electron
+## 通过 Electron 设置
 
-Electron sets some variables in your environment at runtime.
+在Electron运行时设置一些环境变量
 
 ### `ORIGINAL_XDG_CURRENT_DESKTOP`
 
-This variable is set to the value of `XDG_CURRENT_DESKTOP` that your application originally launched with.  Electron 有时修改 `XDG_CURRENT_DESKTOP` 的值以影响Chromium 中的其他逻辑，所以如果您想访问 _原始的_ 值 您应该重新查看此环境变量。
+此变量设置为你的应用程序最初启动的 `XDG_CURRENT_DESKTOP` 值。  Electron 有时修改 `XDG_CURRENT_DESKTOP` 的值以影响Chromium 中的其他逻辑，所以如果您想访问 _原始的_ 值 您应该重新查看此环境变量。

content/zh-CN/docs/api/web-contents.md

@@ -765,7 +765,7 @@ This event will only be emitted when `enablePreferredSizeMode` is set to `true`
   * `httpReferrer` (String | [Referrer](structures/referrer.md)) (可选) - 一个 HTTP Referrer url。
   * `userAgent` String (可选) - 发起请求的 userAgent.
   * `extraHeaders` String (optional) - Extra headers separated by "\n".
-  * `postData` ([UploadRawData](structures/upload-raw-data.md) | [UploadFile](structures/upload-file.md))[] (optional)
+  * `postData` ([UploadRawData](structures/upload-raw-data.md) | [UploadFile](structures/upload-file.md))[] (可选)
   * `baseURLForDataURL` String (可选) - 要加载的数据文件的根 url(带有路径分隔符). 只有当指定的 `url`是一个数据 url 并需要加载其他文件时，才需要这样做。
 
 Returns `Promise<void>` - the promise will resolve when the page has finished loading (see [`did-finish-load`](web-contents.md#event-did-finish-load)), and rejects if the page fails to load (see [`did-fail-load`](web-contents.md#event-did-fail-load)). A noop rejection handler is already attached, which avoids unhandled rejection errors.