From 310fd066e91f454b990372ffa30e803cc8120975 Mon Sep 17 00:00:00 2001 From: Florian Merz Date: Thu, 11 Feb 2021 12:56:40 +0100 Subject: unslug zh-cn: move --- .../macros/commonly-used_macros/index.html | 222 +++++++++++++++++++++ .../mdn/structures/macros/custom_macros/index.html | 222 --------------------- 2 files changed, 222 insertions(+), 222 deletions(-) create mode 100644 files/zh-cn/mdn/structures/macros/commonly-used_macros/index.html delete mode 100644 files/zh-cn/mdn/structures/macros/custom_macros/index.html (limited to 'files/zh-cn/mdn/structures/macros') 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 new file mode 100644 index 0000000000..3809bb2094 --- /dev/null +++ b/files/zh-cn/mdn/structures/macros/commonly-used_macros/index.html @@ -0,0 +1,222 @@ +--- +title: 常用的宏 +slug: MDN/Structures/Macros/Custom_macros +tags: + - CSS + - 参考 + - 宏 + - 结构 +translation_of: MDN/Structures/Macros/Commonly-used_macros +--- +
{{MDNSidebar}}
+ +

本页列举了许多被创建用于 MDN 的通用宏。对于使用这些宏的基础信息，见使用宏和使用链接宏。对于不常用的，只在特定上下文或不赞成使用的宏的信息，参见其它宏。这里也有一份 MDN 上所有宏的完整列表。

+ +

对于适合你使用的样式，另见 CSS 样式指南。

+ +

链接

+ +

创建一个单独的超链接

+ +

通常来说，你不需要使用宏来创建任意的链接。使用编辑器界面上的链接按钮创建链接。

+ + + +

链接到参考文档页面

+ +

有各种宏用来链接到 MDN 上特定参考区域里的页面。

+ + + +

链接到漏洞和互联网中继聊天（IRC）

+ + + +

用于多页面指南的导航帮助

+ +

{{TemplateLink("Previous")}}，{{TemplateLink("Next")}}，和 {{TemplateLink("PreviousNext")}} 提供导航控制用于序列中的部分文章。对于单向模板，唯一需要的参数是序列中前一篇或后一篇文章的维基（wiki）地址。对于 {{TemplateLink("PreviousNext")}}，需要两个适当的文章地址作为参数。第一个参数用于前一篇文章，而第二个用于后一篇文章。

+ +

代码示例

+ +

实样

+ + + +

附上的示例文件

+ + + +

侧边栏组

+ +

There templates for almost every large collection of pages. 它们通常链接回参考/指南/教程的主页面（这经常被需要，因为我们的面包屑有时做不到这样）并把文章放入适当的类别中。

+ + + +

（译者注：通过在 background-color 页面测试，编辑页面中 "Summary" 上一行的 {{CSSRef}} 用于生成页面左侧的 CSS 参考链接的侧边栏）

+ +

通用格式化

+ +

API 文档的行内指示器

+ +

{{TemplateLink("optional_inline")}} 和 {{TemplateLink("ReadOnlyInline")}} 被用于 API 文档，通常当描述一个对象的属性或一个函数的参数的列表。

+ +

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

+ +
+
isCustomObject {{ReadOnlyInline()}}
+
如果为真，指示该对象是一个自定义对象。
+
parameterX {{ optional_inline() }}
+
Blah blah blah...
+
+ +

状态和兼容性指示器

+ +

没有附加参数的行内指示器

+ +

非标准的

+ +

{{TemplateLink("non-standard_inline")}} 插入一个行内标记指示当前 API 还没有被标准化，并且不在一个标准行径上。

+ +
语法
+ +

\{{non-standard_inline}}

+ +
示例
+ + + +

实验性的

+ +

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

+ +
语法
+ +

\{{experimental_inline}}

+ +
示例
+ + + +

提供明确技术的指示器

+ +

在这些宏当中，其参数（在明确规定下）应该是 "html", "js", "css" 或 "gecko" 当中的一个字符串，其后跟着版本号。

+ +

不赞成的

+ +

{{TemplateLink("deprecated_inline")}} 插入一个不赞成的行内标记来劝阻一个官方不赞成的 API 的使用。注意：“不赞成的”表示该项不该再被使用，但是仍然可用。如果你想表示它不再起作用了，使用术语“已废弃”。

+ +

不要在任何浏览器不可知的区域（ HTML, APIs, JS, CSS, … ）内使用参数。

+ +
语法
+ +

\{{deprecated_inline}} 或 \{{deprecated_inline("gecko5")}}

+ +
示例
+ + + +

已废弃的

+ +

{{TemplateLink("obsolete_inline")}} 插入一个已废弃的行内标记来阻止使用，比如正式废弃的一个函数，方法或属性。

+ +

不要在任何浏览器不可知的区域（ HTML, APIs, JS, CSS, … ）内使用参数。

+ +
语法
+ +

\{{obsolete_inline}} 或 \{{obsolete_inline("js1.8.5")}}

+ +
示例
+ + + +

模板徽标

+ +

这些宏大多数被用于 WebAPI 页面。见 {{anch("Creating new badges")}} 关于创建一个新徽标的信息。

+ +

页面或区域标头指示

+ +

这些模板与上述内联模板具有相同的语义。 模板应直接放置在参考页面的主页标题（或面包屑导航，如果可用）的下面。 它们也可以用于标记页面上的某个部分。

