使用宏

rari 後端是 MDN 的構建系統,它提供了一種用於常見任務的宏語法。

在內容中使用宏

要使用宏,您需要將宏的名稱放在一對雙大括號({{ }})中,並附帶其引數(如果有)。

{{macroname(parameter-list)}}

關於宏呼叫的幾點說明

  • 宏名稱區分大小寫,但會盡力糾正常見的拼寫錯誤;即使宏名稱中有大寫字母,您也可以全部使用小寫字母,並且可以大寫一個通常以小寫字母開頭的宏名稱。
  • 引數之間用逗號分隔。
  • 如果沒有引數,您可以完全省略括號;{{macroname()}}{{macroname}} 是相同的。
  • 數字引數可以加引號,也可以不加。這取決於您(但是,如果您的版本號包含多個小數點,則需要加引號)。

宏可以很簡單,只是插入一大塊文字或交換 MDN 中其他部分的內容,也可以很複雜,透過搜尋網站的各個部分、樣式化輸出和新增連結來構建內容的整個索引。

您可以在 常用宏 頁面上閱讀我們最常用的宏。不太常用的宏在 其他宏 文件中有說明。

另見