セクションは次のようにセクションの見出しを作ることで作成されます(見出しのことを英語の転用で「ヘッディング」(heading)ともいいます。「ヘッド」(head)、「ヘッダ」(header)という言い方もありますが、ページの上部にあるテキスト群と区別をつけるために「ヘッディング」という表現が好まれます)。== セクション ===== サブセクション ======= サブ-サブセクション ====
等号の数が多くなるほど、セクションの階層が深くなります。
セクションの名前の両脇に1つの等号のみを付けないでください(例: =見出し=)。このようにすると、ページ冒頭に表示されているページ名と同じ階層の見出しになってしまいます。なお、ページ名は自動的に生成されています。
オプションで見出しに番号を振る設定をすると、セクション見出しに番号がつきます。
セクションの見出しはページ内で同じものを使わない方がよいでしょう。セクションと同じ見出しをサブセクションに使うこともおすすめできません。同じ見出しを複数回使うとセクション編集(後述)をしたあと、要約欄のリンクが間違ったリンク先にとんでしまうことが起りえます。
ページには別ページ(テンプレート)をセクション(または複数の連続するセクション)として呼び出すことができ、閲覧しただけではその事実はわかりません。詳しくはHelp:テンプレート#ページの合成を参照してください。この方法をとると事実上セクションの編集履歴を分離したり、セクションだけをウォッチすることができます。
セクションを含むテンプレートを呼び出している場合、テンプレート内のセクションは生成されるページ内でのその位置に応じて番号付けされます。例えば、テンプレートタグが3番目のセクションにあるとすると、テンプレート内の最初のセクションは「4」と番号付けされます。テンプレート内の最初のセクションより前にあるテキストはテンプレートタグがおかれているセクションの一部とみなされ、またテンプレートタグの後から次の見出しまでにあるテキストはテンプレート内の最後のセクションの一部とみなされます。このようなこと、意図的に行うこともできますが、通常は避けた方がよいでしょう(下記も参照)。
見出しが4つ以上あるページには、基本的にセクション見出しから自動生成される目次が表示されます。ただし次の場合を除きます。
(ユーザー側で)オプションの設定で目次を表示しない設定にしている。
(記事側で)ウィキテキストにマジックワードの__NOTOC__(両脇のアンダースコア2つも必要です)が記入されている。
見出しの数が4つ未満であってもウィキテキスト内に__FORCETOC__または__TOC__を書きこむと、目次が表示されます。
__FORCETOC__があると、目次は最初のセクション見出しの前に置かれます。__TOC__があると、この文字列がある位置に目次が置かれます。またこの文字列の場合は目次を置く場所を任意に指定できます。例えば、右端とかテーブルのセル中に表示させることもできます。メディアウィキの古いバージョンでは複数の目次が生成できましたが、現在はできません。__TOC__を複数書きこむと、最初のところに目次が生成されます。
目次の前には導入部のテキストをおくことがままあります。通常は目次の直後に最初の見出しがある形が望ましいですが、導入部が長いときなどは目次が下に行きすぎることを防ぐためだけに意味のない見出しを追加せずとも、__TOC__を使って目次を適切な位置におくことができます。
__NOTOC__を使うことで、通常の目次を無効化することができます。
次のコードを使うと、目次を画面の右端に浮動テーブルとして置くことができます。 {| style="float:right" |__TOC__ |}
Categoryカテゴリページ内の目次
カテゴリページ内に目次を作りたいときには、
{{CategoryTOC}} と記入します。
目次
あいうえお はひふへほ
かきくけこ まみむめも
さしすせそ やゆよ
たちつてと らりるれろ
なにぬねの わをん
上記のような目次が作られます。
(アルファベットを並べただけのような)非常に短い見出しがたくさんある場合、目次が非常に長くなります。以下のようにすることでコンパクトな目次で置き換えられます。__NOTOC__[[#A|A]] [[#B|B]] [[#C|C]] [[#D|D]] [[#E|E]] [[#F|F]] [[#G|G]][[#H|H]] [[#I|I]] [[#J|J]] [[#K|K]] [[#L|L]] [[#M|M]] [[#N|N]][[#O|O]] [[#P|P]] [[#Q|Q]] [[#R|R]] [[#S|S]] [[#T|T]] [[#U|U]][[#V|V]] [[#W|W]] [[#X|X]] [[#Y|Y]] [[#Z|Z]]
これは以下のように表示されます。
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
同様に年や10年紀も以下のように書けます。
1900年代 - 1910年代 - 1920年代 - 1930年代 - 1940年代 - 1950年代 - 1960年代 - 1970年代 - 1980年代 - 1990年代 - 2000年代
目次に掲載するサブセクションの深さは、$wgMaxTocLevelを使ってサイト全体で制限することができます。LocalSettings.phpにて$wgMaxTocLevelの値が例えば3に設定されていれば、目次には第2レベルの見出しまでしか掲載されません。