Help:セクション
ウィキペディア日本語版のヘルプページです。元文書はメタウィキのヘルプです。
セクション(節)の編集方法について説明します。記事の文章は見出しのついたセクション(節)に分割することができます。ここでは見出しのマークアップを使いセクションに分割する編集方法、各セクションの見出しにリンクする方法、またセクションを編集する機能、また目次について説明します。目次は、見出しが4つ以上になると以下のように自動的に生成されます。
どのようにセクションを分割するのかについては、Wikipedia:スタイルマニュアル/見出しをご覧ください。
セクションの作成と番号付け
[編集]セクションは次のようにセクションの見出しを作ることで作成されます(見出しのことを英語の転用で「ヘッディング」(heading) ともいいます[注 1]。「ヘッド」(head) 、「ヘッダ」(header) という言い方もありますが、ページの上部にあるテキスト群と区別を付けるために「ヘッディング」という表現が好まれます)。
== セクションの見出し == === サブセクションの見出し === ==== サブサブセクションの見出し ====
等号の数が多くなるほど、セクションの階層が深くなります。
セクションの名前の両脇に1つの等号のみを付けないでください(例: = 見出し =
)。このようにすると、ページ冒頭に表示されているページ名と同じ階層の見出しになってしまいます。なお、ページ名は自動的に生成されています。
個人設定で見出しに番号を振る設定をすると、セクション見出しに番号がつきます。
セクションの見出しはページ内で同じものを使わない方がよいでしょう。セクションと同じ見出しをサブセクションに使うこともおすすめできません。同じ見出しを複数回使うとセクション編集(後述)をしたあと、要約欄のリンクが間違ったリンク先に飛んでしまうことが起こり得ます。
ページには別ページ(テンプレート)をセクション(または複数の連続するセクション)として呼び出すことができ、閲覧しただけではその事実はわかりません。詳しくはHelp:テンプレート#ページの合成を参照してください。この方法をとると事実上セクションの編集履歴を分離したり、セクションだけをウォッチすることができます。
セクションを含むテンプレートを呼び出している場合、テンプレート内のセクションは生成されるページ内でのその位置に応じて番号付けされます。例えば、テンプレートタグが3番目のセクションにあるとすると、テンプレート内の最初のセクションは「4」と番号付けされます。テンプレート内の最初のセクションより前にあるテキストはテンプレートタグが置かれているセクションの一部とみなされ、またテンプレートタグの後から次の見出しまでにあるテキストはテンプレート内の最後のセクションの一部とみなされます。このようなことは意図的に行うこともできますが通常は避けた方がよいでしょう(下記も参照)。
目次(TOC)
[編集]見出しが4つ以上あるページには、基本的にセクション見出しから自動生成される目次が表示され、「ベクター(2022年版)」以外の外装では、#toc
と記述すると記事中の目次にリンクする(戻る)ことが出来ます。ただし次の場合を除きます。
- (記事側で)ウィキテキストにマジックワードの
__NOTOC__
(両脇のアンダースコア2つも必要です)が記入されている。
目次は、デスクトップ(パソコン)版の「ベクター(2022年版)」の外装では左側(メニューが出ている場合はその下)に表示され、それ以外の外装やモバイル版では本文内(通常は冒頭定義文のあと)に表示されます。
見出しの数が4つ未満であってもウィキテキスト内に__FORCETOC__
または__TOC__
を書きこむと、目次が表示されます。
- 最初のセクションの前
__FORCETOC__
があると、目次は最初のセクション見出しの前に置かれます。
- 任意の位置
__TOC__
があると、この文字列がある任意の位置に目次が置かれます。- 通常は目次の直後に最初の見出しがある形が望ましいですが、導入部が長くて目次が下に行きすぎることを防ぐためなど、右端やテーブルのセル中に表示させることもできます。
- なお、
__TOC__
を複数書きこむと、最初のところに目次が生成されます(メディアウィキの古いバージョンでは複数の目次が生成できましたが、現在はできません)。
- 目次なし
__NOTOC__
を使うことで、通常の目次を無効化することができます。
- 右端
- 次のコードを使うと、目次を画面の右端に浮動テーブルとして置くことができます(
{{TOCright}}
もあります)。
{| style="float:right" |__TOC__ |}
Categoryカテゴリページ内の目次
[編集] {{CategoryTOC}}
と記入します。
目次 | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
おまかせ表示 | わ | ら | や | ま | は | な | た | さ | か | あ | トップ頁へ | ||
り | み | ひ | に | ち | し | き | い | ||||||
を | る | ゆ | む | ふ | ぬ | つ | す | く | う | ||||
れ | め | へ | ね | て | せ | け | え | ||||||
ん | ろ | よ | も | ほ | の | と | そ | こ | お |
上記のような縦書きの五十音表を使った目次が作られます(その他{{CategoryTOC2}}
{{CategoryTOC3}}
{{CategoryTOC4}}
{{CategoryTOCnum3}}
もあります)。
コンパクトな目次
[編集](アルファベットを並べただけのような)非常に短い見出しがたくさんある場合、目次が非常に長くなります。以下のようにすることでコンパクトな目次で置き換えられます(なおCategory:目次テンプレートには{{CompactTOC}}
{{CompactTOC2}}
などもあります)。
__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
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:セクション#セクションへのリンク]]
同一ページ内からは[[#セクション名]]
の形でもリンクできます。別のページからは[[ページ名#セクション名]]
の形でリンクします。
パイプ(|)を使って[[Help:セクション#セクションへのリンク|セクションへのリンクする方法]]
のように、リンクとして表示する語句を指定することもできます。ただしパイプの裏技は動作しません(Help:パイプ付きリンクを参照)。
[[#リンク先]]
で指定するリンク先は、セクションの名前以外にも、任意に作れます。テンプレートを使って{{anchors|リンク先}}
とするのが簡単でしょう。
URLエンコード/パーセントエンコーディングや、anchors以外では、それをピリオド(.)に置き換えたものも利用可能ですが、記事編集に使用すると分かりにくくなります。
「#セクションへのリンク」の例 #%E3%82%BB%E3%82%AF%E3%82%B7%E3%83%A7%E3%83%B3%E3%81%B8%E3%81%AE%E3%83%AA%E3%83%B3%E3%82%AF #.E3.82.BB.E3.82.AF.E3.82.B7.E3.83.A7.E3.83.B3.E3.81.B8.E3.81.AE.E3.83.AA.E3.83.B3.E3.82.AF
技術
[編集]セクションへのリンクの仕組みは、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:スタイルマニュアル_(見出し)#見出しの中でリンクはしない)。
- #Demo a
- Help:セクション#Demo http:.2F.2Fa
- //ja-two.iwiki.icu/wiki/Help:セクション#Demo_http:.2F.2Fa
ページ内の任意の位置へのリンク作成についてはHelp:リンク#ページへのリンク作成を参照してください。
セクションへのリンクとリダイレクト
[編集]リダイレクトページ内のセクションを指定するリンクはリダイレクト先にある同名のセクションへのリンクになります。
あるページ内のセクションへのリダイレクトも現在では使える場合があります[1]。m:Help:Section linking and redirectsが例です(CSSスタイルシートを強制リロードする必要があるかもしれません)。
ページ名の変更の場合と異なり、セクション名を変更してもリンク切れを防ぐなんらかの転送措置は自動的に行われません。また、リンク元ではセクション別のバックリンクの検出はできず、あるセクションにリンクしているページはすべて単にそのページにリンクするページとしてリストされます。回避策として考えられるのは次の通りです。
- セクションに直接リンクする代りに、セクションにリダイレクトするページへリンクする。セクションの名前が変わったときにはリダイレクト先を変更します。この方法はセクションに対する「リンク元」らしきものも提供します(まずページに対してリンクしているリダイレクトを探し、その下にあるリンクを見ます。セクション名が変わってもリダイレクトページの名前から推測できるでしょう)。
- アンカータグを別に置いて、それにリンクする。
{{anchors}}
を参照。 - セクション冒頭にコメントアウトの形でセクションにリンクするページのリストを書き込む。
- セクションを別のページもしくはテンプレートに分離し親ページに呼び出す、または親ページからリンクする。この場合、セクションにリンクするのではなく別ページにリンクできます。
リダイレクトページはリダイレクトコマンドの後にカテゴリタグを置くことでカテゴリ付けできます。セクションへのリダイレクトと組み合わせれば、カテゴリページからセクションへリンクするという形で、ある程度はセクションをカテゴリ付けできます。しかし、セクションに明示的なカテゴリへのリンクを置かない限り、セクションはカテゴリページにリンクしません。カテゴリページではリダイレクトはredirect-in-category
というCSSセレクタが割り当てられていますので、例えばイタリック体で明示することができます。これはMediaWiki:Common.cssや利用者個人のスタイルシートで設定できます。en:Categorizing redirectsも参照してください。
セクション編集
[編集]セクションは見出しの脇にある「編集」というリンクをクリックすることで、個別に編集できます。個人設定によっては、見出しの右クリックでも同じことができます。これは「セクション編集機能」と呼ばれています。セクション編集機能を使うと、次のようなURLの編集ページに飛びます。
//ja-two.iwiki.icu/w/wiki.phtml?title=Help:セクション&action=edit§ion=2
ここでセクションには「番号」が使われ、セクション名は使われていないことに注意してください。サブセクションにも通して番号が振られますので、例えばセクション2.1はここでは3と振られ、この場合次に来るセクション3がセクション番号4になります。上記のようなURLを直接ブラウザのアドレスバーに入力しても同様の結果が得られます。
この機能は編集が他のセクションには関わらず、編集中にそうした他のセクションのテキストを見る必要がないときに便利です(ほかのセクションのテキストを見る必要があるときには、セクション編集画面を新規ウィンドウで開くかセクション編集中に本文ページを別のウィンドウで開くとよいでしょう)。セクション編集はページサイズが大きい時に起こりうるさまざまな問題を軽減もします。
__NOEDITSECTION__
をページ中のどこかに書きこむと、「編集」リンクが全て表示されなくなります。これはセクション編集自体ができなくなるということではありません。URLの直接入力を使ってセクション編集ができます。また HTMLの<h2>などの見出しタグを用いた見出しや、<noinclude>
タグに囲まれた見出しには、「編集」リンクがつきません。
セクションの挿入は挿入したい位置の前後のセクションのどちらかを編集することで行なえます。前のセクションと統合する時には、見出しを削除します。
ページの最後にセクションを追加するには https://ja-two.iwiki.icu/w/index.php?title=Wikipedia:サンドボックス&action=edit§ion=new のような§ion=new
を付けたURLで行なうこともできます。ノートページでは特別に「+」というこのためのリンクがあります。この場合、セクションの見出しを入力する「題名・見出し」という名前のテキストボックスが表示され、ここに入力した内容が見出しとなり、またその編集の要約欄の内容にもなります。マジックワード の__NEWSECTIONLINK__
をウィキテキスト内に書き込むと、ページに「+」タブが追加されます。
最初のセクションの前の部分の編集
[編集]基本的には最初のセクションの見出しの前にある導入部のテキストだけを編集するためのリンクは提供されていません。ですが、セクション編集機能はこの部分にも適用できます。これをするにはsection=0
とするだけです(例://ja-two.iwiki.icu/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、1.2などになります。例えば、サブセクション3.2を編集する場合、サブサブセクション3.2.4は1.4と番号が振られます。ただし、見出しの形式は絶対的な見出しの階層に一致します。
大きなセクションを持つページの編集
[編集]もしもページ中にとても大きなセクションがあるかページ自体がとても大きくてセクションに分割されていない場合、ブラウザまたは接続によってはこのような大きなセクションは編集できないことがあります(Help:ページサイズ参照)。このような時にも次のことはできます。
- 今あるセクションよりも大きなセクション番号を指定することによりセクションを追加する(大きすぎることは問題にはなりません)。ただし、新しいセクション見出しの前に空白行が加わります。
- 同じ方法でセクション見出しを付けないことで、最後のセクションに内容を追加する。ただし、ブラウザや接続環境の制限がある場合、この部分をあとから編集したり差し戻すことはできなくなります。
大きなセクションのウィキテキストの閲覧は可能な場合、すこしずつ小さいセクションに分割したテキストを追加し、最後にもとの大きなセクションを削除してもよいでしょう。この場合、作業中はテキストの重複が起きますから要約欄に作業についての説明を書いておく方がよいでしょう。
挿入されたテンプレートのセクションの編集
[編集]編集機能は挿入された別ページ(テンプレート)のセクションにも適用できます。呼び出されているセクションの「編集」リンクをクリックすると、別ページの編集画面にとびます。このとき、URLに現れるセクション番号は &action=edit§ion=T-1
のようになります。このセクションHelp:挿入されたテンプレートのセクションの編集が実例になっています。
セクション編集機能では、編集されるセクションの範囲は、別ページを呼び出している親ページの見出しに依存します。例えば、別ページ内の最初の見出しの前にテキストがある場合、親ページ上では、このテキストはテンプレートタグを含んでいるセクションの一部分であるように見えます。しかし、そのセクションの編集リンクをクリックしても、別ページ部分のウィキテキストは表示されません。あるいは、テンプレートタグの直後に、セクション見出しをはさまずにテキストが続いている場合、セクション編集機能を使ってこのテキストを編集するためには、テンプレートタグが挿入されている直前のセクション見出しの編集リンクをクリックしなければなりません。
したがって、親ページの生成画面で表示されているセクションの範囲と、実際のウィキテキストのセクションの範囲が異なると混乱を引き起こします。これを避けるためには、
- 別ページ(テンプレート)が見出しを持っている場合、最初の見出しの前にテキストをおかないでください。
- 親ページでは、セクションをもつ別ページの後には、新しいセクション見出しをおいてください。
別ページ内はセクションに分割する必要がなくても、場合によっては、別ページを新しいセクション見出しで始め、別ページ全体を1つのセクションとするとよいでしょう。このようにしておけば、別ページを呼び出しているページでは、別ページへの明示的なリンクをおかなくても、セクション編集機能を使って別ページを編集することができます。この別ページも、1つのセクションになっています。
別ページ(テンプレート)中のパラメータ値、例えば"{{{1}}}"は、テンプレートを編集することではなく、呼び出しているページのテンプレートタグを編集することで指定されることに注意してください。このような時には、説明の文章か、明示的な編集ページへのリンクをおいておくと便利でしょう。
呼び出されているページに__NOEDITSECTION__
タグが含まれていると、そのページだけでなく、呼び出しているページ、またそのページに呼び出されている他の別ページにも効果が及びます。
関連項目
[編集]
条件文中のセクション
[編集]条件文を使ってセクションの見出しを生成すると、直接的であれセクションを含むテンプレートのトランスクルージョンによってであれ、このセクションおよび後続のセクションの「編集」リンクのリンク先が誤ったものになることがあります(ページの見た目や目次の階層、目次からのリンクは正常です)。これはセクション編集リンクを生成するためのセクションのカウントが条件文の展開の後に行われるのに対して、編集ページを読み込む時にはそこに表示されているセクションだけがカウントされるためです。
これはバグではなく、セクション編集機能の仕様ですので解決法は明白で、条件文を使ったセクション生成をしないかセクション編集機能を止めるしかありません。
セクション、ページの分割、トランスクルージョンの比較
[編集]ページの分割の利点
- リンク元が使える。
- 編集履歴が分離できる。
- 改名の際に自動的にリダイレクトが作られる。
- 短いページを読み込む(ロードする)ほうが長いページを読み込むより早く済む。
- それぞれにカテゴリに入れられる。
セクションをたくさんもつ大きなページの利点
- 長くても1ページを読み込むほうが短いページをいくつも読み込むより速くて簡単である。
- ブラウザやコンピュータの検索機能を利用してページ内を検索する方がプロジェクト全体から複数のページを検索するよりも速く、検索結果の表示や負荷の点からも優れている(生成ページもウィキテキストも検索可能)。さらに目次が便利な案内役になる。
- 複数の定義を含む概念の記事の場合、全体を見通した記事執筆が容易になる。
もう1つの方法としてテンプレート機能を利用して、複数のページをまとめて1つのページにする(トランスクルージョンを使って合成ページを作成する)ことができます。こうすれば生成された合成ページ内での検索は容易になりますが、ウィキテキストを一度に検索することはできません。欠点として、それぞれのページにページ名が必要です。また2,048,000バイトの読み込みページサイズ制限が適用されます。
HTMLとカスタム表示
[編集]ウィキペディアでの== 見出し ==
のようなマークアップは、表示の際にはその階層に沿って、H1からH6までのHTMLの見出し要素に変換されます。HTMLの仕様において、見出しはセクションを説明するものであり、H1を最も重要なもの、H6を最も重要でないものに用います[2]。セクションの見出し1番目(= 見出し =
)を飛ばしているのは、ページのタイトルに見出し要素のH1が割り当てられるからです[3]。
このように最終的にHTMLに変換されているため、HTMLの表示スタイルを指定するCSSの設定を変更することで、個別の設定を行うことができます。H2とH3をはっきり区別したいといった、個人的な必要性がある場合に便利でしょう。
デモ用セクション
[編集]サブセクション名
[編集]このサブセクションは、#リンクの方法からリンクされています。
サブサブセクション名
[編集]このサブサブセクションは、#リンクの方法からリンクされています。
このセクションは#セクション見出し内で内部リンクさせないからリンクされています。
このセクションは#セクション見出し内で内部リンクさせないからリンクされています。
関連項目
[編集]脚注
[編集]注釈
[編集]- ^ 最終的に変換され表示される際の、HTMLの仕様においても、見出し (heading) は、そのセクションの説明とされます。(W3C) Dave Raggett, Arnaud Le Hors, Ian Jacobs (24 December 1999). “W3C Recommendation HTML 4.01 Specification - 7 The global structure of an HTML document”. World Wide Web Consortium (W3C). 2014年9月1日閲覧。、または(W3C) Robin Berjon, Steve Faulkner, Travis Leithead, Erika Doyle Navara, Edward O'Connor, Silvia Pfeiffer, Ian Hickson (31 July 2014). “HTML5: A vocabulary and associated APIs for HTML and XHTML: W3C Candidate Recommendation 31 July 2014”. World Wide Web Consortium (W3C). 2014年9月1日閲覧。
出典
[編集]- ^ “Manual:Parameters to index.php#Raw”. 2014年8月17日閲覧。
- ^ (W3C)Dave Raggett, Arnaud Le Hors, Ian Jacobs (24 December 1999). “W3C Recommendation HTML 4.01 Specification - 7 The global structure of an HTML document”. W3C. 2014年9月1日閲覧。
- ^ Help:Formatting (MediaWiki), version: 22 August 2014, at 07:07.