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

提供: Yourpedia
移動: 案内検索
(<div class="template-documentation" style="clear: both; margin: 1em 0 1em 0; border: 1px solid #aaa; background-color: #ecfcf4; padding: 5px"> ''この記事から呼び出されているウィキペディア由来のテンプレート「[[Tem |{{#ifexist)
(求人広告のユアデム (トーク) による編集を PG による直前の版へ差し戻しました)
1行目: 1行目:
<div class="template-documentation" style="clear: both; margin: 1em 0 1em 0; border: 1px solid #aaa; background-color: #ecfcf4; padding: 5px">
+
このテンプレートは今ここに表示されているような[[Help:テンプレートの説明文|解説]]を、他のページから自動的に呼び出して表示します。このテンプレートは他のページに呼び出されるようなページに解説を加えることに使われ、おもにテンプレートでの使用を想定していますが名前空間によって制限されているわけではありません。
''この記事から呼び出されているウィキペディア由来のテンプレート「[[Tem |{{#ifexist: {{{2}詳細は{{#if:{{{1}}}|「{{#if:{{#ifeq:{{#titleparts:{{{1}}}}}|-||{{#ifeq:[[:特別:Whatlinkshere/{{#titleparts:{{{1}}}}}]]|{{raw:Special:Whatlinkshere/{{#titleparts:{{{1}}}}}}}|valid}}}}|[[:{{{1}}}|{{{1}}}]]|{{{1}}}}}」 | 「{{#invoke:Error|error|エラー:記事名が入力されていません|tag=}}」 }}{{#if:|{{#if:|、|および}}「{{#if:{{#ifeq:{{#titleparts:{{{2}}}}}|-||{{#ifeq:[[:特別:Whatlinkshere/{{#titleparts:{{{2}}}}}]]|{{raw:Special:Whatlinkshere/{{#titleparts:{{{2}}}}}}}|valid}}}}|[[:{{{2}}}|{{{2}}}]]|{{{2}}}}}」 }}{{#if:|{{#if:|、|、および}}「{{#if:{{#ifeq:{{#titleparts:{{{3}}}}}|-||{{#ifeq:[[:特別:Whatlinkshere/{{#titleparts:{{{3}}}}}]]|{{raw:Special:Whatlinkshere/{{#titleparts:{{{3}}}}}}}|valid}}}}|[[:{{{3}}}|{{{3}}}]]|{{{3}}}}}」 }}{{#if:|{{#if:|、|、および}}「{{#if:{{#ifeq:{{#titleparts:{{{4}}}}}|-||{{#ifeq:[[:特別:Whatlinkshere/{{#titleparts:{{{4}}}}}]]|{{raw:Special:Whatlinkshere/{{#titleparts:{{{4}}}}}}}|valid}}}}|[[:{{{4}}}|{{{4}}}]]|{{{4}}}}}」 }}{{#if:|{{#if:|、|、および}}「{{#if:{{#ifeq:{{#titleparts:{{{5}}}}}|-||{{#ifeq:[[:特別:Whatlinkshere/{{#titleparts:{{{5}}}}}]]|{{raw:Special:Whatlinkshere/{{#titleparts:{{{5}}}}}}}|valid}}}}|[[:{{{5}}}|{{{5}}}]]|{{{5}}}}}」 }}{{#if:|{{#if:|、|、および}}「{{#if:{{#ifeq:{{#titleparts:{{{6}}}}}|-||{{#ifeq:[[:特別:Whatlinkshere/{{#titleparts:{{{6}}}}}]]|{{raw:Special:Whatlinkshere/{{#titleparts:{{{6}}}}}}}|valid}}}}|[[:{{{6}}}|{{{6}}}]]|{{{6}}}}}」 }}{{#if:|{{#if:|、|、および}}「{{#if:{{#ifeq:{{#titleparts:{{{7}}}}}|-||{{#ifeq:[[:特別:Whatlinkshere/{{#titleparts:{{{7}}}}}]]|{{raw:Special:Whatlinkshere/{{#titleparts:{{{7}}}}}}}|valid}}}}|[[:{{{7}}}|{{{7}}}]]|{{{7}}}}}」 }}{{#if:|{{#if:|、|、および}}「{{#if:{{#ifeq:{{#titleparts:{{{8}}}}}|-||{{#ifeq:[[:特別:Whatlinkshere/{{#titleparts:{{{8}}}}}]]|{{raw:Special:Whatlinkshere/{{#titleparts:{{{8}}}}}}}|valid}}}}|[[:{{{8}}}|{{{8}}}]]|{{{8}}}}}」 }}{{#if:|{{#if:|、|、および}}「{{#if:{{#ifeq:{{#titleparts:{{{9}}}}}|-||{{#ifeq:[[:特別:Whatlinkshere/{{#titleparts:{{{9}}}}}]]|{{raw:Special:Whatlinkshere/{{#titleparts:{{{9}}}}}}}|valid}}}}|[[:{{{9}}}|{{{9}}}]]|{{{9}}}}}」 }}{{#if:|{{#if:|、|、および}}「{{#if:{{#ifeq:{{#titleparts:{{{10}}}}}|-||{{#ifeq:[[:特別:Whatlinkshere/{{#titleparts:{{{10}}}}}]]|{{raw:Special:Whatlinkshere/{{#titleparts:{{{10}}}}}}}|valid}}}}|[[:{{{10}}}|{{{10}}}]]|{{{10}}}}}」 }}{{#if:|{{#if:|、|、および}}「{{#if:{{#ifeq:{{#titleparts:{{{11}}}}}|-||{{#ifeq:[[:特別:Whatlinkshere/{{#titleparts:{{{11}}}}}]]|{{raw:Special:Whatlinkshere/{{#titleparts:{{{11}}}}}}}|valid}}}}|[[:{{{11}}}|{{{11}}}]]|{{{11}}}}}」 }}{{#if:|{{#if:|、|、および}}「{{#if:{{#ifeq:{{#titleparts:{{{12}}}}}|-||{{#ifeq:[[:特別:Whatlinkshere/{{#titleparts:{{{12}}}}}]]|{{raw:Special:Whatlinkshere/{{#titleparts:{{{12}}}}}}}|valid}}}}|[[:{{{12}}}|{{{12}}}]]|{{{12}}}}}」 }}{{#if:|{{#if:|、|、および}}「{{#if:{{#ifeq:{{#titleparts:{{{13}}}}}|-||{{#ifeq:[[:特別:Whatlinkshere/{{#titleparts:{{{13}}}}}]]|{{raw:Special:Whatlinkshere/{{#titleparts:{{{13}}}}}}}|valid}}}}|[[:{{{13}}}|{{{13}}}]]|{{{13}}}}}」 }}{{#if:|{{#if:|、|、および}}「{{#if:{{#ifeq:{{#titleparts:{{{14}}}}}|-||{{#ifeq:[[:特別:Whatlinkshere/{{#titleparts:{{{14}}}}}]]|{{raw:Special:Whatlinkshere/{{#titleparts:{{{14}}}}}}}|valid}}}}|[[:{{{14}}}|{{{14}}}]]|{{{14}}}}}」 }}{{#if:|、および「{{#if:{{#ifeq:{{#titleparts:{{{15}}}}}|-||{{#ifeq:[[:特別:Whatlinkshere/{{#titleparts:{{{15}}}}}]]|{{raw:Special:Whatlinkshere/{{#titleparts:{{{15}}}}}}}|valid}}}}|[[:{{{15}}}|{{{15}}}]]|{{{15}}}}}」 }}{{#if:|…{{#invoke:Error|error|最大15記事までです。|tag=}} }}を参照
+
+
+
これは記事の内容を補足する記事へのリンクを生成するテンプレートです。plate:未完]]」は、正しく機能しないため無効化されています([[wiki:Template:{{PAGENAME}}|原版はこちら]])。''
+
</div><noinclude>
+
問題を起こしている機能を使用しない形にテンプレートを改良するか、或いはテンプレートの機能に必要なMediaWiki拡張機能が復旧した際に、無効化される前の版に戻すことが可能です。
+
  
[[Category:お知らせテンプレート|*]]</noinclude>
+
__TOC__
 +
== 使い方 ==
 +
=== 基本 ===
 +
あなたがこのテンプレートを使用しようとしているページが「Template:X」だとすると「Template:X/doc」に解説を書いて保存し、「Template:X」に次のコードを付け足してください。
 +
&lt;noinclude&gt;&#123;&#123;{{{template-name|Documentation}}}&#125;&#125;&lt;/noinclude&gt;
 +
 
 +
=== ページ指定 ===
 +
解説が保存されているページが「Template:any page/doc」である場合、次のコードを「Template:X」に付け足してください。
 +
&lt;noinclude&gt;&#123;&#123;{{{template-name|Documentation}}}|Template:any page/doc&#125;&#125;&lt;/noinclude&gt;
 +
 
 +
=== インライン・コンテンツ ===
 +
解説を別のページに保存せず、次のように「Template:X」に直接書き込むこともできます。
 +
&lt;noinclude&gt;&#123;&#123;{{{template-name|Documentation}}}|content=This is documentation.&#125;&#125;&lt;/noinclude&gt;
 +
「Template:X/doc」が存在する場合は、そちらも同時に表示されます。
 +
*'''注意''':「|content=」で指定した部分に含まれている[[Help:表の作り方#パイプ構文|パイプ構文の表]]は'''正しく表示されません'''。「|content=」で指定する部分に表を作成する場合はパイプ構文ではなくHTMLタグを使用するようにしてください(「/doc」等のこのテンプレートによって呼び出されたページにパイプ構文の表が含まれる場合は、'''正しく表示されます''')。
 +
 
 +
=== ヘッドラインを変更する ===
 +
次のように書き込めば、ヘッドラインを変更できます。
 +
&lt;noinclude&gt;&#123;&#123;{{{template-name|Documentation}}}|heading=変更したヘッドライン&#125;&#125;&lt;/noinclude&gt;
 +
 
 +
もし次のように heading 引数を空にすれば、ヘッドラインは表示されません。
 +
&lt;noinclude&gt;&#123;&#123;{{{template-name|Documentation}}}|heading=&#125;&#125;&lt;/noinclude&gt;
 +
 
 +
=== 注意 ===
 +
これらのコードは&lt;noinclude&gt;の前に余分な空白をつけずに、テンプレートやその他の解説を呼び出したいページに付け加えてください。もし、解説・説明文書のページが&lt;includeonly&gt;や&lt;noinclude&gt;といったタグを解説の一部として含むならば「&lt;」を「&amp;lt;」で置き換えてください。
 +
 
 +
== 特別な機能 ==
 +
=== プリロード ===
 +
もし解説のページが存在しなければ、[編集]リンクは[[Template:Documentation/preload]]から解説の雛形ファイルを[[mw:Manual:Creating pages with preloaded text/ja|プリロード]]します。
 +
 
 +
プリロードするファイルは、preload 引数で変更できます。
 +
 
 +
=== サンドボックスとテストケースとの連携 ===
 +
このテンプレートは[[Wikipedia:テンプレートのサンドボックスとテストケース|サンドボックスとテストケース]]の存在を確認し、存在していればそのことを存在していなくてもそのことを通知しサンドボックスとテストケースの使用に誘導します。
 +
 
 +
この機能は、sandbox-testcases引数に「show」以外を指定することによってキャンセルできます。
 +
 
 +
== 引数 ==
 +
{| class="wikitable"
 +
|+引数の一覧
 +
!引数!!指定内容!!既定値!!説明
 +
|-
 +
!style="text-align:left"|1
 +
|ページ名||{{Tl|Documentation/docname}}||解説として読み込むページ名。
 +
|-
 +
!style="text-align:left"|content
 +
|任意の文章||<nowiki>{{{{{1}}}}}</nowiki>||解説として表示する文章。
 +
|-
 +
!style="text-align:left"|heading
 +
|任意の文字列||解説||ヘッドラインとして表示する文字列。
 +
|-
 +
!style="text-align:left"|heading-style
 +
|CSS書式||font-size:150%||ヘッドラインのスタイル。
 +
|-
 +
!style="text-align:left; white-space:nowrap"|heading-padding
 +
|style="white-space:nowrap"|単位つき数値(CSS書式)||3px||ヘッドラインのパディング。
 +
|-
 +
!style="text-align:left"|heading-margin
 +
|単位つき数値(CSS書式)||1ex||ヘッドラインのマージン。
 +
|-
 +
!style="text-align:left"|transcluded
 +
|任意の文字列||show||「show」以外を指定すると、読込先を表示しない。
 +
|-
 +
!style="text-align:left"|sandbox-testcases
 +
|任意の文字列||show||「show」以外を指定すると、サンドボックスとテストケースの存否を表示しない。
 +
|-
 +
!style="text-align:left"|preload
 +
|ページ名||style="white-space:nowrap"|[[Template:Documentation/preload]]||解説のページが存在しない場合にプレロードする雛形ファイル。
 +
|}
 +
 
 +
== カテゴリ ==
 +
''このテンプレートが貼り付けられたページに適用するカテゴリはありません。''
 +
 
 +
== このテンプレートを使う理由 ==
 +
* このテンプレートを使うことによってテンプレートやその他のページが[[Wikipedia:保護の方針|保護]]されていても、そのページのための解説、言語間リンク、カテゴリなどを変更することができます。
 +
* テンプレートのページはテンプレートを表示するための空間に読み込まれますが、その空間の大きさはパフォーマンス上の理由により[[Help:テンプレートの制限|制限されています]]。解説をサブページにおけば、テンプレートのページ自体に書かれるコードを減らすことができます。
 +
 
 +
== 関連項目 ==
 +
* [[Help:テンプレートの説明文]]
 +
* [[Wikipedia:テンプレートのサンドボックスとテストケース]]
 +
* {{Tl|Documentation subpage}}
 +
<includeonly>{{
 +
  #ifeq: {{SUBPAGENAME}} | sandbox
 +
  |
 +
  |
 +
{{DEFAULTSORT:{{PAGENAME}}}}
 +
[[Category:テンプレート文書| ]]
 +
[[Category:テンプレート用テンプレート]]
 +
}}</includeonly>

2015年8月27日 (木) 17:31時点における版

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

使い方

基本

あなたがこのテンプレートを使用しようとしているページが「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 解説のページが存在しない場合にプレロードする雛形ファイル。

カテゴリ

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

このテンプレートを使う理由

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

関連項目