模板:Cards/doc

基础部分

点数

标准52张套牌

标准52张套牌中的点数：

• {{Cards|A}}, {{Cards|K}}, {{Cards|Q}}, {{Cards|J}} = A, K, Q, J
• {{Cards|10}} 或 {{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”（red，红色）或“b”（black，黑色）花色：

• {{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”的首字母将被大写。要避免这种情况，请把它们放在<span></span>：{{Cards|<span>k</span>s}} = 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}}或{{Cards|♣|♦|♠|♥}} = ♣ ♦ ♠ ♥

其他注意事项

被预定义的字串“a”，“k”，“q”，“kn”，“j”，“jkr”，“x”和“s”，“h”，“d”，“c”，“r”，“b”在打包时是大小写不敏感的。

表示卡牌的无名参数数量应为1至15。

高级使用

所有参数的描述

{{Cards
| <!-- 第一张牌的点数及/或花色，在前面的“基础部分”已介绍 -->
| <!-- 第二张牌 --><!-- ... 最多15张 -->
| separator= 
| sortable = <!-- “yes”或其他内容 -->
| rank_name = <!-- “full”或其他内容 -->
| suit_name = <!--“full”或“letter”或其他内容 -->
| hand_style = 
| spades_color   = 
| hearts_color   = 
| diamonds_color = 
| clubs_color    = 
| card_style     = <!--
| use_image      = -->
}}

点击排序 Template:Cards/core3Q Template:Cards/core3K Template:Cards/core310 Template:Cards/core3? Template:Cards/core31 Template:Cards/core3A Template:Cards/core3Jkr Template:Cards/core32 Template:Cards/core39 Template:Cards/core35 Template:Cards/core311 Template:Cards/core3Kn Template:Cards/core3J

点击排序 Template:Cards/core3♣ Template:Cards/core3(black) Template:Cards/core3♥ Template:Cards/core3(red) Template:Cards/core3♠ Template:Cards/core3♦

点击排序 Template:Cards/core310♦ Template:Cards/core3J♥ Template:Cards/core34♦ Template:Cards/core3J♠ Template:Cards/core3Jkr(black) Template:Cards/core3J♣ Template:Cards/core3A♠ Template:Cards/core3Jkr(red) Template:Cards/core3K♠ Template:Cards/core3J♦ Template:Cards/core3J(red) Template:Cards/core3J

点击排序 Template:Cards/core3Template:Cards/core310♦ 10♠ Template:Cards/core3Template:Cards/core3J♥ J♠ Template:Cards/core3Template:Cards/core34♦ Jkr(black) Template:Cards/core3Template:Cards/core3Jack of heart, Jack of heart Template:Cards/core3Template:Cards/core3J♥ Jkr(red) Template:Cards/core3Template:Cards/core34♦ 7♠ Template:Cards/core3Template:Cards/core3J♥ K(black) Template:Cards/core3Template:Cards/core37♠ 4♦ Template:Cards/core3Template:Cards/core3J♥ Kn♠ Template:Cards/core3J♥ Template:Cards/core3Template:Cards/core3Jack♠ 6 Template:Cards/core3Template:Cards/core3Jack♥ Jack(black) Template:Cards/core3Template:Cards/core3J♥ J Template:Cards/core3Template:Cards/core3K♠ A♦ Template:Cards/core3Template:Cards/core3K♠ 3♠

所有参数是可选的。

• separator：分隔符，用于分隔每张牌，默认是不换行空格。（ ）
• sortable：可以是“yes”或其他的：
  • yes：增加一个隐藏按键用来指明卡牌的点数和花色大小，从而让它在一个表格中可以排序；卡牌点数从大到小：Jkr, A, K, Q, Kn, J, 11, 10, 9, 8, 7, 6, 5, 4, 3, 2, 1，然后是其他的；花色从大到小：♠， ♥，♦，♣，red，black，然后是没有花色的牌；注意它只能指明第一张牌的点数，然后是第二张牌的点数……以此类推。当有两张或更多牌的时候，它不能指明手牌的实际大小。
  • 任何其他的（包括将该参数留白或不指明）：默认，什么都不做。
• 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：一个字母的花色名 ：“s”，“h”，“d”，“c”，“r”，“b”
  • 任何其他的（包括留空/不使用此参数）：默认，普通的花色名：“♠”，“♥”，“♦”，“♣”，“(red)”，“(black)”
• hand_style：<b style="" class="pokerhands"></b>的CSS样式
• spades_color，hearts_color，diamonds_color，clubs_color：每种花色的颜色（CSS颜色值，“#FFFFFF”或“white”）；默认是2黑2红；用这些参数你可以做出一套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，class的名称和CSS

本模板中生成的HTML标记包含一个微格式，它使用，富语义class名称，包括：“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>

用于扑克牌的模板会自动对花色以标准的红色/黑色上色。为了看到一套典型的4色纸牌，请将以下内容复制到你的用户样式页面（对于common CSS，请使用Special:MyPage/common.css）：

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

开发者的页面

• en:Template:Cards/core
• en:Template:Cards/core2
• en:Template:Cards/core3
• en:User:Chzz/cards/clubs
• en:User:Chzz/cards/diamonds
• en:User:Chzz/cards/hearts
• en:User:Chzz/cards/spades