Manual:Table of contents/ja


 * このページはウィキページの目次について扱っています. MediaWiki の技術的マニュアルの本文ページについては、 を参照してください. 

普通、目次(TOCと略されることもある)は、3つ以上のセクションヘッダを使っているページに自動的に付けられます.

一般的に、目次はページのすべてのヘッダに番号をつけて表示します.

目次では、見出し内のHTMLは, , , , , 以外はすべて取り除かれます.

The table of contents is not generated for section headings that are found within html tags.

目次を隠す
Place  anywhere you want on the page to hide its TOC.

目次の位置を決める
目次の既定の位置は、最初の節見出しの直前です. 最初の見出しより前にあるテキストはすべて目次の前に置かれます. それ以外の所に目次を配置するには、置きたい所でマジックワード  を使います.

スキンは を使って、目次を無くしたりページの他のセクションに移動することができます.

目次の追加
もし、そのページが3つ未満のヘッダしか持っていなくても目次が欲しいなら、どこかに  と書いて標準位置に配置するか、置きたい場所に   と書いてそこに配置するかの2つの方法があります.

幅
An extenuating circumstance may require the width of a TOC width to be adjusted as a percentage of a page. 例:

深さ
目次に表示することができる最大のヘッダ数は、 によって定義されます. To customize this for individual pages, the TOC can be enclosed in an element with class, if the appropriate CSS rules are defined in the pages CSS.

実装例は、 MediaWiki:Gadget-site.css の中の とそれに関係するルールを参照して下さい.

自動で番号を付ける
普通、目次はセクションに自動で番号を付けます. セクションのヘッダ自体に番号は付けられません. 目次の番号の付け方は、次のいくつかの方法でカスタマイズ出来ます.


 * MediaWiki:Common.css に  として定義された適切なクラスが存在する場合、目次での自動の番号付けをさせないことができます.

To do this selectively, a wrapper element can be placed around the TOC, as in  on the page, and   at MediaWiki:Common.css.


 * There is a user preference to also auto-number the section headings, at  > Appearance > Advanced options > Auto-number headings. This can be set globally for the whole wiki by defining  in
 * This setting can be overridden individually by users, by changing their preferences as described above, or by setting  in their user style page. Administrators who lack server access can also override the setting for all users, if it is activated as mentioned above. This is done by using the same CSS code in the site's global common.css file.


 * To add a period to the automatically generated numbering do as described: https://stackoverflow.com/a/32347680/2275206

国際化
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 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]. Westernization has influenced alphabet and non-alphabet writing systems, with many languages simply copying or being artificially converted to European-style typographic and 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 CSS. Put the following CSS code in a shared CSS file of your MediaWiki installation and it should work:

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

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

フローティング
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  or.

実装例は を参照してください.

拡張機能
The behavior of the table of contents can be further adjusted using extensions.

一覧は を参照してください.

外部リンク

 * w:Help:Section - 英語版Wikipedia での目次のヘルプ
 * m:Help:Section - Meta-Wiki での目次のヘルプ