ウィキペディア日本語版のヘルプページです。元文書はメタウィキのヘルプです。
セクション(節)の編集方法について説明します。記事の文章は見出しのついたセクション(節)に分割することができます。ここでは見出しのマークアップを使いセクションに分割する編集方法、各セクションの見出しにリンクする方法、またセクションを編集する機能、また目次について説明します。目次は、見出しが4つ以上になると以下のように自動的に生成されます。
どのようにセクションを分割するのかについては、Wikipedia:スタイルマニュアル/見出しをご覧ください。
セクションは次のようにセクションの見出しを作ることで作成されます(見出しのことを英語の転用で「ヘッディング」(heading) ともいいます。「ヘッド」(head) 、「ヘッダ」(header) という言い方もありますが、ページの上部にあるテキスト群と区別を付けるために「ヘッディング」という表現が好まれます)。
== セクションの見出し == === サブセクションの見出し === ==== サブサブセクションの見出し ====
等号の数が多くなるほど、セクションの階層が深くなります。
セクションの名前の両脇に1つの等号のみを付けないでください(例: = 見出し =
)。このようにすると、ページ冒頭に表示されているページ名と同じ階層の見出しになってしまいます。なお、ページ名は自動的に生成されています。
個人設定で見出しに番号を振る設定をすると、セクション見出しに番号がつきます。
セクションの見出しはページ内で同じものを使わない方がよいでしょう。セクションと同じ見出しをサブセクションに使うこともおすすめできません。同じ見出しを複数回使うとセクション編集(後述)をしたあと、要約欄のリンクが間違ったリンク先に飛んでしまうことが起こり得ます。
ページには別ページ(テンプレート)をセクション(または複数の連続するセクション)として呼び出すことができ、閲覧しただけではその事実はわかりません。詳しくはHelp:テンプレート#ページの合成を参照してください。この方法をとると事実上セクションの編集履歴を分離したり、セクションだけをウォッチすることができます。
セクションを含むテンプレートを呼び出している場合、テンプレート内のセクションは生成されるページ内でのその位置に応じて番号付けされます。例えば、テンプレートタグが3番目のセクションにあるとすると、テンプレート内の最初のセクションは「4」と番号付けされます。テンプレート内の最初のセクションより前にあるテキストはテンプレートタグが置かれているセクションの一部とみなされ、またテンプレートタグの後から次の見出しまでにあるテキストはテンプレート内の最後のセクションの一部とみなされます。このようなことは意図的に行うこともできますが通常は避けた方がよいでしょう(下記も参照)。
見出しが4つ以上あるページには、基本的にセクション見出しから自動生成される目次が表示され、「ベクター(2022年版)」以外の外装では、#toc
と記述すると記事中の目次にリンクする(戻る)ことが出来ます。ただし次の場合を除きます。
__NOTOC__
(両脇のアンダースコア2つも必要です)が記入されている。目次は、デスクトップ(パソコン)版の「ベクター(2022年版)」の外装では左側(メニューが出ている場合はその下)に表示され、それ以外の外装やモバイル版では本文内(通常は冒頭定義文のあと)に表示されます。
見出しの数が4つ未満であってもウィキテキスト内に__FORCETOC__
または__TOC__
を書きこむと、目次が表示されます。
__FORCETOC__
があると、目次は最初のセクション見出しの前に置かれます。__TOC__
があると、この文字列がある任意の位置に目次が置かれます。__TOC__
を複数書きこむと、最初のところに目次が生成されます(メディアウィキの古いバージョンでは複数の目次が生成できましたが、現在はできません)。__NOTOC__
を使うことで、通常の目次を無効化することができます。{{TOCright}}
もあります)。{| style="float:right" |__TOC__ |}
{{CategoryTOC}}
と記入します。
目次 | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
おまかせ表示 | わ | ら | や | ま | は | な | た | さ | か | あ | トップ頁へ | ||
り | み | ひ | に | ち | し | き | い | ||||||
を | る | ゆ | む | ふ | ぬ | つ | す | く | う | ||||
れ | め | へ | ね | て | せ | け | え | ||||||
ん | ろ | よ | も | ほ | の | と | そ | こ | お |
上記のような縦書きの五十音表を使った目次が作られます(その他{{CategoryTOC2}}
{{CategoryTOC3}}
{{CategoryTOC4}}
{{CategoryTOCnum3}}
もあります)。
(アルファベットを並べただけのような)非常に短い見出しがたくさんある場合、目次が非常に長くなります。以下のようにすることでコンパクトな目次で置き換えられます(なおCategory:目次テンプレートには{{CompactTOC}}
{{CompactTOC2}}
などもあります)。
__NOTOC__ ] ] ] ] ] ] ] ] ] ] ] ] ] ] ] ] ] ] ] ] ] ] ] ] ] ]
これは以下のように表示されます。
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
1900年代 - 1910年代 - 1920年代 - 1930年代 - 1940年代 - 1950年代 - 1960年代 - 1970年代 - 1980年代 - 1990年代 - 2000年代 - 2010年代 - 2020年代 - 2030年代 - 2040年代 - 2050年代 - 2060年代 - 2070年代 - 2080年代 - 2090年代
目次に掲載するサブセクションの深さは、$wgMaxTocLevelを使ってサイト全体で制限することができます。LocalSettings.phpにて$wgMaxTocLevelの値が例えば3に設定されていれば、目次には第2レベルの見出しまでしか掲載されません。
$wgMaxTocLevel = 3;
バージョン1.10.0rc1までは条件文にバグがあり、制限された目次が正しく生成されていませんでした。これにはバグの報告 T8204で簡単な解決案が提案されました。
{{TOC limit}}
を用いることもできます。
内部リンクのマークアップ]
の中に半角で#
(番号記号)を使うことで、セクション見出しにリンクすることができます。節記号(§)ではありません。
例えば本セクションへのリンクは次のようにします。
]
同一ページ内からは]
の形でもリンクできます。別のページからは]
の形でリンクします。
パイプ(|)を使って]
のように、リンクとして表示する語句を指定することもできます。ただしパイプの裏技は動作しません(Help:パイプ付きリンクを参照)。
]
で指定するリンク先は、セクションの名前以外にも、任意に作れます。テンプレートを使って{{anchors|リンク先}}
とするのが簡単でしょう。
セクションへのリンクの仕組みは、HTML のアンカータグを利用しています。ウィキテキストから生成された HTML コード中の各セクションを表示している部分には name属性・id属性双方ともセクション名を値とするアンカー用のHTML要素 "a"が書き込まれています。メディアウィキはこうしたセクション・アンカーを使ってページの目次を自動作成しますが、人間が手動で任意のセクションへのリンクを作るために使うこともできます。
例えば、本セクションの冒頭で生成されているHTMLコードは次の通りです。
<p><a name="セクションへのリンク" id="セクションへのリンク"></a></p> <h2>セクションへのリンク</h2>
セクションのアンカーはセクションの階層を無視します。したがって、サブセクションやサブサブセクションなどへのリンクは#サブセクション名や#サブサブセクション名のようになります。
セクション名が重複する場合には、アンカー名にアンダースコアと番号が自動的に付け加えられます。例えば「例」というセクションが3つあったら、セクションへのリンクに使うセクション名は上から「例」、「例_2」、「例_3」となります。ですが混乱を招くことに「例_2」や「例_3」のセクションを編集した後、例えば要約欄のリンクをクリックすると「例」のセクションに飛んでしまいます。
セクションの見出しが空白だけの時には目次からのリンクが機能しません。同種の機能についてはHelp:条件文#NS:0を参照してください。
セクション見出しは作らずにアンカーターゲットだけを作成するには、{{anchors}}
を使うのが便利ですが、技術的にはspan などのHTMLタグを利用できます。例えば<span id="アンカー名"></span>
とします。ただし、とても古いブラウザでは動作しません。
セクション見出し内に日付形式統一機能(Help:個人設定#日付の形式)を利用すると、セクションへのリンクが複雑になってしまうので注意してください。
セクション見出し内に内部リンクがあることは、セクションへのリンクという点からは特に不都合を生じません。ただし見出しが正しく表示されない例が報告されているので、使用は避けてください(参考:Wikipedia:スタイルマニュアル_(見出し)#見出しの中でリンクはしない)。
ページ内の任意の位置へのリンク作成についてはHelp:リンク#ページへのリンク作成を参照してください。
リダイレクトページ内のセクションを指定するリンクはリダイレクト先にある同名のセクションへのリンクになります。
あるページ内のセクションへのリダイレクトも現在では使える場合があります。m:Help:Section linking and redirectsが例です(CSSスタイルシートを強制リロードする必要があるかもしれません)。
ページ名の変更の場合と異なり、セクション名を変更してもリンク切れを防ぐなんらかの転送措置は自動的に行われません。また、リンク元ではセクション別のバックリンクの検出はできず、あるセクションにリンクしているページはすべて単にそのページにリンクするページとしてリストされます。回避策として考えられるのは次の通りです。
{{anchors}}
を参照。リダイレクトページはリダイレクトコマンドの後にカテゴリタグを置くことでカテゴリ付けできます。セクションへのリダイレクトと組み合わせれば、カテゴリページからセクションへリンクするという形で、ある程度はセクションをカテゴリ付けできます。しかし、セクションに明示的なカテゴリへのリンクを置かない限り、セクションはカテゴリページにリンクしません。カテゴリページではリダイレクトはredirect-in-category
というCSSセレクタが割り当てられていますので、例えばイタリック体で明示することができます。これはMediaWiki:Common.cssや利用者個人のスタイルシートで設定できます。en:Categorizing redirectsも参照してください。
セクションは見出しの脇にある「編集」というリンクをクリックすることで、個別に編集できます。個人設定によっては、見出しの右クリックでも同じことができます。これは「セクション編集機能」と呼ばれています。セクション編集機能を使うと、次のようなURLの編集ページに飛びます。
//ja.wikipedia.org/w/wiki.phtml?title=Help:セクション&action=edit§ion=2
ここでセクションには「番号」が使われ、セクション名は使われていないことに注意してください。サブセクションにも通して番号が振られますので、例えばセクション2.1はここでは3と振られ、この場合次に来るセクション3がセクション番号4になります。上記のようなURLを直接ブラウザのアドレスバーに入力しても同様の結果が得られます。
この機能は編集が他のセクションには関わらず、編集中にそうした他のセクションのテキストを見る必要がないときに便利です(ほかのセクションのテキストを見る必要があるときには、セクション編集画面を新規ウィンドウで開くかセクション編集中に本文ページを別のウィンドウで開くとよいでしょう)。セクション編集はページサイズが大きい時に起こりうるさまざまな問題を軽減もします。
__NOEDITSECTION__
をページ中のどこかに書きこむと、「編集」リンクが全て表示されなくなります。これはセクション編集自体ができなくなるということではありません。URLの直接入力を使ってセクション編集ができます。また HTMLの<h2>などの見出しタグを用いた見出しや、<noinclude>
タグに囲まれた見出しには、「編集」リンクがつきません。
セクションの挿入は挿入したい位置の前後のセクションのどちらかを編集することで行なえます。前のセクションと統合する時には、見出しを削除します。
ページの最後にセクションを追加するには https://ja.wikipedia.org/w/index.php?title=Wikipedia:サンドボックス&action=edit§ion=new のような§ion=new
を付けたURLで行なうこともできます。ノートページでは特別に「+」というこのためのリンクがあります。この場合、セクションの見出しを入力する「題名・見出し」という名前のテキストボックスが表示され、ここに入力した内容が見出しとなり、またその編集の要約欄の内容にもなります。マジックワード の__NEWSECTIONLINK__
をウィキテキスト内に書き込むと、ページに「+」タブが追加されます。
基本的には最初のセクションの見出しの前にある導入部のテキストだけを編集するためのリンクは提供されていません。ですが、セクション編集機能はこの部分にも適用できます。これをするにはsection=0
とするだけです(例://ja.wikipedia.org/w/wiki.phtml?title=Help:セクション&action=edit§ion=0 )。どこか適当なセクションの「編集」リンクから編集画面を呼び出し、sectionの番号を0に変えることでも同じことができます。
また、個人設定で設定できるガジェットを使って、冒頭部に「編集」リンクを設置することができます。
{{Edit-first-section}}
テンプレートは、ページにセクション0への編集リンクを追加します。メタウィキメディアのHelp:Section editing demoもご覧ください。
MediaWikiは、ウィキペディアの母体であるウィキメディア財団による編集と表示の機能を含めたソフトウェアです。MediaWikiでは、section 0をあらゆるセクションの前のセクションと説明することがあります。「最初のセクションの前の部分」と説明しましたが、実質的には導入部もセクションとしての扱いであるということです。
セクション編集中のプレビューはページ全体を表示したときと同じ結果を表示しているとは限りません。例えば、前のセクションにある画像が編集中のセクションまで侵食しているようなときには、ページ全体を表示したときにはレイアウトが変わってみえるでしょう。
編集ページの「使われているテンプレート」のリストでは、そのページで読み込まれている全てのテンプレートが表示されますので他のセクションで使っているテンプレートも表示されます。
サブセクションは編集するセクションの中に含まれます。編集中のセクションの番号付けは相対的でトップレベルが常に1になり、その下にあるサブセクションは相対的に1.1、1.2などになります。例えば、サブセクション3.2を編集する場合、サブサブセクション3.2.4は1.4と番号が振られます。ただし、見出しの形式は絶対的な見出しの階層に一致します。
もしもページ中にとても大きなセクションがあるかページ自体がとても大きくてセクションに分割されていない場合、ブラウザまたは接続によってはこのような大きなセクションは編集できないことがあります(Help:ページサイズ参照)。このような時にも次のことはできます。
大きなセクションのウィキテキストの閲覧は可能な場合、すこしずつ小さいセクションに分割したテキストを追加し、最後にもとの大きなセクションを削除してもよいでしょう。この場合、作業中はテキストの重複が起きますから要約欄に作業についての説明を書いておく方がよいでしょう。
編集機能は挿入された別ページ(テンプレート)のセクションにも適用できます。呼び出されているセクションの「編集」リンクをクリックすると、別ページの編集画面にとびます。このとき、URLに現れるセクション番号は &action=edit§ion=T-1
のようになります。このセクションHelp:挿入されたテンプレートのセクションの編集が実例になっています。
セクション編集機能では、編集されるセクションの範囲は、別ページを呼び出している親ページの見出しに依存します。例えば、別ページ内の最初の見出しの前にテキストがある場合、親ページ上では、このテキストはテンプレートタグを含んでいるセクションの一部分であるように見えます。しかし、そのセクションの編集リンクをクリックしても、別ページ部分のウィキテキストは表示されません。あるいは、テンプレートタグの直後に、セクション見出しをはさまずにテキストが続いている場合、セクション編集機能を使ってこのテキストを編集するためには、テンプレートタグが挿入されている直前のセクション見出しの編集リンクをクリックしなければなりません。
したがって、親ページの生成画面で表示されているセクションの範囲と、実際のウィキテキストのセクションの範囲が異なると混乱を引き起こします。これを避けるためには、
別ページ内はセクションに分割する必要がなくても、場合によっては、別ページを新しいセクション見出しで始め、別ページ全体を1つのセクションとするとよいでしょう。このようにしておけば、別ページを呼び出しているページでは、別ページへの明示的なリンクをおかなくても、セクション編集機能を使って別ページを編集することができます。この別ページも、1つのセクションになっています。
別ページ(テンプレート)中のパラメータ値、例えば"{{{1}}}"は、テンプレートを編集することではなく、呼び出しているページのテンプレートタグを編集することで指定されることに注意してください。このような時には、説明の文章か、明示的な編集ページへのリンクをおいておくと便利でしょう。
呼び出されているページに__NOEDITSECTION__
タグが含まれていると、そのページだけでなく、呼び出しているページ、またそのページに呼び出されている他の別ページにも効果が及びます。
条件文を使ってセクションの見出しを生成すると、直接的であれセクションを含むテンプレートのトランスクルージョンによってであれ、このセクションおよび後続のセクションの「編集」リンクのリンク先が誤ったものになることがあります(ページの見た目や目次の階層、目次からのリンクは正常です)。これはセクション編集リンクを生成するためのセクションのカウントが条件文の展開の後に行われるのに対して、編集ページを読み込む時にはそこに表示されているセクションだけがカウントされるためです。
これはバグではなく、セクション編集機能の仕様ですので解決法は明白で、条件文を使ったセクション生成をしないかセクション編集機能を止めるしかありません。
ページの分割の利点
セクションをたくさんもつ大きなページの利点
もう1つの方法としてテンプレート機能を利用して、複数のページをまとめて1つのページにする(トランスクルージョンを使って合成ページを作成する)ことができます。こうすれば生成された合成ページ内での検索は容易になりますが、ウィキテキストを一度に検索することはできません。欠点として、それぞれのページにページ名が必要です。また2,048,000バイトの読み込みページサイズ制限が適用されます。
ウィキペディアでの== 見出し ==
のようなマークアップは、表示の際にはその階層に沿って、H1からH6までのHTMLの見出し要素に変換されます。HTMLの仕様において、見出しはセクションを説明するものであり、H1を最も重要なもの、H6を最も重要でないものに用います。セクションの見出し1番目(= 見出し =
)を飛ばしているのは、ページのタイトルに見出し要素のH1が割り当てられるからです。
このように最終的にHTMLに変換されているため、HTMLの表示スタイルを指定するCSSの設定を変更することで、個別の設定を行うことができます。H2とH3をはっきり区別したいといった、個人的な必要性がある場合に便利でしょう。
このサブセクションは、#リンクの方法からリンクされています。
このサブサブセクションは、#リンクの方法からリンクされています。
このセクションは#セクション見出し内で内部リンクさせないからリンクされています。
このセクションは#セクション見出し内で内部リンクさせないからリンクされています。