Sjabloon:Cards

Sjabloondokumentasie[sien] [wysig] [geskiedenis] [wis kasgeheue]

Basic

Rank

52-card deck

Card ranks from Standard 52-card deck:

{{Cards|A}}, {{Cards|K}}, {{Cards|Q}}, {{Cards|J}} = A, K, Q, J
{{Cards|10}} or {{Cards|T}} = 10
{{Cards|9}} - {{Cards|2}} = 9 - 2

56-card deck

Card ranks from 56-card deck^[1]:

{{Cards|kn}} or {{Cards|n}} = Kn (Knight, standard 56-card deck)
{{Cards|1}} = 1 (standard 56-card deck)
{{Cards|11}} = 11 (nonstandard 56-card deck)

Joker

{{Cards|Jkr}} = Jkr

You may use "r" (red) or "b" (black) suit:

{{Cards|Jkrr}} = Jkr(rooi)
{{Cards|Jkrb}} = Jkr(swart)

Or maybe use the parameters "rank_name" and "suit_name" (details see below, the "Advanced usage" section) to get a full name:

{{Cards|Jkrr|rank_name=full|suit_name=full}} = Joker (rooi)
{{Cards|Jkrb|rank_name=full|suit_name=full}} = Joker (swart)

? card

Symbols that indicate any or unknown card rank:

{{Cards|?}} = ?
{{Cards|x}} = X

Customized card

Actually any string will be allowed to be shown as a "card", e.g.: {{Cards|Cd}} = C♦, {{Cards|Vs}} = V♠, {{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&}} = R, {{Cards|Joker&}} = Joker, {{Cards|♥♥&}} = ♥♥

The first letter of "a", "k", "q", "kn", "j", "jkr" and "x" will be capitalized. To prevent it, put them in a : {{Cards|ks}} = k♠

Suit

{{Cards|s}} or {{Cards|♠}} = ♠
{{Cards|h}} or {{Cards|♥}} = ♥
{{Cards|d}} or {{Cards|♦}} = ♦
{{Cards|c}} or {{Cards|♣}} = ♣
{{Cards|r}} = (rooi)
{{Cards|b}} = (swart)

Compound use

{{Cards|Ac|Kd|Ts|2h}} or {{Cards|A♣|K♦|10♠|2♥}} = A♣ K♦ 10♠ 2♥
Card ranks without suit: {{Cards|A|K|T|2}} = A K 10 2
Stand-alone suit symbols: {{Cards|c|d|s|h}} or {{Cards|♣|♦|♠|♥}} = ♣ ♦ ♠ ♥

Other note

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.

Advanced usage

Description of all parameters

{{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      = -->
}}

Clk to sort
Q
K
10
?
1
A
Jkr
2
9
5
11
Kn
J

Clk to sort
♣
(swart)
♥
(rooi)
♠
♦

Click to sort
10♦
J♥
4♦
J♠
Jkr(swart)
J♣
A♠
Jkr(rooi)
K♠
J♦
J(rooi)
J

Click to sort
10♦ 10♠
J♥ J♠
4♦ Jkr(swart)
Jack van harte, Jack van harte
J♥ Jkr(rooi)
4♦ 7♠
J♥ K(swart)
7♠ 4♦
J♥ Kn♠
J♥
Jack♠ 6
Jack♥ Jack(swart)
J♥ J
K♠ A♦
K♠ 3♠

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: " van skoppens", " van harte", " van diamante", " van klawers", " (rooi)", " (swart)"; 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}} = Aas van klawers, King van diamante, 10 van skoppens, 2 van harte
- letter: one letter suit name: "s", "h", "d", "c", "r", "b"
- Anything else (incl. leaving blank or not presenting this parameter): default, normal suit name: "♠", "♥", "♦", "♣", "(rooi)", "(swart)"
hand_style: CSS style for the hand 
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}} = A♣ K♦ 10♠ 2♥
boldface: enables or disables boldface on card font
- yes: uses bold font to display cards (default setting): A♣ K♦ Q♠ J♥ Jkr
- no: uses regular font to display cards: A♣ K♦ Q♠ J♥ Jkr
card_style: CSS style for every card 
use_image: (not yet implemented) use images to show the cards

HTML, class names and CSS

The 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 A♣ 10♥ Kn♦ ? J ♠, 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">&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>

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

Hierdie sjabloon gebruik ingewikkelde (en: intricate) eienskappe van sjabloonsintaks.

U word aangeraai om uself te vergewis van die opstel daarvan en die gebruik van parserfunksies voor u die sjabloon wysig. Indien u wysiging onbeplande probleme veroorsaak, maak dit asseblief so gou moontlik ongedaan (undo), aangesien hierdie sjabloon op 'n groot aantal bladsye mag voorkom.

Onthou dat u nie eksperimente hier kan doen nie, en dat alle verbeteringe in of die Wikipedia:Sandput of u eie gebruikerspasie getoets moet word voor enige wysigings hier aangebring word.

Notes

↑ containing in each suit a King, Queen, Knight, and Valet (from the French tarot court)

Sjabloon:Sandbox other

Die bostaande dokumentasie is ingesluit vanaf Sjabloon:Cards/doc. (wysig | geskiedenis)
Redigeerders kan eksperimenteer in hierdie sjabloon se sandput (skep | spieël) en toetsgevalle (skep) blaaie.
Plaas asseblief kategorieë op die /doc-subbladsy. Subbladsye vir die sjabloon.

[1] taining in each suit a King, Queen, Knight, and Valet (from the French tarot court)

[1]