Help:Section/ja

Help:Template/ja

MediaWiki ハンドブック: 目次、読者、編集者、中間管理者、システム管理者 +/-

ページは、セクション見出しのシンタックス（文法）を使って、セクション（節）に分割することができます。

セクションの作成と番号付け

セクションは、次のようにセクションの見出しを作ることで作成されます。（見出しのことを英語の転用で「ヘッディング」 (heading) ともいいます。「ヘッド」 (head) 、「ヘッダ」 (header) という言い方もありますが、ページの上部にあるテキスト群と区別をつけるために「ヘッディング」という表現が好まれます）。

==セクション==
===サブセクション===
====サブ-サブセクション====

等号の数が多くなるほど、セクションの階層が深くなります。

セクションの名前の両脇に1つの等号のみを付けないでください（例: =見出し=）。このようにすると、見出しがページ名とおなじサイズになります。ページ名の見出しは自動的に生成されています。

オプションで見出しに番号を振る設定をすると、セクション見出しに番号がつきます。

セクションの見出しは、ページ内で同じものを使わない方がよいでしょう。セクションと同じ見出しをサブセクションに使うこともおすすめできません。同じ見出しを複数回使うと、セクション編集（後述）をしたあと、要約欄のリンクが間違ったリンク先にとんでしまうことが起りえます。

ページに、別ページ（テンプレート）をセクション（または複数の連続するセクション）として呼び出すことができ、閲覧しただけではその事実はわかりません。詳しくはHelp:Template/ja#ページの合成を参照してください。この方法をとると、事実上セクションの編集履歴を分離したり、セクションだけをウォッチすることができます。

セクションを含むテンプレートを呼び出している場合、テンプレート内のセクションは、生成されるページ内でのその位置に応じて、番号付けされます。例えば、テンプレートタグが3番目のセクションにあるとすると、テンプレート内の最初のセクションは、4と番号付けされます。テンプレート内の最初のセクションより前にあるテキストは、テンプレートタグがおかれているセクションの一部とみなされ、また、テンプレートタグの後から次の見出しまでにあるテキストは、テンプレート内の最後のセクションの一部とみなされます。このようなことは、意図的に行うこともできますが、通常は避けた方がよいでしょう（下記も参照）。

目次 (TOC)

見出しが4つ以上あるページには、基本的に、セクション見出しから自動生成される目次が表示されます。ただし次の場合を除きます。

（ユーザー側で）オプションの設定で、目次を表示しない設定にしている
（記事側で）ウィキテキストにマジックワードの __NOTOC__ （両脇のアンダースコア2つも必要です）が記入されている。

見出しの数が4つ未満であっても、ウィキテキスト内に __FORCETOC__ または __TOC__ を書きこむと、目次が表示されます。

__FORCETOC__があると、目次は最初のセクション見出しの前に置かれます。__TOC__があると、この文字列がある位置に目次が置かれます。またこの文字列の場合は、目次を置く場所を任意に指定できます。例えば、右端とか、テーブルのセル中に表示させることもできます。メディアウィキの古いバージョンでは、複数の目次、例えばセクション毎に目次を生成することもできます（ただし、これはセクションが長くて、目次が全体に占める割合が小さいときでなければ不便なだけでしょうが）。

目次の前には、導入部のテキストをおくことがままあります。通常は目次の直後に最初の見出しがある形が望ましいですが、導入部が長いときなどは、目次が下に行きすぎることを防ぐためだけに意味のない見出しを追加せずとも、 __TOC__ を使って目次を適切な位置におくことができます。

