% !TeX TXS-program:compile = txs:///arara
% arara: pdflatex: {shell: no, synctex: no, interaction: batchmode}
% arara: pdflatex: {shell: no, synctex: no, interaction: batchmode}

\documentclass[11pt,a4paper]{ltxdoc}
\usepackage{amsmath}
\usepackage{kpfonts}
\usepackage{inconsolata}
\usepackage[T1]{fontenc}
\usepackage[scale=0.875]{cabin}
\usepackage{tikz-triminos}
\usepackage{fancyvrb}
\usepackage{fancyhdr}
\usepackage{tabularray}
\fancyhf{}
\renewcommand{\headrulewidth}{0pt}
\lfoot{\sffamily\small [tikz-triminos]}
\cfoot{\sffamily\small - \thepage{} -}
\rfoot{\hyperlink{matoc}{\small\faArrowAltCircleUp[regular]}}
\usepackage{hologo}
\providecommand\tikzlogo{Ti\textit{k}Z}
\providecommand\TeXLive{\TeX{}Live\xspace}
\let\TikZ\tikzlogo

\usepackage{hyperref}
\urlstyle{same}
\hypersetup{pdfborder=0 0 0}
\usepackage[margin=2cm]{geometry}
\setlength{\parindent}{0pt}
\def\TPversion{0.1.0}
\def\TPdate{20/01/2025}
\usepackage{tcolorbox}
\tcbuselibrary{breakable,skins,hooks,listingsutf8}

\lstset{
	language=[LaTeX]TeX,%
	basicstyle=\ttfamily,%
	keywordstyle={\color{blue}},%
	classoffset=0,%
	keywords={},%
	alsoletter={-},%
	keywordstyle={\color{blue}},%
	classoffset=1,%
	alsoletter={-},%
	morekeywords={tkz-triminos},%
	keywordstyle={\color{violet}},%
	classoffset=2,%
	alsoletter={-},%
	morekeywords={\tkztriminos},%
	keywordstyle={\color{green!50!black}},%
	classoffset=3,%
	morekeywords={},%
	keywordstyle={\color{orange}}
}

\newtcblisting{DemoCode}[1]{%
	enhanced,width=\linewidth,%
	bicolor,size=title,%
	colback=cyan!10!white,%
	colbacklower=cyan!5!white,%
	colframe=cyan!75!black,%
	listing options={%
		breaklines=true,%
		breakatwhitespace=true,%
		style=tcblatex,basicstyle=\small\ttfamily,%
		tabsize=4,%
		commentstyle={\itshape\color{gray}},
		keywordstyle={\color{blue}},%
		classoffset=0,%
		keywords={\usepackage,\includegraphics,xstring,listofitems,\tikzset,\readlist,\showitems,\xintFor,\xintSeq},%
		alsoletter={-},%
		keywordstyle={\color{blue}},%
		classoffset=1,%
		alsoletter={-},%
		morekeywords={tikz-triminos},%
		keywordstyle={\color{violet}},%
		classoffset=2,%
		alsoletter={-},%
		morekeywords={\tkztriminos},%
		keywordstyle={\color{green!50!black}},%
		classoffset=3,%
		morekeywords={size,font,decocolor,decoration,showtxtlogo,showiconlogo,bgcolor,txtlogo,iconlogo,scaledeco,fontdeco},%
		keywordstyle={\color{orange}}
	},%
	#1
}

