使用宏

rari 后端是 MDN 的构建系统,它提供了一种用于常见任务的宏语法。

在内容中使用宏

要使用宏,您需要将宏的名称放在一对双大括号({{ }})中,并附带其参数(如果有)。

{{macroname(parameter-list)}}

关于宏调用的几点说明

  • 宏名称区分大小写,但会尽力纠正常见的拼写错误;即使宏名称中有大写字母,您也可以全部使用小写字母,并且可以大写一个通常以小写字母开头的宏名称。
  • 参数之间用逗号分隔。
  • 如果没有参数,您可以完全省略括号;{{macroname()}}{{macroname}} 是相同的。
  • 数字参数可以加引号,也可以不加。这取决于您(但是,如果您的版本号包含多个小数点,则需要加引号)。

宏可以很简单,只是插入一大块文本或交换 MDN 中其他部分的内容,也可以很复杂,通过搜索网站的各个部分、样式化输出和添加链接来构建内容的整个索引。

您可以在 常用宏 页面上阅读我们最常用的宏。不太常用的宏在 其他宏 文档中有说明。

另见