__NOTOC__を使うことで、通常の目次を無効化することができます。以下で説明するセクションへのリンクを使って、代りに縮約版の目次を作成することもできます。例えば、[[#A|A]] [[#B|B]] のようなアルファベット順の目次などです。

次のコードを使うと、目次を画面の右端に浮動テーブルとして置くことができます。

 {|align=right
  |__TOC__
  |}

サイト全体の目次の深さを制限する

目次に掲載するサブセクションの深さは、 $wgMaxTocLevel を使ってサイト全体で制限することができます。 LocalSettings.php にて $wgMaxTocLevel の値が例えば3に設定されていれば、目次には第2レベルの見出しまでしか掲載されません。バージョン1.10.0rc1までは、条件文にバグがあり、制限された目次が正しく生成されていませんでした。これにはバグの報告 6204で簡単な解決案が提案されました。

セクションへのリンク

各セクションを表示しているHTML コードには、"name" 属性・"id" 属性双方ともセクション名を値とするアンカー用のHTML要素 "a"が書き込まれています。これにより、セクションへの直接リンクすることができます。メディアウィキは、こうしたセクション・アンカーを使ってページの目次を自動作成しますが、人間が手動で任意のセクションへのリンクを作るために使うこともできるのです。

例えば、本セクションの冒頭で生成されている HTML コードは、次のとおりです。

<p><a name="セクションへのリンク" id="セクションへのリンク"></a></p>
<h2>セクションへのリンク</h2>

本セクション（セクションへのリンク）へのリンクは、次のようにします。

[[Help:Section/ja#セクションへのリンク|セクションへのリンク]]

同一ページ内からは、[[#セクション名|リンクに表示する文字列]] の形でもリンクできます。別のページからは[[ページ名#セクション名|リンクに表示する文字列]] の形でリンクします。

セクションのアンカーは、セクションの階層を無視します。したがって、サブセクションやサブサブセクションなどへのリンクは[[#サブセクション名]]や[[#サブサブセクション名]]のようになります。

セクション名が重複する場合には、アンカー名にアンダースコアと番号が自動的に付け加えられます。例えば、「例」というセクションが3つあったら、セクションへのリンクに使うセクション名は上から「例」、「例_2」、「例_3」となります。ですが、混乱を招くことに、「例_2」や「例_3」の節を編集した後、例えば要約欄のリンクをクリックすると、「例」の節にとんでしまいます。

セクションの見出しが空白だけの時には、目次からのリンクが機能しません。同種の機能についてはヘルプ:条件文を参照してください。

セクション見出しは作らずに、アンカーターゲットだけを作成するには、spanを利用できます。例えば <span id="アンカー名"></span>とします。ただし、とても古いブラウザでは動作しません。

セクション見出し内に、日付形式統一機能（ヘルプ:オプション）を利用すると、セクションへのリンクが複雑になってしまうので注意してください。

注意

セクション内に内部リンクがあることは、セクションへのリンクという点からは特に不都合を生じません。
- #Demo a
- Help:Section/ja#Demo http:.2F.2Fa
- //meta.wikimedia.org/wiki/Help:Section/ja#Demo_http:.2F.2Fa
パイプの裏技はセクションへのリンクと併用できません。
- [[#section|]] -> [[#section|]]
- [[page#section|]] -> [[page#section|]]
- [[namespace:page#section|]] -> [[namespace:page#section|]]

ページ内の任意の位置へのリンク作成については、Help:Link/ja#ページへのリンク作成を参照してください。

セクションへのリンクとリダイレクト

リダイレクトページ内のセクションを指定するリンクは、リダイレクト先にある同名のセクションへのリンクになります。

あるページ内のセクションへのリダイレクトも、現在では使える場合があります218。Help:Section linking and redirectsが例です。（CSSスタイルシートを強制リロードする必要があるかもしれません。）

ページ名の変更の場合と異なり、セクション名を変更しても、リンク切れを防ぐなんらかの転送措置は自動的に行われません。また、リンク元では、セクション別のバックリンクの検出はできず、あるセクションにリンクしているページはすべて、単にそのページにリンクするページとしてリストされます。回避策として考えられるのは次の通りです。

セクションに直接リンクする代りに、セクションにリダイレクトするページへリンクする。セクションの名前が変わったときにはリダイレクト先を変更します。この方法はセクションに対する「リンク元」らしきものも提供します（まずページに対してリンクしているリダイレクトを探し、その下にあるリンクを見ます。セクション名が変わっても、リダイレクトページの名前から推測できるでしょう）。
アンカータグを別に置いて、それにリンクする。
セクション冒頭に、コメントアウトの形でセクションにリンクするページのリストを書き込む。
セクションを別のページもしくはテンプレートに分離し、親ページに呼び出す、または親ページからリンクする。この場合、セクションにリンクするのではなく、別ページにリンクできます。

リダイレクトページは、リダイレクトコマンドの後にカテゴリタグをおくことでカテゴリ付けできます。セクションへのリダイレクトと組み合わせれば、カテゴリページからセクションへリンクするという形で、ある程度はセクションをカテゴリ付けできます。しかし、セクションに明示的なカテゴリへのリンクを置かない限り、セクションはカテゴリページにリンクしません。カテゴリページでは、リダイレクトは "redirect-in-category" というCSSセレクタが割り当てられていますので、例えばイタリック体で明示することができます。これは MediaWiki:Common.css や利用者個人のスタイルシートで設定できます。w:Wikipedia:Categorizing redirectsも参照してください。

セクション編集

セクションは、見出しの脇にある「編集」というリンクをクリックすることで、個別に編集できます。オプションの設定によっては、見出しの右クリックでも同じことができます。これは「セクション編集機能」と呼ばれています。セクション編集機能を使うと、次のようなURlの編集ページにとびます。

//meta.wikimedia.org/w/wiki.phtml?title=Help:Section/ja&action=edit&section=2

ここで、セクションには「番号」が使われ、セクション名は使われていないことに注意してください。サブセクションにも通して番号が振られますので、例えばセクション 2.1 はここでは3と振られ、この場合、次に来るセクション3がセクション番号4になります。上記のようなURlを直接ブラウザのアドレスバーに入力しても同様の結果が得られます。

この機能は、編集が他のセクションには関わらず、編集中にそうした他のセクションのテキストを見る必要がないときに便利です（ほかのセクションのテキストを見る必要があるときには、セクション編集画面を新規ウィンドウで開くとか、セクション編集中に本文ページを別のウィンドウで開くとよいでしょう）。セクション編集は、ページサイズが大きい時におこりうるさまざまな問題を軽減もします。

__NOEDITSECTION__をページ中のどこかに書きこむと、「編集」リンクが全て表示されなくなります。これはセクション編集自体ができなくなるということではありません。URlの直接入力や、セクションの右クリックを使ってセクション編集ができます。

セクションの挿入は、挿入したい位置の前後のセクションのどちらかを編集することで行なえます。前のセクションと統合する時には、見出しを削除します。この場合、要約欄の見出しの内容に注意してください。

ページ末への新しいセクションの追加

ページの最後にセクションを追加するには、http://meta.wikimedia.org/w/wiki.phtml?title=Meta:Sandbox&action=edit&section=new のような&section=newを付けたURLで行なうこともできます。

ノートページおよびページのウィキテキスト内に __NEWSECTIONLINK__ のマジックワードを挿入したページでは、このために特別にmessage with id 'addsection' (talk) の内容をラベルとするリンク（具体的には「+」タブもしく「新規コメントを追加」というリンク）があります。この場合、セクションの見出しを入力する「題名・見出し」（ message with id 'subject' (talk)で決定）という名前のテキストボックスが表示され、ここに入力した内容が、message with id 'newsectionsummary' (talk) の内容に従ってその編集の要約欄の内容にもなります。要約のためのテキストボックスは現れません。見出しの内容以外のテキストを要約欄に書き込むことは出来ません（要約欄に何かを書き込む必要がある場合は前節の方法でセクションを追加してください）。

最初のセクションの前の部分の編集

基本的には、最初のセクションの見出しの前にある導入部のテキストだけを編集するためのリンクは提供されていません。ですが、セクション編集機能はこの部分にも適用できます。これをするには、section=0とするだけです。例: //meta.wikimedia.org/w/wiki.phtml?title=Help:Section&action=edit&section=0 裏技として、どこか適当なセクションの「編集」リンクをつかって編集画面を呼び出し、セクションの番号を 0 に変えることでも同じことができます。

また、JavaScript を使ってこのURLを生成することができます。詳しくはw:en:Wikipedia:WikiProject User scripts/Scripts/Edit Topをご覧ください。

テンプレート{{Edit-first-section}} または {{Edit-top-section}} は、ページにセクション0への編集リンクを追加します。

Help:Section editing demoもご覧ください。

プレビュー

セクション編集中のプレビューは、ページ全体を表示したときと同じ結果を表示しているとは限りません。例えば、前のセクションにある画像が編集中のセクションまで侵食しているようなときには、ページ全体を表示したときにはレイアウトが変わってみえるでしょう。

編集ページの「使われているテンプレート」のリストでは、そのページで読み込まれている全てのテンプレートが表示されますので、他のセクションで使っているテンプレートも表示されます。

サブセクション

サブセクションは編集するセクションの中に含まれます。編集中のセクションの番号付けは相対的で、トップレベルが常に1になり、その下にあるサブセクションは、相対的に1.1、1.2などになります。例えば、サブセクション3.2を編集する場合、サブサブセクション3.2.4は1.4と番号が振られます。ただし、見出しの形式は絶対的な見出しの階層に一致します。

大きなセクションを持つページの編集

もしもページ中にとても大きなセクションがあるか、ページ自体がとても大きくてセクションに分割されていない場合、ブラウザまたは接続によっては、このような大きなセクションは編集できないことがあります。このような時にも次のことはできます。

今あるセクションよりも大きなセクション番号を指定することによりセクションを追加する（大きすぎることは問題にはなりません）。ただし、新しいセクション見出しの前に空白行が加わります。
同じ方法でセクション見出しを付けないことで、最後のセクションに内容を追加する。ただし、ブラウザや接続環境の制限があるばあい、この部分をあとから編集したり、差し戻すことはできなくなります。

大きなセクションのウィキテキストの閲覧は可能な場合、すこしずつ小さいセクションに分割したテキストを追加し、最後にもとの大きなセクションを削除してもよいでしょう。この場合、作業中はテキストの重複が起きますから、要約欄に作業についての説明を書いておく方がよいでしょう。

挿入されたテンプレートのセクションの編集

編集機能は挿入された別ページ（テンプレート）のセクションにも適用できます。呼び出されているセクションの「編集」リンクをクリックすると、別ページの編集画面にとびます。このセクションヘルプ:挿入されたテンプレートのセクションの編集が実例になっています。

セクション編集機能では、編集されるセクションの範囲は、別ページを呼び出している親ページの見出しに依存します。例えば、別ページ内の最初の見出しの前にテキストがある場合、親ページ上では、このテキストはテンプレートタグを含んでいるセクションの一部分であるように見えます。しかし、そのセクションの編集リンクをクリックしても、別ページ部分のウィキテキストは表示されません。あるいは、テンプレートタグの直後に、セクション見出しをはさまずにテキストが続いている場合、セクション編集機能を使ってこのテキストを編集するためには、テンプレートタグが挿入されている直前のセクション見出しの編集リンクをクリックしなければなりません。

したがって、親ページの生成画面で表示されているセクションの範囲と、実際のウィキテキストのセクションの範囲が異なると混乱を引き起こします。これを避けるためには、

別ページ（テンプレート）が見出しを持っている場合、最初の見出しの前にテキストをおかないでください。
親ページでは、セクションをもつ別ページの後には、新しいセクション見出しをおいてください。

別ページ内はセクションに分割する必要がなくても、場合によっては、別ページを新しいセクション見出しで始め、別ページ全体を1つのセクションとするとよいでしょう。このようにしておけば、別ページを呼び出しているページでは、別ページへの明示的なリンクをおかなくても、セクション編集機能を使って別ページを編集することができます。この別ページも、1つのセクションになっています。

別ページ（テンプレート）中のパラメータ値、例えば"{{{1}}}"は、テンプレートを編集することではなく、呼び出しているページのテンプレートタグを編集することで指定されることに注意してください。このような時には、説明の文章か、明示的な編集ページへのリンクをおいておくと便利でしょう。

呼び出されているページに __NOEDITSECTION__ タグが含まれていると、そのページだけでなく、呼び出しているページ、またそのページに呼び出されている他の別ページにも効果が及びます。

条件文中のセクション

条件文を使ってセクションの見出しを生成すると、直接的であれ、セクションを含むテンプレートのトランスクルージョンによってであれ、このセクションおよび、後続のセクションの「編集」リンクのリンク先が誤ったものになります（ページの見た目や、目次の階層、目次からのリンクは正常です）。これは、セクション編集リンクを生成するためのセクションのカウントが、条件文の展開の後に行われるのに対して、編集ページを読み込む時には、そこに表示されているセクションだけがカウントされるためです。

これは、バグではなく、セクション編集機能の仕様ですので、解決法は明白で、条件文を使ったセクション生成をしないか、セクション編集機能を止めるしかありません。

セクション、ページの分割、トランスクルージョンの比較

ページの分割の利点

リンク元が使える
編集履歴が分離できる
改名の際に自動的にリダイレクトが作られる
短いページを読み込む（ロードする）ほうが、長いページを読み込むより早く済む
それぞれにカテゴリに入れられる
Semantic MediaWikiでは分離した注釈を与えられる

セクションをたくさんもつ大きなページの利点

長くても1ページを読み込むほうが、短いページをいくつも読み込むより速くて簡単である
ブラウザやコンピュータの検索機能を利用して、ページ内を検索する方が、プロジェクト全体から複数のページを検索するよりも速く、検索結果の表示や負荷の点からも優れている（生成ページもウィキテキストも検索可能）。更に目次が便利な案内役になる
複数の定義を含む概念の記事の場合、全体を見通した記事執筆が容易になる

もう1つの方法として、テンプレート機能を利用して、複数のページをまとめて1つのページにする（トランスクルージョンを使って合成ページを作成する）ことができます。こうすれば、生成された合成ページ内での検索は容易になりますが、ウィキテキストを一度に検索することはできません。欠点として、それぞれのページにページ名が必要です。また2,048,000バイトの読み込みページサイズ制限が適用されます。

デモ用セクション

Demo a

このセクションは#セクションのリンクからリンクされています。

Demo http://a