Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

chore(zh-cn): add language tags for fenced codes (part 4) #23300

Merged
merged 4 commits into from
Sep 18, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 21 additions & 0 deletions files/zh-cn/.markdownlint.jsonc
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@
"no-trailing-punctuation": {
"punctuation": ".,;:。,",
},
"fenced-code-language": true,
"search-replace": {
"rules": [
{
Expand Down Expand Up @@ -73,6 +74,26 @@
"searchPattern": "/您/g",
"searchScope": "text",
},
{
"name": "text-code-fence",
"message": "Use 'plain' tag",
"searchPattern": "/(^ *`{3,})(text|none|unix)/gm",
"replace": "$1plain",
"searchScope": "text",
},
{
"name": "gfm-alert",
"message": "Use the GFM syntax: https://developer.mozilla.org/zh-CN/docs/MDN/Writing_guidelines/Howto/Markdown_in_MDN#备注、警告和标注",
"searchPattern": "/^ *> \\*\\*(Note|Warning|Callout):\\*\\*(?! [[{`_*])/gm",
"searchScope": "text",
},
{
"name": "bad-gfm-alert",
"message": "Use the correct GFM syntax: `> [!NOTE]`",
yin1999 marked this conversation as resolved.
Show resolved Hide resolved
// TODO this should use the modifier syntax; until it has better Node support
"searchPattern": "/^ *> !?\\[!?((?!NOTE)[Nn][Oo][Tt][Ee]|(?!WARNING)[Ww][Aa][Rr][Nn][Ii][Nn][Gg]|(?!CALLOUT)[Cc][Aa][Ll][Ll][Oo][Uu][Tt])\\]\\n|^ *> (?!\\[!)!?\\[!?(NOTE|WARNING|CALLOUT)\\]\\n/gm",
"searchScope": "text",
},
],
},
}
19 changes: 0 additions & 19 deletions files/zh-cn/web/api/mediaquerylist/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,13 +9,6 @@ slug: Web/API/MediaQueryList

如果你需要以编程方式来检测一个 document 上的媒体查询的值的变化,这个 `MediaQueryList` 对象使得通过观察其 document 而检测它的媒体查询的值的变化成为可能,而不是周期性地对这些媒体查询的值进行检查。

## 方法概述

```
void addListener(MediaQueryListListener listener);
void removeListener(MediaQueryListListener listener);
```

## 实例属性

_`MediaQueryList` 接口从它的父接口 {{DOMxRef("EventTarget")}} 继承了属性。_
Expand All @@ -31,12 +24,6 @@ _`MediaQueryList` 接口从它的父接口 {{DOMxRef("EventTarget")}} 继承了

在媒体查询列表上增加一个新的监听器,如果列表中已经存在了这个指定的监听器,这个方法将失去作用。

```
void addListener(
MediaQueryListListener listener
);
```

#### 参数 ( 针对 addListener 方法)

