其他宏

常用宏 中列出的宏不同,本文档中记录的宏使用频率较低,或者仅在特定环境中使用,或者已被弃用。

特殊环境

此宏仅在特定环境中使用,例如特定 API 参考。

  • RFC 创建一个指向指定 RFC 的链接,RFC 编号作为参数。语法为:{{RFC(number)}}。例如,{{RFC(2616)}} 将变为 RFC 2616.

着陆页组件

我们有一系列宏可用于自动生成着陆页的内容。以下是这些宏。

子页面列表

  • ListSubpages 生成一个无序列表,其中包含当前页面所有直接子页面的链接;这对于自动生成文档集的目录很有用。
  • LandingPageListSubpages 输出当前页面所有直接子页面的双列定义列表,其标题作为 <dt>,其 SEO 摘要作为 <dd>。这使得自动生成比较美观的着陆页变得容易。
  • APIListAlpha 构建当前页面子页面的列表,格式化为 API 术语列表,按首字母划分。有三个参数。第一个参数为 0 表示包含所有顶级子页面,1 表示不包含名称中包含 "." 的子页面。第二个和第三个参数允许您添加文本作为每个链接名称的一部分显示。这可以用于为元素链接添加 “<” 和 “>”,或者在方法名称列表的末尾添加 "()"。
  • SubpagesWithSummaries 构建当前页面所有直接子页面的定义列表。没有其他格式。您可以使用 LandingPageListSubpages 获取用于多列着陆页的双列列表。

我们有一个专门用于在内容中创建 链接列表 的宏。

  • QuickLinksWithSubpages 创建一个链接列表,该列表由当前页面(或给定的页面)下面的页面组成。最多生成两级深度。