其他宏

常用宏 中列出的宏不同,本文档中介绍的宏使用频率较低,或者仅在特定上下文中才能使用,或者已弃用。

特定上下文

此宏仅用于特定上下文,例如特定的 API 参考。

  • RFC 根据 RFC 的编号创建一个指向该 RFC 的链接。语法为 {{RFC(number)}}。例如,{{RFC(2616)}} 会变成 RFC 2616

登陆页面组件

我们提供了一系列宏,可用于自动生成登陆页面的内容。它们如下。

子页面列表

  • ListSubpages 生成一个无序列表,其中包含指向当前页面所有直接子页面的链接;这对于自动生成文档集的目录非常有用。
  • SubpagesWithSummaries 构建一个定义列表,其中包含当前页面所有直接子页面的链接,其标题作为 <dt>,其 SEO 摘要作为 <dd>。这使得自动生成相当吸引人的登陆页面变得容易。
  • APIListAlpha 构建一个列表,其中包含当前页面的子页面,格式化为 API 术语列表,按首字母分组。它有三个参数。第一个参数是 0,如果您想包含所有顶级子页面;或者 1,以排除名称中包含 "." 的子页面。第二个和第三个参数允许您在每个链接的名称中添加要显示的文本。这可以用于为元素链接添加“<”和“>”,或为方法名称列表末尾添加“()”。

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

  • QuickLinksWithSubpages 创建一个链接列表,该列表由当前页面(或指定的页面,如果提供了)下的页面组成。最多生成两个总深度级别。