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 #23152

Merged
merged 3 commits into from
Aug 27, 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
8 changes: 4 additions & 4 deletions files/zh-cn/games/techniques/controls_gamepad_api/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -225,11 +225,11 @@ if (gamepadAPI.axesStatus[0].x > 0.5) {

布局类型现在是一个可枚举的对象而不是字符串:

```
```ts
enum GamepadMappingType {
"",
"standard"
};
"",
"standard",
}
```

此枚举中定义了已知的控制器映射集。目前只有 `standard` 布局可用,但是未来可能会有新的布局。如果布局未知,那么将会是空字符串。
Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/glossary/time_to_first_byte/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ l10n:

TTFB 是从请求开始到响应开始之间所用的时间,以毫秒为单位:

```
```plain
TTFB = responseStart - requestStart
```

Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/learn/accessibility/multimedia/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -288,7 +288,7 @@ player.ontimeupdate = () => {

典型的 WebVTT 文件如下所示:

```
```plain
WEBVTT

1
Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/learn/css/first_steps/how_css_works/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,7 @@ slug: Learn/CSS/First_steps/How_CSS_works

在这个 DOM 中,`<p>`元素对应了父节点,它的子节点是一个 text 节点和三个对应了`<span>`元素的节点,`SPAN`节点同时也是他们中的 Text 节点的父节点。

```
```plain
P
├─ "Let's use:"
├─ SPAN
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -253,7 +253,7 @@ _以下截图显示了 macOS 上的 Firefox 71 和 Safair 13 以及 Windows 10

例如,当你点击这个小部件图像坐标为 (123,456) 的位置时,它将会通过 `get` 方法提交。你可以看到类似的 URL:

```
```url
http://foo.com?pos.x=123&pos.y=456
```

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ slug: Learn/Getting_started_with_the_web/HTML_basics

HTML 不是一门编程语言,而是一种用于定义内容结构的*标记语言*。HTML 由一系列的{{Glossary("element", "元素")}}组成,这些元素可以用来包围不同部分的内容,使其以某种方式呈现或者工作。一对{{Glossary("tag", "标签")}}可以为一段文字或者一张图片添加超链接,将文字设置为斜体,改变字号,等等。例如,键入下面一行内容:

```
```plain
My cat is very grumpy
```

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ HTML 中有许多其他元素可以用于格式化文本,我们没有在 [HTML

在 HTML 基础部分,我们讨论了如何在 HTML 中[标记基本的列表](/zh-CN/docs/Learn/HTML/Introduction_to_HTML/HTML_text_fundamentals#列表_lists),但是我们没有提到你偶尔会遇到的第三种类型的列表——**描述列表**(description list)。这种列表的目的是标记一组项目及其相关描述,例如术语和定义,或者是问题和答案等。让我们看一组术语和定义的示例:

```
```plain
内心独白
戏剧中,某个角色对自己的内心活动或感受进行念白表演,这些台词只面向观众,而其他角色不会听到。
语言独白
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -144,7 +144,7 @@ HTML 本身不容易出现语法错误,因为浏览器是以宽松模式运行
- End of file reached when inside an attribute value. Ignoring tag(在属性值内达到文件末尾。忽略标签): 这个比较难懂,它说的是在某个地方有一个属性的值格式有误,估计是在文件末尾附近,因为文件的结尾出现在了一个属性值里。事实上浏览器没有渲染超链接已经是一个很明显的线索了。
- End of file seen and there were open elements(文件结尾有未闭合的元素):这个略有歧义,但基本上表明了有元素没有正确闭合。行号指向文件最后几行,且错误信息给出了一个这种错误的案例:

```
```plain
来看一个示例:<a href="https://www.mozilla.org/>Mozilla 主页链接</a> ↩ </ul>↩ </body>↩</html>
```

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ slug: Learn/HTML/Introduction_to_HTML/Getting_started

{{glossary("HTML")}}(HyperText Markup Language,超文本标记语言)是一种用来告知浏览器如何组织页面的*标记语言*。HTML 可复杂、可简单,一切取决于 web 开发者。HTML 由一系列的{{Glossary("Element", "元素")}}组成,这些元素可以用来包围或*标记*不同部分的内容,使其以某种方式呈现或者工作。两端的{{glossary("Tag", "标签")}}可以使内容变成超链接,以连接到另一个页面;使字体表现为斜体等。例如,考虑如下内容:

```
```plain
My cat is very grumpy
```

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -264,7 +264,7 @@ textarea.onkeyup = function () {

无序列表用于标记列表项目顺序无关紧要的列表——让我们以购物清单为例。

```
```plain
豆浆
油条
豆汁
Expand Down Expand Up @@ -431,7 +431,7 @@ textarea.onkeyup = () => {

有序列表需要按照项目的顺序列出来——让我们以一组方向为例:

```
```plain
沿这条路走到头
右转
直行穿过第一个十字路口
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -281,20 +281,21 @@ if (x === 5 || x === 7 || x === 10 || x === 20) {

[`switch` 语句](/zh-CN/docs/Web/JavaScript/Reference/Statements/switch) 在这里是你的朋友——它们以单个表达式/值作为输入,然后查看多个选项,直到找到与该值相匹配的选项,执行与之相关的代码。这里有一些伪代码,可以给你一点灵感:

```
switch (表达式) {
case 选择1:
运行这段代码
```js
switch (expression) {
case choice1:
// 运行这段代码
break;

case 选择2:
否则,运行这段代码
case choice2:
// 否则,运行这段代码
break;

// 包含尽可能多的情况

default:
实际上,仅仅运行这段代码
// 此外,仅运行这段代码
break;
}
```

Expand Down Expand Up @@ -366,7 +367,7 @@ function setWeather() {

在我们举一些例子之前,我们要介绍一下最后一句语法。[三元或条件运算符](/zh-CN/docs/Web/JavaScript/Reference/Operators/Conditional_operator)是一个语法的小点,用于测试一个条件,并返回一个值/表达式,如果它是 `true` 则返回其中一个,否则(`false`)返回另外一个——这在某些情况下是很有用的,如果你通过 `true`/`false` 条件来选择,这比 `if...else` 块占用的代码要少很多。伪代码看起来像这样:

```
```js-nolint
condition ? 运行这段代码 : 否则,运行这段代码
```

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ container.addEventListener("click", handleClick);

你会发现在用户单击按钮时,父元素上触发了单击事件:

```
```plain
你在 DIV 元素上进行了点击
```

Expand Down Expand Up @@ -75,7 +75,7 @@ button.addEventListener("click", handleClick);

你会发现在用户单击按钮时,所有三个元素都触发了单击事件:

```
```plain
你在 BUTTON 元素上进行了点击
你在 DIV 元素上进行了点击
你在 BODY 元素上进行了点击
Expand Down Expand Up @@ -267,7 +267,7 @@ button.addEventListener("click", handleClick);

在这种情况下,消息出现的顺序发生了颠倒:`<body>` 事件处理器首先触发,然后是 `<div>` 的,最后是 `<button>` 的:

```
```plain
你在 BODY 元素上进行了点击
你在 DIV 元素上进行了点击
你在 BUTTON 元素上进行了点击
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ slug: Learn/JavaScript/Objects/Object-oriented_programming

`Professor` 类用伪代码描述如下:

```
```plain
class Professor
properties
name
Expand All @@ -66,7 +66,7 @@ class Professor

通常来说,需要将构造函数作为类定义的一部分明确声明,并且构造函数通常具有和类名相同的函数名。

```
```plain
class Professor
properties
name
Expand Down Expand Up @@ -101,7 +101,7 @@ lillian.introduceSelf(); // '我是丽莲,我是你们的诗歌老师'

然而,学生同样具有一个名字,并且他们可能也想介绍他们自己,因此,我们可能会将学生类的定义写成:

```
```plain
class Student
properties
name
Expand All @@ -116,7 +116,7 @@ class Student

很容易注意到教授和学生都是人,而人是具有姓名,并且可以介绍自己的。我们可以将人定义为一个新类,即 `Person` 类,在 `Person` 类中,我们可以定义所有作为人的通用属性。接下来,我们可以定义 `Professor` 类和 `Student` 类由 `Person` 类**派生**(derive)而来,在伪代码中定义如下:

```
```plain
class Person
properties
name
Expand Down Expand Up @@ -180,7 +180,7 @@ if (student.year > 1) {

问题在于,如果我们决定修改选修弓箭课的标准(例如需要家长的同意),我们需要在选课系统的代码中修改每一个相关的部分,这是相当麻烦的,并且这一过程中程序员很可能出错。现在,如果我们向 `Student` 类中添加一个 `canStudyArchery()` 方法(用于检查学生是否能够选修弓箭课),那么相应代码的实现逻辑就会集中在一个地方:

```
```plain
class Student : extends Person
properties
year
Expand All @@ -201,7 +201,7 @@ if (student.canStudyArchery()) {

在许多面向对象编程语言中,我们可以使用 `private` 关键字标记对象的私有部分,也就是外部代码无法直接访问的部分。如果一个属性在被标记为 `private` 的情况下,外部代码依旧尝试访问该属性,那么通常来说,计算机会抛出一个错误。

```
```plain
class Student : extends Person
properties
private year
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@ myObject.greet(); // 来自 Madrid 的问候

这里有一个对象,它具有数据属性 `city` 和方法 `greet()`。如果你在控制台中输入对象的名称,然后*跟随一个小数点*(如同 `myObject.`),控制台会列出该对象可用的一系列属性。你会看到,除了 `city` 和 `greet` 外,还有很多其他属性!

```
```plain
__defineGetter__
__defineSetter__
__lookupGetter__
Expand Down
10 changes: 5 additions & 5 deletions files/zh-cn/learn/server-side/django/deployment/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -236,7 +236,7 @@ Heroku 与 **git** 源代码版本控制系统紧密集成,使用它来上传/
1. 将你的 Django 应用程序,复制到此文件夹(与 **manage.py** 级别相同的、和以下级别的所有文件,而**不是**包含 locallibrary 文件夹的文件)。
2. 打开 **.gitignore** 文件,将以下几行复制到其底部,然后保存(此文件用于标识默认情况下,不应上传到 git 的文件)。

```
```ignore
# Text backup files
*.bak

Expand All @@ -252,7 +252,7 @@ Heroku 与 **git** 源代码版本控制系统紧密集成,使用它来上传/

4. 使用 status 命令,检查要添加的所有文件是否正确(你希望包含源文件,而不是二进制文件,临时文件等)。它应该看起来有点像下面的列表。

```
```bash
> git status
On branch master
Your branch is up-to-date with 'origin/master'.
Expand Down Expand Up @@ -296,7 +296,7 @@ Heroku 与 **git** 源代码版本控制系统紧密集成,使用它来上传/

在 GitHub 储存库的根目录中,创建文件`Procfile`(无扩展名),以声明应用程序的进程类型和入口点。将以下文本复制到其中:

```
```plain
web: gunicorn locallibrary.wsgi --log-file -
```

Expand Down Expand Up @@ -447,7 +447,7 @@ pip3 freeze > requirements.txt

安装上面所有不同的依赖项后,你的 **requirements.txt** 文件,应至少列出这些项目(尽管版本号可能不同)。请删除下面未列出的任何其他依赖项,除非你已为此应用程序明确添加它们。

```
```plain
dj-database-url==0.4.1
Django==2.0
gunicorn==19.6.0
Expand All @@ -462,7 +462,7 @@ whitenoise==3.2.2

**runtime.txt** 文件(如果已定义)告诉 Heroku 使用哪种编程语言。在 repo 的根目录中,创建文件并添加以下文本:

```
```plain
python-3.6.4
```

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -219,10 +219,10 @@ source ~/.bashrc

此时,你应该能看到一些脚本正在运行,如下所示:

```
```bash
virtualenvwrapper.user_scripts creating /home/ubuntu/.virtualenvs/premkproject
virtualenvwrapper.user_scripts creating /home/ubuntu/.virtualenvs/postmkproject
...
# …
virtualenvwrapper.user_scripts creating /home/ubuntu/.virtualenvs/preactivate
virtualenvwrapper.user_scripts creating /home/ubuntu/.virtualenvs/postactivate
virtualenvwrapper.user_scripts creating /home/ubuntu/.virtualenvs/get_env_details
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -488,7 +488,7 @@ def book_detail_view(request,pk):
>
> 还要注意,如果你没有定义顺序(在基于类的视图或模型上),你还会看到开发服务器中的错误,如下所示:
>
> ```
> ```plain
> [29/May/2017 18:37:53] "GET /catalog/books/?page=1 HTTP/1.1" 200 1637
> /foo/local_library/venv/lib/python3.5/site-packages/django/views/generic/list.py:99: UnorderedObjectListWarning: Pagination may yield inconsistent results with an unordered object_list: <QuerySet [<Author: Ortiz, David>, <Author: H. McRaven, William>, <Author: Leigh, Melinda>]>
> allow_empty_first_page=allow_empty_first_page, **kwargs)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -244,7 +244,7 @@ urlpatterns += [

将路径函数的第一个参数留空以表示'/'。如果你将第一个参数写为'/',Django 会在你启动服务器时给出以下警告:

```
```plain
System check identified some issues:

WARNINGS:
Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/learn/server-side/django/testing/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -109,7 +109,7 @@ class Author(models.Model):

Django 使用 unittest 模块的[内置测试查找](https://docs.python.org/3/library/unittest.html#unittest-test-discovery),它将在任何使用模式**test\*.py** 命名的文件中,查找当前工作目录下的测试。如果你正确命名文件,则可以使用你喜欢的任何结构。我们建议你为测试代码创建一个模块,并为模型,视图,表单和你需要测试的任何其他类型的代码,分别创建文件。例如:

```
```plain
catalog/
/tests/
__init__.py
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -156,7 +156,7 @@ npx create-react-app moz-todo-react

create-react-app 提供了开发 React 应用所需的工具。它的初始文件结构如下:

```
```plain
moz-todo-react
├── README.md
├── node_modules
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -191,7 +191,7 @@ export default {

回到网页浏览器中,你将会看到 todo item 与之前相同,但是没有 label。转到浏览器的开发者工具,你会在控制台中看到这样的警告:

```
```plain
[Vue warn]: Missing required prop: "label"

found in
Expand Down Expand Up @@ -258,7 +258,7 @@ Vue 在这里做了一点魔术 — 它把你所有的 props 直接绑定到组

因此,现在我们需要将 `isDone` 属性附加到我们的组件。与 Vue 使用 `\{{}}` 表达式在模板中显示 JavaScript 表达式的方式类似,Vue 有一种特殊的语法将 JavaScript 表达式绑定到 HTML 元素和组件:**`v-bind`**。`v-bind` 表达式如下所示:

```
```plain
v-bind:attribute="expression"
```

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -169,7 +169,7 @@ Vue CLI 带有内置的开发服务器。这样一来,你就可以在本地运

在你的终端中,尝试运行 `npm run serve`(或者如果希望使用 yarn,则运行 `yarn serve` )。你的终端应输出类似以下内容:

```
```plain
INFO Starting development server...
98% after emitting CopyPlugin

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -425,7 +425,7 @@ Sauce Labs 有一个 [restful API](https://docs.saucelabs.com/dev/api/),允许
1. 首先,按照[设置 Node 和 npm 环境](#设置_node_和_npm_环境)中的详细说明,设置一个新的 npm 项目来进行测试。使用一个与之前不同的目录名称,例如 `sauce-test`。
2. 使用以下命令安装 Node Sauce Labs 包装器:

```
```bash
npm install saucelabs
```

Expand Down Expand Up @@ -732,7 +732,7 @@ TestingBot 有几个 API 客户端,你可以用来与 API 互动,包括 Node
1. 首先,按照[设置 Node 和 npm 环境](#设置_node_和_npm_环境)中的详细说明,设置一个新的 npm 项目来进行测试。使用一个与之前不同的目录名称,例如 `tb-test`。
2. 使用以下命令安装 Node TestingBot 包装器:

```
```bash
npm install testingbot-api
```

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -75,7 +75,7 @@ MDN Web 文档中的**已弃用**(deprecated)术语用于标记不再推荐
> [!NOTE]
> 本地化文档中并不需要添加 `status` 元数据(同样适用于下文),文档构建系统会自动合并来自英文文档的元数据。参见[针对 MDN 文档的本地化指南](https://github.com/mdn/translated-content/blob/main/docs/zh-cn/translation-guide.md#元数据),以了解更多信息。

```
```yaml
status:
- deprecated
```
Expand All @@ -93,7 +93,7 @@ MDN Web 文档中的**已弃用**(deprecated)术语用于标记不再推荐

- 如果该项目有任何仅描述该项目的文档页面(例如 {{domxref("RTCPeerConnection.close()")}}),请在页面顶部添加 [`deprecated_header`](https://github.com/mdn/yari/blob/main/kumascript/macros/Deprecated_Header.ejs) 宏,并在元数据中添加以下 `status:` 条目:

```
```yaml
status:
- deprecated
```
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ slug: MDN/Writing_guidelines/Page_structures/Banners_and_notices

横幅通过使用宏来添加,它们应当与页面的侧边栏宏一起插入到页面元数据的下方。例如,[Ink API](/zh-CN/docs/Web/API/Ink_API) 页面中插入了 `\{{SeeCompatTable}}` 宏,代表它是[实验性的](/zh-CN/docs/MDN/Writing_guidelines/Experimental_deprecated_obsolete#实验性)功能。

```
```md
---
title: Ink API
slug: Web/API/Ink_API
Expand Down
Loading