快速链接
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>
需要注意的重要事项:
使用宏创建快速链接
值得注意的是,你可以(而且通常应该)使用宏来生成快速链接。每当你需要在多个页面上使用相同的快速链接集时,你都应该将它们转换为宏。
你的宏可以是简单或复杂的(若有必要);它需要输出类似于上面的快速链接语法中所示的 HTML。
标准快速链接宏
这里列出了我们用于生成快速链接的标准宏。
CSSRef
-
生成 CSS 参考页面的标准快速链接。
-
生成 HTML 参考页面的标准快速链接。
QuickLinksWithSubpages
-
使用当前页面(或指定页面)的子页面作为目标创建一组快速链接。这将创建最多两层的分层列表。页面的标题将被用作链接文本,摘要则被用作提示。