From 06b1b9f137e15e0d78de6b372971a3926403650c Mon Sep 17 00:00:00 2001
From: PocketZ <45301505+pocketdr@users.noreply.github.com>
Date: Thu, 12 Aug 2021 12:18:20 +0800
Subject: Update MDN/Structures/Macros and MDN/Yari of l10n-zh (#2024)
* Create MDN/Tools/KumaScript
* Create MDN/Tools/KumaScript/Troubleshooting
* Create MDN/Tools/KumaScript
* Create MDN/Tools/KumaScript/Troubleshooting
* Update MDN/Structures/Macros
* Update MDN/Yari
* Update content of Macros and KumaScript
* delete no translated articel
---
files/zh-cn/mdn/structures/macros/index.html | 34 ++++++++++++----------------
1 file changed, 15 insertions(+), 19 deletions(-)
(limited to 'files/zh-cn/mdn/structures/macros/index.html')
diff --git a/files/zh-cn/mdn/structures/macros/index.html b/files/zh-cn/mdn/structures/macros/index.html
index b41123ab3f..4227374bac 100644
--- a/files/zh-cn/mdn/structures/macros/index.html
+++ b/files/zh-cn/mdn/structures/macros/index.html
@@ -1,5 +1,5 @@
---
-title: Macros
+title: 使用宏
slug: MDN/Structures/Macros
tags:
- Guide
@@ -11,36 +11,32 @@ translation_of: MDN/Structures/Macros
---
{{MDNSidebar}}
-Kuma 平台为 MDN 提供了强大的宏系统——KumaScript，使得 MDN 能够自动地去做各种东西。本文提供一些信息以便大家知道如何使用 MDN 上的文章内的宏。
+为了自动化执行某些工作，Yari 平台提供了一个强大的宏系统——KumaScript。本文提供了一些相关信息，方便你在参与编辑 MDN 时，使用这些宏。
-鉴于本文只是 KumaScript 的简介，KumaScript 指南提供了更深入的内容。
+本文只是简要介绍了 KumaScript，KumaScript 指南提供了更深入的内容，帮助你使用和掌握它。
-宏是如何实现的
+宏是如何实现的
-MDN使用的Macros(宏)是基于Node.js执行环境，并在服务端执行运行。这里包括了大量的代码库，另外对此还提供了丰富的wiki说明文档内容。如果你希望能学习到更多的内容，可以查看 KumaScript 指南， KumaScript reference 则提供了更多关于这些代码库和KumaScript的API的实现机理。
+MDN 使用宏是基于运行于服务器上的 JavaScript 代码实现的，并由 Node.js 解释执行。在此之上，已经实现了一个丰富的工具库，让宏可以与这个平台及其中的内容进行互动。
-在文章中使用宏
+在文章中使用宏
-要实际使用宏，只需将对宏的调用括在一对双括号中，其参数（如果有）括在括号中;如下：
+要实际使用宏，只需将对宏的调用和可能需要的参数写在一对双括号中，如下：
\{{macroname(parameter-list)}}
关于宏调用的一些注意事项：
- - 宏名称区分大小写，但有些尝试是为了纠正常见的大写错误;即使宏名称在其中使用大写，您也可以使用全部小写，并且您可以将名称通常以小写字母开头的宏大写。
- - 参数以逗号分隔
- - 如果没有参数，您可以完全省略括号;
\{{macroname()}} 和 \{{macroname}} 完全相同。
- - 数字参数可以是引号，也可以不是。这取决于您（但是，如果您的版本号中包含多个小数，则需要在引号中）
- - 如果您遇到错误，请仔细检查您的代码。如果仍然无法弄清楚发生了什么，请参阅Troubleshooting KumaScript errors以获取帮助。
+ - 宏的名称区分大小写，但一些常见的大小写错误也可以在执行时被纠正。比如将某个名称中含有大写的宏，全部使用小写字母，或者将某些名字以小写开头的宏大写。
+ - 参数以逗号分隔。
+ - 如果没有参数，括号可以省略：
\{{macroname()}} 和 \{{macroname}} 的效果是。
+ - 数字参数可以是引号，也可以不是。这取决于您（但是，像版本号这类可能被识别成小数的参数，则包含在引号中）
+ - 如果遇到错误，请先仔细检查代码。如果仍然无法弄清楚发生了什么，请参阅排查 KumaScript 中的错误以获取帮助。
-宏被高度缓存;对于任何一组输入值（参数和环境值，例如运行宏的URL），结果都会被存储和重用。这意味着宏仅在输入发生变化时才实际运行。
+宏的几乎所有执行结果都会被缓存，以便被重用来加快执行速度。这意味着宏仅在输入发生变化时才实际运行，包括调用时的参数以及环境值（例如这个宏被调用时所在的路径）。
-
-
注意: 您可以通过在浏览器中强制刷新页面（即转移重新加载）来强制重新评估页面上的所有宏。
-
宏既可以用来做一些简单的工作，比如插入更大的文本块或从MDN的另一部分交换内容一样简单，也可以通过搜索站点的各个部分，设置输出样式和添加链接来构建整个内容索引。
-宏可以像插入更大的文本块或从MDN的另一部分交换内容一样简单，也可以通过搜索站点的各个部分，设置输出样式和添加链接来构建整个内容索引。
-
-您可以在Commonly-used macros页面上阅读我们最常用的宏;另外，这里有complete list of all macros。大多数宏都有内置的文档，作为顶部的注释。
+您可以在常用的宏页面看到一些我们最常用到的宏，还可以在我们 Github 的仓库中，浏览所有可用的宏。大多数宏顶部的注释中，都有内置的文档帮助你了解它的作用。
--
cgit v1.2.3-54-g00ecf