「テンプレート:Pathnav/doc」の版間の差分
細 (1版 をインポートしました) |
編集の要約なし |
||
1行目: | 1行目: | ||
== 使用基準 == | |||
本テンプレートを使用するにあたっては、パスの構造が以下の基準を満たしていることが望ましいです。 | 本テンプレートを使用するにあたっては、パスの構造が以下の基準を満たしていることが望ましいです。 | ||
*'''認知されている''' - [[ | |||
*'''中立的''' - [[ | *'''認知されている''' - [[https://en.wikipedia.org/wiki/信頼できる情報源|信頼できる情報源]]において一般的に使われているツリー構造であること。 | ||
*'''中立的''' - [[https://en.wikipedia.org/wiki/中立的な観点|中立的な視点]]に基づくツリー構造であり、ツリー構造に異論の出る余地が少ないものであること。 | |||
*'''安定的''' - ツリー構造が一時的なものでなく、将来に渡って比較的安定すると考えられること。 | *'''安定的''' - ツリー構造が一時的なものでなく、将来に渡って比較的安定すると考えられること。 | ||
*'''深すぎない'''- 関連性の強い、簡単なツリー構造であること。 | *'''深すぎない'''- 関連性の強い、簡単なツリー構造であること。 | ||
*'''浅すぎない'''- 原則として3段以上の階層構造であること。 | *'''浅すぎない'''- 原則として3段以上の階層構造であること。 | ||
使用にあたっては[[ | 使用にあたっては[[https://en.wikipedia.org/wiki/ウィキプロジェクト|ウィキプロジェクト]]や[[https://en.wikipedia.org/wiki/ウィキポータル|ウィキポータル]]などで事前に合意しておくことが必要です。パス構造が変化した場合にも関係するページ全てでPathnavが正しく表示されるよう、プロジェクトが責任を持って管理しなければなりません。管理できそうにない場合は使用しないでください。 | ||
== 使い方 == | == 使い方 == | ||
項目の冒頭([[曖昧さ回避]]の下、[[ | |||
項目の冒頭([[曖昧さ回避|曖昧さ回避]]の下、[[テンプレート: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 | ||
| ページ名 | | ページ名 | ||
変数を <nowiki>[[ ]]</nowiki> で囲む必要はありません。 | | なし | ||
| リンクを表示させるページ名を、名前空間を除いて指定します。最大9個まで指定できます。<br/>存在しないページ名を指定した場合はリンクせずにそのまま表示します。<br/> | |||
変数を | |||
<nowiki>[[ ]]</nowiki> | |||
で囲む必要はありません。 | |||
|- | |- | ||
! this | ! this | ||
| ページ名 | | ページ名 | ||
| 貼り付け先のページ名 | |||
| 呼出元のページ名の表示名を変えることができます。 | |||
|- | |- | ||
! hide | ! hide | ||
| 空白以外 | | 空白以外 | ||
| なし | |||
| 呼出元のページ名を省略できます。<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ページなどのパンくずリストに適しています。 | |||
|- | |- | ||
! namespace | ! namespace | ||
| 名前空間 | | 名前空間 | ||
| 貼り付け先の名前空間 | |||
| リンク先の名前空間を指定します。 | |||
|} | |} | ||
== 使用例 == | == 使用例 == | ||
=== 通常 === | === 通常 === | ||
<nowiki>{{Pathnav|日本|東京都|新宿区}}</nowiki> | <nowiki>{{Pathnav|日本|東京都|新宿区}}</nowiki> | ||
{{Pathnav|日本|東京都|新宿区| | {{Pathnav|日本|東京都|新宿区|西新宿|hide=1|namespace=}} | ||
呼び出し元の[[ | 呼び出し元の[[ヘルプ:名前空間|名前空間]]に応じて、自動的にリンクされます。 | ||
=== 枠なし === | === 枠なし === | ||
([[ | |||
([[wikipedia:表記ガイド|wikipedia:%E8%A1%A8%E8%A8%98%E3%82%AC%E3%82%A4%E3%83%89]]から呼び出した場合) | |||
<nowiki>{{Pathnav|プロジェクト関連文書|スタイルマニュアル}}</nowiki> | <nowiki>{{Pathnav|プロジェクト関連文書|スタイルマニュアル}}</nowiki> | ||
{{Pathnav|プロジェクト関連文書|スタイルマニュアル| | {{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><div class="pathnavbox"> | ||
<div class="pathnavbox"> | |||
* {{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| | *{{Pathnav|foo|bar|baz|呼出元ページ|hide=1}} | ||
* {{Pathnav|hoge|piyo|呼出元ページ|hide=1}} | *{{Pathnav|hoge|piyo|呼出元ページ|hide=1}} | ||
</div> | </div> | ||
=== ツリー状に表示する === | |||
''class="pathnavbox"'' を指定したタグの内側では、箇条書きの行頭のマークは表示されません。 | ''class="pathnavbox"'' を指定したタグの内側では、箇条書きの行頭のマークは表示されません。 | ||
<pre> | <pre><div class="pathnavbox"> | ||
<div class="pathnavbox"> | |||
* {{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| | *{{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|子記事}} - 記事内容に親子関係がある場合の、子記事でのパンくずリスト生成 | |||
{{ | |||
<!-- Add interlangs below this line --> | <!-- Add categories below this line -->{{デフォルトソート:{{PAGENAME}}}} <!-- Add interlangs below this line --> | ||
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}}
複数のパスを並べる
複数のパンくずリストを並べる場合、それぞれに frame パラメータを指定すると、枠が各行ごとにいくつも生成されてしまいます。これを避け、並べた複数のパンくずリスト全体を一つの枠に納めるためには、以下のように記述します。
<div class="pathnavbox"> * {{Pathnav|foo|bar|baz}} * {{Pathnav|hoge|piyo}} </div>
ツリー状に表示する
class="pathnavbox" を指定したタグの内側では、箇条書きの行頭のマークは表示されません。
<div class="pathnavbox"> * {{Pathnav|foo|bar|hide=1}} ** {{Pathnav|baz}} ** {{Pathnav|hoge|piyo}} </div>
関連項目
- {{子記事}} - 記事内容に親子関係がある場合の、子記事でのパンくずリスト生成
fckLR