<html><head><meta name="color-scheme" content="light dark"></head><body><pre style="word-wrap: break-word; white-space: pre-wrap;">% !TeX TXS-program:compile = txs:///arara
% arara: pdflatex: {shell: no, synctex: no, interaction: batchmode}
% arara: pdflatex: {shell: no, synctex: no, interaction: batchmode} if found('log', '(undefined references|Please rerun|Rerun to get)')

\documentclass[11pt,a4paper]{ltxdoc}
\usepackage{thematicpuzzle}
\usepackage{fancyvrb}
\usepackage{fancyhdr}
\usepackage{hyperref}
\usepackage{tcolorbox}
\tcbuselibrary{listings,listingsutf8}
\fancyhf{}
\renewcommand{\headrulewidth}{0pt}
\lfoot{\sffamily\small [thematicpuzzle]}
\rfoot{\sffamily\small - \thepage{} -}
\usepackage{hologo}
\providecommand\tikzlogo{Ti\textit{k}Z}
\providecommand\TeXLive{\TeX{}Live\xspace}
\providecommand\PSTricks{\textsf{PSTricks}\xspace}
\let\pstricks\PSTricks
\let\TikZ\tikzlogo

\urlstyle{same}
\hypersetup{pdfborder=0 0 0}
\usepackage[margin=2cm]{geometry}
\setlength{\parindent}{0pt}
\def\TPversion{0.1.2}
\def\TPdate{05/05/2024}
\usepackage{soul}
\usepackage{codehigh}
\usepackage{tabularray}
\sethlcolor{lightgray!25}
\NewDocumentCommand\MontreCode{ m }{%
	\hl{\vphantom{\texttt{pf}}\texttt{#1}}%
}
\usepackage[french]{babel}

\begin{document}

\pagestyle{fancy}

\thispagestyle{empty}

\begin{center}
	\begin{minipage}{0.88\linewidth}
	\begin{tcolorbox}[colframe=yellow,colback=yellow!15]
		\begin{center}
			\begin{tabular}{c}
				{\Huge \texttt{thematicpuzzle [fr]}}\\
				\\
				{\LARGE PrÃ©senter un 'puzzle' horizontal,} \\
				{\LARGE avec diffÃ©rents thÃ¨mes.} \\
				\\
				{\small \texttt{Version \TPversion{} -- \TPdate}}
		\end{tabular}
		\end{center}
	\end{tcolorbox}
\end{minipage}
\end{center}

\begin{center}
	\begin{tabular}{c}
	\texttt{CÃ©dric Pierquet}\\
	{\ttfamily c pierquet -- at -- outlook . fr}\\
	\texttt{\url{https://forge.apps.education.fr/pierquetcedric/packages-latex}} \\
\end{tabular}
\end{center}

\hrule

\vfill

\begin{tcolorbox}[colframe=lightgray,colback=lightgray!5,halign=center]
\PuzzleThemes[CouleursFond={yellow!50,purple!50}]{A,B,C,D,E,F,G,H}
\end{tcolorbox}

\begin{tcolorbox}[colframe=lightgray,colback=lightgray!5,halign=center]
\PuzzleThemes[Epaisseur=1.25pt,Echelle=2.75,CouleursFond={yellow!10,orange!10,green!10,teal!10,purple!10},Labels={Probas,Stats,Python,Suites,Matrices},CouleurBord=darkgray,CouleurIcones=teal!75!black]{\ThemProbas,\ThemStats,\ThemPython,\ThemSuites,\ThemMatrices}
\end{tcolorbox}

\vfill

\hfill{\footnotesize\itshape Merci Ã&nbsp; quark67 pour ses retours.}

\vspace*{5mm}

\pagebreak

\phantomsection

\hypertarget{matoc}{}

\tableofcontents

\vspace*{5mm}

\hrule

\vspace*{5mm}

\section{Introduction}

\subsection{Description}

Avec ce package, il est possible de crÃ©er un \textit{bandeau horizontal}, sous forme de puzzle, avec diffÃ©rentes thÃ©matiques.

Les styles sont \textit{globalement} fixÃ©s, mais il est possible de configurer :

\begin{itemize}
	\item les couleurs ;
	\item les icones ;
	\item les labels.
\end{itemize}

Les \textit{bordures} intÃ©rieures sont alÃ©atoirement orientÃ©es vers la gauche ou vers la droite, et le code se charge de colorier (le cas Ã©chÃ©ant) les piÃ¨ces de maniÃ¨re satisfaisante.

\subsection{DÃ©corations}

Pour le moment, les \textit{dÃ©corations} des piÃ¨ces sont Ã&nbsp; dÃ©clarer comme des caractÃ¨res, par exemple avec des icÃ´nes du package \MontreCode{fontawesome} (chargÃ© par le package).

\smallskip

Ã€ terme, il sera peut-Ãªtre possible d'insÃ©rer des images ou des codes \TikZ, cela fait partie des pistes d'amÃ©liorations.

\subsection{Chargement}

Pour charger le package, il suffit d'ajouter dans le prÃ©ambule :

\begin{quote}
\begin{verbatim}
\usepackage{thematicpuzzle}                  %avec fontawesome5, par dÃ©faut
\usepackage[fa6]{thematicpuzzle}             %avec fontawesome6 (en test)
\end{verbatim}
\end{quote}

Les packages utiles, et chargÃ©s sont :

\begin{itemize}
	\item \MontreCode{tikz}, \MontreCode{fontawesome} et \MontreCode{xintexpr} ;
	\item \MontreCode{simplekv}, \MontreCode{listofitems} et \MontreCode{xstring}.
\end{itemize}

\vfill

\subsection{Historique}

\begin{quote}
\begin{verbatim}
0.1.2 : Bugfix  + pre-compatibilitÃ© avec fontawesome6
0.1.1 : AmÃ©lioration de la gestion des couleurs
0.1.0 : Version initiale
\end{verbatim}
\end{quote}

\pagebreak

\section{La commande}

\subsection{Fonctionnement global}

Dans le but de crÃ©er un \textit{puzzle de thÃ¨mes}, la commande est :

\begin{quote}
\begin{verbatim}
%----puzzle de thÃ¨mes
\PuzzleThemes[clÃ©s]&lt;options tikz&gt;{liste des dÃ©corations}
\end{verbatim}
\end{quote}

\subsection{ClÃ©s, arguments}

Les \textsf{clÃ©s}, optionnelles et entre \MontreCode{[...]}, sont :

\begin{itemize}
	\item \MontreCode{Epaisseur} := Ã©paisseur des traits (\MontreCode{1pt} par dÃ©faut) ;
	\item \MontreCode{Echelle} := Ã©chelle globale de la figure (\MontreCode{1} par dÃ©faut) ;
	\item \MontreCode{CouleursFond} := couleur(s) de fond (voir paragraphe sur les couleurs) ;
	\item \MontreCode{CouleurBord} := couleur des bordures (\MontreCode{black} par dÃ©faut) ;
	\item \MontreCode{Labels} := libellÃ©s (optionnels) des thÃ¨mes (\MontreCode{\{\}} par dÃ©faut) ;
	\item \MontreCode{EchelleLabels} := Ã©chelle des libellÃ©s (\MontreCode{1.15} par dÃ©faut) ;
	\item \MontreCode{PoliceLabels} := police des libellÃ©s (\MontreCode{\textbackslash tiny\textbackslash sffamily} par dÃ©faut) ;
	\item \MontreCode{CouleurIcones} := couleur des icÃ´nes et les libellÃ©s (\MontreCode{black} par dÃ©faut).
\end{itemize}

\medskip

L'argument optionnel, entre \MontreCode{&lt;...&gt;}, correspond Ã&nbsp; des options spÃ©cifiques (en langage \TikZ) Ã&nbsp; passer Ã&nbsp; l'environnement crÃ©Ã©.

\smallskip

L'argument obligatoire, entre \MontreCode{\{...\}}, correspond Ã&nbsp; la liste des dÃ©corations (sous forme de \textit{caractÃ¨res}) des diffÃ©rentes piÃ¨ces de puzzle, sous la forme \MontreCode{\{DÃ©co&lt;1&gt;,DÃ©co&lt;2&gt;,...,DÃ©co&lt;n&gt;\}}

\subsection{Les couleurs des cases}

Concernant la couleur de cases, c'est la clÃ© \MontreCode{CouleursFond} qui en est en charge.

Elle peut fonctionner de plusieurs maniÃ¨res :

\begin{itemize}
	\item par dÃ©faut elle est vide, ce qui ne colorie pas les cases ;
	\item on peut la donner sous forme unique, via \MontreCode{CouleursFond=macouleur}, au quel cas toutes les cases sont de la mÃªme couleur ;
	\item on peut la donner sous forme d'une liste \MontreCode{CouleursFond=\{macouleurA,macouleurB,...\}} et :
	\begin{itemize}
		\item dans le cas oÃ¹ le nombre de couleurs est suffisant, elles sont utilisÃ©es l'une aprÃ¨s l'autre ;
		\item dans le cas contraire, le code se charge de \textit{rÃ©pÃ©ter} le motif des couleurs proposÃ©es.
	\end{itemize}
\end{itemize}

\subsection{Raccourcis pour certaines dÃ©corations}

Des \textit{raccourcis} francisÃ©s ont Ã©tÃ© crÃ©Ã©s dans le package, pour des saisies simplifiÃ©es des dÃ©corations :

\begin{center}
	\begin{tblr}{hlines,colspec={Q[m,l]Q[m,c]}}
		\fakeverb{\ThemProbas} &amp; \ThemProbas \\
		\fakeverb{\ThemStats} &amp; \ThemStats \\
		\fakeverb{\ThemChimie} &amp; \ThemChimie \\
		\fakeverb{\ThemArithm} &amp; \ThemArithm \\
		\fakeverb{\ThemGraphes} &amp; \ThemGraphes \\
		\fakeverb{\ThemComplexes} &amp; \ThemComplexes \\
		\fakeverb{\ThemMPM} &amp; \ThemMPM \\
		\fakeverb{\ThemCalculs} &amp; \ThemCalculs \\
		\fakeverb{\ThemMatrices} &amp; \ThemMatrices \\
		\fakeverb{\ThemGeometrie} &amp; \ThemGeometrie \\
	\end{tblr}
	\hspace{1cm}
	\begin{tblr}{hlines,colspec={Q[m,l]Q[m,c]}}
		\fakeverb{\ThemEspace} &amp; \ThemEspace \\
		\fakeverb{\ThemPhysique} &amp; \ThemPhysique \\
		\fakeverb{\ThemFonctions} &amp; \ThemFonctions \\
		\fakeverb{\ThemSuites} &amp; \ThemSuites \\
		\fakeverb{\ThemTableur} &amp; \ThemTableur \\
		\fakeverb{\ThemAlgo} &amp; \ThemAlgo \\
		\fakeverb{\ThemEco} &amp; \ThemEco \\
		\fakeverb{\ThemPython} &amp; \ThemPython \\
		\fakeverb{\ThemLogique} &amp; \ThemLogique \\
	\end{tblr}
\end{center}

\subsection{Exemples}

\begin{tcblisting}{colframe=lightgray,colback=lightgray!5}
\PuzzleThemes{\faAngry,\faArchway,\faAtlas,\faAtom}
\end{tcblisting}

\begin{tcblisting}{colframe=lightgray,colback=lightgray!5}
\PuzzleThemes[Labels={Maths,Histoire,GÃ©o,Chimie},CouleursFond={yellow!25,red!25}]%
  {\faAngry,\faArchway,\faAtlas,\faAtom}
\end{tcblisting}

\begin{tcblisting}{colframe=lightgray,colback=lightgray!5}
\PuzzleThemes%
  [Echelle=2,CouleursFond=yellow!25,Labels={Maths,Histoire,GÃ©o,Chimie}]%
  {\faAngry,\faArchway,\faAtlas,\faAtom}
\end{tcblisting}

\begin{tcblisting}{colframe=lightgray,colback=lightgray!5}
\PuzzleThemes%
  [Echelle=3,CouleursFond={yellow!10,orange!10,red!10,teal!10},
  Labels={Maths,Histoire,GÃ©o,Chimie}]%
  {\faAngry,\faArchway,\faAtlas,\faAtom}
\end{tcblisting}

\begin{tcblisting}{colframe=lightgray,colback=lightgray!5}
\PuzzleThemes%
  [Epaisseur=2pt,Echelle=1.25,
  CouleursFond={yellow!10,orange!10,red!10,teal!10,purple!10},
  Labels={Probas,Stats,Python,Suites,Matrices},CouleurBord=brown,
  CouleurIcones=teal!75!black]%
  {\ThemProbas,\ThemStats,\ThemPython,\ThemSuites,\ThemMatrices}
\end{tcblisting}

\pagebreak

\section{La commande en anglais}

Le package propose Ã©galement la commande et ses clÃ©s en version anglaise.

\begin{quote}
\begin{verbatim}
%----commande anglaise
\ThematicPuzzle[clÃ©s]&lt;options tikz&gt;{liste des dÃ©corations}
\end{verbatim}
\end{quote}

Les \textsf{clÃ©s}, toujours optionnelles et entre \MontreCode{[...]}, sont :

\begin{itemize}
	\item \MontreCode{Thickness} ;
	\item \MontreCode{Scale} ;
	\item \MontreCode{BgColors} ;
	\item \MontreCode{BorderColor} ;
	\item \MontreCode{Labels} ;
	\item \MontreCode{ScaleLabels} ;
	\item \MontreCode{FontLabels} ;
	\item \MontreCode{IconsColor}.
\end{itemize}

\begin{tcblisting}{colframe=lightgray,colback=lightgray!5}
\ThematicPuzzle%
  [Thickness=2pt,Scale=1.25,
  BgColors={yellow!10,orange!10,red!10,teal!10,purple!10,gray!10},
  IconsColor=teal!75!black]%
  {P,Y,T,H,O,N}
\end{tcblisting}

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