テンプレート:Idlink/doc

{{idlink|arg1}}
{{idlink|arg1|arg2}}

Wikipedia での
　　{{anchor|arg1}}
　　{{anchor|arg1|[[#arg1|arg2]]}}
に、それぞれ相当するものであり、
　　<span id="arg1"></span>
　　<span id="arg1">[[#arg1|arg2]]</span>
に、それぞれ展開されます。 旧wiki(PukiWiki)での
　　&aname(arg1){};
　　&aname(arg1){arg2};
の代わりです。

arg1 をその位置のページ内リンク用識別子にします。

arg2 があれば、arg2 をそこで表示し、
表示された arg2 をクリックすると、それ自身に飛ぶようにします。
ただし、そのような URL（…#arg1）をブラウザーが取得できるようにしておくこと
が目的であり、 飛ぶ機能自体は確認などのためのものです。

例１）
{{idlink|guide1}}案内１
は、
案内１
と表示されて「案内１」しか見えませんが、
例えば、#guide1 をクリックすると、案内１（の直前）に飛びます。
例２）
{{idlink|guide2|案内２}}
は、
案内２
と表示され、それをクリックすると、それ自身に飛びます。

注意
次のように使うのは、たいていは 不適切 です。

=== エンコードされると１字が９バイトになる見出し１ ===
{{idlink|shortid1}}

{{idlink|shortid2}}
=== エンコードされると１字が９バイトになる見出し２ ===

=== {{idlink|shortid3|エンコードされると１字が９バイトになる見出し３}} ===

１番目のは、#shortid1 をリンク先にすると、
本来の見出しの次の行に飛んでしまいます。
２番目のでは、節単位編集で {{idlink|shortid2}} が、
前の節にまぎれこんでしまいます。
３番目のについては、Wikipedia の Help ページによると
「セクション見出し内に内部リンク……使用は避けてください」
「見出しの中でリンクはしないでください」（どこへのリンクでも）
とのことです。
http://ja.wikipedia.org/wiki/Help:%E3%82%BB%E3%82%AF%E3%82%B7%E3%83%A7%E3%83%B3#.E3.82.BB.E3.82.AF.E3.82.B7.E3.83.A7.E3.83.B3.E8.A6.8B.E5.87.BA.E3.81.97.E5.86.85.E3.81.A7.E5.86.85.E9.83.A8.E3.83.AA.E3.83.B3.E3.82.AF.E3.81.95.E3.81.9B.E3.81.AA.E3.81.84
http://ja.wikipedia.org/wiki/WP:MSH#NOLINK
（ただし、Wikipedia の Help ページでも、例えば、
http://ja.wikipedia.org/wiki/H:SPC#Unicode_OpenType.E3.83.95.E3.82.A9.E3.83.B3.E3.83.88
内の小見出しには、これに「違反」したものがあるのですが。）
現状では、（下記の）４番目や５番目のような書きかたを 正解扱い しておく
しかないようです。

=== {{idlink|shortid4}}エンコードされると１字が９バイトになる見出し４ ===
{{見出しショートカット|shortid4}}

=== <span id="shortid5"></span>エンコードされると１字が９バイトになる見出し５ ===
{{見出しショートカット|shortid5}}

上で言及した、#NOLINK の節の見出し（2013年6月25日 (火) 12:34 UTC の版で確認）
などは、（リダイレクトでページ名を短縮していることにかかわることや
ショートカット名自体を表示していることなども切り捨てて、単純化すると）
機能としては４番目のに相当する書きかたになっていました。
ただし、４番目のでは（３番目のでも、そうですが）節単位編集のとき、
編集サマリー入力ボックスの中にテンプレート呼び出しが書かれてしまいます。
（なお、見出しの中でテンプレートを substで使うことは、
「しないでください」とのことです。）
そこまで考慮するのなら、見出しの中でテンプレートを使わないで、
５番目のような書きかたをすることになります。
http://ja.wikipedia.org/wiki/Template:Anchor/doc#.E7.B7.A8.E9.9B.86.E6.99.82.E3.81.AE.E4.B8.8D.E4.BE.BF
http://en.wikipedia.org/wiki/Template:Anchor/doc#Limitations
（ただし、古めの環境では
　　<span … />
に未対応であることも、考慮に入れました。）

※ ３番目、４番目、５番目について、上述の説明では、
３番目と、４番目、５番目の間で線引きしていますが、
「４番目も不適切」という主張のかたも、
「３番目でも不適切ではない」という主張のかたも、
いらっしゃいました。
なお、以前の版で３番目について、
「関連する難点」が報告されていたと書き、記憶により同様の例を再現しましたが、
その「難点」は
http://ja.wikipedia.org/wiki/H:T#.E3.83.86.E3.83.B3.E3.83.97.E3.83.AC.E3.83.BC.E3.83.88.E3.82.92.E5.91.BC.E3.81.B3.E5.87.BA.E3.81.99
にある記載に拠り解決されるべき別のこと、とのご指摘をいただきましたので、
論拠から除外しました( http://info.2ch.net/?oldid=9211 )。