Modèle:Cartes/Documentation

Ceci est la page de documentation de Modèle:Cartes [modifier] [purger].

Cette sous-page contient les instructions et les catégories de son modèle d'origine et elle n'est pas destinée à être visualisée directement.

Ce modèle permet d'afficher des cartes à jouer dans un article. À réserver de préférence aux tableaux, infobox, listes , etc. À éviter ou limiter dans le corps des articles.

Utilisation

Rang et couleur

Rang et couleur des cartes (respecter la case)
Jeu de 52 cartes			Autres jeu de cartes			Couleur
Rang	Valeur	Exemple	Rang	Valeur	Exemple	Symbole	Valeur
As	A	A♠ A♥ A♦ A♣	Cavalier	kn ou n	C♠ C♥ C♦ C♣	Pique	s
Roi	K	K♠ K♥ K♦ K♣	1	1	1♠ 1♥ 1♦ 1♣	Coeur	h
Dame	Q	Q♠ Q♥ Q♦ Q♣	11, 12, 13, 14, etc.	11, 12, 13, 14, etc.	11♠ 12♥ 13♦ 14♣	Carreau	d
Valet	J	J♠ J♥ J♦ J♣	Joker	Jkr	Jkr♠ Jkr♥ Jkr♦ Jkr♣	Trèfle	c
10	10	10♠ 10♥ 10♦ 10♣	Joker rouge	Jkrr	Jkr (rouge)	Rouge	r
9	9	9♠ 9♥ 9♦ 9♣	Joker noir	Jkrb	Jkr (noir)	Noir	b
8	8	8♠ 8♥ 8♦ 8♣	Carte inconue	? ou X	?♠ ?♥ X♦ X♣
7	7	7♠ 7♥ 7♦ 7♣	Symbole personnalisé	V, $, €, 勾, etc.	V♠ $♥ €♦ 勾♣
6	6	6♠ 6♥ 6♦ 6♣
5	5	5♠ 5♥ 5♦ 5♣
4	4	4♠ 4♥ 4♦ 4♣
3	3	3♠ 3♥ 3♦ 3♣
2	2	2♠ 2♥ 2♦ 2♣

Utilisation classique

Pour obtenir une carte, préciser son rang et sa couleur (respecter la case) :

Roi de cœur = {{Cartes|Kh}} = K♥
Cavalier rouge = {{Cartes|Cr}} = C (rouge)
Joker noir = {{Cartes|Jkrb}} = Jkr (noir)

Il est possible de préciser plusieurs cartes à la suite (15 maximum) :

{{Cartes|Ah|2h|3h|4h|5h}} = A♥ 2♥ 3♥ 4♥ 5♥
{{Cartes|10c|5r|6d|Ab|Jkr}} = 10♣ 5 (rouge) 6♦ A (noir) Jkr

Utilisation avancée

Cartes personnalisées

Il est possible d'utiliser n'importe quel autre symbole pour générer une carte personnalisée :

{{Cartes|Vh|$h|€h|勾h}} = V♥ $♥ €♥ 勾♥

Si les symboles « s », « h », « d », « c », « r » et « b » (peut importe la case) sont utilisés en fin de chaîne, ils seront interprétés comme des couleurs. Le symbole « & » peut être utilisé comme caractère d'échappement ainsi :

{{Cartes|R&}} = R, {{Cartes|Joker&}} = Joker, {{Cartes|♥♥&}} = ♥♥

Les premières lettres des chaînes de caractère « a », « k », « q », « kn» , « j », « jkr » et « x » sont mis en majuscule. Afin d'éviter cela, insérer le code <span></span>: {{Cartes|<span>k</span>s}} = k♠

Paramètres

1 : Première carte. Obligatoire ;
2 à 15 : Autres cartes. Facultatif ;
separator: séparateur entre les différents cartes, par défaut un espace insécable. Facultatif ;
rank_name: Permet de précision si l'on souhaite que le nom complet du rang de la carte s'affiche. Préciser « full » pour afficher le nom complet du rang. Sinon, laisser vide. Facultatif ;
suit_name: Permet de précision si l'on souhaite que le nom complet de la couleur de la carte s'affiche. Préciser « full » pour afficher le nom complet de la couleur, ou « letter » pour une abréviation en deux lettres. Sinon, laisser vide. Facultatif ;
spades_color, hearts_color, diamonds_color, clubs_color: Permet de changer la couleur par défaut de chaque symbole. Utiliser les couleurs du Web, tel que « #FFFFFF » ou « white ».Par défaut il y a deux symboles rouges et deux symboles noirs.

HTML, nom de classe, CSS et liens de développeurs

Le script HTML produit par ce modèle inclut un microformat, utilisant une sémantique riche en classe de nom, incluant: pokerhands, playingCartes, spades, hearts, diamonds, clubs, cardranks, Cartesuits, ce qui le rendant facilement parsable par les bots.

Par exemple, {{Cartes|Ac|10♥|Knd|?|J|s}} generates A♣ 10♥ C♦ ? J ♠, renvoit le code HTML suivant:

