查看“HPC-MXM”的源代码

<languages/>

:''<translate><!--T:48--> This page is about tables of contents in wiki pages. For the contents page of the MediaWiki technical manual, see <tvar name=1>{{ll|Manual:Contents}}</tvar>.</translate>''

<translate>
<!--T:1-->
By default, a '''table of contents''' (sometimes abbreviated to '''TOC''') is automatically generated on a page when more than three section headings are used.

<!--T:2-->
Typically, the table reproduces and numbers these headings. 

<!--T:3-->
All HTML in the headings is stripped in the TOC, except the following tags:
</translate>

* {{tag|sup|open}}, {{tag|sub|open}}<ref>From MediaWiki 1.11 ({{ym|2007|09}}). See [[phab:T10393]].</ref>
* {{tag|i|open}}<ref>From MediaWiki 1.19 ({{ym|2011|11}}). See [[phab:T28375]].</ref>
* {{tag|b|open}}<ref>From MediaWiki 1.19 ({{ym|2011|12}}). See [[phab:T28375]].</ref>
* {{tag|bdi|open}}<ref>From {{ll|MediaWiki 1.25/wmf14}} ({{ymd|2015|01|07}}). See [[phab:T74884]].</ref>
* <syntaxhighlight lang=html inline><span dir="rtl"></syntaxhighlight>, <syntaxhighlight lang=html inline><span dir="ltr"></syntaxhighlight><ref>From {{ll|MediaWiki 1.21/wmf1}} ({{ymd|2012|10|01}}). See [[phab:T37167]].</ref>
* {{tag|s|open}}, {{tag|strike|open}}<ref>From {{ll|MediaWiki 1.28/wmf.21}} ({{ymd|2016|10|04}}). See [[phab:T35715]].</ref>
* {{tag|q|open}}<ref>From MediaWiki 1.39.0-wmf.6 ({{ymd|2022|04|04}}) See [[phab:T251672]].</ref>

<translate>
<!--T:49-->
The table of contents is not generated for section headings that are found within html tags (<tvar name=1>{{ll|Manual:$wgRawHtml}}</tvar>).

== Hiding the TOC == <!--T:4-->

<!--T:50-->
Place <tvar name=1><code><nowiki>__NOTOC__</nowiki></code></tvar> anywhere you want on the page to hide its TOC.

<!--T:57-->
Using certain templates, such as [[w:Template:Compact ToC|Template:Compact ToC]] (found on English Wikipedia), will ''replace'' the regular Table of Contents functionality.

== Positioning the TOC == <!--T:6-->
</translate>
<translate><!--T:7--> The default position of the TOC is directly above the first section heading.</translate>
<translate><!--T:51--> Any prior text is placed before the TOC.</translate>
<translate><!--T:8--> To place it elsewhere, use the magic word <tvar name=toc><code><nowiki>__TOC__</nowiki></code></tvar> at the preferred position on the page.</translate>

<translate>
<!--T:9-->
A skin may remove or move the table of contents to another section of the page using <tvar name=ext>{{ll|Extension:DeToc}}</tvar>.

== Adding the TOC == <!--T:10-->

<!--T:11-->
If you have three or fewer headings but want to have a TOC, write either the magic word <tvar name=forcetoc><code><nowiki>__FORCETOC__</nowiki></code></tvar> anywhere on the page to make it display at the default location, or <tvar name=toc><code><nowiki>__TOC__</nowiki></code></tvar> at the preferred position.

== Customizing the TOC == <!--T:12-->

=== Width === <!--T:52-->
</translate>
{{notice|1=<translate><!--T:58--> This seems to be available in some Wikimedia-projects '''only''', like <tvar name=1>[[w:template:TOC left]]</tvar>.</translate>}}
<translate><!--T:53--> An extenuating circumstance may require the width of a TOC width to be adjusted as a percentage of a page.</translate>
<translate><!--T:54--> For example:</translate>
<nowiki>{{TOC left|width=30%}}</nowiki>

<translate>
=== Depth === <!--T:13-->
</translate>
<translate><!--T:14--> The maximum level of headings displayed on the TOC is defined in <tvar name=MaxTocLevel><code>{{ll|Manual:$wgMaxTocLevel|$wgMaxTocLevel}}</code></tvar>.</translate>
<translate><!--T:15--> To customize this for individual pages, the TOC can be enclosed in an element with class <tvar name=limit><code>toclimit-&lt;limit></code></tvar>, if the appropriate CSS rules are defined in the pages CSS.</translate>

