Дидани манбаъи Шаблон:Cards/doc

{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->

== Basic ==
{{Div col}}
=== Rank ===
==== 52-card deck ====
Card ranks from [[Standard 52-card deck]]:
* {{tlx|Cards|A}}, {{tlx|Cards|K}}, {{tlx|Cards|Q}}, {{tlx|Cards|J}} = {{Cards|A}}, {{Cards|K}}, {{Cards|Q}}, {{Cards|J}}
* {{tlx|Cards|10}} or {{tlx|Cards|T}} = {{Cards|T}}
* {{tlx|Cards|9}} - {{tlx|Cards|2}} = {{Cards|9}} - {{Cards|2}}

==== 56-card deck ====
Card ranks from 56-card deck<ref>containing in each suit a King, Queen, Knight, and Valet (from the French tarot court)</ref>:
* {{tlx|Cards|kn}} or {{tlx|Cards|n}} = {{Cards|kn}} ([[Knight (playing card)|Knight]], standard 56-card deck)
* {{tlx|Cards|1}} = {{Cards|1}} (standard 56-card deck)
* {{tlx|Cards|11}} = {{Cards|11}} (nonstandard 56-card deck)

==== Joker ====
* {{tlx|Cards|Jkr}} = {{Cards|Jkr}}
You may use "r" (red) or "b" (black) suit:
* {{tlx|Cards|Jkrr}} = {{Cards|Jkrr}}
* {{tlx|Cards|Jkrb}} = {{Cards|Jkrb}}
Or maybe use the parameters "<code>rank_name</code>" and "<code>suit_name</code>" (details see below, the "[[#Advanced usage|Advanced usage]]" section) to get a full name:
* {{tlx|Cards|Jkrr|<nowiki>rank_name=full</nowiki>|<nowiki>suit_name=full</nowiki>}} = {{Cards|Jkrr|rank_name=full|suit_name=full}}
* {{tlx|Cards|Jkrb|<nowiki>rank_name=full</nowiki>|<nowiki>suit_name=full</nowiki>}} = {{Cards|Jkrb|rank_name=full|suit_name=full}}

==== ? card ====
Symbols that indicate any or unknown card rank:
* {{tlx|Cards|?}} = {{Cards|?}}
* {{tlx|Cards|x}} = {{Cards|x}}

==== Customized card ====
Actually any string will be allowed to be shown as a "card", e.g.: {{tlx|Cards|Cd}} = {{Cards|Cd}}, {{tlx|Cards|Vs}} = {{Cards|Vs}}, {{tlx|Cards|€h}} = {{Cards|€h}}, {{tlx|Cards|勾c}} = {{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 character|escape]], as: {{tlx|Cards|R&}} = {{Cards|R&}}, {{tlx|Cards|Joker&}} = {{Cards|Joker&}}, {{tlx|Cards|♥♥&}} = {{Cards|♥♥&}}

The first letter of "a", "k", "q", "kn", "j", "jkr" and "x" will be capitalized. To prevent it, put them in a <code><nowiki><span></span></nowiki></code>: {{tlx|Cards|<nowiki><span>k</span>s</nowiki>}} = {{Cards|<span>k</span>s}}

=== Suit ===
* {{tlx|Cards|s}} or {{tlx|Cards|♠}} = {{Cards|s}}
* {{tlx|Cards|h}} or {{tlx|Cards|♥}} = {{Cards|h}}
* {{tlx|Cards|d}} or {{tlx|Cards|♦}} = {{Cards|d}}
* {{tlx|Cards|c}} or {{tlx|Cards|♣}} = {{Cards|c}}
* {{tlx|Cards|r}} = {{Cards|r}}
* {{tlx|Cards|b}} = {{Cards|b}}

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

=== 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.
{{Div col end}}

== Advanced usage ==
=== Description of all parameters ===
<pre style="float: left;">
{{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    = 
| card_style     = <!--
| use_image      = -->
}}
</pre>
{| style="float:right;"
|- style="vertical-align:top;"
|
{| class="wikitable sortable"
|-
! Clk<br />to<br />sort
|-
| {{Cards|Q|sortable=yes}}
|-
| {{Cards|K|sortable=yes}}
|-
| {{Cards|10|sortable=yes}}
|-
| {{Cards|?|sortable=yes}}
|-
| {{Cards|1|sortable=yes}}
|-
| {{Cards|A|sortable=yes}}
|-
| {{Cards|Jkr|sortable=yes}}
|-
| {{Cards|2|sortable=yes}}
|-
| {{Cards|9|sortable=yes}}
|-
| {{Cards|5|sortable=yes}}
|-
| {{Cards|11|sortable=yes}}
|-
| {{Cards|Kn|sortable=yes}}
|-
| {{Cards|J|sortable=yes}}
|}
|
{| class="wikitable sortable"
|-
! Clk<br />to<br />sort
|-
| {{Cards|c|sortable=yes}}
|-
| {{Cards|b|sortable=yes}}
|-
| {{Cards|h|sortable=yes}}
|-
| {{Cards|r|sortable=yes}}
|-
| {{Cards|s|sortable=yes}}
|-
| {{Cards|d|sortable=yes}}
|}
|
{| class="wikitable sortable"
|-
! Click<br />to<br />sort
|-
| {{Cards|10d|sortable=yes}}
|-
| {{Cards|Jh|sortable=yes}}
|-
| {{Cards|4d|sortable=yes}}
|-
| {{Cards|Js|sortable=yes}}
|-
| {{Cards|Jkrb|sortable=yes}}
|-
| {{Cards|Jc|sortable=yes}}
|-
| {{Cards|As|sortable=yes}}
|-
| {{Cards|Jkrr|sortable=yes}}
|-
| {{Cards|Ks|sortable=yes}}
|-
| {{Cards|Jd|sortable=yes}}
|-
| {{Cards|Jr|sortable=yes}}
|-
| {{Cards|J|sortable=yes}}
|}
|
{| class="wikitable sortable"
|-
! Click to sort
|-
| {{Cards|10d|10s|sortable=yes}}
|-
| {{Cards|Jh|Js|sortable=yes}}
|-
| {{Cards|4d|Jkrb|sortable=yes}}
|-
| {{Cards|Jh|Jh|sortable=yes|separator=,&nbsp;|rank_name=full|suit_name=full}}
|-
| {{Cards|Jh|Jkrr|sortable=yes}}
|-
| {{Cards|4d|7s|sortable=yes}}
|-
| {{Cards|Jh|Kb|sortable=yes}}
|-
| {{Cards|7s|4d|sortable=yes}}
|-
| {{Cards|Jh|Kns|sortable=yes}}
|-
| {{Cards|Jh|sortable=yes}}
|-
| {{Cards|Js|6|sortable=yes|rank_name=full}}
|-
| {{Cards|Jh|Jb|sortable=yes|rank_name=full}}
|-
| {{Cards|Jh|J|sortable=yes}}
|-
| {{Cards|Ks|Ad|sortable=yes}}
|-
| {{Cards|Ks|3s|sortable=yes}}
|}
|}
{{Clear|left}}
All these parameters are optional.
* <code>separator</code>: separator that separates every card, default is a [[non-breaking space]] (&amp;nbsp;)
* <code>sortable</code>: may be "yes" or anything else:
** <code>yes</code>: add a [[Sorting#Sorting with a hidden key|hidden key]] to indicate the card rank and suit's level to make it [[Help:Sorting#|sortable]] in a [[Help:Table|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
* <code>rank_name</code>: "full" or anything else:
** <code>full</code>: 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'''", ...
* <code>suit_name</code>: "full" or "letter" or anything else:
** <code>full</code>: full suit name with a space before: "{{Cards|s|suit_name=full}}", "{{Cards|h|suit_name=full}}", "{{Cards|d|suit_name=full}}", "{{Cards|c|suit_name=full}}", "{{Cards|r|suit_name=full}}", "{{Cards|b|suit_name=full}}"; 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 "&amp;nbsp;" must be used), that'll be: {{tlx|Cards|Ac|Kd|10s|2h|<nowiki>separator=,&amp;nbsp;</nowiki>|<nowiki>rank_name=full</nowiki>|<nowiki>suit_name=full</nowiki>}} = {{Cards|Ac|Kd|10s|2h|separator=,&nbsp;|rank_name=full|suit_name=full}}
** <code>letter</code>: one letter suit name: "{{Cards|s|suit_name=letter}}", "{{Cards|h|suit_name=letter}}", "{{Cards|d|suit_name=letter}}", "{{Cards|c|suit_name=letter}}", "{{Cards|r|suit_name=letter}}", "{{Cards|b|suit_name=letter}}"
** Anything else (incl. leaving blank or not presenting this parameter): default, normal suit name: "{{Cards|s}}", "{{Cards|h}}", "{{Cards|d}}", "{{Cards|c}}", "{{Cards|r}}", "{{Cards|b}}"
* <code>hand_style</code>: CSS style for the hand <code><nowiki><b style="" class="pokerhands"></b></nowiki></code>
* <code>spades_color</code>, <code>hearts_color</code>, <code>diamonds_color</code>, clubs_color</code>: color ([[Web colors|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]]: {{tlx|Cards|Ac|Kd|10s|2h|<nowiki>diamonds_color=blue</nowiki>|<nowiki>clubs_color=green</nowiki>}} = {{Cards|Ac|Kd|10s|2h|diamonds_color=blue|clubs_color=green}}
* <code>card_style</code>: CSS style for every card <code><nowiki><span style="" class="playingcards"></span></nowiki></code>
* <code>use_image</code>: (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, {{tlx|Cards|Ac|10♥|Knd|?|J|s}} generates {{Cards|Ac|10♥|Knd|?|J|s}}, whose HTML markup is:
<source lang="html4strict" style="overflow-x:scroll;">
<!-- 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>
</source>

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 [[Help:User style|user style sheet]] ([[Special:MyPage/common.css]] for the common CSS):
<source lang="css">
/* Standard four-color deck */
.diamonds { color: blue !important }
.clubs { color: green !important }
</source>

===Developers' links===
{{Intricate template}}
* [[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 ==
* [[Template:Card]]

==Notes==
<references />

<includeonly>
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
[[Гурӯҳ:Wikipedia formatting and function templates|{{PAGENAME}}]]
[[Гурӯҳ:Card game templates|{{PAGENAME}}]]

[[it:Template:Carte]]
[[ja:Template:Cards]]
</includeonly>