コンテンツにスキップ

英文维基 | 中文维基 | 日文维基 | 草榴社区

Template:Cards/doc

基本

[編集]

ランク

[編集]

52枚のデッキ

[編集]

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

56枚のデッキ

[編集]

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

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

ジョーカー

[編集]

「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|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」のいずれかで始まっている場合、最初の文字は大文字化される。大文字化を防ぐには、<span></span>でくくること:{{Cards|<span>k</span>s}} = k

スート

[編集]

複合

[編集]
  • {{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      = -->
}}
並べ替え
Q
K
10
?
1
A
Jkr
2
9
5
11
Kn
J
並べ替え
(black)
(red)
並べ替え
10
J
4
J
Jkr(black)
J
A
Jkr(red)
K
J
J(red)
J
並べ替え
10 10
J J
4 Jkr(black)
Jack of heartJack of heart
J Jkr(red)
4 7
J K(black)
7 4
J Kn
J
Jack 6
Jack Jack(black)
J J
K A
K 3

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

  • separator: カードとカードを分離する文字列。デフォルトは ノーブレークスペース (&nbsp;)
  • 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)"。スートのフルネームを使用した場合、ランクもフルネームにして、間をコンマかスペース(ノーブレークスペース「&nbsp;」を使う必要がある)で区切るのが普通だろうが、そうするには以下のように書く: {{Cards|Ac|Kd|10s|2h|separator=,&nbsp;|rank_name=full|suit_name=full}} = Ace of clubKing of diamond10 of spade2 of heart
    • letter: スート名をアルファベット1文字で記す: "s", "h", "d", "c", "r", "b"
    • それ以外(空パラメタまたはパラメタを指定しない場合を含む):デフォルト、普通のスート名: "", "", "", "", "(red)", "(black)"
  • hand_style: ポーカーハンド用の CSS スタイル <b style="" class="pokerhands"></b>
  • 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スタイル <span style="" class="playingcards"></span>
  • 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 }

開発者用リンク

[編集]

関連項目

[編集]