其他宏

常用宏 中列出的宏不同,本文件中介紹的宏使用頻率較低,或者僅在特定上下文中才能使用,或者已棄用。

特定上下文

此宏僅用於特定上下文,例如特定的 API 參考。

  • RFC 根據 RFC 的編號建立一個指向該 RFC 的連結。語法為 {{RFC(number)}}。例如,{{RFC(2616)}} 會變成 RFC 2616

登陸頁面元件

我們提供了一系列宏,可用於自動生成登陸頁面的內容。它們如下。

子頁面列表

  • ListSubpages 生成一個無序列表,其中包含指向當前頁面所有直接子頁面的連結;這對於自動生成文件集的目錄非常有用。
  • SubpagesWithSummaries 構建一個定義列表,其中包含當前頁面所有直接子頁面的連結,其標題作為 <dt>,其 SEO 摘要作為 <dd>。這使得自動生成相當吸引人的登陸頁面變得容易。
  • APIListAlpha 構建一個列表,其中包含當前頁面的子頁面,格式化為 API 術語列表,按首字母分組。它有三個引數。第一個引數是 0,如果您想包含所有頂級子頁面;或者 1,以排除名稱中包含 "." 的子頁面。第二個和第三個引數允許您在每個連結的名稱中新增要顯示的文字。這可以用於為元素連結新增“<”和“>”,或為方法名稱列表末尾新增“()”。

我們有一個專門用於在內容中建立連結列表的宏。

  • QuickLinksWithSubpages 建立一個連結列表,該列表由當前頁面(或指定的頁面,如果提供了)下的頁面組成。最多生成兩個總深度級別。