+ + + +

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

+ +

 {{TemplateLink("AvailableInWorkers")}} 宏插入一个本地化的指示框，指示一个功能在Web worker 上下文中可用。

+ +

版本信息宏

+ +

这些宏被用来指示这个语段只与一个产品的特定版本有关。

+ + + +
    +
+ +
    +
diff --git a/files/zh-cn/mdn/structures/macros/custom_macros/index.html b/files/zh-cn/mdn/structures/macros/custom_macros/index.html deleted file mode 100644 index 3809bb2094..0000000000 --- a/files/zh-cn/mdn/structures/macros/custom_macros/index.html +++ /dev/null @@ -1,222 +0,0 @@ ---- -title: 常用的宏 -slug: MDN/Structures/Macros/Custom_macros -tags: - - CSS - - 参考 - - 宏 - - 结构 -translation_of: MDN/Structures/Macros/Commonly-used_macros ---- -
{{MDNSidebar}}
- -

本页列举了许多被创建用于 MDN 的通用宏。对于使用这些宏的基础信息，见使用宏和使用链接宏。对于不常用的，只在特定上下文或不赞成使用的宏的信息，参见其它宏。这里也有一份 MDN 上所有宏的完整列表。

- -

对于适合你使用的样式，另见 CSS 样式指南。

- -

链接

- -

创建一个单独的超链接

- -

通常来说，你不需要使用宏来创建任意的链接。使用编辑器界面上的链接按钮创建链接。

- - - -

链接到参考文档页面

- -

有各种宏用来链接到 MDN 上特定参考区域里的页面。

- - - -

链接到漏洞和互联网中继聊天（IRC）

- - - -

用于多页面指南的导航帮助

- -

{{TemplateLink("Previous")}}，{{TemplateLink("Next")}}，和 {{TemplateLink("PreviousNext")}} 提供导航控制用于序列中的部分文章。对于单向模板，唯一需要的参数是序列中前一篇或后一篇文章的维基（wiki）地址。对于 {{TemplateLink("PreviousNext")}}，需要两个适当的文章地址作为参数。第一个参数用于前一篇文章，而第二个用于后一篇文章。

- -

代码示例

- -

实样

- - - -

附上的示例文件

- - - -

侧边栏组

- -

There templates for almost every large collection of pages. 它们通常链接回参考/指南/教程的主页面（这经常被需要，因为我们的面包屑有时做不到这样）并把文章放入适当的类别中。

- - - -

（译者注：通过在 background-color 页面测试，编辑页面中 "Summary" 上一行的 {{CSSRef}} 用于生成页面左侧的 CSS 参考链接的侧边栏）

- -

通用格式化

- -

API 文档的行内指示器

- -

{{TemplateLink("optional_inline")}} 和 {{TemplateLink("ReadOnlyInline")}} 被用于 API 文档，通常当描述一个对象的属性或一个函数的参数的列表。

- -

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

- -
-
isCustomObject {{ReadOnlyInline()}}
-
如果为真，指示该对象是一个自定义对象。
-
parameterX {{ optional_inline() }}
-
Blah blah blah...
-
- -

状态和兼容性指示器

- -

没有附加参数的行内指示器

- -

非标准的

- -

{{TemplateLink("non-standard_inline")}} 插入一个行内标记指示当前 API 还没有被标准化，并且不在一个标准行径上。

- -
语法
- -

\{{non-standard_inline}}

- -
示例
- - - -

实验性的

- -

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

- -
语法
- -

\{{experimental_inline}}

- -
示例
- - - -

提供明确技术的指示器

- -

在这些宏当中，其参数（在明确规定下）应该是 "html", "js", "css" 或 "gecko" 当中的一个字符串，其后跟着版本号。

- -

不赞成的

- -

{{TemplateLink("deprecated_inline")}} 插入一个不赞成的行内标记来劝阻一个官方不赞成的 API 的使用。注意：“不赞成的”表示该项不该再被使用，但是仍然可用。如果你想表示它不再起作用了，使用术语“已废弃”。

- -

不要在任何浏览器不可知的区域（ HTML, APIs, JS, CSS, … ）内使用参数。

- -
语法
- -

\{{deprecated_inline}} 或 \{{deprecated_inline("gecko5")}}

- -
示例
- - - -

已废弃的

- -

{{TemplateLink("obsolete_inline")}} 插入一个已废弃的行内标记来阻止使用，比如正式废弃的一个函数，方法或属性。

- -

不要在任何浏览器不可知的区域（ HTML, APIs, JS, CSS, … ）内使用参数。

- -
语法
- -

\{{obsolete_inline}} 或 \{{obsolete_inline("js1.8.5")}}

- -
示例
- - - -

模板徽标

- -

这些宏大多数被用于 WebAPI 页面。见 {{anch("Creating new badges")}} 关于创建一个新徽标的信息。

- -

页面或区域标头指示

- -

这些模板与上述内联模板具有相同的语义。 模板应直接放置在参考页面的主页标题（或面包屑导航，如果可用）的下面。 它们也可以用于标记页面上的某个部分。

- - - -

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

- -

 {{TemplateLink("AvailableInWorkers")}} 宏插入一个本地化的指示框，指示一个功能在Web worker 上下文中可用。

- -

版本信息宏

- -

这些宏被用来指示这个语段只与一个产品的特定版本有关。

- - - -
    -
- -
    -
-- cgit v1.2.3-54-g00ecf