「Template:Cards/doc」の版間の差分

履歴の双方向閲覧

← 古い編集新しい編集 →

削除された内容追加された内容

ビジュアルウィキテキスト

インライン

2020年7月5日 (日) 23:00時点における版

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

基本

ランク

52枚のデッキ

通常の52枚のトランプのカード：

{{Cards|A}}, {{Cards|K}}, {{Cards|Q}}, {{Cards|J}} = A, K, Q, J
{{Cards|10}} or {{Cards|T}} = 10
{{Cards|9}} - {{Cards|2}} = 9 - 2

56枚のデッキ

56枚のトランプのカード：

{{Cards|kn}} または {{Cards|n}} = Kn （標準の56枚のトランプのナイト）
{{Cards|1}} = 1 （標準の56枚のトランプ）
{{Cards|11}} = 11 （標準的でない56枚のトランプ）

ジョーカー

{{Cards|Jkr}} = Jkr

「r」で赤いジョーカー、「b」で黒いジョーカー：

{{Cards|Jkrr}} = Jkr(red)
{{Cards|Jkrb}} = Jkr(black)

パラメータ「rank_name」および「suit_name」で指定することも可能（詳細は後述の「高度な使い方」を参照）：

{{Cards|Jkrr|rank_name=full|suit_name=full}} = Joker (red)
{{Cards|Jkrb|rank_name=full|suit_name=full}} = Joker (black)

?

不明なランクを指定するためのシンボル：

{{Cards|?}} = ?
{{Cards|x}} = X

カスタマイズされたカード

実は「カード」としてどんな文字列でも指定することが可能である。例： {{Cards|Cd}} = C♦, {{Cards|Vs}} = V♠, {{Cards|€h}} = €♥, {{Cards|勾c}} = 勾♣

「s・h・d・c・r・b」（大小文字は区別しない）のいずれか、または「♠・♥・♦・♣」のいずれかで終わっている場合、その文字はスートを表すものとみなされる。「&」をエスケープ文字として使用することも可能である。例： {{Cards|R&}} = R, {{Cards|Joker&}} = Joker, {{Cards|♥♥&}} = ♥♥

文字列が「a・k・q・kn・j・jkr・x」のいずれかで始まっている場合、最初の文字は大文字化される。大文字化を防ぐには、でくくること：{{Cards|ks}} = k♠

スート

{{Cards|s}} または {{Cards|♠}} = ♠
{{Cards|h}} または {{Cards|♥}} = ♥
{{Cards|d}} または {{Cards|♦}} = ♦
{{Cards|c}} または {{Cards|♣}} = ♣
{{Cards|r}} = (red)
{{Cards|b}} = (black)

複合

{{Cards|Ac|Kd|Ts|2h}} または {{Cards|A♣|K♦|10♠|2♥}} = A♣ K♦ 10♠ 2♥
ランクのみでスートがない：{{Cards|A|K|T|2}} = A K 10 2
スートのシンボルのみ：{{Cards|c|d|s|h}} or {{Cards|♣|♦|♠|♥}} = ♣ ♦ ♠ ♥

その他の使い方

定義済みの文字列「a・k・q・kn・j・jkr・x」および「s・h・d・c・r・b」は大文字と小文字を区別しない。

基本的な、名前のない（カードの）数値パラメータは1から15までの範囲になければならない。

高度な使い方

全パラメータの説明

{{Cards
| <!-- first card's rank and/or suit,
as described above in the "Basic" section -->
| <!-- second card --><!--
... 15 max. -->
| separator      = 
| sortable       = <!-- "yes" or anything else -->
| rankname       = <!-- "full" or anything else -->
| suitname       = <!-- "full" or "letter" or anything else -->
| hand_style     = 
| spades_color   = 
| hearts_color   = 
| diamonds_color = 
| clubs_color    = 
| card_style     = <!--
| use_image      = -->
}}

並べ替え
&120&00Q
&130&00K
&100&0010
&000&00?
&010&001
&140&00A
&200&00Jkr
&020&002
&090&009
&050&005
&105&0011
&115&00Kn
&110&00J

並べ替え
&105&10♣
&105&01(black)
&105&30♥
&105&02(red)
&105&40♠
&105&20♦

並べ替え
&100&2010♦
&110&30J♥
&040&204♦
&110&40J♠
&200&01Jkr(black)
&110&10J♣
&140&40A♠
&200&02Jkr(red)
&130&40K♠
&110&20J♦
&110&02J(red)
&110&00J

並べ替え
&100&20&100&4010♦ 10♠
&110&30&110&40J♥ J♠
&040&20&200&014♦ Jkr(black)
&110&30&110&30Jack of heart, Jack of heart
&110&30&200&02J♥ Jkr(red)
&040&20&070&404♦ 7♠
&110&30&130&01J♥ K(black)
&070&40&040&207♠ 4♦
&110&30&115&40J♥ Kn♠
&110&30J♥
&110&40&060&00Jack♠ 6
&110&30&110&01Jack♥ Jack(black)
&110&30&110&00J♥ J
&130&40&140&20K♠ A♦
&130&40&030&40K♠ 3♠

どのパラメータも必須ではない。