<!-- 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 class="pokerhands">
	<span class="playingCartes clubs" style="color:black"><!-- 'black' will changed to 'clubs_color''s value if defined; same thing applies to below ones -->
		<span class="cardranks">A</span><span class="Cartesuits">&clubs;</span>
	</span>&nbsp;<!-- &nbsp; will be replaced by user defined 'separator' if there is one; same thing applies to below ones -->
	<span class="playingCartes hearts" style="color:red">
		<span class="cardranks">10</span><span class="Cartesuits">&hearts;</span>
	</span>&nbsp;
	<span class="playingCartes diamonds" style="color:red">
		<span class="cardranks">Kn</span><span class="Cartesuits">&diams;</span>
	</span>&nbsp;
	<span class="playingCartes" style="">
		<span class="cardranks">?</span>
	</span>&nbsp;
	<span class="playingCartes" style="">
		<span class="cardranks">J</span>
	</span>&nbsp;
	<span class="playingCartes spades" style="color:black">
		<span class="Cartesuits">&spades;</span>
	</span>
</b>

Liens de développeurs :

Templatedata

Affiche l'icone d'une carte à jouer

Paramètres du modèle
Paramètre		Description	Type	État
Nom complet - rang	`rank_name`	Préciser « full » pour afficher le nom complet du rang de la carte. Sinon, laisser vide. Valeurs suggérées `full`	Ligne de texte	facultatif
Nom complet - couleur	`suit_name`	Préciser « full » pour afficher le nom complet de la couleur, ou « letter » pour une abréviation en deux lettres. Sinon, laisser vide. Valeurs suggérées `full` `letter`	Ligne de texte	facultatif
Couleur - piques	`spades_color`	Permet de changer la couleur des piques. Par défaut noir Exemple green	Ligne de texte	facultatif
Couleur - cœurs	`hearts_color`	Permet de changer la couleur des cœurs. Par défaut rouge Exemple blue	Ligne de texte	facultatif
Couleur - carreaux	`diamonds_color`	Permet de changer la couleur des carreaux. Par défaut rouge Exemple green	Ligne de texte	facultatif
Couleur - trèfles	`clubs_color`	Permet de changer la couleur des trèfles Par défaut noir Exemple blue	Ligne de texte	facultatif
Séparateur	`separator`	Permet de préciser la séparation entre les cartes. Par défaut espace insécable Exemple « - », « + »	Ligne de texte	facultatif
Première carte	`1`	Préciser la valeur suivie de la couleur. Valeurs : A, K, Q, J, 10 à 1, Jkr. Couleurs : s, h, d, c.	Ligne de texte	suggéré
Deuxième carte	`2`	Préciser la valeur suivie de la couleur. Valeurs : A, K, Q, J, 10 à 1, Jkr. Couleurs : s, h, d, c.	Ligne de texte	facultatif
Troisième carte	`3`	Préciser la valeur suivie de la couleur. Valeurs : A, K, Q, J, 10 à 1, Jkr. Couleurs : s, h, d, c.	Ligne de texte	facultatif
Quatrième carte	`4`	Préciser la valeur suivie de la couleur. Valeurs : A, K, Q, J, 10 à 1, Jkr. Couleurs : s, h, d, c.	Ligne de texte	facultatif
Cinquième carte	`5`	Préciser la valeur suivie de la couleur. Valeurs : A, K, Q, J, 10 à 1, Jkr. Couleurs : s, h, d, c.	Ligne de texte	facultatif
Sixième carte	`6`	Préciser la valeur suivie de la couleur. Valeurs : A, K, Q, J, 10 à 1, Jkr. Couleurs : s, h, d, c.	Ligne de texte	facultatif
Septième carte	`7`	Préciser la valeur suivie de la couleur. Valeurs : A, K, Q, J, 10 à 1, Jkr. Couleurs : s, h, d, c.	Ligne de texte	facultatif
Huitième carte	`8`	Préciser la valeur suivie de la couleur. Valeurs : A, K, Q, J, 10 à 1, Jkr. Couleurs : s, h, d, c.	Ligne de texte	facultatif
Neuvième carte	`9`	Préciser la valeur suivie de la couleur. Valeurs : A, K, Q, J, 10 à 1, Jkr. Couleurs : s, h, d, c.	Ligne de texte	facultatif
Dixième carte	`10`	Préciser la valeur suivie de la couleur. Valeurs : A, K, Q, J, 10 à 1, Jkr. Couleurs : s, h, d, c.	Ligne de texte	facultatif
Onzième carte	`11`	Préciser la valeur suivie de la couleur. Valeurs : A, K, Q, J, 10 à 1, Jkr. Couleurs : s, h, d, c.	Ligne de texte	facultatif
Douzième carte	`12`	Préciser la valeur suivie de la couleur. Valeurs : A, K, Q, J, 10 à 1, Jkr. Couleurs : s, h, d, c.	Ligne de texte	facultatif
Treizième carte	`13`	Préciser la valeur suivie de la couleur. Valeurs : A, K, Q, J, 10 à 1, Jkr. Couleurs : s, h, d, c.	Ligne de texte	facultatif
Quatorzième carte	`14`	Préciser la valeur suivie de la couleur. Valeurs : A, K, Q, J, 10 à 1, Jkr. Couleurs : s, h, d, c.	Ligne de texte	facultatif
Quinzième carte	`15`	Préciser la valeur suivie de la couleur. Valeurs : A, K, Q, J, 10 à 1, Jkr. Couleurs : s, h, d, c.	Ligne de texte	facultatif
use_image	`use_image`	aucune description	Inconnu	obsolète

Voir aussi

Modèle:Carte à jouer