<html><head><meta name="color-scheme" content="light dark"></head><body><pre style="word-wrap: break-word; white-space: pre-wrap;">%% Packages indispensables
\documentclass[a4paper, 12pt]{article}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage[francais]{babel}

\usepackage[a4paper]{geometry}
\usepackage{graphicx}

\newcommand{\package}[1]{\texttt{#1}}
\newcommand{\kv}[2]{\textit{&lt;#1&gt;}\texttt=\textit{&lt;#2&gt;}}
\newcommand{\key}[3]{\textbf{\texttt{#1} (valeur par dĂŠfaut : \texttt{#2})} #3}
\newcommand{\commande}[1]{\texttt{\textbackslash#1}}


\usepackage{hyperref}
\hypersetup{
	colorlinks=true,
	linkcolor=blue,
	urlcolor=blue,
}

\title{Package \texttt{playcards.sty} pour \LaTeX}
\date{\today}
\author{ClĂŠment \bsc{PagĂ¨s} \texttt{contact -- arobase -- clementpages point fr}}

\begin{document}
\maketitle

Ce petit package fournit des commandes pour dessiner des cartes Ă&nbsp; jouer, de largeur 59 mm et de hauteur 89 mm. Ce sont les dimensions des cartes classiques.

\tableofcontents

\section*{Remerciements}
Je remercie Christophe \bsc{Poulain} pour son gĂŠnial package \href{https://ctan.org/pkg/profcollege}{ProfCollege}, dont le code m'a servi d'inspiration pour la syntaxe des commandes utilisĂŠes ici. Et plus globalement pour ce package exceptionnel, devenu indispensable !

Merci ĂŠgalement Ă&nbsp; \href{https://tex.stackexchange.com/users/1948/didest}{didest}, dont la question posĂŠe sur \href{https://tex.stackexchange.com/questions/47924/creating-playing-cards-using-tikz}{StackExchange} m'a servi de base.

\section{TĂŠlĂŠchargement, installation, prĂŠrequis}
Le package est disponible sur CTAN : \url{https://ctan.org/pkg/playcards}. Il contient un unique fichier : \texttt{playcards.sty}.

	\subsection{Packages chargĂŠs automatiquement}
Certains packages sont chargĂŠs automatiquement. Ils sont installĂŠs par dĂŠfaut sur la majoritĂŠs des configurations classiques :
\begin{description}
	\item[\package{tikz}] et certaines de ses librairies.
	\item[\package{simplekv}] pour gĂŠrer les paramĂ¨tres facultatifs des commandes par systĂ¨me \kv{clĂŠ}{valeur}.
	\item[\package{graphicx}] pour les images. 
	\item[\package{contour}] pour les ombres et contours de textes.
\end{description}

	\subsection{Packages recommandĂŠs non chargĂŠs automatiquement}
Pour dessiner les cartes individuellement, il n'y a pas de contraintes sur les marges ou le format de papier.

Pour obtenir des planches de cartes identiques, le format doit ĂŞtre A4 et le package \commande{usepackage[scale=0.95]\{geometry\}} doit ĂŞtre chargĂŠ en prĂŠambule.

\section{Principe gĂŠnĂŠral}
Les principales commandes sont construites sur un systĂ¨me de clĂŠs/valeurs, sur le modĂ¨le \texttt{\textbackslash commande[\kv{cle1}{valeur1}, \kv{cle2}{valeur2}, âŚ]\{param1\}\{param2\}}.

Toutes les clĂŠs sont facultatives et si elles ne sont pas renseignĂŠes, il leur est attribuĂŠ une valeur par dĂŠfaut.

Sauf prĂŠcision contraire, les longueurs sont mentionnĂŠes en millimĂ¨tres.

\section{Commandes fournies}
	\subsection{Options du package}
Par dĂŠfaut, la police d'ĂŠcriture utilisĂŠe pour le texte des cartes est la mĂŞme que celle du document. Il est possible de passer en option le paramĂ¨tre \texttt{anttor} pour que la police des cartes soit \href{https://tug.org/FontCatalogue/antykwatorunska/}{Antykwa ToruĹska}.

	\subsection{Commande \commande{drawcardsrecto}}
Cette commande prend un paramĂ¨tre obligatoire : le texte qui apparaĂŽtra au centre de la carte. Elle remplit une feuille A4 avec 9 cartes identiques. Cette commande trace le recto des cartes. Un exemple est donnĂŠ figure \ref{fig:recto}.
\begin{figure}[h]\begin{center}
	\caption{\commande{drawcardsrecto[trame=false]\{5\}}}
	\includegraphics{fig01.pdf}\label{fig:recto}
\end{center}\end{figure}

ParamĂ¨tres optionnels :
\begin{itemize}
	\item \key{borders}{true}{Trace les bordures. Si \texttt{false}, les bordures sont retirĂŠes.}
	\item \key{trame}{true}{Si \texttt{true}, remplit une feuille A4 avec les cartes. Si \texttt{false}, dessine une seule carte. Pour fonctionner correctement, la clĂŠ \texttt{trame=true} nĂŠcessite que le document soit au format A4 et que soit chargĂŠ en prĂŠambule \commande{usepackage[scale=0.95]\{geometry\}}}.
	\item \key{corners}{true}{Si \texttt{true}, le texte de la carte est reportĂŠ Ă&nbsp; l'endroit Ă&nbsp; et Ă&nbsp; l'envers dans les coins. Si \texttt{false}, les coins ne sont pas affichĂŠs.}
	\item \key{backgroundImg}{true}{Si \texttt{true}, affiche l'arriĂ¨re-plan. Si \texttt{false}, pas d'arriĂ¨re-plan.}
	\item \key{backgroundColor}{red}{SpĂŠcifie la couleur de l'arriĂ¨re-plan. Sera ignorĂŠ si \texttt{backgroundImg=false}. Utilise les couleurs du package \href{https://www.ctan.org/pkg/xcolor}{xcolor}.}
	\item \key{contentsFontSize}{120}{Taille (en pt) du texte au centre de la carte.}
	\item \key{circleRay}{20}{Rayon du cercle blanc au centre de la carte. La valeur \texttt 0 ĂŠquivaut Ă&nbsp; ne pas tracer le cercle.}
\end{itemize}

	\subsection{Commande \commande{drawcardsverso}}
Il est possible, mais ce n'est pas obligatoire, de dessiner le verso des cartes. Les rectos devront ĂŞtre sur une page et les versos sur une autre. Il est recommandĂŠ d'avoir autant de rectos que de versos pour prĂŠserver l'alignement. Un exemple est donnĂŠ figure \ref{fig:verso}.

Pour avoir le bon alignement, il est recommandĂŠ de placer les commandes dans un environnement \verb!\begin{center}...\end{center}!.
\begin{figure}[h]\begin{center}
	\caption{\commande{drawcardsverso[trame=false,contentsFontSize=40]\{Exemple\}}}
	\includegraphics{fig02.pdf}\label{fig:verso}
\end{center}\end{figure}

ParamĂ¨tres optionnels :
\begin{itemize}
	\item \key{backgroundImg}{true}{Si \texttt{true}, affiche l'arriĂ¨re-plan. Si \texttt{false}, pas d'arriĂ¨re-plan.}
	\item \key{trame}{true}{Si \texttt{true}, remplit une feuille A4 avec les cartes. Si \texttt{false}, dessine une seule carte. Pour fonctionner correctement, la clĂŠ \texttt{trame=true} nĂŠcessite que le document soit au format A4 et que soit chargĂŠ en prĂŠambule \commande{usepackage[scale=0.95]\{geometry\}}}.
	\item \key{contentsFontSize}{50}{Taille (en pt) du texte au centre de la carte.}
\end{itemize}

\end{document}
</pre></body></html>