Manual:目录

此页面是关于wiki页面的目录的。有关MediaWiki技术手册的内容页面，请参阅手册:索引 。

默认情况下，当使用超过三个章节标题时，页面会自动生成目录（有时缩写为TOC）。

通常该目录会复制这些标题并对其进行编号。

标题中的所有HTML都会在TOC中移除，但以下标记除外：

• ‎<sup>, ‎<sub>
• ‎<i>
• ‎<b>
• ‎<bdi>
• <span dir="rtl">, <span dir="ltr">
• ‎<s>, ‎<strike>
• ‎<q>

不会为html标记（手册:$wgRawHtml ）中的章节标题生成目录。

隐藏目录

将__NOTOC__放在页面上任何您想要隐藏其目录的位置。

使用某些模板，例如Template:Compact ToC（可在英文Wikipedia上找到），将替换通常的目录功能。

目录位置

TOC的默认位置位于第一节标题的正上方。 任何先前的文本都会在TOC之前。 要将其放置在其他位置，请在页面上的目标位置使用魔术字__TOC__。

皮肤可以使用Extension:DeToc 移除目录或将目录移动到页面的其他部分。

添加目录

如果您有三个或更少的标题，但想要有一个TOC，请在页面上的任意位置添加魔术字__FORCETOC__，使其显示在默认位置，或使用__TOC__显示在目标位置。

自定义目录

深度

TOC显示的最深标题级别由$wgMaxTocLevel 定义。 要为单个页面自定义此规则，如果在页面CSS中定义了合适的CSS规则，则可以将TOC包含在具有类toclimit-<limit>的元素中。

有关示例实现，请参阅Template:TOC 和Template:TOC/limit-styles.css中的相关规则。

自动编号

默认情况下，目录会自动为这部分编号。 本节标题未进行编号。 目录的此行为可以通过多种方式自定义：

• 如果存在在MediaWiki:Common.css中定义为.tocnumber { display: none; }的合适的类，则可以在TOC中取消自动生成的节编号。

To do this selectively, a wrapper element can be placed around the TOC, as in <div class="noautonum">__TOC__</div> on the page, and .noautonum .tocnumber { display: none; } at MediaWiki:Common.css.

It is also possible to add numbering to headings themselves using JavaScript, as explained at Snippets/Auto-number headings .

国际化

Different languages have different ways of expressing TOCs and how its (sub)section numbering is done. Also, the different style guides of many languages differ in what style of TOC and TOC (sub)section numbering scheme they recommend for writers to use.

The different w:style guides of each language sometimes recommend different typographic conventions to follow.

It's important to note that most languages don't even have any style guide for writing in that language (and many languages don't have a written form entirely), so people usually use the most common style based on existing written convention (not prescribed, but simply 'standard' due to popular usage), which makes the written use of many languages have a sort of 'fluid' punctuation, spelling/orthography and even [personal changes of the very] grammar [of that particular language]. w:Westernization has influenced alphabet and non-alphabet writing systems, with many languages simply copying or being artificially converted to European-style typographic and w:punctuational conventions.

An example on how to change the style of a TOC to a localized one is given below:

Some languages put a dot after a (sub)section ordinal number, e.g. they do not use the following TOC style:

Contents
1 Section [1]
1.1 Subsection [1.1]
2 Section [2]
2.1 Subsection [2.1]
3 Section [3]
3.1 Subsection [3.1]
3.1.1 Subsubsection [3.1.1]
3.1.2 Subsubsection [3.1.2]

But use one like so:

Contents
1. Section [1.]
1.1. Subsection [1.1.]
2. Section [2.]
2.1. Subsection [2.1.]
3. Section [3.]
3.1. Subsection [3.1.]
3.1.1. Subsubsection [3.1.1.]
3.1.2. Subsubsection [3.1.2.]

(Notice the addition of dots after ordinal numerals before the section names!)

It's possible to produce that effect using w:CSS. Put the following CSS code in a shared CSS file of your MediaWiki installation and it should work:

.tocnumber:after { content: '.' }

where the symbol between the single quotation marks is the sign after a (sub)section number.

Also, see bugzilla:43494 and bugzilla:33450 for details on related i18n problems of TOCs.

宽度

一个合理的方式是将TOC的宽度调整为页面宽度的百分比。 例如：

{{TOC left|width=30%}}

浮动

The TOC can be made to display as a floating element on the page, with text flowing around it.

For this, enclose the TOC in an element with the CSS style float:left; or float:right;.

See Template:TOC for an example implementation.

扩展

目录的行为可以通过扩展进一步调整。

有关列表，请参阅分类:目录扩展 。

See also

• w:Help:Section#Table of contents (TOC) - 在英文Wikipedia的TOC帮助
• Help:Section#Table of contents (TOC) - 在Meta-Wiki的TOC帮助