 | This is the template sandbox page for Template:Cards (diff). See also the companion subpage for test cases. |
 | This template uses TemplateStyles: |
Basic
editRank
edit52-card deck
editCard ranks from Standard 52-card deck:
{{Cards|A}},{{Cards|K}},{{Cards|Q}},{{Cards|J}}= , , ,{{Cards|10}}or{{Cards|T}}={{Cards|9}}-{{Cards|2}}= -
56-card deck
editCard 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)
Joker
edit{{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:
? card
editSymbols that indicate any or unknown card rank:
Customized card
editActually 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}} =
Suit
edit{{Cards|s}}or{{Cards|♠}}={{Cards|h}}or{{Cards|♥}}={{Cards|d}}or{{Cards|♦}}={{Cards|c}}or{{Cards|♣}}={{Cards|r}}={{Cards|b}}=
Compound use
edit{{Cards|Ac|Kd|Ts|2h}}or{{Cards|A♣|K♦|10♠|2♥}}=- Card ranks without suit:
{{Cards|A|K|T|2}}= - Stand-alone suit symbols:
{{Cards|c|d|s|h}}or{{Cards|♣|♦|♠|♥}}=
Other note
editPredefined 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.
Advanced usage
editDescription of all parameters
edit{{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 cards- Anything else (incl. leaving blank or not presenting this parameter): default, not do it
rank_name: "full" or anything else:full: full rank name: "Joker", "Ace", "King", "Queen", "Knight", "Jack", "11", "10", "9", ...- Anything else (incl. leaving blank or not presenting this parameter): default, normal abbr. rank name: "Jkr", "A", "K", "Q", "Kn", "J", "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: "", "", "", "", "", ""- Anything else (incl. leaving blank or not presenting this parameter): default, normal 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 fontyes: 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 cards
HTML, class names and CSS
editThe 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 }
Developers' links
edit | 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. |
- Template:Cards/core
- Template:Cards/core2
- Template:Cards/core3
- User:Chzz/cards/clubs
- User:Chzz/cards/diamonds
- User:Chzz/cards/hearts
- User:Chzz/cards/spades
See also
editNotes
edit- ^ containing in each suit a King, Queen, Knight, and Valet (from the French tarot court)