<translate>
<!--T:16-->
See <tvar name=toc>{{ll|Template:TOC}}</tvar> and the relevant rules at <tvar name=Common>[[Template:TOC/limit-styles.css]]</tvar> for an example implementation.

=== Auto-numbering === <!--T:17-->
</translate>
<translate><!--T:18--> By default, the TOC automatically numbers the sections.</translate>
<translate><!--T:56--> The section headings themselves aren't numbered.</translate>
<translate><!--T:19--> This behavior of the table of contents can be customised in several ways:</translate>

<translate>
<!--T:20-->
* It is possible to suppress the auto-generated section numbers '''in the TOC''', if the proper class exists locally at <tvar name=Common>[[MediaWiki:Common.css]]</tvar>, defined as <tvar name=css><syntaxhighlight lang=css inline>.tocnumber { display: none; }</syntaxhighlight></tvar>.

<!--T:21-->
To do this selectively, a wrapper element can be placed around the TOC, as in <tvar name=noauntonum><syntaxhighlight lang=html inline><div class="noautonum"></div></syntaxhighlight></tvar> on the page, and <tvar name=css><syntaxhighlight lang=css inline>.noautonum .tocnumber { display: none; }</syntaxhighlight></tvar> at <tvar name=Common>[[MediaWiki:Common.css]].</tvar>

<!--T:59-->
It is also possible to add numbering to headings themselves using JavaScript, as explained at <tvar name=1>{{ll|Snippets/Auto-number headings}}</tvar>.

=== Internationalization === <!--T:24-->
</translate>
<translate><!--T:25--> Different languages have different ways of expressing TOCs and how its (sub)section numbering is done.</translate>
<translate><!--T:26--> 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.</translate>

<translate>
<!--T:27-->
The different [[w:style guide]]s of each language sometimes recommend different typographic conventions to follow.
</translate>

<translate><!--T:28--> 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].</translate>
<translate><!--T:29--> [[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:punctuation]]al conventions.</translate>

<translate>
<!--T:30-->
An example on how to change the style of a TOC to a localized one is given below:

<!--T:31-->
Some languages put a dot after a (sub)section ordinal number, e.g. they do not use the following TOC style:
</translate>

<pre>
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]
</pre>

<translate>
<!--T:32-->
But use one like so:
</translate>

<pre>
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.]
</pre>

''<translate><!--T:33--> (Notice the addition of dots after ordinal numerals before the section names!)</translate>''

<translate><!--T:34--> It's possible to produce that effect using [[w:CSS]].</translate>
<translate><!--T:35--> Put the following CSS code in a shared CSS file of your MediaWiki installation and it should work:</translate>

<syntaxhighlight lang="CSS">
.tocnumber:after { content: '.' }
</syntaxhighlight>

<translate>
<!--T:36-->
where the symbol between the single quotation marks is the sign after a (sub)section number.

<!--T:37-->
Also, see [[bugzilla:43494]] and [[bugzilla:33450]] for details on related i18n problems of TOCs.

== Floating == <!--T:38-->

<!--T:39-->
The TOC can be made to display as a floating element on the page, with text flowing around it.

<!--T:40-->
For this, enclose the TOC in an element with the CSS style <code>float:left;</code> or <code>float:right;</code>.

<!--T:41-->
See <tvar name=1>{{ll|Template:TOC}}</tvar> for an example implementation.

=== Extensions === <!--T:42-->

<!--T:43-->
The behavior of the table of contents can be further adjusted using extensions.

<!--T:44-->
See <tvar name=1>{{ll|Category:TOC extensions}}</tvar> for a list.

== External links == <!--T:45-->
</translate>
* [[w:Help:Section#Table of contents (TOC)]] - <translate><!--T:46--> Help on TOC at the English Wikipedia</translate>
* [[m:Help:Section#Table of contents (TOC)]] - <translate><!--T:47--> Help on TOC at the Meta-Wiki</translate>

[[Category:MediaWiki components{{#translation:}}]]

[[文件:HPC-MXM-12700H GPP BenchMark.jpg|缩略图]]
[[文件:HPC-MXM-11900H-核心硬件评测.png|缩略图]]
[[文件:HPC-MXM-11900H-GPP BenchMark.jpg|缩略图]]
[[文件:HPC-MXM-12700H 核心硬件评测.png|缩略图]]