separator: カードとカードを分離する文字列。デフォルトはノーブレークスペース ( )
sortable: 「yes」またはそれ以外を指定する
- yes: ランクとスートの順位をソートできるように隠れたキーを設定する。カードは高い方から順に： Jkr, A, K, Q, Kn, J, 11, 10, 9, 8, 7, 6, 5, 4, 3, 2, 1 それ以外の順序に並ぶ。スートは高い方から順に： ♠, ♥, ♦, ♣, red, black, スートなしの順序に並ぶ。注意：この機能は最初のカードのランク、2枚目のランク……を見るだけなので、ひとつのテンプレートが2枚以上のカードを含むときはカードの実際の価値を反映しない可能性があることに
- それ以外（空パラメタまたはパラメタを指定しない場合を含む）：デフォルト、ソートキーを生成しない
rank_name: 「full」またはそれ以外を指定する
- full: ランク名をフルネームで表示する: "Joker", "Ace", "King", "Queen", "Knight", "Jack", "11", "10", "9"……
- それ以外（空パラメタまたはパラメタを指定しない場合を含む）：デフォルト、通常の省略したランク名： "Jkr", "A", "K", "Q", "Kn", "J", "11", "10", "9"……
suit_name: 「full」・「letter」・それ以外
- full: スペースに続けてスートのフルネームを表示する： " of spade", " of heart", " of diamond", " of club", " (red)", " (black)"。スートのフルネームを使用した場合、ランクもフルネームにして、間をコンマかスペース（ノーブレークスペース「 」を使う必要がある）で区切るのが普通だろうが、そうするには以下のように書く： {{Cards|Ac|Kd|10s|2h|separator=, |rank_name=full|suit_name=full}} = Ace of club, King of diamond, 10 of spade, 2 of heart
- letter: スート名をアルファベット1文字で記す： "s", "h", "d", "c", "r", "b"
- それ以外（空パラメタまたはパラメタを指定しない場合を含む）：デフォルト、普通のスート名： "♠", "♥", "♦", "♣", "(red)", "(black)"
hand_style: ポーカーハンド用の CSS スタイル 
spades_color, hearts_color, diamonds_color, clubs_color: 各スートのカード用の色（CSSの色、「#FFFFFF」あるいは「white」）。通常は黒と赤であるが、このパラメータを使うことによって、4色デックを実現できる： {{Cards|Ac|Kd|10s|2h|diamonds_color=blue|clubs_color=green}} = A♣ K♦ 10♠ 2♥
card_style: 各カード用のCSSスタイル 
use_image: （未実装）カードをあらわす画像

HTML・クラス名・CSS

このテンプレートによって生成されるHTMLマークアップはマイクロフォーマットを含んでおり、 "pokerhands", "playingcards", "spades", "hearts", "diamonds", "clubs", "cardranks", "cardsuits" といったクラス名を含んでいるので、計算機による解析が可能になっている。

例えば、{{Cards|Ac|10♥|Knd|?|J|s}} は A♣ 10♥ Kn♦ ? J ♠ を生成し、そのHTMLマークアップは以下のようになる。

<!-- sortable hidden key, if needed, is inserted before <b /> and is like:
<span class="sortkey" style="display:none;">&140&10&100&30&115&20&000&00&110&00&105&40</span> -->
<b style="" class="pokerhands"><!-- value of 'hand_style', if exists, is added here inside 'style=""' -->
	<span style="color:black;" class="playingcards clubs"><!-- 'black' will changed to 'clubs_color''s value if defined;
'card_style''s value, if exists, is added here inside 'style=""', and after the color value;
same things apply to below ones -->
		<span class="cardranks">A</span><span class="cardsuits">&clubs;</span>
	</span>&nbsp;<!-- &nbsp; will be replaced by user defined 'separator' if there is one;
same thing applys to below ones -->
	<span style="color:red;" class="playingcards hearts">
		<span class="cardranks">10</span><span class="cardsuits">&hearts;</span>
	</span>&nbsp;
	<span style="color:red;" class="playingcards diamonds">
		<span class="cardranks">Kn</span><span class="cardsuits">&diams;</span>
	</span>&nbsp;
	<span style="" class="playingcards"><!-- 'card_style''s value, if exists, is added here inside 'style=""';
same thing applys to below one -->
		<span class="cardranks">?</span>
	</span>&nbsp;
	<span style="" class="playingcards">
		<span class="cardranks">J</span>
	</span>&nbsp;
	<span style="color:black;" class="playingcards spades">
		<span class="cardsuits">&spades;</span>
	</span>
</b>

トランプ用のテンプレートは標準的なスート色に合わせて自動的に赤・黒の色をつける。それ以外の色を使いたい場合には、以下のCSSをユーザースタイルシートに追加すること。

/* Standard four-color deck */
.diamonds { color: blue !important }
.clubs { color: green !important }

開発者用リンク

このテンプレートの記述は複雑な構成となっています。編集後の結果が予想できないか、または変更にともなう影響を修正する用意ができていない場合は編集をお控えください。練習や実験はテンプレートのサンドボックス・サブページ、テストケース・サブページもしくはあなた自身の利用者スペースのページでお願いします。

@@ 216行目: / 216行目: @@
 例えば、{{tlx|Cards|Ac|10♥|Knd|?|J|s}} は {{Cards|Ac|10♥|Knd|?|J|s}} を生成し、そのHTMLマークアップは以下のようになる。
-<source lang="html4strict" style="overflow-x:scroll;">
+<syntaxhighlight lang="html4strict" style="overflow-x:scroll;">
 <!-- sortable hidden key, if needed, is inserted before <b /> and is like:
 <span class="sortkey" style="display:none;">&140&10&100&30&115&20&000&00&110&00&105&40</span> -->
@@ 243行目: / 243行目: @@
 	</span>
 </b>
+</syntaxhighlight>
-</source>
 トランプ用のテンプレートは標準的なスート色に合わせて自動的に赤・黒の色をつける。それ以外の色を使いたい場合には、以下のCSSをユーザースタイルシートに追加すること。
-<source lang="css">
+<syntaxhighlight lang="css">
 /* Standard four-color deck */
 .diamonds { color: blue !important }
 .clubs { color: green !important }
+</syntaxhighlight>
-</source>
 === 開発者用リンク ===