Template:GamesSport/doc
 | これはTemplate:GamesSportの解説サブページです。 使用方法、カテゴリ、およびその他テンプレート自体に含まれない情報を収容しています。 |
Template:GamesSportは、総合競技大会の各回大会主記事でのみ使用されることを前提にしたテンプレートです。このテンプレートの目的は、総合競技大会の各回大会主記事において、その実施競技一覧を記述する方法を徹底的に簡素化することです。
典型的には、それらの記事には大会の実施競技の一覧が記されることが多く、それは次に挙げる3つまたは4つの要素で構成されます:
- 当該競技の主記事へのリンク
- 当該大会における当該競技の概要や競技結果を記した記事へのリンク
- 当該大会期間中に実施される当該競技の全種目数
- 当該競技を表すピクトグラム画像
GamesSportテンプレートを使用すれば、競技名を入力するだけで、これら全ての要素を表示することができます。基本的な使い方は以下の通りです:
{{GamesSport|競技名}}
背景
[編集]普通の書き方（GamesSportを使用しない場合）
[編集]従来は、前掲の各要素を以下に示すように別々に書き込む必要がありました（2012年ロンドンオリンピックを例に）:
{{Colbegin|3}}
* [[陸上競技]]（[[2012年ロンドンオリンピックの陸上競技|詳細]]）
* [[自転車競技]]（[[2012年ロンドンオリンピックの自転車競技|詳細]]）
* [[サッカー]]（[[2012年ロンドンオリンピックのサッカー競技|詳細]]）
* [[テニス]]（[[2012年ロンドンオリンピックのテニス競技|詳細]]）
* [[フィールドホッケー|ホッケー]]（[[2012年ロンドンオリンピックのホッケー競技|詳細]]）
* [[体操競技|体操]]（[[2012年ロンドンオリンピックの体操競技|詳細]]）
{{Colend}}
GamesSportを使用した書き方
[編集]GamesSportテンプレートを使うことで、競技の記事の一覧をずっと簡単に表示することができ、各競技の記事名とそれに対応するピクトグラム画像のファイル記事名を一々探す手間を省けます。出力結果に表示されるリンクは、テンプレートを使用した記事の記事名に応じた名前のリンクを返します。そのため、このページ（GamesSportの解説サブページ）でテンプレートを使用した場合、"GamesSport/docの〈競技名〉"という名前のリンクを返します。2008年北京オリンピックの記事内で使用すれば、 "2008年北京オリンピックの〈競技名〉"という名前のリンクを返します（現在、このリンク表示に関しては解決すべき課題があります。詳細はノートを参照）。
{{Colbegin|3}}
* {{GamesSport|Athletics}}
* {{GamesSport|Cycling}}
* {{GamesSport|Football}}
* {{GamesSport|Tennis}}
* {{GamesSport|Field hockey}}
* {{GamesSport|Gymnastics}}
{{Colend}}
種目数を追加する
[編集]引数 "Events=〈種目数〉" を使うことで、各競技の種目数を追加できます:
{{Colbegin|3}}
* {{GamesSport|Athletics|Events=47}}
* {{GamesSport|Cycling|Events=18}}
* {{GamesSport|Football|Events=2}}
* {{GamesSport|Tennis|Events=5}}
* {{GamesSport|Field hockey|Events=2}}
* {{GamesSport|Gymnastics|Events=18}}
{{Colend}}
上記のように記述すると以下の結果を返します:
ピクトグラム画像を非表示にする
[編集]引数 "Image=No" を使うことで、ピクトグラム画像を非表示にできます:
{{Colbegin|3}}
* {{GamesSport|Athletics|Events=47|Image=No}}
* {{GamesSport|Cycling|Events=18|Image=No}}
* {{GamesSport|Football|Events=2|Image=No}}
* {{GamesSport|Tennis|Events=5|Image=No}}
* {{GamesSport|Field hockey|Events=2|Image=No}}
* {{GamesSport|Gymnastics|Events=18|Image=No}}
{{Colend}}
上記のように記述すると以下の結果を返します:
リンクする記事の形式を変更する
[編集]引数"Format"により、リンクする記事の形式を変更できます。
- 競技の主記事 (main sport) のみへリンクしたい場合は、引数 "Format=m"
- オリンピック競技大会 (olympics) に類似する記事の場合は、引数 "Format=o"
- 国民体育大会 (kokutai) などの記事の場合は、引数 "Format=k"
- 上記以外の総合競技大会 (details) の記事の場合は、引数 "Format=d"
- オリンピック競技の主記事（例: オリンピックの陸上競技 etc.）にリンクし、競技結果の詳細リンクも別に表示したい場合 (olympic sports details) は、引数 "Format=osd"
- オリンピック競技の主記事のみへリンクしたい場合 (olympic sports main) は、引数"Format=osm"
なぜこれほど複雑な仕様になっているのか、その詳細はノートを参照。
| 値 | 例 | リンク先 |
|---|---|---|
| m | {{GamesSport|Athletics|Format=m}} →  陸上競技
|
競技名 |
| o | {{GamesSport|Athletics|Format=o}} → 陸上競技
|
記事名 + の + 競技名 |
| d | {{GamesSport|Athletics|Format=d}} → 陸上競技
|
記事名 + における + 競技名 |
| k | {{GamesSport|Athletics|Format=k}} → 陸上競技
|
記事名 + 競技名 |
| osd | {{GamesSport|Athletics|Format=osd}} → 陸上競技（詳細）
|
オリンピックの + 競技名 + (記事名 + の + 競技名) |
| osm | {{GamesSport|Athletics|Format=osm}} → 陸上競技
|
オリンピックの + 競技名 |
Format=m
[編集]競技の主記事 (main sport) のリンクのみを表示したい場合は、引数 "Format=m" を使います:
{{Colbegin|3}}
* {{GamesSport|Athletics|Events=47|Format=m}}
* {{GamesSport|Cycling|Events=18|Format=m}}
* {{GamesSport|Football|Events=2|Format=m}}
* {{GamesSport|Tennis|Events=5|Format=m}}
* {{GamesSport|Field hockey|Events=2|Format=m}}
* {{GamesSport|Gymnastics|Events=18|Format=m}}
{{Colend}}
上記のように記述すると以下の結果を返します:
Format=o
[編集]オリンピック競技大会 (olympics) に類似する記事の場合に、引数 "Format=o" を使います:
{{Colbegin|3}}
* {{GamesSport|Athletics|Events=47|Format=o}}
* {{GamesSport|Cycling|Events=18|Format=o}}
* {{GamesSport|Football|Events=2|Format=o}}
* {{GamesSport|Tennis|Events=5|Format=o}}
* {{GamesSport|Field hockey|Events=2|Format=o}}
* {{GamesSport|Gymnastics|Events=18|Format=o}}
{{Colend}}
上記のように記述すると以下の結果を返します:
Format=k
[編集]国民体育大会 (kokutai) などの記事で、引数 "Format=k" を使います:
{{Colbegin|3}}
* {{GamesSport|Athletics|Events=47|Format=k}}
* {{GamesSport|Cycling|Events=18|Format=k}}
* {{GamesSport|Football|Events=2|Format=k}}
* {{GamesSport|Tennis|Events=5|Format=k}}
* {{GamesSport|Field hockey|Events=2|Format=k}}
* {{GamesSport|Gymnastics|Events=18|Format=k}}
{{Colend}}
上記のように記述すると以下の結果を返します:
Format=d
[編集]上記以外の総合競技大会 (details) の記事で、引数 "Format=d" を使います:
{{Colbegin|3}}
* {{GamesSport|Athletics|Events=47|Format=d}}
* {{GamesSport|Cycling|Events=18|Format=d}}
* {{GamesSport|Football|Events=2|Format=d}}
* {{GamesSport|Tennis|Events=5|Format=d}}
* {{GamesSport|Field hockey|Events=2|Format=d}}
* {{GamesSport|Gymnastics|Events=18|Format=d}}
{{Colend}}
上記のように記述すると以下の結果を返します:
Format=osd
[編集]オリンピック競技の主記事（例: オリンピックの陸上競技 etc.）にリンクしたい場合、競技結果の詳細リンクを別に表示したい場合 (olympic sports details) は、引数 "Format=osd" を使います:
{{Colbegin|3}}
* {{GamesSport|Athletics|Events=47|Format=osd}}
* {{GamesSport|Cycling|Events=18|Format=osd}}
* {{GamesSport|Football|Events=2|Format=osd}}
* {{GamesSport|Tennis|Events=5|Format=osd}}
* {{GamesSport|Field hockey|Events=2|Format=osd}}
* {{GamesSport|Gymnastics|Events=18|Format=osd}}
{{Colend}}
上記のように記述すると以下の結果を返します:
Format=osm
[編集]オリンピック競技の主記事のみ (olympic sports main) へリンクを表示したい場合は、引数"Format=osm" を使います:
{{Colbegin|3}}
* {{GamesSport|Athletics|Events=47|Format=osm}}
* {{GamesSport|Cycling|Events=18|Format=osm}}
* {{GamesSport|Football|Events=2|Format=osm}}
* {{GamesSport|Tennis|Events=5|Format=osm}}
* {{GamesSport|Field hockey|Events=2|Format=osm}}
* {{GamesSport|Gymnastics|Events=18|Format=osm}}
{{Colend}}
上記のように記述すると以下の結果を返します:
引数
[編集]| 引数 | 指定内容 | 既定値 | 説明 |
|---|---|---|---|
| 1= | 競技名 | 無 | 値の入力は必須です。競技名は原則的に英語で記入してください（一部の競技は日本語での記入にも対応しています）。主要な競技は英語版の記入例を引用してくればそのまま使えるはずです。引数 "Format=m" を使う場合は/reftable2に、引数 "Format=" にm以外の値を入力して使う場合は/reftable1に、それぞれ対応する競技のリスト（日英対照表）があります。引数 "Format=" を使用しない場合は、競技リンク名を前者のリストから、詳細リンク名を後者のリストから呼び出しています。 |
| Events= | 種目数 | 無 | 入力は任意です。その競技の全種目数を記入してください。使用法は種目数を追加するを参照してください。 |
| Image= | ピクトグラム画像の有無 | 無 | 入力は任意です。各競技に対応するピクトグラム画像を表示させたくない場合に使用します。有効な値はNoのみです。使用法はピクトグラム画像を非表示にするを参照してください。 |
| Format= | 一覧の表示形式のオプション | 無 | 入力は任意です。一覧の表示形式を変更したいときに使用します。有効な値はd, k, m, o, osd, osmのみです。使い方はリンクする記事の形式を変更するを参照してください。 |
関連項目
[編集]