From a70214aa3d2afca518337b7e5ddc1bba122c685f Mon Sep 17 00:00:00 2001 From: Dongsen Date: Tue, 12 Oct 2021 22:11:23 +0800 Subject: update macros translate for zh-CN (#2174) * rebase #2173 * revert title anchor translate * update deprecate translate * add the newest update for EmbedGHLiveSample translate --- .../macros/commonly-used_macros/index.html | 72 ++++++++--------- files/zh-cn/mdn/structures/macros/index.html | 6 +- files/zh-cn/mdn/structures/macros/other/index.html | 91 +++++++++++----------- 3 files changed, 80 insertions(+), 89 deletions(-) (limited to 'files/zh-cn') diff --git a/files/zh-cn/mdn/structures/macros/commonly-used_macros/index.html b/files/zh-cn/mdn/structures/macros/commonly-used_macros/index.html index 313dbd3a22..a29edc2bf8 100644 --- a/files/zh-cn/mdn/structures/macros/commonly-used_macros/index.html +++ b/files/zh-cn/mdn/structures/macros/commonly-used_macros/index.html @@ -11,13 +11,13 @@ original_slug: MDN/Structures/Macros/Custom_macros ---
{{MDNSidebar}}
-

本页列举了一些 MDN 中的常用宏命令。对于使用这些宏的入门信息，请阅读使用宏这篇文章。还有一些不常用或只在特定内容中适用，以及一些不赞成使用的宏的信息，参见其它宏。在我们的 GitHub Repo 中，可以找到MDN 上所有宏的完整列表。

+

本页列举了一些 MDN 中的常用宏命令。对于使用这些宏的入门信息，请阅读使用宏这篇文章。

-

对于调整页面样式相关的宏，另见 CSS 样式指南。

+

还有一些不常用或只在特定内容中适用，以及一些不赞成使用的宏的信息，参见其它宏。对于调整页面样式相关的宏，另见CSS 样式指南。

链接

-

为了简化一些常见超链接的创建工作——如指向站内的技术参考页面、术语库以及其他主题的链接——我们提供了丰富的宏来完成这些工作

+

为了简化一些常见超链接的创建工作——如指向站内的技术参考页面、术语库以及其他主题的链接，我们提供了丰富的宏来完成这些工作

我们推荐使用宏来创建这些常见的链接，这样不但简洁，对翻译工作也很友好——使用宏创建的术语库和技术参考链接不需要翻译者再做处理，这些宏可提供正确的链接，使其符合当前页面的语言。

@@ -45,9 +45,7 @@ original_slug: MDN/Structures/Macros/Custom_macros

链接到 MDN 的参考文档页面

@@ -142,26 +140,23 @@ original_slug: MDN/Structures/Macros/Custom_macros

多页面间的导航栏

-

- {{TemplateLink("Previous")}}、{TemplateLink("Next")}}、{{TemplateLink("PreviousNext")}}、{{TemplateLink("PreviousMenuNext")}}这几个宏可以在页面中创建导航栏，帮助读者按照文章的先后顺序阅读。其中的参数需要填入目标页面在 MDN 中的位置，你可以在页面的网址中找到所需的信息。例如 JavaScript 中的继承这个页面，链接地址为“https://developer.mozilla.org/zh-CN/docs/Learn/JavaScript/Objects/Inheritance”，那么它在 MDN 中的位置就可以用Learn/JavaScript/Objects/Object_prototypes描述。

+

{{TemplateLink("Previous")}}、{TemplateLink("Next")}} 和 {{TemplateLink("PreviousNext")}} 这几个宏可以在页面中创建导航栏，帮助读者按照文章的先后顺序阅读。其中的参数需要填入目标页面在 MDN 中的位置，你可以在页面的网址中找到所需的信息。对于 {{TemplateLink("PreviousNext")}}，需要的两个参数是相应文章的 Wiki 位置。第一个参数用于上一篇文章，第二个参数用于下一篇文章。

代码示例

动态示例

@@ -179,8 +174,7 @@ original_slug: MDN/Structures/Macros/Custom_macros

API 文档的行内指示器

-

{{TemplateLink("optional_inline")}} 和 {{TemplateLink("ReadOnlyInline")}} 被用于 API 文档，通常可以用来描述一个对象的属性是只读的或一个函数的参数是可省略的。 -

+

{{TemplateLink("optional_inline")}} 和 {{TemplateLink("ReadOnlyInline")}} 被用于 API 文档，通常可以用来描述一个对象的属性是只读的或一个函数的参数是可省略的。

用法: \{{optional_inline}} 或 \{{ReadOnlyInline}} 。示例：

@@ -195,48 +189,48 @@ original_slug: MDN/Structures/Macros/Custom_macros

