「テンプレート:Documentation」の版間の差分

提供:メディカルウェア
ナビゲーションに移動 検索に移動
imported>Administrator
(ページの作成:「<div class="template-documentation" style="clear:both; margin:1em 0 1em 0; border:1px solid #aaa; background-color:#ecfcf4; padding:5px"><!--styleパラメータは、本...」)
 
編集の要約なし
 
(他の1人の利用者による、間の1版が非表示)
59行目: 59行目:
     | {{ns:template}}/show
     | {{ns:template}}/show
     | {{ns:user}}/show = <!-- show /sandbox /testcases -->{{
     | {{ns:user}}/show = <!-- show /sandbox /testcases -->{{
       #ifexist:{{ #rel2abs: /sandbox }}
       #ifexist:{{#rel2abs:/sandbox}}
       | {{
       | {{
         #ifexist:{{ #rel2abs: /testcases }}
         #ifexist:{{ #rel2abs: /testcases }}
         | <!-- /sandbox も /testcases も存在する
         | <!-- /sandbox も /testcases も存在する
             -->このテンプレートには、[[/sandbox|サンドボックス]]<small class="plainlinks" style="font-style:normal">([{{
             -->このテンプレートには、[[{{#rel2abs:/sandbox}}|サンドボックス]]<small class="plainlinks" style="font-style:normal">([{{
           fullurl:{{ #rel2abs: /sandbox }}
           fullurl:{{#rel2abs:/sandbox}}
           | action=edit
           | action=edit
           }} 編集])</small>と[[/testcases|テストケース]]<small class="plainlinks" style="font-style:normal">([{{
           }} 編集])</small>と[[{{#rel2abs:/testcases}}|テストケース]]<small class="plainlinks" style="font-style:normal">([{{
           fullurl:{{ #rel2abs: /testcases }}
           fullurl:{{ #rel2abs: /testcases }}
           | action=edit
           | action=edit
           }} 編集])</small>があります。
           }} 編集])</small>があります。
         | <!-- /sandbox は存在するが、 /testcases が存在しない
         | <!-- /sandbox は存在するが、 /testcases が存在しない
             -->このテンプレートには、[[/sandbox|サンドボックス]]<small class="plainlinks" style="font-style:normal">([{{
             -->このテンプレートには、[[{{#rel2abs:/sandbox}}|サンドボックス]]<small class="plainlinks" style="font-style:normal">([{{
           fullurl:{{ #rel2abs: /sandbox }}
           fullurl:{{#rel2abs:/sandbox}}
           | action=edit
           | action=edit
           }} 編集])</small>がありますが、[[/testcases|テストケース]]はありません。
           }} 編集])</small>がありますが、[[{{#rel2abs:/testcases}}|テストケース]]はありません。
         }}<!-- #ifexist: {{ #rel2abs: /testcases }} を閉じる -->
         }}<!-- #ifexist: {{ #rel2abs: /testcases }} を閉じる -->
       | {{
       | {{
         #ifexist:{{ #rel2abs: /testcases }}
         #ifexist:{{ #rel2abs: /testcases }}
         | <!-- /sandbox は存在しないが /testcases が存在する
         | <!-- /sandbox は存在しないが /testcases が存在する
             -->このテンプレートには、[[/testcases|テストケース]]<small class="plainlinks" style="font-style:normal">([{{
             -->このテンプレートには、[[{{#rel2abs:/testcases}}|テストケース]]<small class="plainlinks" style="font-style:normal">([{{
           fullurl: {{ #rel2abs: /testcases }}
           fullurl: {{ #rel2abs: /testcases }}
           | action=edit
           | action=edit
           }} 編集])</small>がありますが、[[/sandbox|サンドボックス]]はありません。
           }} 編集])</small>がありますが、[[{{#rel2abs:/sandbox}}|サンドボックス]]はありません。
         | <!-- /sandbox も /testcases も存在しない
         | <!-- /sandbox も /testcases も存在しない
             -->このテンプレートには、[[/sandbox|サンドボックス]]も[[/testcases|テストケース]]もありません。
             -->このテンプレートには、[[{{#rel2abs:/sandbox}}|サンドボックス]]も[[{{#rel2abs:/testcases}}|テストケース]]もありません。
         }}<!-- #ifexist:{{ #rel2abs: /testcases }} を閉じる -->
         }}<!-- #ifexist:{{ #rel2abs: /testcases }} を閉じる -->
       }}<!-- #ifexist:{{ #rel2abs: /sandbox }} を閉じる -->([[MedicalWare:テンプレートのサンドボックスとテストケース|解説]])<br />
       }}<!-- #ifexist:{{#rel2abs:/sandbox}} を閉じる -->([[MedicalWare:テンプレートのサンドボックスとテストケース|解説]])<br />
     }}<!-- #switch:{{SUBJECTSPACE}}/{{{sandbox-testcases|show}}} を閉じる-->
     }}<!-- #switch:{{SUBJECTSPACE}}/{{{sandbox-testcases|show}}} を閉じる-->


100行目: 100行目:
   | ns:0
   | ns:0
   }}
   }}
}}<div style="clear:both" /></div>
}}<div style="clear:both"></div></div>

2011年3月2日 (水) 15:58時点における最新版

[編集] [キャッシュ破棄] テンプレートの解説
この解説は、テンプレート:Documentation/doc 編集 | 履歴から呼び出されています。
このテンプレートには、サンドボックス編集がありますが、テストケースはありません。(解説

このテンプレートは今ここに表示されているような解説を、他のページから自動的に呼び出して表示します。このテンプレートは他のページに呼び出されるようなページに解説を加えることに使われ、おもにテンプレートでの使用を想定していますが名前空間によって制限されているわけではありません。

使い方[ソースを編集]

基本[ソースを編集]

あなたがこのテンプレートを使用しようとしているページが「Template:X」だとすると「Template:X/doc」に解説を書いて保存し、「Template:X」に次のコードを付け足してください。

<noinclude>{{Documentation}}</noinclude>

ページ指定[ソースを編集]

解説が保存されているページが「Template:any page/doc」である場合、次のコードを「Template:X」に付け足してください。

<noinclude>{{Documentation|Template:any page/doc}}</noinclude>

インライン・コンテンツ[ソースを編集]

解説を別のページに保存せず、次のように「Template:X」に直接書き込むこともできます。

<noinclude>{{Documentation|content=This is documentation.}}</noinclude>

「Template:X/doc」が存在する場合は、そちらも同時に表示されます。

  • 注意:「|content=」で指定した部分に含まれているパイプ構文の表正しく表示されません。「|content=」で指定する部分に表を作成する場合はパイプ構文ではなくHTMLタグを使用するようにしてください。(「/doc」等のこのテンプレートによって呼び出されたページにパイプ構文の表が含まれる場合は、正しく表示されます。)

ヘッドラインを変更する[ソースを編集]

次のように書き込めば、ヘッドラインを変更できます。

<noinclude>{{Documentation|heading=変更したヘッドライン}}</noinclude>

もし次のように heading 引数を空にすれば、ヘッドラインは表示されません。

<noinclude>{{Documentation|heading=}}</noinclude>

注意[ソースを編集]

これらのコードは<noinclude>の前に余分な空白をつけずに、テンプレートやその他の解説を呼び出したいページに付け加えてください。もし、解説・説明文書のページが<includeonly>や<noinclude>といったタグを解説の一部として含むならば「<」を「&lt;」で置き換えてください。

特別な機能[ソースを編集]

プリロード[ソースを編集]

もし解説のページが存在しなければ、[編集]リンクは Template:Documentation/preload から解説の雛形ファイルをプリロードします。

プリロードするファイルは、preload 引数で変更できます。

サンドボックスとテストケースとの連携[ソースを編集]

このテンプレートはサンドボックスとテストケースの存在を確認し、存在していればそのことを存在していなくてもそのことを通知しサンドボックスとテストケースの使用に誘導します。

この機能は、sandbox-testcases引数に「show」以外を指定することによってキャンセルできます。

引数[ソースを編集]

引数の一覧
引数 指定内容 既定値 説明
1 ページ名 {{Documentation/docname}} 解説として読み込むページ名。
content 任意の文章 {{{{{1}}}}} 解説として表示する文章。
heading 任意の文字列 解説 ヘッドラインとして表示する文字列。
heading-style CSS書式 font-size:150% ヘッドラインのスタイル。
heading-padding 単位つき数値(CSS書式) 3px ヘッドラインのパディング。
heading-margin 単位つき数値(CSS書式) 1ex ヘッドラインのマージン。
transcluded 任意の文字列 show 「show」以外を指定すると、読込先を表示しない。
sandbox-testcases 任意の文字列 show 「show」以外を指定すると、サンドボックスとテストケースの存否を表示しない。
preload ページ名 Template:Documentation/preload 解説のページが存在しない場合にプレロードする雛形ファイル。

カテゴリ[ソースを編集]

このテンプレートが貼り付けられたページに適用するカテゴリはありません。

このテンプレートを使う理由[ソースを編集]

  • このテンプレートを使うことによってテンプレートやその他のページが保護されていても、そのページのための解説、言語間リンク、カテゴリなどを変更することができます。
  • テンプレートのページはテンプレートを表示するための空間に読み込まれますが、その空間の大きさはパフォーマンス上の理由により制限されています。解説をサブページにおけば、テンプレートのページ自体に書かれるコードを減らすことができます。

関連項目[ソースを編集]