- `listener`
Expand All @@ -46,12 +33,6 @@ void addListener(

从媒体查询列表中移除一个监听器,如果列表中不存在这个指定的监听器,则这个方法将失去作用。

```
void removeListener(
MediaQueryListListener listener
);
```

#### 参数 (针对 removeListener 方法)

- `listener`
Expand Down
6 changes: 0 additions & 6 deletions files/zh-cn/web/api/node/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -182,12 +182,6 @@ function eachNode(rootNode, callback) {
}
```

#### 语法

```
eachNode(rootNode, callback);
```

#### 描述

使用递归的方式对 `rootNode` 的所有后代节点执行回调函数(包括 `rootNode` 自身)
Expand Down
8 changes: 1 addition & 7 deletions files/zh-cn/web/api/uievent/which/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,13 +7,7 @@ slug: Web/API/UIEvent/which

{{domxref("KeyboardEvent")}} 接口的 **`which`** 只读属性返回所按下键的数字 `keyCode` 或所按下字母数字键的字符代码 (`charCode`) 。

## 语法

```
var keyResult = event.which;
```

### 返回值
## 值

- `keyResult` contains the numeric code for a particular key pressed, depending on whether an alphanumeric or non-alphanumeric key was pressed. Please see {{domxref("KeyboardEvent.charCode")}} and {{domxref("KeyboardEvent.keyCode")}} for more details.

Expand Down
12 changes: 6 additions & 6 deletions files/zh-cn/web/css/-webkit-touch-callout/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,16 +13,16 @@ slug: Web/CSS/-webkit-touch-callout

## 语法

```
Formal syntax: default | none
```

```css
-webkit-touch-callout: default; /* displays the callout */
-webkit-touch-callout: none; /* disables the callout */
/* 关键字值 */
-webkit-touch-callout: default;
-webkit-touch-callout: none;

/* 全局值 */
-webkit-touch-callout: initial;
-webkit-touch-callout: inherit;
-webkit-touch-callout: revert;
-webkit-touch-callout: revert-layer;
-webkit-touch-callout: unset;
```

Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/css/_colon_target/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ slug: Web/CSS/:target

例如,以下 URL 具有一个片段(由 # 符号表示),指向名为 `section2` 的元素:

```
```url
http://www.example.com/index.html#section2
```

Expand Down
14 changes: 8 additions & 6 deletions files/zh-cn/web/css/_colon_where/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,14 @@ footer p:hover {

`:where()` 和 {{CSSxRef(":is", ":is()")}} 的不同之处在于,`:where()` 的[优先级](/zh-CN/docs/Web/CSS/Specificity)总是为 0,但是 `:is()` 的优先级是由它的选择器列表中优先级最高的[选择器](/zh-CN/docs/Glossary/CSS_Selector)决定的。

## 语法

```css-nolint
:where(<complex-selector-list>) {
/* ... */
}
```

### 可容错选择器解析

规范将 `:is()` 和 `:where()` 定义为接受一个[可容错选择器列表](https://drafts.csswg.org/selectors-4/#typedef-forgiving-selector-list)。
Expand Down Expand Up @@ -143,12 +151,6 @@ footer a {

{{EmbedLiveSample('示例', '100%', 600)}}

## 语法

```
:where( <complex-selector-list> )
```

## 规范

{{Specifications}}
Expand Down
6 changes: 4 additions & 2 deletions files/zh-cn/web/css/_doublecolon_backdrop/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,8 +20,10 @@ dialog::backdrop {

## 语法

```
::backdrop
```css
::backdrop {
/* ... */
}
```

## 示例
Expand Down
6 changes: 4 additions & 2 deletions files/zh-cn/web/css/_doublecolon_cue/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,8 +26,10 @@ slug: Web/CSS/::cue

## 语法

```
::cue | ::cue( <selector> )
```css-nolint
::cue | ::cue(<selector>) {
/* ... */
}
```

## 示例
Expand Down
9 changes: 4 additions & 5 deletions files/zh-cn/web/css/_doublecolon_selection/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,11 +31,10 @@ slug: Web/CSS/::selection

## 语法

```
/* Legacy Firefox syntax (version 61 and below) */
::-moz-selection

{{CSSSyntax}}
```css
::selection {
/* ... */
}
```

## 示例
Expand Down
13 changes: 11 additions & 2 deletions files/zh-cn/web/css/attr/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,8 +17,17 @@ CSS 表达式 `attr()` 用来获取选择到的元素的某一 HTML 属性值,

## 语法

```
语法:attr( attribute-name <type-or-unit>? [, <fallback> ]? )
```css
/* 关键字值 */
-webkit-touch-callout: default;
-webkit-touch-callout: none;

/* 全局值 */
-webkit-touch-callout: initial;
-webkit-touch-callout: inherit;
-webkit-touch-callout: revert;
-webkit-touch-callout: revert-layer;
-webkit-touch-callout: unset;
```

### 解释
Expand Down
21 changes: 14 additions & 7 deletions files/zh-cn/web/css/background-blend-mode/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,19 +15,18 @@ slug: Web/CSS/background-blend-mode

## 语法

```
Formal syntax: {{csssyntax("background-blend-mode")}}
```

```
```css
/* 单值 */
background-blend-mode: normal;

/* 双值,每个背景一个值 */
/* 双值,一个值对应一个背景 */
background-blend-mode: darken, luminosity;

background-blend-mode: initial;
/* 全局值 */
background-blend-mode: inherit;
background-blend-mode: initial;
background-blend-mode: revert;
background-blend-mode: revert-layer;
background-blend-mode: unset;
```

Expand All @@ -36,6 +35,14 @@ background-blend-mode: unset;
- {{cssxref("&lt;blend-mode&gt;")}}
- : 一个定义混合的模式,可以有多个值,用逗号间隔。

## 形式定义

{{cssinfo}}

## 形式语法

{{csssyntax}}

## 示例

```html hidden
Expand Down
35 changes: 19 additions & 16 deletions files/zh-cn/web/css/background-origin/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,20 +14,20 @@ slug: Web/CSS/background-origin
> [!NOTE]
> 假如{{cssxref("background")}}简写中没有设置该值,那么在 background 简写值后指定 background-origin,那么后面的值就会覆盖简写值,其实说白了,就是后出现的值会覆盖前面的值。

{{cssinfo}}

## 语法

```
Formal syntax: {{csssyntax("background-origin")}}
```

```
background-origin: border-box
background-origin: padding-box
background-origin: content-box

background-origin: inherit
```css
/* 关键字值 */
background-origin: border-box;
background-origin: padding-box;
background-origin: content-box;

/* 全局值 */
background-origin: inherit;
background-origin: initial;
background-origin: revert;
background-origin: revert-layer;
background-origin: unset;
```

### 属性值
Expand All @@ -39,12 +39,15 @@ background-origin: inherit
- `content-box`
- : 背景图片的摆放以 content 区域为参考

### 形式化语法
## 形式语法

{{cssinfo}}

## 形式定义

[How to read CSS syntax.](/zh-CN/docs/Web/CSS/Value_definition_syntax)
{{csssyntax("background-origin")}}
{{csssyntax}}

## 例子
## 示例

```css
.example {
Expand Down
6 changes: 3 additions & 3 deletions files/zh-cn/web/css/background-position/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -84,20 +84,20 @@ background-position: unset;

基本上发生的情况是从相应的容器尺寸中*减去*背景图像尺寸,然后将结果值的百分比用作从左(或顶部)边界的直接偏移量。

```
```plain
(container width - image width) * (position x%) = (x offset value)
(container height - image height) * (position y%) = (y offset value)
```

以 X 轴为例,假设我们有一个 300px 宽的图像,我们在一个 100px 宽的容器中使用它,`background-size` 设置为 `auto`:

```
```plain
100px - 300px = -200px (container & image difference)
```

因此,位置百分比为 -25%、0%、50%、100%、125%,我们得到这些图像到容器边界偏移值:

```
```plain
-200px * -25% = 50px
-200px * 0% = 0px
-200px * 50% = -100px
Expand Down
Loading
Loading