无需参数的行内指示器

-

非标准

+

非标准的

-

{{TemplateLink("non-standard_inline")}} 指示当前 API 还没有被标准化，也没有进入标准化议程。

+

{{TemplateLink("non-standard_inline")}} 插入一个行内标记，表示 API 尚未标准化并且不在标准轨道上。

-
语法
+
语法
-

\{{non-standard_inline}}

+

\{{Non-standard_Inline}}

示例

实验性的

-

{{TemplateLink("experimental_inline")}} 指示当前 API 没有被广泛支持，且将来可能会有所修改。

+

{{TemplateLink("Experimental_Inline")}} 插入一个行内标记，表示当前 API 没有被广泛地实现，并且在以后可能会改变。

语法
-

\{{experimental_inline}}

+

\{{Experimental_Inline}}

示例

代表明确技术参考的行内指示器

-

不赞成的

+

已弃用

-

{{TemplateLink("deprecated_inline")}}会插入一个带有“不赞成”的行内指示器，即{{Deprecated_Inline}}。这表示不鼓励使用该 API ，或其已经被移除。

+

{{TemplateLink("deprecated_inline")}}会插入一个带有 ({{Deprecated_Inline}}) 的标记以阻止使用官方不推荐使用（或已删除）的 API。

语法
-

\{{deprecated_inline}}>

+

\{{Deprecated_Inline}}

示例

页面或章节头部的指示器

@@ -244,26 +238,24 @@ original_slug: MDN/Structures/Macros/Custom_macros

下列指示器的含义，类似于上述的内联指示器。这些组件应直接放置在技术参考页面的标题（或面包屑导航栏）下，也可以用于标记页面上的某个小节。

-

指示一个功能在 web workers 中可用

+

表明某个功能在 Web Worker 中可用的指示器

-

{{TemplateLink("AvailableInWorkers")}} 宏插入一个本地化的指示框，指示一个功能在Web worker上下文中可用。它还有一个可选参数，当带有notservice时，表示该功能在 web worker 中可用但在 servcie worker 中不可用。

+

{{TemplateLink("AvailableInWorkers")}} 宏插入一个本地化的注释框，指示一个功能在 Web worker 上下文中可用。它还有一个可选参数，当带有notservice时，表示该功能在 Web Worker 中可用但在 Servcie Worker 中不可用。

语法
-

\{{AvailableInWorkers}} - \{{AvailableInWorkers("notservice")}}

+
\{{AvailableInWorkers}}
+\{{AvailableInWorkers("notservice")}}
Examples
-
{{AvailableInWorkers}} +
+ {{AvailableInWorkers}} {{AvailableInWorkers("notservice")}}
diff --git a/files/zh-cn/mdn/structures/macros/index.html b/files/zh-cn/mdn/structures/macros/index.html index 67cd0470bd..170c06ded8 100644 --- a/files/zh-cn/mdn/structures/macros/index.html +++ b/files/zh-cn/mdn/structures/macros/index.html @@ -17,13 +17,13 @@ translation_of: MDN/Structures/Macros

宏是如何实现的

-

MDN 使用的宏基于运行于服务器上的 JavaScript 代码来实现，并由 Node.js 解释执行。在此之上，已经实现了一个丰富的工具库，让宏可以与这个平台以及其中的内容进行交互。

+

MDN 使用的宏基于运行于服务器上的 JavaScript 代码来实现的，并由 Node.js 解释执行。在此之上，已经实现了一个丰富的工具库，让宏可以与这个平台以及其中的内容进行交互。

在文章中使用宏

要在文章中实际使用宏，只需将对宏的调用和可能需要的参数写在一对双括号中，如下：

-
\{{macroname(parameter-list)}}
+
\{{macroname(parameter-list)}}

关于宏调用的一些注意事项：

@@ -39,4 +39,4 @@ translation_of: MDN/Structures/Macros

宏既可以用来做一些简单的工作，比如插入更大的文本块或用 MDN 的替换文章中的内容。也可以通过搜索站点的各个部分，设置输出样式和添加链接来构建整个内容索引。

-

你可以在常用的宏页面看到一些我们最常用到的宏，还可以在我们 Github 的仓库中，浏览所有可用的宏。大多数宏顶部的注释中，都有内置的文档帮助你了解它的作用。

+

你可以在常用的宏页面看到一些我们最常用到的宏，还可以在我们 Github 的仓库中，浏览所有可用的宏。大多数宏顶部的注释中，都有内置的文档帮助你了解它的作用。

