Skip to content

Commit

Permalink
zh-cn: convert noteblocks to GFM syntax (part 1) (#22806)
Browse files Browse the repository at this point in the history
zh-cn: convert noteblocks in `/mozilla` to GFM syntax
  • Loading branch information
yin1999 authored Aug 1, 2024
1 parent a525229 commit 5349f08
Show file tree
Hide file tree
Showing 100 changed files with 238 additions and 121 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -108,7 +108,8 @@ URL 的第一部分是*方案*(scheme),它表示浏览器必须使用的
- 显示多媒体如图片(用 {{HTMLElement("img")}} 元素)、视频(用 {{HTMLElement("video")}} 元素)、声音和音乐(用 {{HTMLElement("audio")}} 元素)等;
- 显示其他 HTML 文档,用 {{HTMLElement("iframe")}} 元素。

> **备注:** 当在页面中加载资源时指定 URL(例如使用 `<script>``<audio>``<img>``<video>` 等),通常应只使用 HTTP 和 HTTPS URL,除了一些例外情况(一个显著的例外是 `data:`;参见[数据 URL](/zh-CN/docs/Web/HTTP/Basics_of_HTTP/Data_URLs))。例如,使用 FTP 是不安全的,并且不再受现代浏览器的支持。
> [!NOTE]
> 当在页面中加载资源时指定 URL(例如使用 `<script>``<audio>``<img>``<video>` 等),通常应只使用 HTTP 和 HTTPS URL,除了一些例外情况(一个显著的例外是 `data:`;参见[数据 URL](/zh-CN/docs/Web/HTTP/Basics_of_HTTP/Data_URLs))。例如,使用 FTP 是不安全的,并且不再受现代浏览器的支持。
其他大量使用 URL 的技术(如 {{Glossary("CSS")}} 或 {{Glossary("JavaScript")}})才是 Web 的中心。

Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/learn/server-side/django/deployment/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -341,7 +341,7 @@ db_from_env = dj_database_url.config(conn_max_age=500)
DATABASES['default'].update(db_from_env)
```

> **备注:**
> [!NOTE]
>
> - 我们仍然会在开发期间使用 SQLite,因为我们的开发计算机上不会设置`DATABASE_URL`环境变量。
> - `conn_max_age=500`的值使连接持久,这比在每个请求周期重新创建连接更有效。但是,这是可选的,如果需要可以删除。
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -609,7 +609,7 @@ class BookListView(generic.ListView):
URL 映射器和视图所需的代码,应与我们上面创建的`Book`列表和详细视图几乎完全相同。模板将有所不同,但会分享类似的行为。
> **备注:**
> [!NOTE]
>
> - 为作者列表页面,创建 URL 映射器之后,还需要更新基本模板中的所有作者 **All authors** 链接。按照我们更新“所有图书”**All books** 链接时,所做的相同过程。
> - 为作者详细信息页面,创建 URL 映射器之后,还应更新书本详细信息视图模板(**/locallibrary/catalog/templates/catalog/book_detail.html**),以便作者链接,指向新的作者详细信息页面(而不是一个空的 URL)。该行将更改为添加下面以粗体显示的模板标记。
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -75,7 +75,8 @@ background-page.html 的内容如下:

后台脚本在一个被称为后台页面的特殊页面的上下文环境中运行。此环境为其提供了全局变量 [`window`](/zh-CN/docs/Web/API/Window) ,也提供了所有的标准 DOM API。

> **警告:** 在 Firefox 浏览器中,后台页面不支持使用 [`alert()`](/zh-CN/docs/Web/API/Window/alert), [`confirm()`](/zh-CN/docs/Web/API/Window/alert)[`prompt()`](/zh-CN/docs/Web/API/Window/alert)
> [!WARNING]
> 在 Firefox 浏览器中,后台页面不支持使用 [`alert()`](/zh-CN/docs/Web/API/Window/alert)[`confirm()`](/zh-CN/docs/Web/API/Window/alert)[`prompt()`](/zh-CN/docs/Web/API/Window/alert)
#### WebExtension API

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -26,4 +26,5 @@ l10n:

{{WebExtExamples}}

> **备注:** 此 API 基于 Chromium 的 [`chrome.alarms`](https://developer.chrome.com/extensions/alarms) API。
> [!NOTE]
> 此 API 基于 Chromium 的 [`chrome.alarms`](https://developer.chrome.com/extensions/alarms) API。
Original file line number Diff line number Diff line change
Expand Up @@ -45,4 +45,5 @@ clearAlarm.then(onCleared);

{{Compat}}

> **备注:** 此 API 基于 Chromium 的 [`chrome.alarms`](https://developer.chrome.com/extensions/alarms) API。
> [!NOTE]
> 此 API 基于 Chromium 的 [`chrome.alarms`](https://developer.chrome.com/extensions/alarms) API。
Original file line number Diff line number Diff line change
Expand Up @@ -42,4 +42,5 @@ clearAlarms.then(onClearedAll);

{{Compat}}

> **备注:** 此 API 基于 Chromium 的 [`chrome.alarms`](https://developer.chrome.com/extensions/alarms) API。
> [!NOTE]
> 此 API 基于 Chromium 的 [`chrome.alarms`](https://developer.chrome.com/extensions/alarms) API。
Original file line number Diff line number Diff line change
Expand Up @@ -83,7 +83,8 @@ browser.alarms.create("my-periodic-alarm", {

{{Compat}}

> **备注:** 此 API 基于 Chromium 的 [`chrome.alarms`](https://developer.chrome.com/extensions/alarms) API。
> [!NOTE]
> 此 API 基于 Chromium 的 [`chrome.alarms`](https://developer.chrome.com/extensions/alarms) API。
<!--
// Copyright 2015 The Chromium Authors. All rights reserved.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -47,4 +47,5 @@ getAlarm.then(gotAlarm);

{{Compat}}

> **备注:** 此 API 基于 Chromium 的 [`chrome.alarms`](https://developer.chrome.com/extensions/alarms) API。
> [!NOTE]
> 此 API 基于 Chromium 的 [`chrome.alarms`](https://developer.chrome.com/extensions/alarms) API。
Original file line number Diff line number Diff line change
Expand Up @@ -43,4 +43,5 @@ browser.alarms.getAll().then(gotAll);

{{Compat}}

> **备注:** 此 API 基于 Chromium 的 [`chrome.alarms`](https://developer.chrome.com/extensions/alarms) API。
> [!NOTE]
> 此 API 基于 Chromium 的 [`chrome.alarms`](https://developer.chrome.com/extensions/alarms) API。
Original file line number Diff line number Diff line change
Expand Up @@ -42,4 +42,5 @@ l10n:

{{Compat}}

> **备注:** 此 API 基于 Chromium 的 [`chrome.alarms`](https://developer.chrome.com/extensions/alarms) API。
> [!NOTE]
> 此 API 基于 Chromium 的 [`chrome.alarms`](https://developer.chrome.com/extensions/alarms) API。
Original file line number Diff line number Diff line change
Expand Up @@ -55,4 +55,5 @@ browser.alarms.onAlarm.addListener(handleAlarm);

{{Compat}}

> **备注:** 此 API 基于 Chromium 的 [`chrome.alarms`](https://developer.chrome.com/docs/extensions/reference/api/alarms/) API。
> [!NOTE]
> 此 API 基于 Chromium 的 [`chrome.alarms`](https://developer.chrome.com/docs/extensions/reference/api/alarms/) API。
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,8 @@ l10n:
- : 一个{{jsxref("string", "字符串", "", 1)}},唯一标识节点。每个 ID 在用户的配置文件中是唯一的,在浏览器重新启动时保持不变。
- `index` {{optional_inline}}
- : 一个数字,表示该节点在其父文件夹中的从零开始的位置,其中零代表第一个条目。
> **备注:** 如果你创建或移动多个书签,由于 {{WebExtAPIRef("bookmarks.create()")}} 和 {{WebExtAPIRef("bookmarks.move()")}} 方法是异步的,请求可能以任何顺序处理。因此,直到所有请求完成之前,每个书签的索引值可能会改变或是未知的。如果与书签相关的索引对你的扩展很重要,那么在创建或移动多个书签时,扩展应等待每个 `bookmarks.create``bookmarks.move` 调用完成。等待确保与每个书签关联的索引不会受到在原始调用进行时并发执行的创建或移动调用的影响。
> [!NOTE]
> 如果你创建或移动多个书签,由于 {{WebExtAPIRef("bookmarks.create()")}} 和 {{WebExtAPIRef("bookmarks.move()")}} 方法是异步的,请求可能以任何顺序处理。因此,直到所有请求完成之前,每个书签的索引值可能会改变或是未知的。如果与书签相关的索引对你的扩展很重要,那么在创建或移动多个书签时,扩展应等待每个 `bookmarks.create``bookmarks.move` 调用完成。等待确保与每个书签关联的索引不会受到在原始调用进行时并发执行的创建或移动调用的影响。
- `parentId` {{optional_inline}}
- : 一个{{jsxref("string", "字符串", "", 1)}},指定父文件夹的 ID。此属性不存在于根节点。
- `title`
Expand All @@ -41,7 +42,8 @@ l10n:

{{WebExtExamples}}

> **备注:** 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/#type-BookmarkTreeNode) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)
> [!NOTE]
> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/#type-BookmarkTreeNode) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)
<!--
// Copyright 2015 The Chromium Authors. All rights reserved.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,8 @@ l10n:

{{WebExtExamples}}

> **备注:** 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/#type-BookmarkTreeNodeUnmodifiable) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)
> [!NOTE]
> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/#type-BookmarkTreeNodeUnmodifiable) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)
<!--
// Copyright 2015 The Chromium Authors. All rights reserved.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,8 @@ l10n:

在指定的 `parentId` 的 {{WebExtAPIRef("bookmarks.BookmarkTreeNode", "BookmarkTreeNode")}} 下创建一个书签或文件夹。要创建文件夹,请省略或留空 {{WebExtAPIRef("bookmarks.CreateDetails", "CreateDetails", "url")}} 参数。

> **警告:** 如果你的扩展尝试在书签树的根节点中创建新书签,则会引发错误:“_The bookmark root cannot be modified_”,并且不会创建该书签。
> [!WARNING]
> 如果你的扩展尝试在书签树的根节点中创建新书签,则会引发错误:“_The bookmark root cannot be modified_”,并且不会创建该书签。
这是一个返回 [`Promise`](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Promise) 的异步函数。

Expand All @@ -30,7 +31,8 @@ let createBookmark = browser.bookmarks.create(

一个 [`Promise`](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Promise),其会兑现一个 {{WebExtAPIRef('bookmarks.BookmarkTreeNode', 'BookmarkTreeNode')}} 对象,该对象描述了新创建的书签节点。

> **备注:** 如果你创建多个书签,由于此 API 是异步的,因此创建调用可能以任何顺序处理。因此,在 {{WebExtAPIRef('bookmarks.BookmarkTreeNode', 'BookmarkTreeNode')}} 中返回的每个书签的索引值可能会在所有创建调用完成之前发生变化或是未知的。如果书签的索引对你的扩展很重要,那么在创建多个书签时,扩展应等待每个 `bookmarks.create` 调用完成后再创建下一个书签。等待可确保每个书签的索引不受在原始调用正在进行时并发执行的创建调用的影响。
> [!NOTE]
> 如果你创建多个书签,由于此 API 是异步的,因此创建调用可能以任何顺序处理。因此,在 {{WebExtAPIRef('bookmarks.BookmarkTreeNode', 'BookmarkTreeNode')}} 中返回的每个书签的索引值可能会在所有创建调用完成之前发生变化或是未知的。如果书签的索引对你的扩展很重要,那么在创建多个书签时,扩展应等待每个 `bookmarks.create` 调用完成后再创建下一个书签。等待可确保每个书签的索引不受在原始调用正在进行时并发执行的创建调用的影响。
## 示例

Expand All @@ -55,7 +57,8 @@ createBookmark.then(onCreated);

{{Compat}}

> **备注:** 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)
> [!NOTE]
> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)
<!--
// Copyright 2015 The Chromium Authors. All rights reserved.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,8 @@ l10n:

{{WebExtExamples}}

> **备注:** 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/#type-CreateDetails) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)
> [!NOTE]
> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/#type-CreateDetails) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)
<!--
// Copyright 2015 The Chromium Authors. All rights reserved.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,8 @@ gettingBookmarks.then(onFulfilled, onRejected);

{{Compat}}

> **备注:** 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)
> [!NOTE]
> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)
<!--
// Copyright 2015 The Chromium Authors. All rights reserved.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,8 @@ gettingChildren.then(onFulfilled, onRejected);

{{Compat}}

> **备注:** 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/#method-getChildren) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)
> [!NOTE]
> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/#method-getChildren) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)
<!--
// Copyright 2015 The Chromium Authors. All rights reserved.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,8 @@ browser.bookmarks.getRecent(1).then(onFulfilled, onRejected);

{{Compat}}

> **备注:** 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/#method-getRecent) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)
> [!NOTE]
> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/#method-getRecent) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)
<!--
// Copyright 2015 The Chromium Authors. All rights reserved.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -74,7 +74,8 @@ browser.bookmarks.getSubTree(subTreeID).then(logSubTree, onRejected);

{{Compat}}

> **备注:** 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/#method-getSubTree) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)
> [!NOTE]
> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/#method-getSubTree) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)
<!--
// Copyright 2015 The Chromium Authors. All rights reserved.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,8 @@ gettingTree.then(logTree, onRejected);

{{Compat}}

> **备注:** 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/#method-getTree) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)
> [!NOTE]
> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/#method-getTree) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)
<!--
// Copyright 2015 The Chromium Authors. All rights reserved.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -72,7 +72,8 @@ l10n:

{{WebExtExamples("h2")}}

> **备注:** 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)
> [!NOTE]
> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)
<!--
// Copyright 2015 The Chromium Authors. All rights reserved.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,8 @@ l10n:

**`bookmarks.move()`** 方法将指定的 {{WebExtAPIRef("bookmarks.BookmarkTreeNode", "BookmarkTreeNode")}} 移动到书签树中的指定目的地。这允许你将书签移动到新文件夹或文件夹内的位置。

> **警告:** 如果你的扩展尝试将书签移动到书签树根节点,则调用将引发错误,并显示消息:“_The bookmark root cannot be modified_”,移动操作将不会完成。
> [!WARNING]
> 如果你的扩展尝试将书签移动到书签树根节点,则调用将引发错误,并显示消息:“_The bookmark root cannot be modified_”,移动操作将不会完成。
这是一个返回 [`Promise`](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Promise) 的异步函数。

Expand Down Expand Up @@ -41,7 +42,8 @@ let movingBookmark = browser.bookmarks.move(

如果与 `id` 参数对应的节点无法找到,则该 Promise 将以错误消息拒绝。

> **备注:** 如果移动多个书签,由于此 API 是异步的,移动调用可能以任何顺序处理。因此,每个书签的索引值在 {{WebExtAPIRef('bookmarks.BookmarkTreeNode', 'BookmarkTreeNode')}} 中返回之前可能会改变或是未知的。如果书签的索引与你的扩展相关,则在移动下一个书签之前,扩展应该等待每个 `bookmarks.move` 调用完成。等待确保每个书签关联的索引不会受到在原始调用进行时并发执行移动调用的影响。
> [!NOTE]
> 如果移动多个书签,由于此 API 是异步的,移动调用可能以任何顺序处理。因此,每个书签的索引值在 {{WebExtAPIRef('bookmarks.BookmarkTreeNode', 'BookmarkTreeNode')}} 中返回之前可能会改变或是未知的。如果书签的索引与你的扩展相关,则在移动下一个书签之前,扩展应该等待每个 `bookmarks.move` 调用完成。等待确保每个书签关联的索引不会受到在原始调用进行时并发执行移动调用的影响。
## 示例

Expand All @@ -68,7 +70,8 @@ movingBookmark.then(onMoved, onRejected);

{{Compat}}

> **备注:** 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/#method-move) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)
> [!NOTE]
> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/#method-move) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)
<!--
// Copyright 2015 The Chromium Authors. All rights reserved.
Expand Down
Loading

0 comments on commit 5349f08

Please sign in to comment.