Template: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张套牌^[1]

标准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”的首字母将被大写。要避免这种情况，请把它们放在：{{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}}或{{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

点击排序
10♦ 10♠
J♥ J♠
4♦ Jkr(black)
Jack of heart, Jack of heart
J♥ Jkr(red)
4♦ 7♠
J♥ K(black)
7♠ 4♦
J♥ Kn♠
Template:Cards/core3J♥
Jack♠ 6
Jack♥ Jack(black)
J♥ J
K♠ A♦
K♠ 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：的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样式
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 }

开发者的页面

本模板含有複雜而精密的扩展语法。
編輯本模板前，建議您先熟悉解析器函數与本模板的设计思路、运作原理等。若您的編輯引發了意外的問題，請儘快撤銷編輯，因為本模板可能被大量頁面使用。
您所作的编辑可先在或您的个人页面中进行測試。

注释

^ 每种花色包含一个国王、王后、骑士和仆从（来自法国塔罗牌）

[1] 每种花色包含一个国王、王后、骑士和仆从（来自法国塔罗牌）

[1]