侧边栏

MDN 支持在页面中添加侧边栏；这些框是包含到 MDN 上的其他页面或站外页面链接的可分层列表。本文描述了如何创建侧边栏。

侧边栏语法

页面的侧边栏是通过创建一个 ID 为“Quick_links”的 <section> 块来提供的。然后，将要放入侧边栏框中的内容放在 section 内。这些链接需要格式化为 <ol> 有序列表（可以嵌套）。你可以通过使用编辑器工具栏中的编号列表按钮来实现这一点。例如，你的侧边栏 HTML 可能如下所示：

html

<section id="Quick_links">
  <ol>
    <li><a href="http://docs.ckeditor.com/">CKEditor 文档站点</a></li>
    <li>
      <a href="http://mxr.mozilla.org/">MXR：Mozilla 源代码交叉引用</a>
    </li>
    <li class="toggle">
      <details>
        <summary>风格指南</summary>
        <ol>
          <li>
            <a href="http://www.economist.com/research/StyleGuide/"
              >经济学人风格指南</a
            >
          </li>
          <li>
            <a href="https://www.amazon.com/gp/product/0226104036/"
              >芝加哥风格手册</a
            >
          </li>
          <li>
            <a href="http://www.answers.com/library/Dictionary"
              >Answers.com 字典</a
            >
          </li>
          <li>
            <a href="http://www.wsu.edu/~brians/errors/">英语中的常见错误</a>
          </li>
        </ol>
      </details>
    </li>
  </ol>
</section>

需要注意的重要事项：

应该使用有序列表。
你可以通过在同一个 <li> 块内部使用包含另一个有序列表的 <details> 来创建嵌套列表。

使用宏创建侧边栏

值得注意的是，你可以（而且通常应该）使用宏来生成侧边栏。每当你需要在多个页面上使用相同的侧边栏集时，你都应该将它们转换为宏。

你的宏可以是简单或复杂的（若有必要）；它需要输出类似于上面的侧边栏语法中所示的 HTML。

标准侧边栏宏

这里列出了我们用于生成侧边栏的标准宏。

CSSRef: 生成 CSS 参考页面的标准侧边栏。
HTMLSidebar: 生成 HTML 参考页面的标准侧边栏。
QuickLinksWithSubpages: 使用当前页面（或指定页面）的子页面作为目标创建一组侧边栏。这将创建最多两层的分层列表。页面的标题将被用作链接文本，摘要则被用作提示。