「Wikipedia:テンプレートのサンドボックスとテストケース｣

栄光のﾆﾀﾞｰﾗﾝ
ちょっと走ってくる
携帯wikipediaビュア「うらぺでぃあ」

前4)下8)次6) 初1)末3)

Wikipedia:テンプレートのサンドボックスとテストケース - Wikipedia

stylepath="http://bits.wikimedia.org/skins-1.5",

/* */
Wikipedia:テンプレートのサンドボックスとテストケース
出典: フリー百科事典『ウィキペディア（Wikipedia）』

この文書はウィキペディア日本語版の考慮すべきガイドラインです。多くの利用者が基本的に同意しており、従うことが推奨されますが、公式な方針ではありません。必要に応じて編集することは可能ですが、大きな変更を加える場合は、先にノートページで提案してください。
テンプレートはメディアウィキのとても強力な機能ですが、経験を積んだ利用者であってさえも、簡単に失敗をしてしまうことがあります。したがって、バグを防ぐために、複雑なテンプレートにはそのサブページとして、試作を行うサンドボックスとその試作品の呼び出しをテストするテストケースが必要です。
目次
1 この方法が向いているテンプレート
2 サンドボックスとテストケースのサブページの作り方
2.1 サブページを作る
2.2 サンドボックスにコードを複製する
2.3 テストケースを作る
3 サンドボックスとテストケースの使い方
4 サンドボックス対応のコードの書き方
5 テストケース対応のコードの書き方
6 実例
7 脚注
8 関連項目
//

この方法が向いているテンプレート

テンプレートは多くのページに呼び出されるものであり、テンプレートの編集で失敗をするとその影響が大きくなります。そのため、大きな変更をする前にサンドボックスでテストをするのがよいでしょう。膨大な数のページに呼び出されているテンプレートは、編集する前に必ずテストしてください。
特に条件文を使ったテンプレートは、多くの引数をとったり、#switch演算子の多くの分岐によって、非常に多彩な出力を生成することができます。このようなテンプレートは、プレビューやサンドボックスだけでは問題がないか確かめることが困難であり、テストケースでいろいろなパターンの出力を試すことが勧められます。さらに、このようなテストケースは表示例の一覧としても役に立ちます。
逆に、関連項目へのリンク一覧であるナビゲーションテンプレートのように、パラメータを受け取らず、どの呼び出し先でも同じ表示がされるものはテストケースを利用する利点が少ないといえるでしょう。
また、テンプレートが呼び出されたページの構成によっては表示に問題が起こることがあります。それを防ぐために、サンドボックスに作成したテンプレートを様々な環境で閲覧して確かめたり、テストケースで他のテンプレートや表、画像などと一緒に表示した結果をテストすることもできます。

サンドボックスとテストケースのサブページの作り方

サブページを作る
テンプレートの名前がTemplate:Xだとすると、サンドボックスの名前はTemplate:X/sandbox、テストケースの名前はTemplate:X/testcasesになります。
テンプレートの解説に、{{Documentation}}が使われていれば、それぞれのサブページへの赤リンクがあるので、そこからサブページを作成することができます。既にこの名前のサブページがあれば、{{Documentation}}を用いてそれらにリンクすることができます。{{Documentation}}が使われていない場合は、改めて使用するか独自にサブページへのリンクを作ってください。

サンドボックスにコードを複製する

サンドボックスにコードを複製します。その際、履歴継承の必要性などGFDLの諸条件を満たす必要があります。つまり、
Template:X/sandboxの末尾に、Template:Xから <noinclude> で囲まれていない部分全体を複製します。要約欄には「[[Template:X]]のxxxx年xx月xx日 xx:xx (UTC) から一部複製」と記入し一旦投稿します。
次のコードを最初の行の先頭に挿入します。<noinclude>と</noinclude>の間には空行があっても構いませんが、</noinclude>の後には空行や空白を入れないでください。
<noinclude>{{Template sandbox notice}}</noinclude>
必要があればその他の編集を行なった上で投稿します[1]。
1.と2.とで2回に分けて投稿するのは複製作業と編集作業とを明確に区別するためです。手順の詳細については、Wikipedia:ページの分割と統合#一部転記の手順も参考にしてください。

テストケースを作る

Template:X/testcasesにはいくつかの呼び出しの例 ({{X | .... }}) を作成します。テンプレートの解説文にある場合はそれをコピーしてください。そして、それぞれの例をさらに二つに複製します。さらにそれぞれの例の片方について、XをX/sandboxに置き換えてください。これで、元のテンプレートによる表示と新しいテンプレートによる表示を一つ一つ比較できるようになります。最後に、{{Template test cases notice}}をテストケースのページの先頭に加えてください。周囲に空行を入れても構いません。
最終的に、Template:X/testcasesは、次のようなコードになるはずです：
{{Template test cases notice}}
{{X | .... }}
{{X/sandbox | .... }}

サンドボックスとテストケースの使い方

まず、サンドボックスを編集して新しいテンプレートにします。ノートページやローカルのエディタなどで新しいテンプレートを用意してある場合や、既存のテンプレートと全く違うものを作る場合でなければ、サンドボックスを作るときと同じように現在のテンプレートを複製してから、それを編集しましょう。
次にテストケースを表示し、新しいテンプレートが問題なく呼び出されるか確認します。新しい出力と元の出力を比較するには、テストケースに一度に表示されるのを比べる方法だけでなく、タブ・ブラウザを使って、サンドボックスを変更する前にテストケースのサブページを表示し、サンドボックスの変更後にもう一つのタブで表示することで、変更前後のテストケースを比べる方法もあります。

出典:Wikipedia

「Wikipedia:テンプレートのサンドボックスとテストケース」@2ch

ProducedBy(^_^;)
上前次 1- 末

Powered byGoogle

Wikipedia:テンプレートのサンドボックスとテストケース@amazon
Wikipedia:テンプレートのサンドボックスとテストケース@2典
Wikipedia:テンプレートのサンドボックスとテストケース@YouTube
Wikipedia:テンプレートのサンドボックスとテストケース@ヤフオク

携帯wikipediaビュア「うらぺでぃあ」
Powered by Maido3.com
Body text is available under
GNU Free Documentation License.