<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>