\newtcbinputlisting\DemoCodeFile[1]{%
	enhanced,width=\linewidth,%
	bicolor,size=title,%
	colback=lightgray!10!white,%
	colbacklower=lightgray!5!white,%
	colframe=lightgray!75!black,%
	listing options={%
		breaklines=true,%
		breakatwhitespace=true,%
		style=tcblatex,
		basicstyle=\scriptsize\ttfamily,%
		tabsize=4,%
		commentstyle={\itshape\color{gray}},%
		%lastline=148
	},%
	breakable,
	listing only,%
	listing file={#1}
}

\NewDocumentCommand\ShowCode{ m }{%
	\lstinline{#1}%
}

\begin{document}

\thispagestyle{empty}

\begin{center}
	\begin{minipage}{0.88\linewidth}
		\begin{tcolorbox}[colframe=yellow,colback=yellow!15]
			\begin{center}
				\renewcommand{\arraystretch}{1.25}%
				\begin{tabular}{c}
					{\Huge \texttt{tikz-triminos}}\\
					\\
					{\LARGE Single or several TriMinos,} \\
					{\LARGE made with Ti\textit{k}Z\ldots} \\
					\\
					{\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{tcblisting}{colframe=lightgray,colback=lightgray!5,listing only}
%single TriMino
\tkztriminos{One § Two § \faHatWizard}~~\tkztriminos{\faHatWizard § Three § Two}
\end{tcblisting}

\begin{tcolorbox}[colframe=lightgray,colback=lightgray!5]
\hfill\tkztriminos<scale=0.85,transform shape>{One § Two § \faHatWizard}~~\tkztriminos<scale=0.85,transform shape>{\faHatWizard § Three § Two}\hfill~
\end{tcolorbox}


\begin{tcblisting}{colframe=lightgray,colback=lightgray!5,listing only}
%multiple TriMino (9 or 12)
\tkztriminos[keys]<tikz options>{list of values}
\end{tcblisting}

\begin{tcolorbox}[colframe=lightgray,colback=lightgray!5]
\hfill\tkztriminos%
[size=5cm,showiconlogo,bgcolor=teal!15,font=\large,iconlogo={\scalebox{3}[3]{\textcolor{orange}{\faBahai}}},decocolor=orange]%
<scale=0.5,rotate=90,transform shape>%
{%
	$1+1$ § $2$ §
	$2+2$ § $4$ §
	$3+3$ § ${6}$ §
	{$x_{1}=\frac{-3-\sqrt{41}}{6}$ ; $x_{2}=\frac{-3+\sqrt{41}}{6}$} § $9x^{2}+9x-8$ §
	$5+5$ § $10$ §
	${6}+6$ § $12$ §
	$7+7$ § $14$ §
	$8+8$ § $16$ §
	${9}+{9}$ § $18$ §
	$10+10$ § $20$ §
	$11+11$ § $22$ §
	$12+12$ § $24$ §
	$13+13$ § $26$ §
	$14+14$ § $28$ §
	$15+15$ § $30$ §
	$16+16$ § $32$ §
	$17+17$ § $34$ §
	$18+18$ § $36$
}\hfill~
\end{tcolorbox}

\vfill~

\hrule

\vspace*{2.5mm}

\textit{Inspirations, with \texttt{CC\,BY-NC-SA\,4.0} license, come from  \url{https://schule.paul-matthies.de/Trimino.php}}.

\vspace*{2.5mm}

\hrule

\vspace*{2.5mm}

{\tiny\itshape Yes, it's -- again -- a package "clearly too limited which simply aligns, linearly and without any real programmation, the high-level macros of the packages \lstinline[language={[latex]TeX},basicstyle=\ttfamily]|tikz|, \texttt{listofitems}, \texttt{xstring}, \texttt{settobox} and \texttt{simplekv}". But if you don't want to use it, it's easy\ldots don't load it ! If you want to take ownership of the package, with better programming, it's easy too\ldots just ask !}

\vspace*{2.5mm}

\hrule

\pagebreak

\phantomsection

\hypertarget{matoc}{}

\tableofcontents

\vspace*{5mm}

%\hrule

\pagebreak

\section{Loading, useful packages, purposes and acknowledgments}

\subsection{Loading and useful packages}

In order to load \lstinline[language={[latex]TeX},basicstyle=\ttfamily]{tikz-triminos}, simply use:

\begin{DemoCode}{listing only}
\usepackage{tikz-triminos}
\end{DemoCode}

%Loaded packages are \lstinline[language={[latex]TeX},basicstyle=\ttfamily]|tikz| (with librairies \lstinline[language={[latex]TeX},basicstyle=\ttfamily]|calc| and \lstinline[language={[latex]TeX},basicstyle=\ttfamily]|decorations text|), \lstinline[language={[latex]TeX},basicstyle=\ttfamily]|ifthen|, \lstinline[language={[latex]TeX},basicstyle=\ttfamily]|simplekv|, \lstinline[language={[latex]TeX},basicstyle=\ttfamily]|listofitems|, \lstinline[language={[latex]TeX},basicstyle=\ttfamily]|fontawesome5| and \lstinline[language={[latex]TeX},basicstyle=\ttfamily]|settobox|.

\subsection{Purposes and acknowledgments}

The purposes of this small package is to provide simple tool to create \textsf{TriMinos} (1 or 9 or 12) with automatic positionning of texts.

\smallskip

\textit{Inspiration come from \url{https://schule.paul-matthies.de/Trimino.php} (CC BY-SA 4.0)}.

\section{Usage}

\subsection{Main macro}

In order to create (single or multiple) \textsf{TriMinos}, simple use:

\begin{DemoCode}{listing only}
\tkztriminos[keys]<tikz options>{list of values}
\end{DemoCode}

For \texttt{list of values} argument (seperated with \texttt{§}):

\begin{itemize}
	\item 3 values can be given (so 1 \textsf{TriMino}) ;
	\item 19 values can be given (so 9 \textsf{TriMinos}, with 5 \textit{jokers}) ;
	\item 25 values can be given (so 12 \textsf{TriMinos}, with 10 \textit{jokers}) ;
	\item 36 values can be given (so 12 full \textsf{TriMinos}).
\end{itemize}

Moreover:

\begin{itemize}
	\item if the text is too long for the \textsf{TriMino}, the code adjusts its width ;
	\item icons of graphicx elements can be used ;
	\item with \textit{jokers}, the final value is the \textit{joker}.
\end{itemize}

\begin{DemoCode}{}
%default output
\tkztriminos{value 1 § value 2 § a long long value 3}
\end{DemoCode}

\pagebreak

\subsection{TikZ styles}

Few \TikZ\ styles are available, and they can be modified.

\begin{DemoCode}{listing only}
%sides of TriMino
\tikzset{tkztriminoside/.style={thick}}

%labels (with \tkztriminofont given by key)
\tikzset{tkztriminolabel/.style={font=\tkztriminofont,inner sep=1pt}}

%decoration (with \tkztriminocolor given by key)
\tikzset{tkztriminosidedeco/.style={semithick,draw=black,fill=\tkztriminocolor}}
\end{DemoCode}

\subsection{Keys}

Available keys, to be given within \lstinline[language={[latex]TeX},basicstyle=\ttfamily]|[...]| are:

\begin{itemize}
	\item \lstinline[language={[latex]TeX},basicstyle=\ttfamily]|size| := size of \textsf{TriMino}\hfill(default \lstinline[language={[latex]TeX},basicstyle=\ttfamily]|5cm|)
	\item \lstinline[language={[latex]TeX},basicstyle=\ttfamily]|font| := font for texts\hfill(default \lstinline[language={[latex]TeX},basicstyle=\ttfamily]|\Large|)
	\item \lstinline[language={[latex]TeX},basicstyle=\ttfamily]|decoration| :=boolean for showing the \textit{inner} decoration\hfill(default \lstinline[language={[latex]TeX},basicstyle=\ttfamily]|true|)
	\item \lstinline[language={[latex]TeX},basicstyle=\ttfamily]|decocolor| := color of the optional \textit{inner} decoration\hfill(default \lstinline[language={[latex]TeX},basicstyle=\ttfamily]|lightgray|)
	\item \lstinline[language={[latex]TeX},basicstyle=\ttfamily]|showtxtlogo| := boolean for showing optional circular logo text\hfill(default \lstinline[language={[latex]TeX},basicstyle=\ttfamily]|false|)
	\item \lstinline[language={[latex]TeX},basicstyle=\ttfamily]|txtlogo| := text for optional circular logo\hfill(default \lstinline[language={[latex]TeX},basicstyle=\ttfamily]|TriMino~TriMino~TriMino~|)
	\item \lstinline[language={[latex]TeX},basicstyle=\ttfamily]|fontdeco| := font for optional circular logo\hfill(default \lstinline[language={[latex]TeX},basicstyle=\ttfamily]|\tiny\sffamily|)
	\item \lstinline[language={[latex]TeX},basicstyle=\ttfamily]|showiconlogo| := boolean for showing optional graphic logo\hfill(default \lstinline[language={[latex]TeX},basicstyle=\ttfamily]|false|)
	\item \lstinline[language={[latex]TeX},basicstyle=\ttfamily]|iconlogo| := graphic element for center logo
	\item \lstinline[language={[latex]TeX},basicstyle=\ttfamily]|bgcolor| := optional background color of \textsf{TriMino}
	\item \lstinline[language={[latex]TeX},basicstyle=\ttfamily]|scaledeco| :=scale for \textit{inner} decoration\hfill(default \lstinline[language={[latex]TeX},basicstyle=\ttfamily]|0.25|)
\end{itemize}

\pagebreak

\section{Examples}

\subsection{One TriMino}

\begin{DemoCode}{}
\tkztriminos%
	[showiconlogo,size=4cm,bgcolor=yellow!15,decocolor=teal!75,font=\large]
	{$(x+1)(x+2)$ § $x^2+2x+1$ § $(x-7)^2-4$}
\end{DemoCode}

\begin{DemoCode}{}
\tkztriminos[showtxtlogo]{%
	\faHatWizard\,--\,\faHatWizard\,--\,\faHatWizard
	§
	\faPython\,--\,\faPython\,--\,\faPython
	§
	\faTimes\,--\,\faTimes\,--\,\faTimes
}
\end{DemoCode}

\subsection{Several TriMinos}

\begin{DemoCode}{}
\tkztriminos%
	[size=5cm,showiconlogo,bgcolor=orange!15,font=\large,decocolor=purple,%
	iconlogo={\scalebox{2.15}[2.15]{\textcolor{blue!75!black}{\faPuzzlePiece}}}]%
	<scale=0.75,transform shape>%
	{%
	$1+1$ § $2$ §
	$2+2$ § $4$ §
	$3+3$ § $6$ §
	{$x_{1}=\frac{-3-\sqrt{41}}{6}$ ; $x_{2}=\frac{-3+\sqrt{41}}{6}$} § $9x^{2}+9x-8$ §
	$5+5$ § $10$ §
	$6+6$ § $12$ §
	$7+7$ § $14$ §
	$8+8$ § $16$ §
	$9+9$ § $18$ §
	$10+10$ § $20$ §
	$11+11$ § $22$ §
	$12+12$ § $24$ §
	Joker
}
\end{DemoCode}

\pagebreak

\begin{DemoCode}{}
\tkztriminos%
	[showiconlogo,iconlogo={\includegraphics[height=0.75cm]{pfl-checked}}]%
	{1a§1b§2a§2b§3a§3b§4a§4b§5a§5b§6a§6b§7a§7b§8a§8b§9a§9b§joker}
\end{DemoCode}

\pagebreak

\section{History}

\texttt{0.1.0: Initial version}

\end{document}