Template:Documentation/doc
[Wikipedia|▼Menu]
.mw-parser-output .ombox{margin:4px 0;border-collapse:collapse;border:1px solid #a2a9b1;background-color:#f8f9fa;box-sizing:border-box}.mw-parser-output .ombox.mbox-small{font-size:88%;line-height:1.25em}.mw-parser-output .ombox-speedy{border:2px solid #b32424;background-color:#fee7e6}.mw-parser-output .ombox-delete{border:2px solid #b32424}.mw-parser-output .ombox-content{border:1px solid #f28500}.mw-parser-output .ombox-style{border:1px solid #fc3}.mw-parser-output .ombox-move{border:1px solid #9932cc}.mw-parser-output .ombox-protection{border:2px solid #a2a9b1}.mw-parser-output .ombox .mbox-text{border:none;padding:0.25em 0.9em;width:100%;font-size:90%}.mw-parser-output .ombox .mbox-image{border:none;padding:2px 0 2px 0.9em;text-align:center}.mw-parser-output .ombox .mbox-imageright{border:none;padding:2px 0.9em 2px 0;text-align:center}.mw-parser-output .ombox .mbox-empty-cell{border:none;padding:0;width:1px}.mw-parser-output .ombox .mbox-invalid-type{text-align:center}@media(min-width:720px){.mw-parser-output .ombox{margin:4px 10%}.mw-parser-output .ombox.mbox-small{clear:right;float:right;margin:4px 0 4px 1em;width:238px}}

これはTemplate:Documentation解説サブページです。
使用方法、カテゴリ、およびその他テンプレートページ自体に含まれない情報を収容しています。

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

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

解説が保存されているページが「Template:any page/doc」である場合、次のコードを「Template:テンプレート名例示用」に付け足してください。<noinclude>{{Documentation|Template:any page/doc}}</noinclude>
インライン・コンテンツ

解説を別のページに保存せず、次のように「Template:テンプレート名例示用」に直接書き込むこともできます。<noinclude>{{Documentation|content=This is documentation.}}</noinclude>

「Template:テンプレート名例示用/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」以外を指定することによってキャンセルできます。
保護アイコンの表示 

このテンプレートを使用しているテンプレートが保護されていれば、そのテンプレートのページに{{pp-template}}に相当するインジケーターアイコンを表示し、さらにCategory:編集保護中のテンプレートCategory:編集半保護中のテンプレートなどのカテゴリを付与します。

したがって本テンプレートを使用しているのであれば、テンプレートを保護しても手動で{{pp-template}}を追加する必要はありません。荒らし行為や編集合戦などを理由に一時的に保護する場合、テンプレートのページにおいて{{Documentation}}より後ろに{{pp-vandalism|small=yes}}のようなテンプレート呼び出しを挿入することで、インジケーターアイコンを上書きすることができます。
引数

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

カテゴリ

このテンプレートが使用されているページが保護されている場合はCategory:編集保護中のテンプレートCategory:編集半保護中のテンプレートなどのカテゴリを付与します。
このテンプレートを使う理由

このテンプレートを使うことによってテンプレートやその他のページが
保護されていても、そのページのための解説、言語間リンク、カテゴリなどを変更することができます。

テンプレートのページはテンプレートを表示するための空間に読み込まれますが、その空間の大きさはパフォーマンス上の理由により制限されています。解説をサブページにおけば、テンプレートのページ自体に書かれるコードを減らすことができます。


次ページ
記事の検索
おまかせリスト
▼オプションを表示
ブックマーク登録
mixiチェック!
Twitterに投稿
オプション/リンク一覧
話題のニュース
列車運行情報
暇つぶしWikipedia

Size:10 KB
出典: フリー百科事典『ウィキペディア(Wikipedia)
担当:undef