MDN’s new design is in Beta! A sneak peek:


この翻訳は不完全です。英語から この記事を翻訳 してください。

MDN はページへの quicklinks 追加をサポートしています。つまり、これらはMDN内外のページへのリンクの階層リストを含むこともあるボックスです。この記事ではquicklinks ボックスの生成法を記します。

A page may have no more than one quicklinks box, which is presented in the left-hand sidebar. This sidebar may, optionally, be hidden by the user by clicking the "Hide this sidebar" link at the top of the sidebar.

The quicklinks for a page are provided by creating a <section> block with the ID "Quick_Links". Then you place the contents that go into the quicklinks box within the section. These should be formatted as an <ol> ordered list (optionally nested). You can do this by using the numbered list button in the editor toolbar. For example, this page has a quicklinks box that connects you to several useful pages. Its HTML looks like this:

<section id="Quick_Links">
    <li><a href="">CKEditor documentation site</a></li>
    <li><a href="">MXR: Mozilla source cross-reference</a></li>
    <li><a href="#">Style guides</a>
        <li><a href="">The Economist style guide</a></li>
        <li><a href="">The Chicago manual of style</a></li>
        <li><a href=""> dictionary</a></li>
        <li><a href="">Common Errors in English</a></li>

The important things to note:

  • The list must be an ordered list. Unordered lists will not work correctly.
  • You may have nested lists by providing a name, which is a link, for the folder, then another ordered list inside the same <li> block as the title link for the folder.

It's worth noting that you can (and often should use macros to generate quicklinks. Any time you need to use the same set of quicklinks on more than one page, you should turn them into a macro. This page, for example, uses the EditorGuideQuicklinks macro to create its quicklinks box; so does every other page in the MDN editor guide.

Your macro can be as simple or as complex as necessary; it simply needs to output HTML similar to what's shown in Quicklinks syntax above.

ここに quicklinks を生成する私たちの標準マクロがあります。

Builds the standard quicklinks for CSS Reference pages.
Builds the standard quicklinks for HTML Reference pages.
Given a list of pages on MDN, this macro constructs a quicklinks box using the pages' titles as the link text and their summaries as tooltips. This doesn't create hierarchical lists.
Creates a set of quicklinks using the current page's (or the specified page's) children as the destinations. This creates hierarchical lists up to two levels deep. The pages' titles are used as the link text and their summaries as tooltips.


 このページの貢献者: Uemmra3
 最終更新者: Uemmra3,