diff --git a/files/zh-cn/mdn/structures/macros/other/index.html b/files/zh-cn/mdn/structures/macros/other/index.html index d9dd6f2ea3..c8a8de7a85 100644 --- a/files/zh-cn/mdn/structures/macros/other/index.html +++ b/files/zh-cn/mdn/structures/macros/other/index.html @@ -1,5 +1,5 @@ --- -title: 其他需要注意的宏 +title: 其他宏 slug: MDN/Structures/Macros/Other tags: - Macros @@ -7,86 +7,85 @@ tags: ---
{{MDNSidebar}}
-

In contrast to the macros listed in Commonly-used macros, the macros documented in this article are used infrequently or only in specific contexts, or are deprecated.

+

与 常用的宏 中列出的宏相比，本文中记录的宏很少使用或仅在特定上下文中使用，或者已弃用。

-

Special contexts

+

特殊情况

-

These macros are used only with particular contexts, such as a specific API reference.

+

这些宏仅用于特定的上下文，例如特定的 API 参考。

-

Landing page components

+

着陆页组件

-

We have an assortment of macros that can be used to automatically generate the contents of landing pages. Here they are.

+

我们有各种各样的宏，可用于自动生成着陆页面的内容。请参考：

-

Lists of subpages

+

子页面列表

- + -

We have some macros specifically designed to create quicklinks:

+

我们有一些宏，专门用于创建 快速链接:

-

Transclusion

+

嵌入

-

Transclusion is the embedding of part or all of one page into another. Exercise caution when using this macro, to ensure that the transcluded content makes sense in the context of the page it is embedded into.

+

嵌入是将一个页面的部分或全部嵌入到另一个页面中。使用此宏时要小心，以确保嵌入的内容在其嵌入的页面上下文中有意义。

-

page lets you embed some or all of a specific page into a document. It accepts five parameters:

+

page 允许您将特定页面的部分或全部嵌入到文档中。它接受五个参数：

    -
  1. The URI of the page to transclude. For example, "/en-US/docs/MDN/About".
    2. -
  2. The name of the section within the page to transclude. This can be specified either as the title string or as the ID of a block to copy over. If not specified, the entire article is transcluded. {{optional_inline}}
    3. -
  3. The revision number of the page version to transclude. This feature is not currently implemented, but would allow including text from specific versions of an article. {{unimplemented_inline}}
    4. -
  4. A Boolean value indicating whether or not to show the heading of the top-level section being transcluded. This is useful if you wish to specify your own heading. The default value is false, meaning the heading is not included by default. {{optional_inline}}
    5. -
  5. The heading level to use as the top heading level. This adjusts the outermost first-discovered level of the transcluded content to the specified number, and all other headings correspondingly. This lets you include content that has its own headings but adjust them to match the heading level at which you're including them. If you don't specify this value, the headings are not adjusted. {{unimplemented_inline}}
    6. +
  6. 要嵌入的页面的 URI。例如 "/en-US/docs/MDN/About"。
    7. +
  7. 页面中要嵌入的部分的名称。这可以指定为标题字符串或要复制的块的 ID。如果未指定，则整篇文章被嵌入。 {{optional_inline}}
    8. +
  8. 要嵌入的页面版本的修订号。此功能目前尚未实现，但允许包含来自文章特定版本的文本。 {{unimplemented_inline}}
    9. +
  9. 一个布尔值，指示是否显示被嵌入的顶级部分的标题。如果您希望指定自己的标题，这很有用。默认值为 false，表示默认情况下不包含标题。 {{optional_inline}}
    10. +
  10. 用作顶部标题级别的标题级别。这会将嵌入内容的最外层首次发现级别调整为指定数量，并相应地调整所有其他标题。这使您可以包含具有自己标题的内容，但可以调整它们以匹配您包含它们的标题级别。如果不指定此值，则不会调整标题。 {{unimplemented_inline}}
-

Example without heading

+

没有标题的例子

\{{Page("/en-US/docs/MDN/About", "How you can help")}}

-

Result:

+

输出以下内容：

-

{{Page("/en-US/docs/MDN/About", "How you can help")}}

+{{Page("/en-US/docs/MDN/About", "How you can help")}} -

Example with heading

+

带标题的例子

\{{Page("/en-US/docs/MDN/About", "How you can help", 0, 1)}}

-

Result:

+

输出以下内容：

-

{{Page("/en-US/docs/MDN/About", "How you can help", 0, 1)}}

+{{Page("/en-US/docs/MDN/About", "How you can help", 0, 1)}} -

Deprecated

+

不赞成的

-

These macros have been replace by other ways of doing the same thing, and should no longer be used. If you find them in existing articles, please replace them.

+

这些宏已被其他做同样事情的方式所取代，不应再使用。如果您在现有文章中找到它们，请替换它们。

-

Linking

+

链接

-- cgit v1.2.3-54-g00ecf