「テンプレート:Pathnav/doc」の版間の差分

提供:クレープ屋まとめwiki
ナビゲーションに移動 検索に移動
(1版 をインポートしました)
 
編集の要約なし
1行目: 1行目:
<noinclude>{{Documentation subpage|種類=[[Help:テンプレート|テンプレート]]}}</noinclude>
<includeonly>{{使用箇所の多いテンプレート|40,000以上}}</includeonly>
[[パンくずリスト]]あるいはトピックパス([[木構造 (データ構造)|ツリー構造]]を表すナビゲーションリンク)を生成するテンプレート。


本テンプレートを使用するにあたっては、事前にその分野で使用について何らかの合意がないかどうか確認してください。(例:[[プロジェクト:日本の市町村#トピックパス(Pathnav)]])
== 使用基準 ==


== 使用基準 ==
本テンプレートを使用するにあたっては、パスの構造が以下の基準を満たしていることが望ましいです。
本テンプレートを使用するにあたっては、パスの構造が以下の基準を満たしていることが望ましいです。
*'''認知されている''' - [[Wikipedia:信頼できる情報源|信頼できる情報源]]において一般的に使われているツリー構造であること。
 
*'''中立的''' - [[Wikipedia:中立的な観点|中立的な視点]]に基づくツリー構造であり、ツリー構造に異論の出る余地が少ないものであること。
*'''認知されている''' - [[https://en.wikipedia.org/wiki/信頼できる情報源|信頼できる情報源]]において一般的に使われているツリー構造であること。
*'''中立的''' - [[https://en.wikipedia.org/wiki/中立的な観点|中立的な視点]]に基づくツリー構造であり、ツリー構造に異論の出る余地が少ないものであること。
*'''安定的''' - ツリー構造が一時的なものでなく、将来に渡って比較的安定すると考えられること。
*'''安定的''' - ツリー構造が一時的なものでなく、将来に渡って比較的安定すると考えられること。
*'''深すぎない'''- 関連性の強い、簡単なツリー構造であること。
*'''深すぎない'''- 関連性の強い、簡単なツリー構造であること。
*'''浅すぎない'''- 原則として3段以上の階層構造であること。
*'''浅すぎない'''- 原則として3段以上の階層構造であること。


使用にあたっては[[Wikipedia:ウィキプロジェクト|ウィキプロジェクト]]や[[Wikipedia:ウィキポータル|ウィキポータル]]などで事前に合意しておくことが必要です。パス構造が変化した場合にも関係するページ全てでPathnavが正しく表示されるよう、プロジェクトが責任を持って管理しなければなりません。管理できそうにない場合は使用しないでください。
使用にあたっては[[https://en.wikipedia.org/wiki/ウィキプロジェクト|ウィキプロジェクト]]や[[https://en.wikipedia.org/wiki/ウィキポータル|ウィキポータル]]などで事前に合意しておくことが必要です。パス構造が変化した場合にも関係するページ全てでPathnavが正しく表示されるよう、プロジェクトが責任を持って管理しなければなりません。管理できそうにない場合は使用しないでください。


== 使い方 ==
== 使い方 ==
項目の冒頭([[曖昧さ回避]]の下、[[Template:mbox|メッセージボックス]]の上)に設置します。
 
項目の冒頭([[曖昧さ回避|曖昧さ回避]]の下、[[テンプレート:Mbox|メッセージボックス]]の上)に設置します。
 


<nowiki>{{Pathnav | ページ名1 | ページ名2 | … | ページ名9 | hide = 1 | frame = 1 | namespace = 名前空間名 }}</nowiki>
<nowiki>{{Pathnav | ページ名1 | ページ名2 | … | ページ名9 | hide = 1 | frame = 1 | namespace = 名前空間名 }}</nowiki>


== 引数 ==
== 引数 ==
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|+ 引数の一覧
|+ 引数の一覧
! 引数 !! 指定内容 !! 既定値 !! 説明
|-
! 引数
! 指定内容
! 既定値
! 説明
|-
|-
! 1 ~ 9
! 1 ~ 9
| ページ名 || なし || リンクを表示させるページ名を、名前空間を除いて指定します。最大9個まで指定できます。<br />存在しないページ名を指定した場合はリンクせずにそのまま表示します。<br />
| ページ名
変数を <nowiki>[[ ]]</nowiki> で囲む必要はありません。
| なし
| リンクを表示させるページ名を、名前空間を除いて指定します。最大9個まで指定できます。<br/>存在しないページ名を指定した場合はリンクせずにそのまま表示します。<br/>
変数を
<nowiki>[[ ]]</nowiki>
で囲む必要はありません。
|-
|-
! this
! this
| ページ名 || 貼り付け先のページ名 || 呼出元のページ名の表示名を変えることができます。
| ページ名
| 貼り付け先のページ名
| 呼出元のページ名の表示名を変えることができます。
|-
|-
! hide
! hide
| 空白以外 || なし || 呼出元のページ名を省略できます。<br/>パスをツリー状に表示する場合([[#ツリー状に表示する|後述]])に、先頭の行に付けるなどします。
| 空白以外
| なし
| 呼出元のページ名を省略できます。<br/>パスをツリー状に表示する場合([[#.E3.83.84.E3.83.AA.E3.83.BC.E7.8A.B6.E3.81.AB.E8.A1.A8.E7.A4.BA.E3.81.99.E3.82.8B|後述]])に、先頭の行に付けるなどします。
|-
|-
! frame
! frame
| 空白以外 || なし || 枠に囲まれた状態で表示します。<br />Categoryページなどのパンくずリストに適しています。
| 空白以外
| なし
| 枠に囲まれた状態で表示します。<br/>Categoryページなどのパンくずリストに適しています。
|-
|-
! namespace
! namespace
| 名前空間 || 貼り付け先の名前空間 || リンク先の名前空間を指定します。
| 名前空間
| 貼り付け先の名前空間
| リンク先の名前空間を指定します。
|}
|}


== 使用例 ==
== 使用例 ==
=== 通常 ===
=== 通常 ===
<nowiki>{{Pathnav|日本|東京都|新宿区}}</nowiki>
<nowiki>{{Pathnav|日本|東京都|新宿区}}</nowiki>


{{Pathnav|日本|東京都|新宿区|<nowiki>西新宿</nowiki>|hide=1|namespace=}}
{{Pathnav|日本|東京都|新宿区|西新宿|hide=1|namespace=}}


呼び出し元の[[Help:名前空間|名前空間]]に応じて、自動的にリンクされます。
呼び出し元の[[ヘルプ:名前空間|名前空間]]に応じて、自動的にリンクされます。


=== 枠なし ===
=== 枠なし ===
([[Wikipedia:表記ガイド]]から呼び出した場合)
 
([[wikipedia:表記ガイド|wikipedia:%E8%A1%A8%E8%A8%98%E3%82%AC%E3%82%A4%E3%83%89]]から呼び出した場合)
 


<nowiki>{{Pathnav|プロジェクト関連文書|スタイルマニュアル}}</nowiki>
<nowiki>{{Pathnav|プロジェクト関連文書|スタイルマニュアル}}</nowiki>


{{Pathnav|プロジェクト関連文書|スタイルマニュアル|<nowiki>表記ガイド</nowiki>|hide=1|namespace=Wikipedia}}
{{Pathnav|プロジェクト関連文書|スタイルマニュアル|表記ガイド|hide=1|namespace=Wikipedia}}


=== 枠付き ===
=== 枠付き ===
(Category名前空間のページから呼び出した場合)
(Category名前空間のページから呼び出した場合)


<nowiki> {{Pathnav|主要カテゴリ|…|日本|日本の文化|frame=1|hide=1}}</nowiki>
<nowiki> {{Pathnav|主要カテゴリ|…|日本|日本の文化|frame=1|hide=1}}</nowiki>
65行目: 88行目:


== pathnavbox スタイル ==
== pathnavbox スタイル ==
=== 複数のパスを並べる ===
=== 複数のパスを並べる ===
複数のパンくずリストを並べる場合、それぞれに ''frame'' パラメータを指定すると、枠が各行ごとにいくつも生成されてしまいます。これを避け、並べた複数のパンくずリスト全体を一つの枠に納めるためには、以下のように記述します。
複数のパンくずリストを並べる場合、それぞれに ''frame'' パラメータを指定すると、枠が各行ごとにいくつも生成されてしまいます。これを避け、並べた複数のパンくずリスト全体を一つの枠に納めるためには、以下のように記述します。
<pre>
<pre>&lt;div class="pathnavbox"&gt;
&lt;div class="pathnavbox"&gt;
* {{Pathnav|foo|bar|baz}}
* {{Pathnav|foo|bar|baz}}
* {{Pathnav|hoge|piyo}}
* {{Pathnav|hoge|piyo}}
74行目: 98行目:
</pre>
</pre>
<div class="pathnavbox">
<div class="pathnavbox">
* {{Pathnav|foo|<nowiki>bar</nowiki>|baz|呼出元ページ|hide=1}}
*{{Pathnav|foo|bar|baz|呼出元ページ|hide=1}}
* {{Pathnav|hoge|piyo|呼出元ページ|hide=1}}
*{{Pathnav|hoge|piyo|呼出元ページ|hide=1}}
</div>
</div>
=== ツリー状に表示する ===


=== ツリー状に表示する ===
''class="pathnavbox"'' を指定したタグの内側では、箇条書きの行頭のマークは表示されません。
''class="pathnavbox"'' を指定したタグの内側では、箇条書きの行頭のマークは表示されません。
<pre>
<pre>&lt;div class="pathnavbox"&gt;
&lt;div class="pathnavbox"&gt;
* {{Pathnav|foo|bar|hide=1}}
* {{Pathnav|foo|bar|hide=1}}
** {{Pathnav|baz}}
** {{Pathnav|baz}}
88行目: 111行目:
</pre>
</pre>
<div class="pathnavbox">
<div class="pathnavbox">
* {{Pathnav|foo|<nowiki>bar</nowiki>|hide=1}}
*{{Pathnav|foo|bar|hide=1}}
** {{Pathnav|baz|呼出元ページ|hide=1}}
**{{Pathnav|baz|呼出元ページ|hide=1}}
** {{Pathnav|hoge|piyo|呼出元ページ|hide=1}}
**{{Pathnav|hoge|piyo|呼出元ページ|hide=1}}
</div>
</div>
== 関連項目 ==
== 関連項目 ==
* {{tl|子記事}} - 記事内容に親子関係がある場合の、子記事でのパンくずリスト生成


<includeonly>
*{{tl|子記事}} - 記事内容に親子関係がある場合の、子記事でのパンくずリスト生成
<!-- Add categories below this line -->
{{デフォルトソート:{{PAGENAME}}}}
[[Category:内部リンク用テンプレート]]
[[Category:条件文]]


<!-- Add interlangs below this line -->
<!-- Add categories below this line -->{{デフォルトソート:{{PAGENAME}}}} <!-- Add interlangs below this line -->






</includeonly>
fckLR
[[Category:内部リンク用テンプレート]] [[Category:条件文]]

2016年5月6日 (金) 14:14時点における版

使用基準

本テンプレートを使用するにあたっては、パスの構造が以下の基準を満たしていることが望ましいです。

  • 認知されている - [[1]]において一般的に使われているツリー構造であること。
  • 中立的 - [[2]]に基づくツリー構造であり、ツリー構造に異論の出る余地が少ないものであること。
  • 安定的 - ツリー構造が一時的なものでなく、将来に渡って比較的安定すると考えられること。
  • 深すぎない- 関連性の強い、簡単なツリー構造であること。
  • 浅すぎない- 原則として3段以上の階層構造であること。

使用にあたっては[[3]]や[[4]]などで事前に合意しておくことが必要です。パス構造が変化した場合にも関係するページ全てでPathnavが正しく表示されるよう、プロジェクトが責任を持って管理しなければなりません。管理できそうにない場合は使用しないでください。

使い方

項目の冒頭(曖昧さ回避の下、メッセージボックスの上)に設置します。


{{Pathnav | ページ名1 | ページ名2 | … | ページ名9 | hide = 1 | frame = 1 | namespace = 名前空間名 }}

引数

引数の一覧
引数 指定内容 既定値 説明
1 ~ 9 ページ名 なし リンクを表示させるページ名を、名前空間を除いて指定します。最大9個まで指定できます。
存在しないページ名を指定した場合はリンクせずにそのまま表示します。

変数を [[ ]] で囲む必要はありません。

this ページ名 貼り付け先のページ名 呼出元のページ名の表示名を変えることができます。
hide 空白以外 なし 呼出元のページ名を省略できます。
パスをツリー状に表示する場合(後述)に、先頭の行に付けるなどします。
frame 空白以外 なし 枠に囲まれた状態で表示します。
Categoryページなどのパンくずリストに適しています。
namespace 名前空間 貼り付け先の名前空間 リンク先の名前空間を指定します。

使用例

通常

{{Pathnav|日本|東京都|新宿区}}

日本 > 東京都 > 新宿区 > 西新宿

呼び出し元の名前空間に応じて、自動的にリンクされます。

枠なし

wikipedia:%E8%A1%A8%E8%A8%98%E3%82%AC%E3%82%A4%E3%83%89から呼び出した場合)


{{Pathnav|プロジェクト関連文書|スタイルマニュアル}}

プロジェクト関連文書 > スタイルマニュアル > 表記ガイド

枠付き

(Category名前空間のページから呼び出した場合)


{{Pathnav|主要カテゴリ|…|日本|日本の文化|frame=1|hide=1}}

主要カテゴリ > … > 日本 > 日本の文化

pathnavbox スタイル

複数のパスを並べる

複数のパンくずリストを並べる場合、それぞれに frame パラメータを指定すると、枠が各行ごとにいくつも生成されてしまいます。これを避け、並べた複数のパンくずリスト全体を一つの枠に納めるためには、以下のように記述します。

<div class="pathnavbox">
* {{Pathnav|foo|bar|baz}}
* {{Pathnav|hoge|piyo}}
</div>
  • foo > bar > baz > 呼出元ページ
  • hoge > piyo > 呼出元ページ

ツリー状に表示する

class="pathnavbox" を指定したタグの内側では、箇条書きの行頭のマークは表示されません。

<div class="pathnavbox">
* {{Pathnav|foo|bar|hide=1}}
** {{Pathnav|baz}}
** {{Pathnav|hoge|piyo}}
</div>
  • foo > bar
    • baz > 呼出元ページ
    • hoge > piyo > 呼出元ページ

関連項目

  • {{子記事}} - 記事内容に親子関係がある場合の、子記事でのパンくずリスト生成



fckLR