テンプレート:Anchor-common-doc
このテンプレートは、{{anchors}}、{{Visible anchor}}、{{anchor}}などのヘルプから呼び出されています。 |
アンカー、つまり[[#リンク先]]や[[ページ名#リンク先]]など、ページ内へのリンク先を作るテンプレート、{{anchors}}、{{Visible anchor}}(別名{{vanc}})、{{anchor}}について解説します。
通常は、#引き潮は、節「引き潮」の冒頭へのリンクですが、アンカーを作ることで、任意の名前で、ページ内の任意の箇所にリンク先を作る事ができます。ただし、一つのページの中に同じ名前のアンカーを複数作るとうまく動作しないので、注意して下さい。そのようなページはHTMLとしても正しくありません。W3C Markup Validation Serviceを使うことで、チェックができます。
アンカーを作った際は、どこからリンクしているのかを、コメント、つまり<!-- 注釈 -->の形で明示する方が良いかも知れません。特に、他の記事からリンクをしている際は、そうすることで、アンカーの名前の変更による、アンカーへのリンク切れを防げるでしょう。
使い方
[編集]anchors
[編集]Luaモジュールを使用しています: |
一番単純なのは、{{anchors}}(語末のsに注意)を使う方法です。{{anchors|リンク1|リンク2|...}}とすると、最大9個、アンカーを作れます。これらは、[[#リンク先1]]、[[#リンク先2]]...としてリンクできます。何も表示はされませんが、リンク先が、そこに作られます。
- 例:{{anchors|アンカー1|アンカー2}}
- 結果:(何も見えませんが、アンカーがこの前にあります)
#アンカー1、#アンカー2は、上の「結果」の行にジャンプします。
visible anchor
[編集]{{visible anchor}}(別名{{vanc}})は似たテンプレートですが、1個目のリンク先が表示されます。
- 例:{{visible anchor|va1|va2|va3}}
- 結果:va1
#va1、#va2、#va3は、上のva1にジャンプします。
anchor
[編集]{{anchor}}(語末にsがありません)は、アンカーを一つだけ作ります。引数が一つの場合、{{visible anchor}}と同じになります。
- 例:{{Anchor|アメリカ}}
- 結果:アメリカ
#アメリカでリンクができます。
引数を二つ使い、表示される文字を変える事もできます。[[リンク]]と似た感覚です:
- 例:{{Anchor|イギリス|グレートブリテン及び北アイルランド連合王国}}
- 結果:グレートブリテン及び北アイルランド連合王国
#イギリスでリンクできます。
文字を表示しない事もできます。最初の引数の後にパイプ(|)を書きますが、二番目の引数は空にします:
- 例:{{Anchor|総理大臣|}}首相
- 結果:首相
これで、#総理大臣で「首相」のところにジャンプできます。この方法は、後で他の編集者が、最後のパイプを見落とす可能性もありますので、{{anchors}}の方が良いかも知れません。
節とアンカー
[編集]節に別名を付ける
[編集]アンカーを使い、節に別名を付けることができます。
== {{anchors|別名1|別名2}} 節の名前 ==
もしくは== {{vanc|節の名前|別名1|別名2}} ==
などとします。この節にも、#別名でリンクを作ってあります。ページのソースを見て下さい。
これで、他のページからでも、[[ページ名#別名]]
でリンクできます。
別名が必要な時は、たとえば他のページからその節へのリンクが既にある時に、節の名前を変更した後です。
節の名前の固定と、他の編集者への注意
[編集]アンカー作成テンプレートを使う場合でも、そうでない場合でも、節の名前を変更して欲しくない時は、コメント、つまり<!-- 注釈 -->を使い、他の編集者への注意を残して下さい。元の名前を別名として残して欲しい時は、{{anchors}}を使うこと、詳細は{{anchors}}のヘルプを見よ、などと書いて下さい。
特に、他のページからのリンクがある場合、節の名前が変更されても、リンクが無効になる事を防ぐ事が期待されます。
編集時の不便
[編集]このテンプレートを使用した節を節編集しようとすると、要約欄への自動的な記述が適切に行われません。
== {{Anchor|カルチョ|イタリア}} ==
と書くと、要約欄は本来
/* イタリア */
となるべきですが、
/* {{Anchor|カルチョ|イタリア}} */
となってしまいます。これについては、既知の問題ですので、報告しないで下さい。
別名
[編集]- {{vanc}} = {{visible anchor}}