chore(zh): content clean up for markdown-lint-cli bump (#17083)

Co-authored-by: Jason Ren <[email protected]>
mdn · Nov 24, 2023 · 094ab5c · 094ab5c
1 parent 597a975
commit 094ab5c
Show file tree

Hide file tree

Showing 70 changed files with 409 additions and 570 deletions.
diff --git a/files/zh-cn/.markdownlint.jsonc b/files/zh-cn/.markdownlint.jsonc
@@ -1,5 +1,8 @@
 {
   "extends": "../../.markdownlint.jsonc",
+  "no-trailing-punctuation": {
+    "punctuation": ".,;:。，"
+  },
   "search-replace": {
     "rules": [
       {

diff --git a/files/zh-cn/glossary/grid/index.md b/files/zh-cn/glossary/grid/index.md
@@ -11,9 +11,7 @@ slug: Glossary/Grid
 
 如果开发者将内容放置在显式网格之外，或者依赖自动布局的话，网格法 (grid algorithm) 将需要创建额外的 row 或者 column、 {{glossary("grid tracks", "tracks")}} 来包含显示网格之外的内容 {{glossary("grid item", "grid items")}}，为此将在隐式网格 (implicit grid) 中创建额外的轨道 (tracks)。_当内容添加到了已定义的 tracks 之外的时候，隐式网格 (implicit grid) 会被自动创建。_
 
-下面的例子创建了一个有两行三列的显式网格*。*由于超过显式网格可容纳的六个条目，_此网格中的第三行将是一个隐式网格行轨道 (implicit grid_ row track)
-
-_（注：在容器 div 上用 row 和 column 定义的网格总数，等于 行数乘以列数 个。比如一个容器 div 定义了 2 行 \* 3 列 = 6 个网格，这 6 个就是显式网格，但是假如里面有 8 个 子 div，多出来那 2 个就叫做隐式网格。）_
+下面的例子创建了一个有两行三列的显式网格。由于超过显式网格可容纳的六个条目，此网格中的第三行将是一个*隐式网格*行轨道（implicit grid row track）。
 
 ## 示例
 

diff --git a/files/zh-cn/learn/css/first_steps/styling_a_biography_page/index.md b/files/zh-cn/learn/css/first_steps/styling_a_biography_page/index.md
@@ -39,7 +39,7 @@ slug: Learn/CSS/First_steps/Styling_a_biography_page
 
 > **备注：** 如果遇到困难，你可以向我求助——参见本页下面的[测评或请求帮助](#测评或请求帮助)部分。
 
-**让我们来学一些 CSS 样式**
+### 让我们来学一些 CSS 样式
 
 接下来的实例是一个个人主页，我们用 CSS 设定它的样式。以下是我用到的一些 CSS 属性，通过这些链接，你可以打开相应的 MDN 页面了解更多。
 
@@ -83,7 +83,7 @@ slug: Learn/CSS/First_steps/Styling_a_biography_page
 - 你希望测试的例子的在网络编辑器上的链接。这是很好的做法，因为如果不让帮助你的看到你的程序，他们就很难帮助你解决程序的问题。
 - 你的网页的测评页面链接，这样我们就可以找到你所求助的问题。
 
-**接下来是什么？**
+## 接下来是什么？
 
 恭喜你完成了第一个模块的学习。现在你应该对 CSS 有了一个大致的了解 并且能够了解在样式表中发生的大多数事情。在下一个模块[CSS 构建](/zh-CN/docs/Learn/CSS/Building_blocks)中，我们将对一些关键区域进行深入的学习。
 

diff --git a/files/zh-cn/learn/html/multimedia_and_embedding/video_and_audio_content/index.md b/files/zh-cn/learn/html/multimedia_and_embedding/video_and_audio_content/index.md
@@ -282,7 +282,7 @@ WEBVTT
 
 > **备注：** 文本轨道会使你的网站更容易被搜索引擎抓取到（{{glossary("SEO")}}），由于搜索引擎的文本抓取能力非常强大，使用文本轨道甚至可以让搜索引擎通过视频的内容直接链接。
 
-## 实践学习：在你的网站上嵌入你自己的视频或音频。
+## 实践学习：在你的网站上嵌入你自己的视频或音频
 
 在这个实践学习当中，我们希望你能够走出去，并且记录一些你自己的视频或者音频 — 如今，大多数手机都能够非常方便的记录视频或者音频，并且你可以将他们上传到你的电脑上面，你可以使用这些功能来记录你的视频或音频。在这时候，你可能需要做一些格式转换，如果是视频的话，你需要将它们转化为 WebM 或者 MP4，如果是音频的话，你需要将它们转化为 MP3 或者 Ogg。不过你并不需要担心，有许多的程序都能够帮你解决这些问题，例如 [Miro Video Converter](http://www.mirovideoconverter.com/) 和 [Audacity](https://sourceforge.net/projects/audacity/)。我们非常希望你能够亲自动手实现它。
 

diff --git a/files/zh-cn/learn/tools_and_testing/cross_browser_testing/introduction/index.md b/files/zh-cn/learn/tools_and_testing/cross_browser_testing/introduction/index.md
@@ -66,7 +66,7 @@ slug: Learn/Tools_and_testing/Cross_browser_testing/Introduction
 
 一个项目的测试和排错工作流可以大致分为如下四个阶段（这只是粗略划分——因人而异）：
 
-**初步规划>开发>测试/查错>修复/迭代**
+**初步规划** > **开发** > **测试/查错** > **修复/迭代**
 
 步骤 2 到步骤 4 在必要时应多次重复直到开发完成。我们会在后续章节详细探讨测试程序的不同之处，但现在我们只概述每个阶段可能出现的问题。
 

diff --git a/files/zh-cn/mozilla/add-ons/webextensions/anatomy_of_a_webextension/index.md b/files/zh-cn/mozilla/add-ons/webextensions/anatomy_of_a_webextension/index.md
@@ -47,7 +47,7 @@ slug: Mozilla/Add-ons/WebExtensions/Anatomy_of_a_WebExtension
 
 与此同时，你也可以先引入一个后台页面，再在后台页面中引入脚本。这样做能为后台脚本添加 ES 6 模块支持，算是一个优势。
 
-**manifest.json**
+manifest.json 的内容如下：
 
 ```json
 // manifest.json
@@ -57,7 +57,7 @@ slug: Mozilla/Add-ons/WebExtensions/Anatomy_of_a_WebExtension
 }
 ```
 
-**background-page.html**
+background-page.html 的内容如下：
 
 ```html
 <!doctype html>
@@ -83,7 +83,7 @@ slug: Mozilla/Add-ons/WebExtensions/Anatomy_of_a_WebExtension
 
 #### 跨域访问
 
-后台脚本可以向任何拥有[主机权限](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions#%E4%B8%BB%E6%9C%BA%E6%9D%83%E9%99%90)的主机发送 XHR 请求。
+后台脚本可以向任何拥有[主机权限](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions#主机权限)的主机发送 XHR 请求。
 
 #### 网页内容
 

diff --git a/files/zh-cn/mozilla/firefox/releases/59/index.md b/files/zh-cn/mozilla/firefox/releases/59/index.md
@@ -90,13 +90,13 @@ _无变化。_
 
 ### SVG
 
-_无变化_
+_无变化。_
 
 ## Mozilla 和附加组件开发者应该注意的变化
 
 ### WebExtensions
 
-_无变化_
+_无变化。_
 
 ## 参见
 

diff --git a/files/zh-cn/web/api/canvasgradient/index.md b/files/zh-cn/web/api/canvasgradient/index.md
@@ -13,20 +13,20 @@ _不透明对象，没有暴露的属性。_
 
 ## 方法
 
-_没有继承的方法_
+_没有继承的方法。_
 
 - {{domxref("CanvasGradient.addColorStop()")}}
   - : 添加一个由偏移（`offset`）和颜色（`color`）定义的断点到渐变中。如果偏移值不在 0 到 1 之间，将抛出`INDEX_SIZE_ERR 错误，如果颜色值不能被解析为有效的 CSS 颜色值 {{cssxref("&lt;color&gt;")}}，将抛出 SYNTAX_ERR`错误。
 
-## 标准
+## 规范
 
 {{Specifications}}
 
 ## 浏览器兼容性
 
 {{Compat}}
 
-## 请参考
+## 参见
 
-- 创建方法在{{domxref("CanvasRenderingContext2D")}}.
-- {{HTMLElement("canvas")}} 元素及其有关接口{{domxref("HTMLCanvasElement")}}.
+- 创建方法在 {{domxref("CanvasRenderingContext2D")}}。
+- {{HTMLElement("canvas")}} 元素及其有关接口 {{domxref("HTMLCanvasElement")}}。
diff --git a/files/zh-cn/web/api/canvasrenderingcontext2d/putimagedata/index.md b/files/zh-cn/web/api/canvasrenderingcontext2d/putimagedata/index.md
@@ -16,10 +16,8 @@ void ctx.putImageData(imagedata, dx, dy, dirtyX, dirtyY, dirtyWidth, dirtyHeight
 
 ### 参数
 
-**imageData**
-
-{{domxref("ImageData")}} ，包含像素值的数组对象。
-
+- `imageData`
+  - : {{domxref("ImageData")}}，包含像素值的数组对象。
 - `dx`
   - : 源图像数据在目标画布中的位置偏移量（x 轴方向的偏移量）。
 - `dy`

diff --git a/files/zh-cn/web/api/document/adoptnode/index.md b/files/zh-cn/web/api/document/adoptnode/index.md
@@ -7,64 +7,25 @@ slug: Web/API/Document/adoptNode
 
 从其他的 document 文档中获取一个节点。该节点以及它的子树上的所有节点都会从原文档删除 (如果有这个节点的话), 并且它的[`ownerDocument`](/zh-CN/docs/DOM/Node.ownerDocument) 属性会变成当前的 document 文档。之后你可以把这个节点插入到当前文档中。
 
-**从 Gecko 1.9 (Firefox 3) 开始支持**
-
 ## 语法
 
-```plain
-node = document.adoptNode(externalNode);
+```js-nolint
+adoptNode(externalNode)
 ```
 
-- `node`
-  - : 导入当前文档的新节点。新节点的 [`parentNode`](/zh-CN/DOM/Node.parentNode) 是 `null`, 因为它还没有插入当前文档的文档树中，属于游离状态。
 - `externalNode`
   - : 将要从外部文档导入的节点。
 
-## 例子
+## 示例
 
 ```js
-// 该函数用来从本文档的第一个 iframe 中获取第一个 element 元素，
-// 并插入到当前文档树中
-function getEle() {
-  var iframe = document.getElementsByTagName("iframe")[0],
-    ele = iframe.contentWindow.document.body.firstElementChild;
-  if (ele) {
-    document.body.appendChild(document.adoptNode(ele));
-  } else {
-    alert("没有更多元素了");
-  }
-}
-document.getElementById("move").onclick = getEle;
-```
+const iframe = document.querySelector("iframe");
+const iframeImages = iframe.contentDocument.querySelectorAll("img");
+const newParent = document.getElementById("images");
 
-HTML 文档
-
-```html
-// index.html
-
-<!doctype html>
-<html>
-  <head>
-    <title>index.html</title>
-  </head>
-  <body>
-    <iframe src="iframe.html"></iframe>
-    <button id="move">移动元素</button>
-  </body>
-</html>
-
-// iframe.html
-
-<!doctype html>
-<html>
-  <head>
-    <title>iframe.html</title>
-  </head>
-  <body>
-    <h1>Hello</h1>
-    <h3>My world!</h3>
-  </body>
-</html>
+iframeImages.forEach((imgEl) => {
+  newParent.appendChild(document.adoptNode(imgEl));
+});
 ```
 
 ## 笔记

diff --git a/files/zh-cn/web/api/domimplementation/index.md b/files/zh-cn/web/api/domimplementation/index.md
@@ -13,7 +13,7 @@ _这个接口没有特定的属性，并且也没有继承到任何属性。_
 
 ## 方法
 
-_没有继承的方法_
+_没有继承的方法。_
 
 - {{domxref("DOMImplementation.createDocument()")}}
   - : 创建并返回一个 {{domxref("XMLDocument")}}对象。
@@ -32,6 +32,6 @@ _没有继承的方法_
 
 {{Compat}}
 
-## See also
+## 参见
 
-- [The DOM interfaces index.](/zh-CN/docs/DOM/DOM_Reference)
+- [DOM 接口索引](/zh-CN/docs/Web/API/Document_Object_Model)
diff --git a/files/zh-cn/web/api/dynamicscompressornode/index.md b/files/zh-cn/web/api/dynamicscompressornode/index.md
@@ -39,7 +39,7 @@ slug: Web/API/DynamicsCompressorNode
 
 ## 属性
 
-_由父类 {{domxref("AudioNode")}} 派生_
+_由父类 {{domxref("AudioNode")}} 派生。_
 
 - {{domxref("DynamicsCompressorNode.threshold")}} {{readonlyInline}}
   - : [比例系数](/zh-CN/docs/DOM/AudioParam#k-rate) {{domxref("AudioParam")}} 型。分贝高于此值时，将会进行压缩。

diff --git a/files/zh-cn/web/api/element/lostpointercapture_event/index.md b/files/zh-cn/web/api/element/lostpointercapture_event/index.md
@@ -7,7 +7,7 @@ slug: Web/API/Element/lostpointercapture_event
 
 The **`onlostpointercapture`** event handler property of the {{domxref("GlobalEventHandlers")}} interface returns the event handler (function) for the `lostpointercapture` event type.
 
-**语法**
+## 语法
 
 ```plain
 window.onlostpointercapture = functionReference

diff --git a/files/zh-cn/web/api/event/eventphase/index.md b/files/zh-cn/web/api/event/eventphase/index.md
@@ -13,13 +13,13 @@ slug: Web/API/Event/eventPhase
 var phase = event.eventPhase;
 ```
 
-返回一个代表当前执行阶段的 整数值，下面列出了不同的执行阶段[事件阶段常量](#事件阶段常量).
+返回一个代表当前执行阶段的整数值，下面列出了不同的执行阶段[事件阶段常量](#事件阶段常量)。
 
 ## 常量
 
 ### 事件阶段常量
 
-### 下面这些值表示了事件流当前执行的阶段。
+### 下面这些值表示了事件流当前执行的阶段
 
 | 常量                    | 值  | 描述                                                                                                                                                                                                                                                                                                            |
 | ----------------------- | --- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

diff --git a/files/zh-cn/web/api/event/originaltarget/index.md b/files/zh-cn/web/api/event/originaltarget/index.md
@@ -5,19 +5,13 @@ slug: Web/API/Event/originalTarget
 
 {{ ApiRef("DOM") }} {{Non-standard_header}}
 
-## 简介
-
-original target 是事件重定向之前的原始目标。(Mozilla-特有)
+**`originalTarget`** 只读属性是事件重定向之前的原始目标。（Mozilla-特有）
 
 在 XBL 的匿名内容中，这将是该事件最初触发的匿名节点。看到匿名的内容。查看[Anonymous Content#Event_Flow_and_Targeting](/zh-CN/docs/XBL/XBL_1.0_Reference/Anonymous_Content#Event_Flow_and_Targeting) 获取更多细节。
 
-注意：原始目标也可能是原生的匿名内容 (参见 Bug(“208427”))，在这种情况下，它对于非特权代码是无用的。
-
-查看[Comparison of Event Targets](/zh-CN/docs/DOM/event/Comparison_of_Event_Targets)
-
-## 示例
+注意：原始目标也可能是原生的匿名内容，在这种情况下，它对于非特权代码是无用的。
 
-_需要一个有意义的示例_
+参见[事件目标对比](/zh-CN/docs/Web/API/Event/Comparison_of_Event_Targets)。
 
 ## 规范
 

diff --git a/files/zh-cn/web/api/fontface/index.md b/files/zh-cn/web/api/fontface/index.md
@@ -31,21 +31,21 @@ _这个接口不继承任何属性。_
 - {{domxref("FontFace.featureSettings")}}
   - : 这是不是一个 {{domxref("DOMString")}} ？是的话将表示该字体的 _features_ 属性，相当于 {{cssxref("@font-face/feature-settings", "feature-settings")}} 。
 - {{domxref("FontFace.status")}} {{readonlyinline}}
-  - : 返回一个表示字体当前状态的可枚举值，它可能是下列之一： `"unloaded"`, `"loading"`, `"loaded"`, `"error"`。
+  - : 返回一个表示字体当前状态的可枚举值，它可能是下列之一：`"unloaded"`、`"loading"`、`"loaded"`、`"error"`。
 - {{domxref("FontFace.loaded")}} {{readonlyinline}}
-  - : 当字体完全加载或加载失败时返回该 `FontFace` 的{{domxref("Promise")}} 。
+  - : 当字体完全加载或加载失败时返回该 `FontFace` 的 {{domxref("Promise")}}。
 
-## Methods
+## 方法
 
-_这个接口不继承任何方法_
+_这个接口不继承任何方法。_
 
 - {{domxref("FontFace.load()")}}
-  - : 加载该字体，返回该字体完全加载或加载失败时的{{domxref("Promise")}} 。
+  - : 加载该字体，返回该字体完全加载或加载失败时的 {{domxref("Promise")}}。
 
-## Specifications
+## 规范
 
 {{Specifications}}
 
-## Browser compatibility
+## 浏览器兼容性
 
 {{Compat}}
diff --git a/files/zh-cn/web/api/gamepad_api/using_the_gamepad_api/index.md b/files/zh-cn/web/api/gamepad_api/using_the_gamepad_api/index.md
@@ -234,13 +234,9 @@ function gameLoop() {
 }
 ```
 
-### 使用坐标方向 (axes) 信息
+## 完整的示例：显示控制器状态
 
-**待讨论 (除了一个用 axes\[i] 一个用 button\[i].value，其他基本一样，Firefox 与 Chrome 均是。)**
-
-## 完整的例子：显示控制器状态
-
-这个例子展示了怎样使用 {{ domxref("Gamepad") }} 对象，还有 [`gamepadconnected`](/zh-CN/docs/Web/API/Window/gamepadconnected_event) 和 [`gamepaddisconnected`](/zh-CN/docs/Web/API/Window/gamepaddisconnected_event) 事件显示所有已连接到系统的控制器的状态。你可以查看[在线演示](http://luser.github.io/gamepadtest/)并且可在 Github 上看到[完整的源代码](https://github.com/luser/gamepadtest)。
+这个示例展示了怎样使用 {{ domxref("Gamepad") }} 对象，还有 [`gamepadconnected`](/zh-CN/docs/Web/API/Window/gamepadconnected_event) 和 [`gamepaddisconnected`](/zh-CN/docs/Web/API/Window/gamepaddisconnected_event) 事件显示所有已连接到系统的控制器的状态。你可以查看[在线演示](http://luser.github.io/gamepadtest/)并且可在 Github 上看到[完整的源代码](https://github.com/luser/gamepadtest)。
 
 ```js
 var haveEvents = "ongamepadconnected" in window;

diff --git a/files/zh-cn/web/api/hashchangeevent/index.md b/files/zh-cn/web/api/hashchangeevent/index.md
@@ -22,30 +22,10 @@ _这个接口也从 {{domxref("Event")}} 中继承属性。_
 
 ## 方法
 
-_这个接口没有自己的方法，但从 {{domxref("Event")}} 中继承方法_
+_这个接口没有自己的方法，但从 {{domxref("Event")}} 中继承方法。_
 
 ## 示例
 
-### 井号内容变化的语法选择
-
-你可以选择使用下述的任一方法监听 [`hashchange`](/zh-CN/docs/Web/API/Window/hashchange_event) 事件。
-
-```js
-window.onhashchange = funcRef;
-```
-
-**或**
-
-```html
-<body onhashchange="funcRef();"></body>
-```
-
-**或**
-
-```js
-window.addEventListener("hashchange", funcRef, false);
-```
-
 ### 基本示例
 
 ```js

diff --git a/files/zh-cn/web/api/htmlbaseelement/index.md b/files/zh-cn/web/api/htmlbaseelement/index.md
@@ -9,7 +9,7 @@ slug: Web/API/HTMLBaseElement
 
 ## 属性
 
-_继承了其父级 {{domxref("HTMLElement")}} 的所有属性_
+_继承了其父级 {{domxref("HTMLElement")}} 的所有属性。_
 
 - {{domxref("HTMLBaseElement.href")}}
   - : 映射自 {{domxref("DOMString")}} HTML [`href`](/zh-CN/docs/Web/HTML/Element/base#href) 特性，包含了当前文档中所有相对 URL 地址的基准 URL。
@@ -20,14 +20,14 @@ _继承了其父级 {{domxref("HTMLElement")}} 的所有属性_
 
 _没有特殊的方法，继承了其父级 {{domxref("HTMLElement")}} 的所有特性。_
 
-## Specifications
+## 规范
 
 {{Specifications}}
 
-## Browser compatibility
+## 浏览器兼容性
 
 {{Compat}}
 
-## See also
+## 参见
 
-- HTML element implementing this interface: {{ HTMLElement("base") }}
+- 实现了该接口的 HTML 元素：{{ HTMLElement("base") }}