This is a
documentation
subpage for
Template:Cards. It may contain usage information, categories and other content that is not part of the original template page. |
Card ranks from Standard 52-card deck:
{{
Cards|A}}
, {{
Cards|K}}
, {{
Cards|Q}}
, {{
Cards|J}}
= , , , {{
Cards|10}}
or {{
Cards|T}}
= {{
Cards|9}}
- {{
Cards|2}}
= - Card ranks from 56-card deck [1]:
{{
Cards|kn}}
or {{
Cards|n}}
= (
Knight, standard 56-card deck){{
Cards|1}}
= (standard 56-card deck){{
Cards|11}}
= (nonstandard 56-card deck){{
Cards|Jkr}}
= You may use "r" (red) or "b" (black) suit:
Or maybe use the parameters "rank_name
" and "suit_name
" (details see below, the "
Advanced usage" section) to get a full name:
Symbols that indicate any or unknown card rank:
Actually any string will be allowed to be shown as a "card", e.g.: {{
Cards|Cd}}
= , {{
Cards|Vs}}
= , {{
Cards|€h}}
= , {{
Cards|勾c}}
=
If one of "s", "h", "d", "c", "r", "b" in lower or upper case, and ♠, ♥, ♦, ♣ is at the end, it will be thought as a suit. A "&" symbol can be used to
escape, as: {{
Cards|R&}}
= , {{
Cards|Joker&}}
= , {{
Cards|♥♥&}}
=
The first letter of "a", "k", "q", "kn", "j", "jkr" and "x" will be capitalized. To prevent it, put them in a <span></span>
: {{
Cards|<span>k</span>s}}
=
{{
Cards|s}}
or {{
Cards|♠}}
= {{
Cards|h}}
or {{
Cards|♥}}
= {{
Cards|d}}
or {{
Cards|♦}}
= {{
Cards|c}}
or {{
Cards|♣}}
= {{
Cards|r}}
= {{
Cards|b}}
= {{
Cards|Ac|Kd|Ts|2h}}
or {{
Cards|A♣|K♦|10♠|2♥}}
= {{
Cards|A|K|T|2}}
= {{
Cards|c|d|s|h}}
or {{
Cards|♣|♦|♠|♥}}
= Predefined strings: "a", "k", "q", "kn", "j", "jkr", "x", and "s", "h", "d", "c", "r", "b", are case insensitive when parsed.
The number of the basic, non-named parameters (for cards) should be from 1 to 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 -->
| rank_name = <!-- "full" or anything else -->
| suit_name = <!-- "full" or "letter" or anything else -->
| hand_style =
| spades_color =
| hearts_color =
| diamonds_color =
| clubs_color =
| boldface = <!-- "yes" or "no" -->
| card_style = <!--
| use_image = -->
}}
|
|
|
|
All these parameters are optional.
separator
: separator that separates every card, default is a
non-breaking space ( )sortable
: may be "yes" or anything else:
yes
: add a
hidden key to indicate the card rank and suit's level to make it
sortable in a
table; card ranks from highest to lowest: Jkr, A, K, Q, Kn, J, 11, 10, 9, 8, 7, 6, 5, 4, 3, 2, 1, then anything else; suits from highest to lowest: ♠, ♥, ♦, ♣, red, black, then those without suit indicated; note that it can only tell first card's rank, then the second card's rank, ..., it may not reflect the hand's actual value when it includes 2 or more cardsrank_name
: "full" or anything else:
full
: full rank name: "Joker", "Ace", "King", "Queen", "Knight", "Jack", "11", "10", "9", ...suit_name
: "full" or "letter" or anything else:
full
: full suit name with a space before: " ", " ", " ", " ", " ", " "; if you use a full suit name, usually you may want to make the card rank name full and make the separator a comma and a space (a non-breaking space " " must be used), that'll be: {{
Cards|Ac|Kd|10s|2h|separator=, |rank_name=full|suit_name=full}}
= , , , letter
: one letter suit name: " ", " ", " ", " ", " ", " "hand_style
: CSS style for the hand <b style="" class="pokerhands"></b>
spades_color
, hearts_color
, diamonds_color
, clubs_color
: color (
CSS color value, like "#FFFFFF" or "white") for cards of every suit; default is 2 black and 2 red; with these parameters, you may make it a
4-color deck: {{
Cards|Ac|Kd|10s|2h|diamonds_color=blue|clubs_color=green}}
= boldface
: enables or disables boldface on card font
yes
: uses bold font to display cards (default setting): no
: uses regular font to display cards: card_style
: CSS style for every card <span style="" class="playingcards"></span>
use_image
: (not yet implemented) use images to show the cardsThe HTML markup produced by this template includes a microformat, it uses rich semantic class names including: "pokerhands", "playingcards", "spades", "hearts", "diamonds", "clubs", "cardranks", "cardsuits", which makes the details parsable by computers.
For example, {{
Cards|Ac|10♥|Knd|?|J|s}}
generates , whose HTML markup is:
<!-- sortable hidden key, if needed, is inserted before <b /> and is like:
<span data-sort-value="&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">♣</span>
</span> <!-- 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">♥</span>
</span>
<span style="color:red;" class="playingcards diamonds">
<span class="cardranks">Kn</span><span class="cardsuits">♦</span>
</span>
<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>
<span style="" class="playingcards">
<span class="cardranks">J</span>
</span>
<span style="color:black;" class="playingcards spades">
<span class="cardsuits">♠</span>
</span>
</b>
Template for playing cards, will automatically color the suits with the standard red/black. To see a typical 4-color deck, copy the following into your user style sheet ( Special:MyPage/common.css for the common CSS):
/* Standard four-color deck */
.diamonds { color: blue !important }
.clubs { color: green !important }
This template employs intricate features of template syntax.
You are encouraged to familiarise yourself with its setup and
parser functions before editing the template. If your edit causes unexpected problems, please
undo it quickly, as this template may appear on a large number of pages. You can conduct experiments, and should test all major changes, in either this template's sandbox, the general template sandbox, or your user space before changing anything here. |
This is a
documentation
subpage for
Template:Cards. It may contain usage information, categories and other content that is not part of the original template page. |
Card ranks from Standard 52-card deck:
{{
Cards|A}}
, {{
Cards|K}}
, {{
Cards|Q}}
, {{
Cards|J}}
= , , , {{
Cards|10}}
or {{
Cards|T}}
= {{
Cards|9}}
- {{
Cards|2}}
= - Card ranks from 56-card deck [1]:
{{
Cards|kn}}
or {{
Cards|n}}
= (
Knight, standard 56-card deck){{
Cards|1}}
= (standard 56-card deck){{
Cards|11}}
= (nonstandard 56-card deck){{
Cards|Jkr}}
= You may use "r" (red) or "b" (black) suit:
Or maybe use the parameters "rank_name
" and "suit_name
" (details see below, the "
Advanced usage" section) to get a full name:
Symbols that indicate any or unknown card rank:
Actually any string will be allowed to be shown as a "card", e.g.: {{
Cards|Cd}}
= , {{
Cards|Vs}}
= , {{
Cards|€h}}
= , {{
Cards|勾c}}
=
If one of "s", "h", "d", "c", "r", "b" in lower or upper case, and ♠, ♥, ♦, ♣ is at the end, it will be thought as a suit. A "&" symbol can be used to
escape, as: {{
Cards|R&}}
= , {{
Cards|Joker&}}
= , {{
Cards|♥♥&}}
=
The first letter of "a", "k", "q", "kn", "j", "jkr" and "x" will be capitalized. To prevent it, put them in a <span></span>
: {{
Cards|<span>k</span>s}}
=
{{
Cards|s}}
or {{
Cards|♠}}
= {{
Cards|h}}
or {{
Cards|♥}}
= {{
Cards|d}}
or {{
Cards|♦}}
= {{
Cards|c}}
or {{
Cards|♣}}
= {{
Cards|r}}
= {{
Cards|b}}
= {{
Cards|Ac|Kd|Ts|2h}}
or {{
Cards|A♣|K♦|10♠|2♥}}
= {{
Cards|A|K|T|2}}
= {{
Cards|c|d|s|h}}
or {{
Cards|♣|♦|♠|♥}}
= Predefined strings: "a", "k", "q", "kn", "j", "jkr", "x", and "s", "h", "d", "c", "r", "b", are case insensitive when parsed.
The number of the basic, non-named parameters (for cards) should be from 1 to 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 -->
| rank_name = <!-- "full" or anything else -->
| suit_name = <!-- "full" or "letter" or anything else -->
| hand_style =
| spades_color =
| hearts_color =
| diamonds_color =
| clubs_color =
| boldface = <!-- "yes" or "no" -->
| card_style = <!--
| use_image = -->
}}
|
|
|
|
All these parameters are optional.
separator
: separator that separates every card, default is a
non-breaking space ( )sortable
: may be "yes" or anything else:
yes
: add a
hidden key to indicate the card rank and suit's level to make it
sortable in a
table; card ranks from highest to lowest: Jkr, A, K, Q, Kn, J, 11, 10, 9, 8, 7, 6, 5, 4, 3, 2, 1, then anything else; suits from highest to lowest: ♠, ♥, ♦, ♣, red, black, then those without suit indicated; note that it can only tell first card's rank, then the second card's rank, ..., it may not reflect the hand's actual value when it includes 2 or more cardsrank_name
: "full" or anything else:
full
: full rank name: "Joker", "Ace", "King", "Queen", "Knight", "Jack", "11", "10", "9", ...suit_name
: "full" or "letter" or anything else:
full
: full suit name with a space before: " ", " ", " ", " ", " ", " "; if you use a full suit name, usually you may want to make the card rank name full and make the separator a comma and a space (a non-breaking space " " must be used), that'll be: {{
Cards|Ac|Kd|10s|2h|separator=, |rank_name=full|suit_name=full}}
= , , , letter
: one letter suit name: " ", " ", " ", " ", " ", " "hand_style
: CSS style for the hand <b style="" class="pokerhands"></b>
spades_color
, hearts_color
, diamonds_color
, clubs_color
: color (
CSS color value, like "#FFFFFF" or "white") for cards of every suit; default is 2 black and 2 red; with these parameters, you may make it a
4-color deck: {{
Cards|Ac|Kd|10s|2h|diamonds_color=blue|clubs_color=green}}
= boldface
: enables or disables boldface on card font
yes
: uses bold font to display cards (default setting): no
: uses regular font to display cards: card_style
: CSS style for every card <span style="" class="playingcards"></span>
use_image
: (not yet implemented) use images to show the cardsThe HTML markup produced by this template includes a microformat, it uses rich semantic class names including: "pokerhands", "playingcards", "spades", "hearts", "diamonds", "clubs", "cardranks", "cardsuits", which makes the details parsable by computers.
For example, {{
Cards|Ac|10♥|Knd|?|J|s}}
generates , whose HTML markup is:
<!-- sortable hidden key, if needed, is inserted before <b /> and is like:
<span data-sort-value="&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">♣</span>
</span> <!-- 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">♥</span>
</span>
<span style="color:red;" class="playingcards diamonds">
<span class="cardranks">Kn</span><span class="cardsuits">♦</span>
</span>
<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>
<span style="" class="playingcards">
<span class="cardranks">J</span>
</span>
<span style="color:black;" class="playingcards spades">
<span class="cardsuits">♠</span>
</span>
</b>
Template for playing cards, will automatically color the suits with the standard red/black. To see a typical 4-color deck, copy the following into your user style sheet ( Special:MyPage/common.css for the common CSS):
/* Standard four-color deck */
.diamonds { color: blue !important }
.clubs { color: green !important }
This template employs intricate features of template syntax.
You are encouraged to familiarise yourself with its setup and
parser functions before editing the template. If your edit causes unexpected problems, please
undo it quickly, as this template may appear on a large number of pages. You can conduct experiments, and should test all major changes, in either this template's sandbox, the general template sandbox, or your user space before changing anything here. |