summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/latex/babel/README.md18
-rw-r--r--Master/texmf-dist/doc/latex/babel/babel-code.pdfbin650256 -> 651093 bytes
-rw-r--r--Master/texmf-dist/doc/latex/babel/babel.pdfbin423559 -> 424112 bytes
-rw-r--r--Master/texmf-dist/doc/latex/catppuccinpalette/README.md79
-rw-r--r--Master/texmf-dist/doc/latex/catppuccinpalette/catppuccinpalette.pdfbin212270 -> 224058 bytes
-rw-r--r--Master/texmf-dist/doc/latex/wordle/README.md41
-rw-r--r--Master/texmf-dist/doc/latex/wordle/wordle-doc-en.pdfbin284036 -> 266174 bytes
-rw-r--r--Master/texmf-dist/doc/latex/wordle/wordle-doc-en.tex1323
-rw-r--r--Master/texmf-dist/doc/latex/wordle/wordle-doc-fr.pdfbin279989 -> 264372 bytes
-rw-r--r--Master/texmf-dist/doc/latex/wordle/wordle-doc-fr.tex1153
10 files changed, 1763 insertions, 851 deletions
diff --git a/Master/texmf-dist/doc/latex/babel/README.md b/Master/texmf-dist/doc/latex/babel/README.md
index c84cd4389bf..ca87d0cf3b6 100644
--- a/Master/texmf-dist/doc/latex/babel/README.md
+++ b/Master/texmf-dist/doc/latex/babel/README.md
@@ -1,6 +1,6 @@
-## Babel 24.7
+## Babel 24.8
-2024-06-26
+2024-08-18
`babel` is the multilingual framework for localizing documents in
LaTeX, LuaLaTeX, XeLaTeX. It manages culturally-determined
@@ -10,9 +10,9 @@ languages even work with Plain formats.
The latest stable version is available on <https://ctan.org/pkg/babel>.
-Changes in version 24.7 are described in:
+Changes in version 24.8 are described in:
-https://latex3.github.io/babel/news/whats-new-in-babel-24.7.html
+https://latex3.github.io/babel/news/whats-new-in-babel-24.8.html
Apart from the manual, you can find information on some aspects of babel at:
@@ -43,15 +43,15 @@ You may also report them to the current maintainer more informally on:
https://latex3.github.io/babel/contact.html
-Bugs related to specific languages are best reported to their
+Bugs related to specific languages are best reported to theirs
respective authors.
### Summary of latest changes
```
-24.7 2024-06-26
- * Improvements in some locales:
- - Filipino (thanks to Leothelion, @ponte-vecchio)
- - Line breaking in Blin, Geez, Tigre, Tigrinya, Wolaytta.
+24.8 2024-08-18
+ * Internal changes in bidi=basic (more reliable).
+ * Hook 'foreign' and \BabelWrapText.
+ * Improved some locales thanks to Stephen Huan (@stephen-huan).
```
### Previous changes
diff --git a/Master/texmf-dist/doc/latex/babel/babel-code.pdf b/Master/texmf-dist/doc/latex/babel/babel-code.pdf
index 8be78258039..3e5cfe93063 100644
--- a/Master/texmf-dist/doc/latex/babel/babel-code.pdf
+++ b/Master/texmf-dist/doc/latex/babel/babel-code.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/babel/babel.pdf b/Master/texmf-dist/doc/latex/babel/babel.pdf
index 8d3e32fbc89..e99c81ec6f0 100644
--- a/Master/texmf-dist/doc/latex/babel/babel.pdf
+++ b/Master/texmf-dist/doc/latex/babel/babel.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/catppuccinpalette/README.md b/Master/texmf-dist/doc/latex/catppuccinpalette/README.md
index 105e5497a4d..4efad071cef 100644
--- a/Master/texmf-dist/doc/latex/catppuccinpalette/README.md
+++ b/Master/texmf-dist/doc/latex/catppuccinpalette/README.md
@@ -1,28 +1,75 @@
-# Readme for the package catppuccinPalette
+<h3 align="center">
+ <img src="https://raw.githubusercontent.com/catppuccin/catppuccin/main/assets/logos/exports/1544x1544_circle.png" width="100" alt="Logo"/><br/>
+ <img src="https://raw.githubusercontent.com/catppuccin/catppuccin/main/assets/misc/transparent.png" height="30" width="0px"/>
+ Catppuccin for <a href="https://www.latex-project.org/">LaTeX</a>
+ <img src="https://raw.githubusercontent.com/catppuccin/catppuccin/main/assets/misc/transparent.png" height="30" width="0px"/>
+</h3>
-Author: Lukas Heindl (`oss.heindl+latex@protonmail.com`).
+<p align="center">
+ <a href="https://github.com/catppuccin/latex/stargazers"><img src="https://img.shields.io/github/stars/catppuccin/latex?colorA=363a4f&colorB=b7bdf8&style=for-the-badge"></a>
+ <a href="https://github.com/catppuccin/latex/issues"><img src="https://img.shields.io/github/issues/catppuccin/latex?colorA=363a4f&colorB=f5a97f&style=for-the-badge"></a>
+ <a href="https://github.com/catppuccin/latex/contributors"><img src="https://img.shields.io/github/contributors/catppuccin/latex?colorA=363a4f&colorB=a6da95&style=for-the-badge"></a>
+</p>
-CTAN page: [catppuccinPalette](https://ctan.org/pkg/catppuccinpalette)
+<p align="center">
+ <img src="assets/preview.webp"/>
+</p>
-## License
-The LaTeX package `catppuccinPalette` is distributed under the LPPL 1.3 license.
+## Previews
-## Description
+<details>
+<summary>đŸŒ» Latte</summary>
+<img src="assets/latte.webp"/>
+</details>
+<details>
+<summary>đŸȘŽ FrappĂ©</summary>
+<img src="assets/frappe.webp"/>
+</details>
+<details>
+<summary>đŸŒș Macchiato</summary>
+<img src="assets/macchiato.webp"/>
+</details>
+<details>
+<summary>🌿 Mocha</summary>
+<img src="assets/mocha.webp"/>
+</details>
-The LaTeX package `catppuccinPalette` provides new colors for xcolor.
+## Usage
-## Installation
+### Importing the theme file
+1. The [catppuccinPalette](https://www.ctan.org/pkg/catppuccinpalette) package is present on CTAN, but probably not included in your TeX Live installation. Follow the steps below to install it manually:
+ - Shortcut: If you set up your local `texmf` you should be able to simply install by executing `make install` (this installs the package locally for the current user)
+ - If you don't like installing the package locally for the current user you might also execue `l3build unpack` and move the generated `.sty` file `build/unpacked/catppuccinpalette.sty` to the root directory of your project.
+ - If you don't have `l3build` available, you can also download the `catppuccinpalette.sty` file from the [latest GitHub release](https://github.com/catppuccin/latex/releases/latest) and move the file to your project root.
+2. Import the package by adding `\usepackage[FLAVOR]{catppuccinpalette}`, replacing `FLAVOR` with the flavor of your choice. i.e. `\usepackage[macchiato]{catppuccinpalette}`. Valid options are: mocha (default), latte, frappe, and macchiato.
+ - If you want the package not only to add color definitions, you can also pass `textcolor=true` and/or `pagecolor=true` to the `catppuccinpalette` package.
+ - Also note that in the pdf containing the documentation, the available options are described in more detail and also the defined colors are listed and shown.
-For a manual installation:
+### Color Naming Conventions
-* put the files `catppuccinpalette.ins` and `catppuccinpalette.dtx` in the same directory;
-* run `latex catppuccinpalette.ins` in that directory.
+All [Catppuccin palette colors](https://github.com/catppuccin/catppuccin#-palette), across all flavors, follow the same naming convention. This theme set prefixes all Catppuccin colors with `Ctp`, i.e. `CtpPeach`, or `CtpBlue`.
-The file `catppuccinpalette.sty` will be generated.
-The file `catppuccinpalette.sty` is the only file necessary to use the latex package `catppuccinPalette`.
-You have to put it in the same directory as your document or (best) in a `texmf` tree.
+### Examples
-Simplified version:
+Please refer to the [examples](https://github.com/catppuccin/latex/tree/main/examples) for full demonstrations, with LaTeX sources and their outputs, on theme usage and code highlighting.
+
+## 💝 Thanks to
+
+- [Lukas](https://github.com/atticus-sullivan)
+- [Brandon](https://github.com/walshyb)
+
+&nbsp;
+
+<p align="center">
+ <img src="https://raw.githubusercontent.com/catppuccin/catppuccin/main/assets/footers/gray0_ctp_on_line.svg?sanitize=true" />
+</p>
+
+<p align="center">
+ Copyright &copy; 2021-present <a href="https://github.com/catppuccin" target="_blank">Catppuccin Org</a>
+</p>
+
+<p align="center">
+ <a href="https://github.com/catppuccin/catppuccin/blob/main/LICENSE"><img src="https://img.shields.io/static/v1.svg?style=for-the-badge&label=License&message=MIT&logoColor=d9e0ee&colorA=363a4f&colorB=b7bdf8"/></a>
+</p>
-* run `l3build unpack` to generate the `.sty` in `build/unpacked/`
diff --git a/Master/texmf-dist/doc/latex/catppuccinpalette/catppuccinpalette.pdf b/Master/texmf-dist/doc/latex/catppuccinpalette/catppuccinpalette.pdf
index 8a5e2d9c89f..b66eca9b011 100644
--- a/Master/texmf-dist/doc/latex/catppuccinpalette/catppuccinpalette.pdf
+++ b/Master/texmf-dist/doc/latex/catppuccinpalette/catppuccinpalette.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/wordle/README.md b/Master/texmf-dist/doc/latex/wordle/README.md
index f1977a1ae76..fdfd9968701 100644
--- a/Master/texmf-dist/doc/latex/wordle/README.md
+++ b/Master/texmf-dist/doc/latex/wordle/README.md
@@ -1,8 +1,33 @@
-wordle is a package to work with Wordle game.
------------------------------------------------------------
-wordle est un package pour travailler avec le jeu du sutom.
------------------------------------------------------------
-Author : CĂ©dric Pierquet
-email : cpierquet@outlook.fr
-Licence : Released under the LaTeX Project Public License v1.3c or later, see http://www.latex-project.org/lppl.txt
-Source : https://tex.stackexchange.com/questions/659860/wordle-like-colored-letter-boxes-in-latex \ No newline at end of file
+![v![]()ersion](https://img.shields.io/github/v/tag/AndrewMathas/wordle?color=success&label=version)
+<a href="http://www.latex-project.org/lppl.txt"><img src="https://img.shields.io/badge/license-LPPLv1.3c-blueviolet.svg"></a>
+<a href="https://www.latex-project.org/"><img src="https://img.shields.io/badge/latex-20B2AA?logo=Latex"></a>
+
+# Wordle
+
+A stupidly feature-rich LaTeX package for typesetting **Wordle** puzzles. This package provides a stupidly feature-rich way of creating Wordle puzzles in LaTeX, which [Wikipedia](https://en.wikipedia.org/wiki/Wordle) describes as a hugely popular web-based word game created and developed by Welsh software engineer Josh Wardle.
+
+This package provides the `wordle` environment, which uses the syntax:
+
+```tex
+% \usepackage{wordle}
+\begin{wordle}{ANVIL}
+ CRANE
+ NATAL
+ ANVIL
+\end{wordle}
+```
+
+Ce package fournit un moyen stupidement riche en fonctionnalitĂ©s de crĂ©er des puzzles **Wordle** en LaTeX, que [Wikipedia](https://en.wikipedia.org/wiki/Wordle) dĂ©crit comme comme un jeu de lettres en ligne extrĂȘmement populaire, crĂ©Ă© et dĂ©veloppĂ© par l'ingĂ©nieur logiciel gallois Josh Wardle.
+
+```tex
+% \usepackage{wordle}
+\begin{GrilleSutom}{REBUS}
+ ABRIS
+ ROUTE
+ REBUS
+\end{GrilleSutom}
+```
+
+### Authors
+Andrew Mathas and CĂ©dric Pierquet
+
diff --git a/Master/texmf-dist/doc/latex/wordle/wordle-doc-en.pdf b/Master/texmf-dist/doc/latex/wordle/wordle-doc-en.pdf
index aadb07f54b0..7845bc31b5f 100644
--- a/Master/texmf-dist/doc/latex/wordle/wordle-doc-en.pdf
+++ b/Master/texmf-dist/doc/latex/wordle/wordle-doc-en.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/wordle/wordle-doc-en.tex b/Master/texmf-dist/doc/latex/wordle/wordle-doc-en.tex
index 06352f5ad5f..a638ed94962 100644
--- a/Master/texmf-dist/doc/latex/wordle/wordle-doc-en.tex
+++ b/Master/texmf-dist/doc/latex/wordle/wordle-doc-en.tex
@@ -1,426 +1,921 @@
-% !TeX TXS-program:compile = txs:///arara
-% arara: pdflatex: {shell: yes, synctex: no, interaction: batchmode}
-% arara: pdflatex: {shell: yes, synctex: no, interaction: batchmode} if found('log', '(undefined references|Please rerun|Rerun to get)')
-
-\documentclass[english,a4paper,11pt]{article}
-\usepackage[margin=2cm,includefoot]{geometry}
-\def\TPversion{0.1.1}
-\def\TPdate{03/09/2023}
-\usepackage{amssymb,amsfonts,amsmath}
-\usepackage[utf8]{inputenc}
-%\usepackage[T1]{fontenc}
+% !TeX TS-program = pdflatex
+
+\documentclass[svgnames]{report}
\usepackage{wordle}
-\usepackage{awesomebox}
-\usepackage{fontawesome5}
-\usepackage{footnote}
-\makesavenoteenv{tabular}
+\usepackage{manfnt}
\usepackage{enumitem}
-\usepackage{tabularray}
-\usepackage{fancyvrb}
-\usepackage{fancyhdr}
-\fancyhf{}
-\renewcommand{\headrulewidth}{0pt}
-\lfoot{\sffamily\small [wordle]}
-\cfoot{\sffamily\small - \thepage{} -}
-\rfoot{\hyperlink{matoc}{\small\faArrowAltCircleUp[regular]}}
-
-%\usepackage{hvlogos}
-\usepackage{xspace}
-\usepackage{hologo}
-\providecommand\tikzlogo{Ti\textit{k}Z}
-\providecommand\TeXLive{\TeX{}Live\xspace}
-\providecommand\PSTricks{\textsf{PSTricks}\xspace}
-\let\pstricks\PSTricks
-\let\TikZ\tikzlogo
-\newcommand\TableauDocumentation{%
- \begin{tblr}{width=\linewidth,colspec={X[c]X[c]X[c]X[c]X[c]X[c]},cells={font=\sffamily}}
- {\LARGE \LaTeX} & & & & &\\
- & {\LARGE \hologo{pdfLaTeX}} & & & & \\
- & & {\LARGE \hologo{LuaLaTeX}} & & & \\
- & & & {\LARGE \TikZ} & & \\
- & & & & {\LARGE \TeXLive} & \\
- & & & & & {\LARGE \hologo{MiKTeX}} \\
- \end{tblr}
+\setlist[description]{font=\sffamily\bfseries\color{ForestGreen},labelwidth=\textwidth}
+\usepackage{booktabs}
+\usepackage[a4paper,margin=18mm]{geometry}
+\synctex=1
+\parindent=0pt
+\parskip=2mm
+
+\usepackage{cmap} % fix search and cut-and-paste in Acrobat
+\setcounter{secnumdepth}{0}
+
+\usepackage{listings}\lstset{language=[LaTeX]TeX,framerule=2pt}
+\lstset{language=[LaTeX]TeX,
+ texcsstyle=*\bfseries\color{Peru},
+ backgroundcolor=\color{Ivory},
+ numbers=none,
+ breaklines=true,
+ keywordstyle=\color{Sienna},
+ commentstyle=\color{BurlyWood},
+ tabsize=2,
+ morekeywords={Wordle,wordle,GrilleSutom},
+ resetmargins=true,
}
-
-\usepackage{hyperref}
-\urlstyle{same}
-\hypersetup{pdfborder=0 0 0}
-\setlength{\parindent}{0pt}
-\definecolor{LightGray}{gray}{0.9}
-
-\usepackage{babel}
-%\AddThinSpaceBeforeFootnotes
-%\FrenchFootnotes
-
-\usepackage{listings}
-
-\usepackage{newverbs}
-\newverbcommand{\motcletex}{\color{cyan!75!black}}{}
-\newverbcommand{\packagetex}{\color{violet!75!black}}{}
-
-\usepackage[most]{tcolorbox}
-\tcbuselibrary{listingsutf8}
-\newtcblisting{DemoCode}[1][]{%
- enhanced,width=0.95\linewidth,center,%
- bicolor,size=title,%
- colback=cyan!2!white,%
- colbacklower=cyan!1!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={},%
- alsoletter={-},%
- keywordstyle={\color{blue}},%
- classoffset=1,%
- alsoletter={-},%
- morekeywords={center,justify},%
- keywordstyle={\color{violet}},%
- classoffset=2,%
- alsoletter={-},%
- morekeywords={WordleGrid},%
- keywordstyle={\color{green!50!black}},%
- classoffset=3,%
- morekeywords={Colors,Rounded,Unit,Font,ColorLetters,Letters,Style,Thickness,BorderColor},%
- keywordstyle={\color{orange}}
- },%
- #1
+% hyperref links to ctan
+\newcommand\ctan[1]{\href{https://www.ctan.org/pkg/#1}{\texttt{#1}}}
+
+\newcommand\Section[1]{\subsection{\textcolor{DarkGreen}{#1}}}
+
+\ExplSyntaxOn
+\NewDocumentCommand\option{ omo }{%
+ \IfNoValueTF{#1}{\textsf{#2}}
+ {%
+ \textbf{\textcolor{Crimson}{#2}}
+ \str_if_empty:nF {#1}{~(default:~\textcolor{DarkRed}{#1})}%
+ \IfNoValueF{#3}{\hfill\textcolor{Gray}{[accepts:~#3]}}%
+ }%
+ \index{#2}%
+}
+\ExplSyntaxOff
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\usepackage{imakeidx}
+\indexsetup{level=\section*, toclevel=section, noclearpage}
+\makeindex[intoc,columns=3]
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\usepackage[skins,listings]{tcolorbox}
+\usetikzlibrary{backgrounds, shapes.geometric} % for tikz={framed,...}
+
+\DeclareTotalTCBox\keyword{ O{} v }{
+ fontupper=\sffamily,
+ nobeforeafter,
+ skin=tile,
+ verbatim,
+ on line,
+ tcbox raise base,
+ top=0pt,bottom=0pt,left=0mm,right=0mm,
+ colback=OldLace,
+ colupper=ForestGreen,
+ #1}
+{#2}
+
+\lstdefinestyle{tikz}{style=tcblatex,
+ classoffset=0,
+ texcsstyle=*\color{DarkGoldenrod},%
+ deletetexcs={begin, end},
+ moretexcs={,%
+ node,
+ draw,
+ true,
+ false
+ },%
+ classoffset=1,
+ keywordstyle=\color{ForestGreen},%
+ morekeywords={wordle,GrilleSutom},
+ classoffset=2,
+ keywordstyle=\color{Crimson},%
+ morekeywords={
+ absent,
+ align,
+ border,
+ borders,
+ case,
+ color,
+ colors,
+ colour,
+ colours,
+ correct,
+ empty,
+ font,
+ frame,
+ frames,
+ letters,
+ lower,
+ name,
+ natural,
+ noalign,
+ noletters,
+ params,
+ present,
+ rounded,
+ rows,
+ scale,
+ sensitive,
+ separation,
+ shape,
+ shapes,
+ size,
+ strict,
+ style,
+ style,
+ text,
+ thickness,
+ tikz,
+ tile,
+ upper,
+ },
+ classoffset=3,
+ keywordstyle=\color{DarkOrange},%
+ morekeywords={
+ hard,
+ standard,
+ sutom,
+ }
}
-\tcbset{vignettes/.style={%
- nobeforeafter,box align=base,boxsep=0pt,enhanced,sharp corners=all,rounded corners=southeast,%
- boxrule=0.75pt,left=7pt,right=1pt,top=0pt,bottom=0.25pt,%
- }
+\DeclareTCBListing{example}{ !O{} }{%
+ skin=bicolor,
+ colframe=MediumSeaGreen,
+ colbacklower=OldLace,
+ colback=LawnGreen!20,
+ lefthand width=50mm,
+ listing style=tikz,
+ sidebyside,
+ sidebyside align=center,
+ sidebyside gap=4mm,
+ text and listing,
+ text outside listing,
+ boxsep = 0pt,
+ #1
}
-\tcbset{vignetteMaJ/.style={%
- fontupper={\vphantom{pf}\footnotesize\ttfamily},
- vignettes,colframe=purple!50!black,coltitle=white,colback=purple!10,%
- overlay={\begin{tcbclipinterior}%
- \fill[fill=purple!75]($(interior.south west)$) rectangle node[rotate=90]{\tiny \sffamily{\textcolor{black}{\scalebox{0.66}[0.66]{\textbf{MĂ J}}}}} ($(interior.north west)+(5pt,0pt)$);%
- \end{tcbclipinterior}}
- }
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+
+\makeatletter
+\author{Andrew Mathas and CĂ©dric Pierquet}
+\usepackage{tikz}
+\usetikzlibrary{shadows.blur}
+\tikzset{shadowed/.style={blur shadow={shadow blur steps=5},
+ bottom color=ForestGreen!30,
+ draw=MediumSeaGreen!70,
+ shade,
+ font=\normalfont\Huge\bfseries\scshape,
+ rounded corners=8pt,
+ top color=SeaGreen,
+ },
+ boxes/.style={draw=SeaGreen,
+ fill=Cornsilk,
+ font=\sffamily\small,
+ inner sep=5pt,
+ rectangle,
+ rounded corners=8pt,
+ text=DarkGreen,
+ }
+}
+\newcommand\Wordle{%
+ \begin{tikzpicture}[remember picture,overlay]
+ \node[yshift=-3cm] at (current page.north west)
+ {\begin{tikzpicture}[remember picture, overlay]
+ \draw[shadowed](30mm,0) rectangle node[white]{wordle} (\paperwidth-30mm,16mm);
+ \node[anchor=west,boxes] at (4cm,0cm) {\@author};
+ \node[anchor=east,boxes] at (\paperwidth-4cm,0) {Version \wordle@version};
+ \end{tikzpicture}
+ };
+ \end{tikzpicture}
+ \vspace*{20mm}
}
-\newcommand\Cle[1]{{\small\sffamily\textlangle \textcolor{orange}{#1}\textrangle}}
-\newcommand\cmaj[1]{\tcbox[vignetteMaJ]{#1}\xspace}
+\def\@oddfoot{\textsc{Wordle} --- \wordle@version~(released~\wordle@release)\hfill\thepage}
+
+\usepackage[colorlinks=true,linkcolor=blue,urlcolor=MediumBlue]{hyperref}
+\hypersetup{
+ pdfcreator={ Generated by pdfLaTeX },
+ pdfinfo={
+ Author ={ Andrew Mathas and CĂ©dric Pierquet},
+ Keywords={ wordle },
+ License ={ LaTeX Project Public License v1.3c or later },
+ Subject ={ LaTeXing Wordle puzzles },
+ Title ={ Wordle - \wordle@version }
+ },
+}
+\makeatother
\begin{document}
-\setlength{\aweboxleftmargin}{0.07\linewidth}
-\setlength{\aweboxcontentwidth}{0.93\linewidth}
-\setlength{\aweboxvskip}{8pt}
-
-\pagestyle{fancy}
-
-\thispagestyle{empty}
-
-\vspace{2cm}
-
-\begin{center}
- \begin{minipage}{0.75\linewidth}
- \begin{tcolorbox}[colframe=yellow,colback=yellow!15]
- \begin{center}
- \begin{tabular}{c}
- {\Huge \texttt{wordle} [en]}\\
- \\
- {\LARGE Grids of Wordle,} \\
- \\
- {\LARGE made with \textsf{Ti\textit{k}Z}.} \\
- \end{tabular}
-
- \bigskip
-
- {\small \texttt{Version \TPversion{} -- \TPdate}}
- \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://github.com/cpierquet/wordle}}
-\end{tabular}
-\end{center}
-
-\vspace{0.25cm}
-
-{$\blacktriangleright$~~Create Wordle grids Wordle/Sutom\footnotemark\footnotetext{\url{https://en.wikipedia.org/wiki/Wordle}}.}
-
-\vspace{0.25cm}
-
-{$\blacktriangleright$~~Specify colors and font\footnotemark\footnotetext{Ideas from \url{ttps://tex.stackexchange.com/questions/659860/wordle-like-colored-letter-boxes-in-latex}}.
-
-\vspace{0.5cm}
-
-\begin{center}
-\begin{WordleGrid}{CRAZE}
- GRAIL TRACK CRAMP CRABS CRAZY CRAZE
-\end{WordleGrid}
-\end{center}
-
-\begin{center}
-\begin{WordleGrid}[Rounded=0,Colors={lightgray,orange,teal},Style=alt,Unit=0.5,Letters=false]{LADLE}
- FLAIL LAPEL LADLE
-\end{WordleGrid}
-%
-\hspace{5mm}
-%
-\begin{WordleGrid}[Rounded=0,Colors={lightgray,orange,teal},Style=alt,Unit=0.5]{LADLE}
- FLAIL LAPEL LADLE
-\end{WordleGrid}
-\end{center}
-
-\vspace{0.25cm}
-
-%\hfill{}\textit{Merci à Denis Bitouzé et à Gilles Le Bourhis pour leurs retours et idées !}
-
-\smallskip
-
-\vfill
-
-\hrule
-
-\medskip
-
-\TableauDocumentation
-
-\medskip
-
-\hrule
-
-\vspace*{1cm}
-
-\newpage
-
-\phantomsection
-\hypertarget{matoc}{}
-
-\tableofcontents
-
-\vfill
-
-\section{History}
-
-\verb|v0.1.1|~:~~~~Bugfix with english version.
-
-\verb|v0.1.0|~:~~~~Initial version.
-
-\newpage
-
-\section{The wordle package}
-
-\subsection{The game}
-
-\begin{noteblock}
-Wordle is a web-based word game created and developed by Welsh software engineer Josh Wardle. Players have six attempts to guess a five-letter word, with feedback given for each guess in the form of colored tiles indicating when letters match or occupy the correct position.
-
-Every day, a five-letter word is chosen which players aim to guess within six tries. After every guess, each letter is marked as either green, yellow or gray: green indicates that letter is correct and in the correct position, yellow means it is in the answer but not in the right position, while gray indicates it is not in the answer at all. Multiple instances of the same letter in a guess, such as the "o"s in "robot", will be colored green or yellow only if the letter also appears multiple times in the answer; otherwise, excess repeating letters will be colored gray.
-
-\smallskip
-
-\hfill{\scriptsize \url{https://en.wikipedia.org/wiki/Wordle}}
-\end{noteblock}
-
-\subsection{The package}
-
-\begin{noteblock}
-This package can display, in a \textsf{tex} file, a wordle grid (with \TikZ{} and within a \motcletex!minipage!), with ability :
-
-\begin{itemize}
- \item to change dimensions and colors ;
- \item to pick style for misplaced letters ;
- \item to change borders and corners ;
- \item to print or not the letters.
-\end{itemize}
-
-It's possible to "play" with other words than five-letter words !
-\end{noteblock}
-
-\begin{importantblock}
-Most of source code, in \hologo{LaTeX3}, is given by thread from \texttt{tex.stackexchange}, proposed by user \textsf{3141592653589793238}.
-\end{importantblock}
-
-\subsection{Loading of the package, used packages}
-
-\begin{importantblock}
-The package \packagetex!wordle! loads within the preamble.
-
-There's no option, and \packagetex!xcolor! isn't loaded.
-\end{importantblock}
-
-\begin{DemoCode}[listing only]
-\documentclass{article}
-\usepackage{wordle}
-
-\end{DemoCode}
-
-\begin{noteblock}
-\packagetex!wordle! loads the following packages and libraries :
-
-\begin{itemize}
- \item \packagetex!tikz!;
- \item \packagetex!simplekv! ;
- \item \packagetex!xstring!.
-\end{itemize}
-
-It’s mostly compatible with \textsf{latex}, \textsf{pdflatex}, \textsf{lualatex} or \textsf{xelatex} compilation !
-\end{noteblock}
-
-\vfill~
-
-\pagebreak
-
-\section{WordleGrid environment}
-
-\subsection{Environment}
-
-\begin{cautionblock}
-The environment to display a Wordle grid is \packagetex!WordleGrid!.
-
-It works with keys, between \texttt{[...]} and needs to know :
-
-\begin{itemize}
- \item the good word ;
- \item the different guesses.
-\end{itemize}
-
-The code create the grid and the colors !
-\end{cautionblock}
-
-\begin{DemoCode}[listing only]
-\begin{WordleGrid}[keys]{good word}
- guess n°1
- guess n°2
- guess n°3
-\end{WordleGrid}
-\end{DemoCode}
-
-\begin{noteblock}
-the grid is created with a \motcletex!minipage!, with automatic width and spacings !
-\end{noteblock}
-
-\begin{DemoCode}[]
-%default output
-\begin{WordleGrid}{REBUS}
- ARISE
- ROUTE
- RULES
- REBUS
-\end{WordleGrid}
-\end{DemoCode}
-
-\subsection{Keys and options}
-
-\begin{tipblock}
-The first argument, mandatory and between \texttt{[...]}, proposes the following \Cle{keys} :
-
-\begin{itemize}
- \item \Cle{Colors} : = colors of the boxes \Cle{back,misplaced,good} ;
-
- \hfill{}default : \Cle{WordleBack,WordleBad,WordleGood},%
- \item \Cle{Rounded} := arc for corners, in mm ; \hfill{}default : \Cle{0.1}
- \item \Cle{Unit} := width of cases, in cm ; \hfill{}default : \Cle{1}
- \item \Cle{Font} := font for letters ; \hfill{}default : \Cle{\textbackslash LARGE\textbackslash bfseries\textbackslash sffamily}
- \item \Cle{ColorLetters} := color for letters ; \hfill{}default : \Cle{white}
- \item \Cle{BorderColor} := color fot the border ; \hfill{}default : \Cle{white}
- \item \Cle{Letters} := boolean to print letters ; \hfill{}default : \Cle{true}
- \item \Cle{Style} := style within \Cle{default / other} to change the style ; \hfill{}default : \Cle{default}
- \item \Cle{Thick} := thickness of the borders, in mm. \hfill{}default : \Cle{0.25}
-\end{itemize}
-\vspace*{-\baselineskip}\leavevmode
-\end{tipblock}
-
-\begin{tipblock}
-The second argument, optional and between \texttt{\{...\}} is the correct word.
-
-\smallskip
-
-Different guesses are given within the body of the environment (line by line or space separated).
-\end{tipblock}
-
-\subsection{Examples}
-
-\begin{DemoCode}[]
-\begin{WordleGrid}{BURGH}
- ABATE
- HERBS
- BURLY
- BURGH
-\end{WordleGrid}
-%
-\hspace{5mm}
-%
-\begin{WordleGrid}[Style=alt]{BURGH}
- ABATE HERBS BURLY BURGH
-\end{WordleGrid}
-\end{DemoCode}
-
-\begin{DemoCode}[]
-\begin{WordleGrid}
- [Thickness=0.3,BorderColor=black,%
- Colors={lightgray,orange,teal}]{BURGH}
- ABATE
- HERBS
- BURLY
- BURGH
-\end{WordleGrid}
-%
-\hspace{5mm}
-%
-\begin{WordleGrid}
- [Rounded=0,Thickness=0.3,BorderColor=black,%
- Colors={lightgray,orange,teal}]{BURGH}
- ABATE
- HERBS
- BURLY
- BURGH
-\end{WordleGrid}
-\end{DemoCode}
-
-\begin{DemoCode}[]
-\begin{WordleGrid}[Unit=2,Font=\Huge\ttfamily,ColorLetters=black]{BURGH}
- ABATE
- HERBS
- BURLY
- BURGH
-\end{WordleGrid}
-\end{DemoCode}
-
-\begin{DemoCode}[]
-\begin{WordleGrid}%
- [Unit=0.75,Rounded=0,Colors={cyan,orange,violet},Letters=false]{BURGH}
- ABATE
- HERBS
- BURLY
- BURGH
-\end{WordleGrid}
-\hspace{5mm}
-\begin{WordleGrid}%
- [Unit=0.75,Rounded=0,Colors={cyan,orange,violet},Style=alt]
- {BURGH}
- ABATE
- HERBS
- BURLY
- BURGH
-\end{WordleGrid}
-\hspace{5mm}
-\begin{WordleGrid}%
- [Unit=0.75,Rounded=0,Colors={cyan,orange,violet},Style=alt,Letters=false]
- {BURGH}
- ABATE
- HERBS
- BURLY
- BURGH
-\end{WordleGrid}
-\end{DemoCode}
-
-\end{document} \ No newline at end of file
+ \Wordle
+
+ This package provides a stupidly feature-rich way of creating
+ \keyword{Wordle} puzzles in \LaTeX, which
+ \href{https://en.wikipedia.org/wiki/Wordle}{Wikipedia} describes as a
+ hugely popular web-based word game created and developed by Welsh
+ software engineer Josh Wardle. This package is an enhanced version of
+ one of the solutions to a question asked by \textcolor{FireBrick}{valerio\_new}
+ on
+ \href{https://tex.stackexchange.com/questions/659860/wordle-like-colored-letter-boxes-in-latex/660056#660056}{tex.stackexchange.com}.
+
+ This package provides the \keyword{wordle} environment, which uses the
+ syntax:
+
+ \begin{tcblisting}{
+ listing only,
+ skin=bicolor,
+ colframe=MediumSeaGreen,
+ colbacklower=OldLace,
+ colback=LawnGreen!20,
+ listing style=tikz,
+ boxsep = 0pt,
+ }
+ % \usepackage{wordle}
+ \begin{wordle}[wordle settings]{solution}[optional tikz commands]
+ guess1 guess2 ...
+ \end{wordle}
+ \end{tcblisting}
+ \index{environment!wordle}
+ \index{wordle}
+
+ and the \keyword{GrilleSutom} environment, for \keyword{Sutom}, the French version of
+ the games:
+
+ \begin{tcblisting}{
+ listing only,
+ skin=bicolor,
+ colframe=MediumSeaGreen,
+ colbacklower=OldLace,
+ colback=LawnGreen!20,
+ listing style=tikz,
+ boxsep = 0pt,
+ }
+ % \usepackage{wordle}
+ \begin{GrilleSutom}[sutom settings]{solution}[optional TikZ commands]
+ guess1 guess2 ...
+ \end{GrilleSutom}
+ \end{tcblisting}
+ \index{environment!GrilleSutom}
+ \index{GrilleSutom}
+ \index{sutom}
+
+ The words in the puzzle can be entered on a single lines, or on separate
+ lines. Here are some examples:
+
+ \begin{example}
+ \begin{wordle}{ANVIL}
+ % English version of sutom (wordle)
+ CRANE
+ NATAL
+ ANVIL
+ \end{wordle}
+ \end{example}
+
+ \begin{example}
+ % French version of wordle (sutom)
+ \begin{GrilleSutom}{REBUS}
+ ABRIS
+ ROUTE
+ REBUS
+ \end{GrilleSutom}
+ \end{example}
+
+ As in the online puzzles, the \keyword{wordle} environment
+ automatically colours the letter tiles
+ \keyword[colback=WordleCorrect,colupper=White]{green}
+ when the letter is in the same position as the solution, and as
+ \keyword[colback=WordlePresent,colupper=White]{gold} when
+ the letter is in the solution but it is not in the correct position.
+ Similarly, \keyword{GrilleSutom} colours the correct letters
+ \keyword[colback=WordleSutomCorrect,colupper=White]{red}
+ and the present letters
+ \keyword[colback=WordleSutomPresent,colupper=White]{gold}.
+ As described below, these colours can be changed to suit your tastes.
+
+ The number of letters in the puzzle is determined by the solution,
+ being constrained only by the page width.
+
+ \begin{example}
+ \begin{wordle}[rows=4]{orange}
+ normal
+ orders
+ orange
+ \end{wordle}
+ \end{example}
+
+ The letters in the puzzle can be entered in upper case, lower case, or
+ mixed case. By default, the case of the letters is ignored when
+ determining the colours of the letter tiles.
+
+ As described below, the \keyword{wordle} and \keyword{GrilleSutom}
+ environments accept an array of different options that change the
+ colours, fonts, and shapes of the tile. In addition, you can the case
+ sensitivity of the environments, add extra rows to the puzzle, disable
+ special formatting of the \textit{letter tiles}. These options are
+ given as a comma separated list key-value pairs. They can be set
+ locally, using the optional argument of the \keyword|wordle|
+ environment, or they can be set globally (more accurately, in the
+ current \LaTeX\ group) using the \keyword{\WordleSetup} command
+ \index{\textbackslash WordleSetup}, or as global package options, via
+ \keyword{\usepackage[options]{wordle}}. The order of the options does
+ not matter, except that later options take precedence over earlier
+ ones, with the exception of \option{tikz} and \option{tile style} keys
+ which are always applied last.
+
+ The \keyword{wordle} puzzles are drawn using \ctan{TikZ}, with each
+ letter in the puzzle sitting inside a \ctan{TikZ} node. Many of the
+ options control the settings of these nodes.
+
+ The descriptions of the options below are grouped according to their
+ function.
+
+ %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+ \Section{Wordle styles}
+
+ The \option{style} key can be used to change many characteristics of
+ the tiles in a \keyword{wordle} puzzle, including their colours, the
+ fonts and so on. The more common settings can be setting using the
+ \option{style} keyword. \textit{The style should always be set first
+ because, otherwise, the style settings may override earlier settings.}
+
+ The following styles are supported:
+
+ \textcolor{DarkOrange}{sutom}
+ \index{style!sutom}
+ \index{sutom}
+
+ \begin{example}
+ \begin{wordle}[style=sutom]{ANVIL}
+ CRANE
+ NATAL
+ ANVIL
+ \end{wordle}
+ \end{example}
+
+ The \textcolor{DarkOrange}{sutom} style is the default
+ style for the \keyword{GrilleSutom} environment.
+
+ \textcolor{DarkOrange}{standard}
+ \index{style!standard}
+
+ \begin{example}
+ \begin{wordle}[style=standard]{ANVIL}
+ CRANE
+ NATAL
+ ANVIL
+ \end{wordle}
+ \end{example}
+
+ The \textcolor{DarkOrange}{standard} style is the default style for the
+ \keyword{wordle} environment.
+
+ \textcolor{DarkOrange}{hard}
+ \index{style!hard}
+
+ \begin{example}
+ \begin{wordle}[style=hard]{ANVIL}
+ CRANE
+ NATAL
+ ANVIL
+ \end{wordle}
+ \end{example}
+
+ %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+ \Section{Options for the individual styles of the letter tiles}
+
+ There are four types of letter tiles in \keyword{wordle}:
+ \option{absent}, \option{present}, \option{correct} and
+ \option{empty}, corresponding to letters not in the solution,
+ incorrectly placed letters, correctly placed letters, and empty
+ tiles, respectively. The options in this section can be used to set
+ the text, tile and border colours, shapes, and frames of these tiles.
+
+ The letter tiles in a \keyword{wordle} environment are typeset inside
+ a \ctan{TikZ} \keyword{\node}. The options below control the different
+ style settings of these nodes.
+
+ \option[--]{colours}[comma separated list of valid colours]
+
+ The \option{colours} option is a short-hand for specifying the colours
+ of the \option{absent}, \option{present}, \option{correct} and
+ \option{empty} tiles, in that order. Later colours can be omitted but
+ the colours should be given in this order, from left to right.
+ If only one colour is given then this colour is applied to all tiles.
+
+ \begin{example}
+ \begin{wordle}[colours={LightGray,Orange,Teal}]{cellar}
+ pounds
+ taylor
+ cellar
+ \end{wordle}
+ \end{example}
+
+ The colours can also be set individually using \option{absent colour},
+ \option{present colour}, \option{correct colour} and \option{empty
+ colour}. To support north American dialects, is also possible to use
+ \option{colors}, \option{absent color}, \option{present color},
+ \option{correct color} and \option{empty color}.
+
+ \begin{example}
+ \begin{wordle}[absent colour=DarkGray,present color=Salmon,
+ correct color=SeaGreen]{cellar}
+ pounds
+ taylor
+ cellar
+ \end{wordle}
+ \end{example}
+
+ \option[white]{borders}[comma separated list of valid colours]
+
+ Similar to the \option{colours} option, this is a short-hand for the
+ setting border colour of the \option{absent}, \option{present},
+ \option{correct} and \option{empty} tiles, in that order.
+ If only one colour is given then this colour is applied to all tiles.
+
+ \begin{example}
+ \begin{wordle}[borders={red, orange,blue}]{ANVIL}
+ CRANE
+ NATAL
+ ANVIL
+ \end{wordle}
+ \end{example}
+
+ You can set the border borders of the individual tiles using
+ \option{absent border}, \option{present border}, \option{correct
+ border} and \option{empty border}
+
+ \option[false]{frames}[comma separated list of true/false]
+
+ This is a short-hand for adding a rectangular frame around the
+ \option{absent}, \option{present}, \option{correct} and \option{empty}
+ tiles, in that order, with the same background colour as the
+ \option{absent} file. This is only useful for non-square tiles.
+
+ \begin{example}
+ \begin{wordle}[frames={false,true,true}, shapes=circle]{ANVIL}
+ CRANE
+ NATAL
+ ANVIL
+ \end{wordle}
+ \end{example}
+
+ You can set the frames of the individual tiles using
+ \option{absent frame}, \option{present frame},
+ \option{correct frame} and \option{empty~frame}.
+
+ \option[rectangle]{shapes}[comma separated list of TikZ shapes]
+
+ Similar to the \option{colours} option, this is a short-hand for the
+ setting shape colour of the \option{absent}, \option{present},
+ \option{correct} and \option{empty} tiles, in that order.
+
+ \begin{example}
+ \begin{wordle}[shapes={circle, rectangle, circle}]{ANVIL}
+ CRANE
+ NATAL
+ ANVIL
+ \end{wordle}
+ \end{example}
+
+ You can set the shape shapes of the individual tiles using
+ \option{absent shape}, \option{present shape},
+ \option{correct shape} and \option{empty shape}
+ You can use the shapes provided by the \ctan{TikZ}
+ \texttt{shapes.geometric} package, including \texttt{diamond},
+ \texttt{ellipse}, \texttt{trapezium} and \texttt{star}; see
+ section~71.2 of the \ctan{TikZ} manual.
+
+ \begin{example}
+ % \usepackage{shapes.geometric}
+ \begin{wordle}[shapes={diamond, ellipse, star}]{LADLE}
+ FLAIL
+ LAPEL
+ *
+ LADLE
+ LOVER
+ \end{wordle}
+ \end{example}
+
+ \option[white]{text}[comma separated list of valid colours]
+
+ This is a short-hand for the setting the text colours of the
+ \option{absent}, \option{present}, \option{correct} and \option{empty}
+ tiles, in that order.
+
+ \begin{example}
+ \begin{wordle}[text={red, orange,blue}]{ANVIL}
+ CRANE
+ NATAL
+ ANVIL
+ \end{wordle}
+ \end{example}
+
+ You can set the text borders of the individual tiles using
+ \option{absent text}, \option{present border}, \option{correct
+ text} and \option{empty border}
+
+
+ \Section{Common tile characteristics}
+
+ The following options apply to all tiles.
+
+ \option[]{noalign} (default) \qquad
+ \option[]{align}
+
+ The options tweak the vertical alignment of the letters in each row of
+ the puzzle. This is only likely to be useful if you have lower case
+ letters in your puzzle.
+
+ \begin{example}
+ \begin{wordle}[align]{agony}
+ groan
+ angry
+ agony
+ \end{wordle}
+ \end{example}
+
+ \begin{example}
+ \begin{wordle}[noalign]{agony} % the default
+ groan
+ angry
+ agony
+ \end{wordle}
+ \end{example}
+
+ \option[\textbackslash Large\textbackslash bfseries\textbackslash sffamily]{font}
+ [LaTeX font specification]
+
+ Sets the font used by all \keyword{wordle} letters. Any valid sequence
+ of \LaTeX\ font commands can be used.
+
+ \begin{example}
+ \begin{wordle}[font=\large\sffamily]{ANVIL}
+ CRANE
+ NATAL
+ ANVIL
+ \end{wordle}
+ \end{example}
+
+ \option[1mm]{rounded}[a length]
+
+ Set TikZ \texttt{rounded corners} key for the \keyword{wordle} letter tiles.
+
+ \begin{example}
+ \begin{wordle}[rounded=2mm]{ANVIL}
+ CRANE
+ NATAL
+ ANVIL
+ \end{wordle}
+ \end{example}
+
+ \option[0.5mm]{separation}[a length]
+
+ Sets the separation distance between the \keyword{wordle} letter
+ tiles.
+
+ \begin{example}
+ \begin{wordle}[separation=2mm, borders=black]{ANVIL}
+ CRANE
+ NATAL
+ ANVIL
+ \end{wordle}
+ \end{example}
+
+ \option[1]{scale}[a number]
+
+ The \option{scale} option rescales the \keyword{wordle} environment.
+ The \option{scale} alters the dimensions sets by the \option{rounded},
+ \option{separation} \option{size} and \option{thickness} options. If
+ you change the scale, then you will almost certainly want
+ to change font size font as well, which you can do using the
+ \option{font} option:
+
+ \begin{example}
+ \begin{wordle}[scale=1.5, font=\huge\bfseries]{SIZE}
+ HELP
+ WISE
+ SIZE
+ \end{wordle}
+ \end{example}
+
+ \option[8mm]{size}[a length]
+
+ The \option{size} option sets the size of the \keyword{wordle} letter
+ tiles. Unlike the \option{scale} option, \option{size} only changes
+ the dimensions of the letter tiles.
+
+ \begin{example}
+ \begin{wordle}[size=10mm, font=\huge\bfseries]{LADLE}
+ FLAIL LAPEL * LADLE
+ \end{wordle}
+ \end{example}
+
+ \option[0.25mm]{thickness}[a length]
+
+ Sets the border thickness of the \keyword{wordle} letter tiles. By
+ default, the borders of the tiles are white, which makes this setting
+ hard to see, so the following example changes the border to red.
+
+ \begin{example}
+ \begin{wordle}[thickness=1mm, borders=red]{LADLE}
+ FLAIL
+ LAPEL
+ LADLE
+ \end{wordle}
+ \end{example}
+
+ \option[--]{tile style}[comma separated list of TikZ style keys]
+
+ A comma-separated list of \ctan{Tikz} node keys that are appended to
+ the style of the \ctan{TikZ} node that contains each of the
+ \keyword{wordle} letters. Some of the options given above can be set
+ directly using the \option{tile style} option. When using the
+ \option{tile style}, be careful not to break the special formatting of
+ letters provided by the \keyword{wordle} environment.\par
+
+ With most of the \keyword{wordle} options, the latter options take
+ precedence, however, the \option{tile style} option is applied last,
+ so it overrides any competing options.
+
+ % TODO: Fix this because it looks like this style is being applied
+ % twice because the PDF file shows a rotation of 90 = 2*45...
+ \begin{example}
+ \begin{wordle}[tile style={rotate=45}]{ANVIL}
+ CRANE
+ NATAL
+ ANVIL
+ \end{wordle}
+ \end{example}
+
+ %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+ \Section{Extra rows and columns}
+
+ By default, all of the words in a \keyword{wordle} puzzle are assumed
+ to have the same number of letters as the solution, and the number of
+ rows in the puzzle is number of words given in the environment. The
+ options below give more control over the number of rows and columns in
+ the puzzle.
+
+ \option[]{letters} (default)\qquad
+ \option[]{noletters}
+
+ By default, the letters in the puzzle are printed. You can hide the
+ letters from the puzzle, while still keeping the \keyword{wordle} tile
+ colouring, using \option{noletters}.
+
+ \begin{example}
+ \begin{wordle}[letters]{CRAZE} % the default
+ TRACE
+ CREAM
+ CRAZE
+ \end{wordle}
+ \end{example}
+
+ \begin{example}
+ \begin{wordle}[noletters]{CRAZE}
+ TRACE
+ CREAM
+ CRAZE
+ \end{wordle}
+ \end{example}
+
+ \option[false]{strict}[true/false/--]
+
+ By default, the \keyword{wordle} environment does not check that each
+ word in the puzzle has the same length as the solution, so missing
+ and extra letters receive no special processing.
+
+ \begin{example}
+ \begin{wordle}[strict=false]{CRAZE} % the default
+ GRAIL
+ CRAMPS
+ CRAM
+ CRABS
+ \end{wordle}
+ \end{example}
+
+ The \option{strict} option enforces the word length in the puzzle by
+ marking missing letters as incorrect and striking out extra letters.
+
+ \begin{example}
+ \begin{wordle}[strict]{CRAZE}
+ GRAIL
+ CRAMPS
+ CRAM
+ CRABS
+ \end{wordle}
+ \end{example}
+
+ \option[--]{rows}
+
+ By default, a \keyword{wordle} environment displays the words
+ in the puzzle environment with one word per row. You can add extra
+ (blank) rows to the puzzle with the \option{rows} option.
+
+ \begin{example}
+ \begin{wordle}[rows=4]{ANVIL}
+ CRANE
+ NATAL
+ ANVIL
+ \end{wordle}
+ \end{example}
+
+ The \option{rows} option only adds extra rows to the puzzle if they
+ are needed. This option does not prevent ``extra'' rows from
+ appearing.
+
+ \begin{example}
+ \begin{wordle}[rows=2]{ANVIL}
+ CRANE
+ NATAL
+ ANVIL
+ \end{wordle}
+ \end{example}
+
+
+ \option[]{*}
+
+ You can disable the special colouring of letter tiles in a
+ \keyword{wordle} puzzle by adding an asterisk,~\option{*}, as a
+ \textit{word}, into the puzzle.
+
+ \begin{example}
+ \begin{wordle}{ANVIL}
+ CRANE
+ NATAL
+ * % disable wordle colouring
+ ANNUL
+ ANVIL
+ \end{wordle}
+ \end{example}
+
+
+ %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+ \Section{Case sensitivity}
+ \index{case~sensitive}
+ \index{case~sensitive!lower case}
+ \index{case~sensitive!natural case}
+ \index{case~sensitive!upper case}
+
+ By default, the letters are printed in upper and lower case, exactly
+ as typed, and the letter comparisons are not case sensitive.
+
+ \option[false]{case~sensitive}
+
+ By default the \keyword{wordle} puzzles are not case sensitive, but
+ you can make them case sensitive using this option. Note that
+ \keyword{case sensitive} is the same as \keyword{case sensitive=true}
+ (and the default option is the same as
+ \keyword{case sensitive=false}).
+
+ \begin{example}
+ \begin{wordle}[case sensitive=false]{youth} % the default
+ North
+ South
+ Youth
+ \end{wordle}
+ \end{example}
+
+ Here is a case sensitive version of this puzzle.
+
+ \begin{example}
+ \begin{wordle}[case sensitive]{youth}
+ North
+ South
+ Youth
+ \end{wordle}
+ \end{example}
+
+ As this puzzle is case sensitive, the \keyword{Y} on the last line is
+ not marked as being correct because it does not match the \keyword{y}
+ in the solution.
+
+ \option[]{natural case} (default) \qquad
+ \option[]{lower case} \qquad
+ \option[]{upper case}
+
+ The \option{lower case} and \option{upper case} options force all
+ letters in the puzzle to be in lower or upper case, respectively.
+
+ \begin{example}
+ \begin{wordle}[lower case]{YOUTH}
+ North
+ South
+ Youth
+ \end{wordle}
+ \end{example}
+
+ \begin{example}
+ \begin{wordle}[upper case]{youth}
+ North
+ South
+ Youth
+ \end{wordle}
+ \end{example}
+
+ As these examples show, both of these options disable the case
+ sensitivity of the tests for colouring the \keyword{wordle} tiles;
+ that is, they set \option{case sensitive=false}. To balance the
+ \option{lower case} and \option{upper case} options, the
+ \option{natural case} option makes the \keyword{wordle} environment
+ restores the default behaviour, which respects the case of the letters
+ as typed into the environment. The \option{natural case} option does
+ not change the \option{case sensitive} setting.
+
+ \begin{example}
+ \begin{wordle}[natural case]{youth} % the default
+ North
+ South
+ youth
+ \end{wordle}
+ \end{example}
+
+ %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+ \Section{Adding \ctan{TikZ} code}
+
+ The \keyword{wordle} environment is a fancy wrapper around a
+ \keyword{tikzpicture} environment, with some code under the hood that
+ automatically colours the letter tiles according to how well they
+ match the solution. The options in this section describe how to access
+ the underlying \ctan{TikZ} layer.
+
+ \option[]{tikz}[TikZ commands]
+
+ The \option{tikz} option passes \ctan{TikZ} keys to the underlying
+ \keyword{tikzpicture} environment. The \option{tikz} option is almost
+ the same as using a \keyword{\tikzset{...}} command before the
+ \keyword{wordle} environment except that it is applied to the
+ \keyword{tikpicture} environment, which contains the \keyword{wordle}
+ puzzle, such that the \option{tikz} keys are applied \textit{after}
+ all of options above and \textit{before} \option{tile style} is
+ applied.
+
+ \begin{example}
+ % \usetikzlibrary{backgrounds}
+ \begin{wordle}[
+ tikz={framed,
+ background rectangle/.style={
+ double,ultra thick, draw=SteelBlue
+ }
+ }]{youth}
+ North South youth
+ \end{wordle}
+ \end{example}
+
+ As this example indicates, it is advisable to enclose complicated
+ \ctan{TikZ} settings inside braces.
+
+ \option[W]{name}
+
+ All of the tiles in a \keyword{wordle} puzzle are given node names of
+ the form $\langle$\textsf{name}$\rangle$-$\mathsf{r}$-$\mathsf{c}$,
+ for the tile in row~$\mathsf{r}$ and column~$\mathsf{c}$. By default,
+ the prefix \textsf{name} is \texttt{W}. Within reason, the
+ \option{name} prefix can be changed to anything you like using the
+ \option{name} option.
+
+ One way to use the named nodes for the letter tiles is with
+ \ctan{TikZ} \texttt{overlay} and \texttt{remember picture} keys:
+
+ \begin{example}
+ \begin{wordle}[tikz={remember picture}]{CRAZE}
+ TRACE
+ CREAM
+ CRAZE
+ \end{wordle}
+ \end{example}
+
+ This makes it possible, for example, to draw arrows to tiles in a
+ \keyword{wordle} puzzle:
+
+ \begin{example}
+ \tikz[remember picture]\draw[overlay, very thick, opacity=0.5,->,red](0,0)node{No M!} to [out=90, in=180](W-2-5);
+ \end{example}
+
+ A second use of the tile node names is in conjunction with \ctan{TikZ}
+ commands that can be added to a \keyword{wordle} puzzle using the
+ second optional argument to the environment. As with the \option{tikz}
+ option, it is advisable to enclose complicated \ctan{TikZ} commands
+ inside braces.
+
+ \begin{example}
+ \begin{wordle}[name=M,
+ tikz={arr/.style={Red,ultra thick,->}}
+ ]{MACAW}
+ [{
+ \draw[arr](M-1-3.south)--(M-3-2.north)--(M-4-2.north);
+ \draw[arr](M-1-1.south)--(M-3-5)--(M-4-3.north east);
+ }]
+ CRANE HOTLY BASIC MACAW
+ \end{wordle}
+ \end{example}
+
+ In practice, we are not convinced that anyone will find a real use for this!
+
+ %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+ \Section{The package code}
+
+ The \keyword{wordle} package is a \LaTeX3 package. There are many
+ comments in the code explaining how the code works. The automatic
+ colouring of the letter tiles is a fun exercise in \LaTeX3
+ programming, which was motivated by a
+ \href{https://tex.stackexchange.com/questions/659860/wordle-like-colored-letter-boxes-in-latex/660056#660056}{tex.stackexchange.com} post.
+
+ Bug reports and feature requests can be made on \href{https://github.com/AndrewMathas/Wordle}{github}.
+
+ %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+ \printindex
+
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/wordle/wordle-doc-fr.pdf b/Master/texmf-dist/doc/latex/wordle/wordle-doc-fr.pdf
index 3277ca9a99c..09d306b0f30 100644
--- a/Master/texmf-dist/doc/latex/wordle/wordle-doc-fr.pdf
+++ b/Master/texmf-dist/doc/latex/wordle/wordle-doc-fr.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/wordle/wordle-doc-fr.tex b/Master/texmf-dist/doc/latex/wordle/wordle-doc-fr.tex
index f365cbb4598..039bc7a1583 100644
--- a/Master/texmf-dist/doc/latex/wordle/wordle-doc-fr.tex
+++ b/Master/texmf-dist/doc/latex/wordle/wordle-doc-fr.tex
@@ -1,422 +1,767 @@
-% !TeX TXS-program:compile = txs:///arara
-% arara: pdflatex: {shell: yes, synctex: no, interaction: batchmode}
-% arara: pdflatex: {shell: yes, synctex: no, interaction: batchmode} if found('log', '(undefined references|Please rerun|Rerun to get)')
-
-\documentclass[french,a4paper,11pt]{article}
-\usepackage[margin=2cm,includefoot]{geometry}
-\def\TPversion{0.1.1}
-\def\TPdate{3 septembre 2023}
-\usepackage{amssymb,amsfonts,amsmath}
+% !TeX TS-program = pdflatex
+
+\documentclass[svgnames]{report}
\usepackage[utf8]{inputenc}
-%\usepackage[T1]{fontenc}
\usepackage{wordle}
-\usepackage{awesomebox}
-\usepackage{fontawesome5}
-\usepackage{footnote}
-\makesavenoteenv{tabular}
+\usepackage{manfnt}
\usepackage{enumitem}
-\usepackage{tabularray}
-\usepackage{fancyvrb}
-\usepackage{fancyhdr}
-\fancyhf{}
-\renewcommand{\headrulewidth}{0pt}
-\lfoot{\sffamily\small [wordle]}
-\cfoot{\sffamily\small - \thepage{} -}
-\rfoot{\hyperlink{matoc}{\small\faArrowAltCircleUp[regular]}}
-
-%\usepackage{hvlogos}
-\usepackage{hologo}
-\providecommand\tikzlogo{Ti\textit{k}Z}
-\providecommand\TeXLive{\TeX{}Live\xspace}
-\providecommand\PSTricks{\textsf{PSTricks}\xspace}
-\let\pstricks\PSTricks
-\let\TikZ\tikzlogo
-\newcommand\TableauDocumentation{%
- \begin{tblr}{width=\linewidth,colspec={X[c]X[c]X[c]X[c]X[c]X[c]},cells={font=\sffamily}}
- {\LARGE \LaTeX} & & & & &\\
- & {\LARGE \hologo{pdfLaTeX}} & & & & \\
- & & {\LARGE \hologo{LuaLaTeX}} & & & \\
- & & & {\LARGE \TikZ} & & \\
- & & & & {\LARGE \TeXLive} & \\
- & & & & & {\LARGE \hologo{MiKTeX}} \\
- \end{tblr}
+\setlist[description]{font=\sffamily\bfseries\color{ForestGreen},labelwidth=\textwidth}
+\usepackage{booktabs}
+\usepackage[a4paper,margin=18mm]{geometry}
+\synctex=1
+\parindent=0pt
+\parskip=2mm
+
+\usepackage{cmap} % fix search and cut-and-paste in Acrobat
+\setcounter{secnumdepth}{0}
+
+\usepackage{listings}\lstset{language=[LaTeX]TeX,framerule=2pt}
+\lstset{language=[LaTeX]TeX,
+ texcsstyle=*\bfseries\color{Peru},
+ backgroundcolor=\color{Ivory},
+ numbers=none,
+ breaklines=true,
+ keywordstyle=\color{Sienna},
+ commentstyle=\color{BurlyWood},
+ tabsize=2,
+ morekeywords={Wordle,wordle,GrilleSutom},
+ resetmargins=true,
}
-
-\usepackage{hyperref}
-\urlstyle{same}
-\hypersetup{pdfborder=0 0 0}
-\setlength{\parindent}{0pt}
-\definecolor{LightGray}{gray}{0.9}
-
-\usepackage{babel}
-\AddThinSpaceBeforeFootnotes
-\FrenchFootnotes
-
-\usepackage{listings}
-
-\usepackage{newverbs}
-\newverbcommand{\motcletex}{\color{cyan!75!black}}{}
-\newverbcommand{\packagetex}{\color{violet!75!black}}{}
-
-\usepackage[most]{tcolorbox}
-\tcbuselibrary{listingsutf8}
-\newtcblisting{DemoCode}[1][]{%
- enhanced,width=0.95\linewidth,center,%
- bicolor,size=title,%
- colback=cyan!2!white,%
- colbacklower=cyan!1!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={},%
- alsoletter={-},%
- keywordstyle={\color{blue}},%
- classoffset=1,%
- alsoletter={-},%
- morekeywords={center,justify},%
- keywordstyle={\color{violet}},%
- classoffset=2,%
- alsoletter={-},%
- morekeywords={GrilleSutom},%
- keywordstyle={\color{green!50!black}},%
- classoffset=3,%
- morekeywords={Couleurs,Arrondi,Unite,Police,CouleurLettres,Lettres,Style,Epaisseur,CouleurBordure},%
- keywordstyle={\color{orange}}
- },%
- #1
+% hyperref links to ctan
+\newcommand\ctan[1]{\href{https://www.ctan.org/pkg/#1}{\texttt{#1}}}
+
+\newcommand\Section[1]{\subsection{\textcolor{DarkGreen}{#1}}}
+
+\ExplSyntaxOn
+\NewDocumentCommand\option{ omo }{%
+ \IfNoValueTF{#1}{\textsf{#2}}
+ {%
+ \textbf{\textcolor{Crimson}{#2}}
+ \str_if_empty:nF {#1}{~(défaut~:~\textcolor{DarkRed}{#1})}%
+ \IfNoValueF{#3}{\hfill\textcolor{Gray}{[accepte~:~#3]}}%
+ }%
+ \index{#2}%
+}
+\ExplSyntaxOff
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\usepackage{imakeidx}
+\indexsetup{level=\section*, toclevel=section, noclearpage}
+\makeindex[intoc,columns=3]
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\usepackage[skins,listings]{tcolorbox}
+\usetikzlibrary{backgrounds, shapes.geometric} % for tikz={framed,...}
+
+\DeclareTotalTCBox\keyword{ O{} v }{
+ fontupper=\sffamily,
+ nobeforeafter,
+ skin=tile,
+ verbatim,
+ on line,
+ tcbox raise base,
+ top=0pt,bottom=0pt,left=0mm,right=0mm,
+ colback=OldLace,
+ colupper=ForestGreen,
+ #1}
+{#2}
+
+\lstdefinestyle{tikz}{style=tcblatex,
+ classoffset=0,
+ texcsstyle=*\color{DarkGoldenrod},%
+ deletetexcs={begin, end},
+ moretexcs={,%
+ node,
+ draw,
+ true,
+ false
+ },%
+ classoffset=1,
+ keywordstyle=\color{ForestGreen},%
+ morekeywords={wordle,GrilleSutom},
+ classoffset=2,
+ keywordstyle=\color{Crimson},%
+ morekeywords={
+ absent,
+ Strict,
+ Taille,
+ Lignes,
+ Epaisseur,
+ align,
+ border,
+ borders,
+ Bords,
+ Cadres,
+ Style,
+ Formes,
+ Separation,
+ case,
+ Police,
+ Arrondi,
+ Echelle,
+ NonLettres,
+ color,
+ Couleurs,
+ CouleurBordures,
+ CouleurLettres,
+ bordure,
+ couleur,
+ colours,
+ correct,
+ vide,
+ font,
+ frame,
+ frames,
+ letters,
+ lower,
+ params,
+ name,
+ natural,
+ noalign,
+ noletters,
+ present,
+ rounded,
+ rows,
+ scale,
+ sensitive,
+ separation,
+ shape,
+ shapes,
+ size,
+ strict,
+ style,
+ style,
+ text,
+ thickness,
+ tikz,
+ tile,
+ upper,
+ },
+ classoffset=3,
+ keywordstyle=\color{DarkOrange},%
+ morekeywords={
+ hard,
+ standard,
+ sutom,
+ }
}
-\tcbset{vignettes/.style={%
- nobeforeafter,box align=base,boxsep=0pt,enhanced,sharp corners=all,rounded corners=southeast,%
- boxrule=0.75pt,left=7pt,right=1pt,top=0pt,bottom=0.25pt,%
- }
+\DeclareTCBListing{example}{ !O{} }{%
+ skin=bicolor,
+ colframe=MediumSeaGreen,
+ colbacklower=OldLace,
+ colback=LawnGreen!20,
+ lefthand width=50mm,
+ listing style=tikz,
+ sidebyside,
+ sidebyside align=center,
+ sidebyside gap=4mm,
+ text and listing,
+ text outside listing,
+ boxsep = 0pt,
+ #1
}
-\tcbset{vignetteMaJ/.style={%
- fontupper={\vphantom{pf}\footnotesize\ttfamily},
- vignettes,colframe=purple!50!black,coltitle=white,colback=purple!10,%
- overlay={\begin{tcbclipinterior}%
- \fill[fill=purple!75]($(interior.south west)$) rectangle node[rotate=90]{\tiny \sffamily{\textcolor{black}{\scalebox{0.66}[0.66]{\textbf{MĂ J}}}}} ($(interior.north west)+(5pt,0pt)$);%
- \end{tcbclipinterior}}
- }
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+
+\makeatletter
+\author{Andrew Mathas \&\ CĂ©dric Pierquet}
+\usepackage{tikz}
+\usetikzlibrary{shadows.blur}
+\tikzset{shadowed/.style={blur shadow={shadow blur steps=5},
+ bottom color=ForestGreen!30,
+ draw=MediumSeaGreen!70,
+ shade,
+ font=\normalfont\Huge\bfseries\scshape,
+ rounded corners=8pt,
+ top color=SeaGreen,
+ },
+ boxes/.style={draw=SeaGreen,
+ fill=Cornsilk,
+ font=\sffamily\small,
+ inner sep=5pt,
+ rectangle,
+ rounded corners=8pt,
+ text=DarkGreen,
+ }
+}
+\newcommand\Wordle{%
+ \begin{tikzpicture}[remember picture,overlay]
+ \node[yshift=-3cm] at (current page.north west)
+ {\begin{tikzpicture}[remember picture, overlay]
+ \draw[shadowed](30mm,0) rectangle node[white]{wordle} (\paperwidth-30mm,16mm);
+ \node[anchor=west,boxes] at (4cm,0cm) {\@author};
+ \node[anchor=east,boxes] at (\paperwidth-4cm,0) {Version \wordle@version};
+ \end{tikzpicture}
+ };
+ \end{tikzpicture}
+ \vspace*{20mm}
}
-\newcommand\Cle[1]{{\small\sffamily\textlangle \textcolor{orange}{#1}\textrangle}}
-\newcommand\cmaj[1]{\tcbox[vignetteMaJ]{#1}\xspace}
+\def\@oddfoot{\textsc{Wordle} --- \wordle@version~(version~du~\wordle@release)\hfill\thepage}
+
+\usepackage[colorlinks=true,linkcolor=blue,urlcolor=MediumBlue]{hyperref}
+\hypersetup{
+ pdfcreator={ Generated by pdfLaTeX },
+ pdfinfo={
+ Author ={ Andrew Mathas et CĂ©dric Pierquet },
+ Keywords={ wordle },
+ License ={ LaTeX Project Public License v1.3c or later },
+ Subject ={ LaTeXing Wordle puzzles },
+ Title ={ Wordle - \wordle@version }
+ },
+}
+\makeatother
\begin{document}
-\setlength{\aweboxleftmargin}{0.07\linewidth}
-\setlength{\aweboxcontentwidth}{0.93\linewidth}
-\setlength{\aweboxvskip}{8pt}
-
-\pagestyle{fancy}
-
-\thispagestyle{empty}
-
-\vspace{2cm}
-
-\begin{center}
- \begin{minipage}{0.75\linewidth}
- \begin{tcolorbox}[colframe=yellow,colback=yellow!15]
- \begin{center}
- \begin{tabular}{c}
- {\Huge \texttt{wordle} [fr]}\\
- \\
- {\LARGE Des grilles de Wordle (Sutom),} \\
- \\
- {\LARGE avec \textsf{Ti\textit{k}Z}.} \\
- \end{tabular}
-
- \bigskip
-
- {\small \texttt{Version \TPversion{} -- \TPdate}}
- \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://github.com/cpierquet/wordle}}
-\end{tabular}
-\end{center}
-
-\vspace{0.25cm}
-
-{$\blacktriangleright$~~Créer des grilles de Wordle/Sutom\footnotemark\footnotetext{\url{https://fr.wikipedia.org/wiki/Wordle}}.}
-
-\vspace{0.25cm}
-
-{$\blacktriangleright$~~Gestion des couleurs, de la taille\footnotemark\footnotetext{Idées venant de \url{ttps://tex.stackexchange.com/questions/659860/wordle-like-colored-letter-boxes-in-latex}}.
-
-\vspace{1cm}
-
-\begin{center}
-\begin{GrilleSutom}{LUCIOLE}
- LAPINES
- LUMIERE
- LOURDES
- LUCIOLE
-\end{GrilleSutom}
-\end{center}
-
-\medskip
-
-\begin{center}
-\begin{GrilleSutom}[Arrondi=0,Couleurs={lightgray,orange,teal},Style=alt,Unite=0.5,Lettres=false]{REBUS}
- ABRIS
- ROUTE
- RUDES
- REBUS
-\end{GrilleSutom}
-%
-\hspace{5mm}
-%
-\begin{GrilleSutom}[Arrondi=0,Couleurs={lightgray,orange,teal},Style=alt,Unite=0.5]{REBUS}
- ABRIS
- ROUTE
- RUDES
- REBUS
-\end{GrilleSutom}
-\end{center}
-
-\vspace{0.5cm}
-
-%\hfill{}\textit{Merci à Denis Bitouzé et à Gilles Le Bourhis pour leurs retours et idées !}
-
-\smallskip
-
-\vfill
-
-\hrule
-
-\medskip
+ \Wordle
+
+ Ce package fournit un moyen \textit{stupidement} riche en fonctionnalités de créer des puzzles \keyword{Wordle} en \LaTeX, que \href{https://en.wikipedia.org/wiki/Wordle}{Wikipedia} décrit comme
+ comme un jeu de lettres en ligne extrĂȘmement populaire, crĂ©Ă© et dĂ©veloppĂ© par l'ingĂ©nieur logiciel gallois Josh Wardle. Ce paquet
+ est une version améliorée d'une des solutions à une question posée par \textcolor{FireBrick}{valerio\_new} sur \href{https://tex.stackexchange.com/questions/659860/wordle-like-colored-letter-boxes-in-latex/660056#660056}{tex.stackexchange.com}.
+
+ Ce paquet fournit l'environnement \keyword{GrilleSutom}, qui utilise la syntaxe :
+
+ \begin{tcblisting}{
+ listing only,
+ skin=bicolor,
+ colframe=MediumSeaGreen,
+ colbacklower=OldLace,
+ colback=LawnGreen!20,
+ listing style=tikz,
+ boxsep = 0pt,
+ }
+ % \usepackage{wordle}
+ \begin{GrilleSutom}[params sutom]{solution}[commandes tikz optionnelles]
+ essai1 essai2 ...
+ \end{GrilleSutom}
+ \end{tcblisting}
+ \index{environnement!GrilleSutom}
+ \index{GrilleSutom}
+ \index{sutom}
+
+ et l'environnement \keyword{wordle}, pour la version anglaise du jeu :
+
+ \begin{tcblisting}{
+ listing only,
+ skin=bicolor,
+ colframe=MediumSeaGreen,
+ colbacklower=OldLace,
+ colback=LawnGreen!20,
+ listing style=tikz,
+ boxsep = 0pt,
+ }
+ % \usepackage{wordle}
+ \begin{wordle}[params wordle]{solution}[commandes tikz optionnelles]
+ essai1 essai2 ...
+ \end{wordle}
+ \end{tcblisting}
+ \index{environnement!wordle}
+ \index{wordle}
+
+ Les mots du puzzle peuvent ĂȘtre saisis sur une seule ligne ou sur des lignes sĂ©parĂ©es. Voici quelques exemples :
+
+ \begin{example}
+ %Version fr du wordle (sutom)
+ \begin{GrilleSutom}{REBUS}
+ ABRIS
+ ROUTE
+ REBUS
+ \end{GrilleSutom}
+ \end{example}
+
+ \begin{example}
+ % Version en du sutom (wordle)
+ \begin{wordle}{SUTOM}
+ SAUCE
+ SAUTS
+ SUTOM
+ \end{wordle}
+ \end{example}
+
+ Comme pour les puzzles en ligne, l'environnement \keyword{GrilleSutom}
+ colore automatiquement les lettres en
+ \keyword[colback=WordleSutomCorrect,colupper=White]{rouge}
+ lorsque la lettre se trouve dans la mĂȘme position que la solution, et en
+ \keyword[colback=WordlePresent,colupper=White]{or} lorsque la lettre est dans la solution mais qu'elle n'est pas bien placée.
+ De mĂȘme, \keyword{GrilleSutom} colore les lettres correctes en
+ \keyword[colback=WordleCorrect,colupper=White]{vert}
+ et les lettres actuelles en
+ \keyword[colback=WordleCorrect,colupper=White]{or}.
+ Comme dĂ©crites ci-dessous, ces couleurs peuvent ĂȘtre modifiĂ©es en fonction de vos goĂ»ts.
+
+ Le nombre de lettres du puzzle est déterminé par la solution, et n'est limité que par la largeur de la page.
+
+ \begin{example}
+ \begin{GrilleSutom}[Lignes=4]{orange}
+ normal
+ ordres
+ orange
+ \end{GrilleSutom}
+ \end{example}
+
+ Les lettres du puzzle peuvent ĂȘtre saisies en majuscules, en minuscules ou en mĂ©lange de majuscules et de minuscules. Par dĂ©faut, la casse des lettres est ignorĂ©e lors de la dĂ©termination des couleurs des cases de lettres.
+
+ Comme dĂ©crit ci-dessous, les environnements \keyword{wordle} et \keyword{GrilleSutom} acceptent une liste d'options diffĂ©rentes qui modifient les couleurs, les polices et les formes de la tuile. De plus, vous pouvez modifier la sensibilitĂ© Ă  la casse des environnements, ajouter des lignes supplĂ©mentaires au puzzle, dĂ©sactiver la mise en forme spĂ©ciale des \textit{cases de lettres}. Ces options sont donnĂ©es sous la forme d'une liste sĂ©parĂ©e par des virgules de paires \texttt{clĂ©-valeur}. Elles peuvent ĂȘtre dĂ©finies localement, en utilisant l'argument optionnel de l'environnement \keyword|wordle|, ou globalement (plus prĂ©cisĂ©ment, dans le groupe \LaTeX\ actuel) en utilisant la commande \keyword{\ParamsSutom} \index{\textbackslash ParamsSutom}, ou comme options globales du package, via \keyword{\usepackage[options]{wordle}}. L'ordre des options n'a pas d'importance, sauf que les options ultĂ©rieures ont prioritĂ© sur les options prĂ©cĂ©dentes, Ă  l'exception des clĂ©s \option{tikz} et \option{tile style} qui sont toujours appliquĂ©es en dernier.
+
+ Les puzzles \keyword{wordle} sont dessinĂ©s Ă  l'aide de \ctan{TikZ}, chaque lettre du puzzle Ă©tant placĂ©e Ă  l'intĂ©rieur d'un nƓud \ctan{TikZ}. De nombreuses options contrĂŽlent les paramĂštres de ces nƓuds. Les descriptions des options ci-dessous sont regroupĂ©es en fonction de leur fonction.
+
+ %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+ \Section{Styles Wordle}
+
+ La clĂ© \option{Style} peut ĂȘtre utilisĂ©e pour modifier de nombreuses caractĂ©ristiques des cases dans un puzzle \keyword{wordle}, y compris leurs couleurs, les polices et ainsi de suite. Les paramĂštres les plus courants peuvent ĂȘtre dĂ©finis Ă  l'aide du mot-clĂ© \option{style}. \textit{Le style doit toujours ĂȘtre dĂ©fini en premier car, sinon, les paramĂštres de style peuvent remplacer les paramĂštres prĂ©cĂ©dents.}
+
+ Les styles suivants sont pris en charge :
+
+ \textcolor{DarkOrange}{sutom}
+ \index{Style!sutom}
+ \index{sutom}
+
+ \begin{example}
+ \begin{GrilleSutom}[Style=sutom]{REBUS}
+ ABRIS
+ ROUTE
+ REBUS
+ \end{GrilleSutom}
+ \end{example}
+
+ En plus de définir les couleurs des cases, les cadres et les formes, le style \textsf{sutom} définit également la taille des cases à 8 mm. Le style \textsf{sutom} est le style par défaut pour l'environnement \keyword{GrilleSutom}.
+
+ \textcolor{DarkOrange}{standard}
+ \index{style!standard}
+
+ \begin{example}
+ \begin{GrilleSutom}[Style=standard]{REBUS}
+ ABRIS
+ ROUTE
+ REBUS
+ \end{GrilleSutom}
+ \end{example}
+
+ Le style \textcolor{DarkOrange}{standard} est le style par défaut pour l'environnement \keyword{wordle}.
+
+ \textcolor{DarkOrange}{hard}
+ \index{style!hard}
+
+ \begin{example}
+ \begin{GrilleSutom}[Style=hard]{REBUS}
+ ABRIS
+ ROUTE
+ REBUS
+ \end{GrilleSutom}
+ \end{example}
+
+ %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+ \Section{Options pour les styles individuels des cases de lettres}
+
+ Il existe quatre types de cases de lettres dans \keyword{wordle} :
+ \option{absent}, \option{present}, \option{correct} et
+ \option{vide}, correspondant respectivement aux lettres qui ne sont pas dans la solution,
+ aux lettres mal placĂ©es, aux lettres correctement placĂ©es et aux cases vides. Les options de cette section peuvent ĂȘtre utilisĂ©es pour
+ définir les couleurs du texte, des cases et des bordures, les formes et les cadres de ces cases.
+
+ Les cases de lettres dans un environnement \keyword{wordle} sont composées à l'intérieur
+ d'un \keyword{\node} \ctan{TikZ}. Les options ci-dessous contrĂŽlent les
+ diffĂ©rents paramĂštres de style de ces nƓuds.
+
+ \option[--]{Couleurs}[liste de couleurs valides séparées par des virgules]
+
+ L'option \option{Couleurs} est un raccourci pour spécifier les
+ couleurs des cases \option{absent}, \option{present}, \option{correct} et
+ \option{vide}, dans cet ordre. Les couleurs suivantes peuvent ĂȘtre omises, mais
+ les couleurs doivent ĂȘtre donnĂ©es dans cet ordre, de gauche Ă  droite.
+ Si une seule couleur est donnée, cette couleur est appliquée à toutes les cases.
+
+ \begin{example}
+ \begin{GrilleSutom}[Couleurs={LightGray,Orange,Teal}]{cellar}
+ pounds
+ taylor
+ cellar
+ \end{GrilleSutom}
+ \end{example}
+
+ Les couleurs peuvent Ă©galement ĂȘtre dĂ©finies individuellement Ă  l'aide de \option{couleur absent}, \option{couleur present}, \option{couleur correct} et \option{couleur vide}.
+
+ \begin{example}
+ \begin{GrilleSutom}[couleur absent=DarkGray,couleur present=Salmon,
+ couleur correct=SeaGreen]{cellar}
+ pounds
+ taylor
+ cellar
+ \end{GrilleSutom}
+ \end{example}
+
+ \option[white]{CouleurBordures}[liste de couleurs valides séparées par des virgules]
+
+ de maniÚre similaire à l'option \option{Couleurs}, il s'agit d'un raccourci pour le paramétrage des couleurs des bordures des cases \option{absent}, \option{present},
+ \option{correct} et \option{vide}, dans cet ordre.
+
+ Si une seule couleur est donnée, elle est appliquée à toutes les cases.
-\TableauDocumentation
+ \begin{example}
+ \begin{GrilleSutom}[CouleurBordures={red,orange,blue}]{REBUS}
+ ABRIS
+ ROUTE
+ REBUS
+ \end{GrilleSutom}
+ \end{example}
+
+ Les bordures pour les cases individuelles peuvent ĂȘtre paramĂ©trer via
+ \option{bordure absent}, \option{bordure present}, \option{bordure correct} et \option{bordure vide}.
+
+ \option[false]{Cadres}[liste de booléens true/false séparées par des virgules]
+
+ Il s'agit d'un raccourci pour ajouter un cadre autour des cases \option{absent}, \option{present}, \option{correct} et \option{vide}, dans cet ordre, avec la mĂȘme couleur que \option{absent}. C'est utile uniquement pour les cases non carrĂ©e.
+
+ \begin{example}
+ \begin{GrilleSutom}[Cadres={false,true,true},Formes=circle]{REBUS}
+ ABRIS
+ ROUTE
+ REBUS
+ \end{GrilleSutom}
+ \end{example}
+
+ Les cadres pour les cases individuelles peuvent ĂȘtre paramĂ©trer via \option{cadre absent}, \option{cadre present},
+ \option{cadre correct} and \option{cadre vide}.
+
+ \option[rectangle]{Formes}[liste de formes TikZ séparées par des virgules]
+
+ De mĂȘme que pour l'option \option{Couleurs}, c'est un raccourci pour paramĂ©trer les formes des cases \option{absent}, \option{present},
+ \option{correct} et \option{vide}, dans cet ordre.
+
+ \begin{example}
+ \begin{GrilleSutom}[Formes={circle, rectangle, circle}]{REBUS}
+ ABRIS
+ ROUTE
+ REBUS
+ \end{GrilleSutom}
+ \end{example}
+
+ Les formes individuelles peuvent ĂȘtre paramĂ©trer via \option{forme absent}, \option{forme present},
+ \option{forme correct} et \option{forme vide}.
+
+ Les formes proposés par le package \ctan{TikZ}
+ \texttt{shapes.geometric}, incluant \texttt{diamond},
+ \texttt{ellipse}, \texttt{trapezium} et \texttt{star} (voir section~71.2 du manuel \ctan{TikZ}).
+
+ \begin{example}
+ % \usepackage{shapes.geometric}
+ \begin{GrilleSutom}[Formes={diamond,ellipse,star}]{LADLE}
+ FLAIL
+ LAPEL
+ *
+ LADLE
+ LOVER
+ \end{GrilleSutom}
+ \end{example}
+
+ \option[white]{CouleurLettres}[liste de couleurs valides séparées par des virgules]
+
+ Il s'agir d'un raccourci pour paramétrer la couleur des lettres des cases \option{absent}, \option{present}, \option{correct} et \option{vide}, dans cet ordre.
+
+ \begin{example}
+ \begin{GrilleSutom}[CouleurLettres={red,orange,blue}]{REBUS}
+ ABRIS
+ ROUTE
+ REBUS
+ \end{GrilleSutom}
+ \end{example}
+
+ Les cases individuelles peuvent ĂȘtre paramĂ©trer via \option{coultxt absent}, \option{coultxt present}, \option{coultxt correct} et \option{coultxt vide}.
+
+
+ \Section{Caractéristiques communes des cases}
+
+ Les options suivantes s'appliquent Ă  toutes les cases.
+
+ \option[]{nonalign} (default) \qquad
+ \option[]{align}
-\medskip
+ Cette option s'occupe de l'alignement vertical des lettres. C'est utile essentiellement lors de l'utilisation de minuscules.
-\hrule
+ \begin{example}
+ \begin{GrilleSutom}[align]{agony}
+ groan
+ angry
+ agony
+ \end{GrilleSutom}
+ \end{example}
-\vspace*{1cm}
-
-\newpage
-
-\phantomsection
-\hypertarget{matoc}{}
-
-\tableofcontents
-
-\vfill
-
-\section{Historique}
-
-\verb|v0.1.0|~:~~~~Correction d'un bug avec la version anglaise.
-
-\verb|v0.1.0|~:~~~~Version initiale.
-
-\newpage
-
-\section{Le package wordle}
-
-\subsection{Le principe du jeu}
-
-\begin{noteblock}
-Wordle est un jeu de lettres en ligne gratuit développé en 2021 par Josh Wardle. Ce jeu est une adaptation directe du jeu télévisé américain Lingo (Motus en France) qui propose de faire deviner un mot par plusieurs tentatives, en indiquant pour chacune d'entre-elles la position des lettres bien placées et mal placées.
-
-Le but du jeu est de deviner un mot spécifique de cinq lettres en un maximum de six tentatives, en tapant des lettres sur un écran de six lignes de cinq cases chacune. La personne qui joue inscrit sur la premiÚre ligne un mot de cinq lettres de son choix et entre sa proposition. AprÚs chaque proposition, les lettres apparaissent en couleurs : le fond gris représente les lettres qui ne se trouvent pas dans le mot recherché, le fond jaune représente les lettres qui se trouvent ailleurs dans le mot, et le fond vert représente les lettres qui se trouvent à la bonne place dans le mot à trouver.
-
-\smallskip
-
-\hfill{\scriptsize \url{https://fr.wikipedia.org/wiki/Wordle}}
-\end{noteblock}
-
-\subsection{Le package}
-
-\begin{noteblock}
-Le package propose de quoi afficher, dans son document \LaTeX, une grille de Wordle (ou de Sutom) à l'aide de \TikZ{} et d'une \motcletex!minipage!, avec la possibilité :
-
-\begin{itemize}
- \item de spécifier les dimensions, la couleur ;
- \item de choisir le style des lettres mal placées ;
- \item de personnaliser les bordure et les coins ;
- \item d'afficher ou non les lettres.
-\end{itemize}
-
-Contrairement au jeu \og initial \fg, il est possible de travailler avec des mots de longueur différente de 5 !
-\end{noteblock}
-
-\begin{importantblock}
-Une bonne partie du code, en \hologo{LaTeX3}, est issu d'un fil sur \texttt{tex.stackexchange}, et proposé par l'internaute \textsf{3141592653589793238}.
-\end{importantblock}
-
-\subsection{Chargement du package, packages utilisés}
-
-\begin{importantblock}
-Le package se charge, de maniÚre classique, dans le préambule.
-
-Il n'existe pas d'option pour le package, et \packagetex!xcolor! n'est pas chargé.
-\end{importantblock}
-
-\begin{DemoCode}[listing only]
-\documentclass{article}
-\usepackage{wordle}
+ \begin{example}
+ \begin{GrilleSutom}{agony} % nonalign par defaut
+ groan
+ angry
+ agony
+ \end{GrilleSutom}
+ \end{example}
+
+ \option[\textbackslash Large\textbackslash bfseries\textbackslash sffamily]{Police}
+ [Police \LaTeX]
-\end{DemoCode}
-
-\begin{noteblock}
-\packagetex!wordle! charge les packages suivants :
-
-\begin{itemize}
- \item \packagetex!tikz!;
- \item \packagetex!simplekv! ;
- \item \packagetex!xstring!.
-\end{itemize}
-
-Il est compatible avec les compilations usuelles en \textsf{latex}, \textsf{pdflatex}, \textsf{lualatex} ou \textsf{xelatex}.
-\end{noteblock}
-
-\vfill~
-
-\pagebreak
-
-\section{Environnement GrilleSutom}
-
-\subsection{Fonctionnement global}
-
-\begin{cautionblock}
-L'environnement dédié à la création de la grille du Sutom est \packagetex!GrilleSutom!.
-
-Il fonctionne avec un systÚme de clés, entre \texttt{[...]}, et nécessite de préciser :
-
-\begin{itemize}
- \item le bon mot ;
- \item les différentes propositions.
-\end{itemize}
-
-Le code se charge de mettre en forme (grùce à une \motcletex!minipage!) la grille et les différentes couleurs d'aide.
-\end{cautionblock}
-
-\begin{DemoCode}[listing only]
-\begin{GrilleSutom}[clés]{mot à trouver}
- proposition n°1
- proposition n°2
- proposition n°3
-\end{GrilleSutom}
-\end{DemoCode}
-
-\begin{noteblock}
-Comme indiqué dans l'introduction, la grille est créée à l'aide d'un environnement \motcletex!minipage!, avec gestion automatique de la largeur et des espacements.
-\end{noteblock}
-
-\begin{DemoCode}[]
-%sortie par défaut
-\begin{GrilleSutom}{SUTOM}
- SAUCE
- SAUTS
- SUTOM
-\end{GrilleSutom}
-\end{DemoCode}
-
-\subsection{Clés et options}
-
-\begin{tipblock}
-Le premier argument, optionnel et entre \texttt{[...]}, propose les \Cle{clés} suivantes :
-
-\begin{itemize}
- \item \Cle{Couleurs} : = couleur des cases, sous la forme \Cle{fond,mal placée,bien placée} ;
-
- \hfill{}défaut : \Cle{cyan!75!black,yellow,red},%
- \item \Cle{Arrondi} := arrondi des coins, en mm ; \hfill{}défaut : \Cle{0.1}
- \item \Cle{Unite} := largeur des cases, en cm ; \hfill{}défaut : \Cle{1}
- \item \Cle{Police} := police des lettres ; \hfill{}défaut : \Cle{\textbackslash LARGE\textbackslash bfseries\textbackslash sffamily}
- \item \Cle{CouleurLettres} := couleur des lettres ; \hfill{}défaut : \Cle{white}
- \item \Cle{CouleurBordure} := couleur de la bordure des cases ; \hfill{}défaut : \Cle{white}
- \item \Cle{Lettres} := booléen pour afficher les lettre ; \hfill{}défaut : \Cle{true}
- \item \Cle{Style} := style parmi \Cle{rond / autre} pour changer le style ; \hfill{}défaut : \Cle{rond}
- \item \Cle{Epaisseur} := épaisseur des traits, en mm. \hfill{}défaut : \Cle{0.25}
-\end{itemize}
-\vspace*{-\baselineskip}\leavevmode
-\end{tipblock}
-
-\begin{tipblock}
-Le second argument, obligatoire et entre \texttt{\{...\}} correspond au mot correct Ă  trouver.
-
-\smallskip
-
-Les différentes propositions sont à donner (ligne par ligne ou séparées par des espaces) dans le corps de l'environnement.
-\end{tipblock}
-
-\subsection{Exemples}
-
-\begin{DemoCode}[]
-\begin{GrilleSutom}{BOURDON}
- BALEINE
- BOURBON
- BROMURE
- BOURDON
-\end{GrilleSutom}
-%
-\hspace{5mm}
-%
-\begin{GrilleSutom}[Style=alt]{BOURDON}
- BALEINE BOURBON BROMURE BOURDON
-\end{GrilleSutom}
-\end{DemoCode}
-
-\begin{DemoCode}[]
-\begin{GrilleSutom}
- [Style=alt,Epaisseur=0.3,CouleurBordure=black,%
- Couleurs={lightgray,orange,teal}]%
- {BOURDON}
- BALEINE BOURBON BROMURE BOURDON
-\end{GrilleSutom}
-%
-\hspace{5mm}
-%
-\begin{GrilleSutom}
- [Arrondi=0,Epaisseur=0.3,CouleurBordure=black,%
- Couleurs={lightgray,orange,teal}]%
- {BOURDON}
- BALEINE BOURBON BROMURE BOURDON
-\end{GrilleSutom}
-\end{DemoCode}
-
-\begin{DemoCode}[]
-\begin{GrilleSutom}[Unite=2,Police=\Huge\ttfamily,CouleurLettres=black]{BOURDON}
- BALEINE
- BOURBON
- BROMURE
- BOURDON
-\end{GrilleSutom}
-\end{DemoCode}
-
-\begin{DemoCode}[]
-\begin{GrilleSutom}%
- [Unite=0.75,Arrondi=0,Couleurs={cyan,orange,violet},%
- Style=alt,Lettres=false]{REBUS}
- ABRIS
- ROUTE
- RUDES
- REBUS
-\end{GrilleSutom}
-\hspace{5mm}
-\begin{GrilleSutom}%
- [Unite=0.75,Arrondi=0,Couleurs={cyan,orange,violet},Style=alt]{REBUS}
- ABRIS
- ROUTE
- RUDES
- REBUS
-\end{GrilleSutom}
-\end{DemoCode}
-
-\end{document} \ No newline at end of file
+ Cela permet de paramétrer la police de toutes les lettres. Toute commande valide est acceptée.
+
+ \begin{example}
+ \begin{GrilleSutom}[Police=\large\ttfamily]{REBUS}
+ ABRIS
+ ROUTE
+ REBUS
+ \end{GrilleSutom}
+ \end{example}
+
+ \option[1mm]{Arrondi}[une longueur]
+
+ Cela permet de paramétrer le paramÚtres \texttt{rounded corners} (de TikZ) pour les cases \keyword{wordle}.
+
+ \begin{example}
+ \begin{GrilleSutom}[Arrondi=2.5mm]{REBUS}
+ ABRIS
+ ROUTE
+ REBUS
+ \end{GrilleSutom}
+ \end{example}
+
+ \option[0.5mm]{Separation}[une longueur]
+
+ Cela permet de paramétrer la séparation entre les cases du \keyword{wordle}.
+
+ \begin{example}
+ \begin{GrilleSutom}[Separation=2mm,CouleurBordures=black]{REBUS}
+ ABRIS
+ ROUTE
+ REBUS
+ \end{GrilleSutom}
+ \end{example}
+
+ \option[1]{Echelle}[un nombre]
+
+ L'option \option{Echelle} applique un facteur Ă  l'environnement \keyword{wordle}.
+ Cette option modifie les dimensions définies par les options \option{Arrondi},
+ \option{Separation}, \option{Taille} et \option{Epaisseur}. Si vous changez l'Ă©chelle, vous voudrez Ă©galement changer la police de caractĂšres via \option{Police} :
+
+ \begin{example}
+ \begin{GrilleSutom}[Echelle=1.5,Police=\huge\bfseries]{SIZE}
+ HELP
+ WISE
+ SIZE
+ \end{GrilleSutom}
+ \end{example}
+
+ \option[8mm]{Taille}[une longueur]
+
+ L'option \option{Taille} définit la taille des cases. Contrairement à l'option \option{Echelle}, \option{Taille} change uniquement la dimension des cases.
+
+ \begin{example}
+ \begin{GrilleSutom}[Taille=10mm,Police=\huge\bfseries]{REPU}
+ ABRI ROUE * REPU
+ \end{GrilleSutom}
+ \end{example}
+
+ \option[0.25mm]{Epaisseur}[une longueur]‱
+
+ Cela permet de paramétrer la taille des bordures des cases. Par défaut la couleur est blanche, donc pour illustrer cette option elle sera paramétrer en rouge.
+
+ \begin{example}
+ \begin{GrilleSutom}[Epaisseur=0.75mm,CouleurBordures=red]{LADLE}
+ FLAIL
+ LAPEL
+ LADLE
+ \end{GrilleSutom}
+ \end{example}
+
+ %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+ \Section{Lignes et colonnes supplémentaires}
+
+ Par défaut, le nombre de lignes et de colonnes de la grille est fixée par les mots donnés.
+
+ \option[]{Lettres} (défaut)\qquad
+ \option[]{NonLettres}
+
+ Par dafut, les lettres sont affichĂ©es, mais l'option \option{NonLettres} peuvent ĂȘtre cachĂ©es.
+
+ \begin{example}
+ \begin{GrilleSutom}{CRAZE} % the default
+ TRACE
+ CREAM
+ CRAZE
+ \end{GrilleSutom}
+ \end{example}
+
+ \begin{example}
+ \begin{GrilleSutom}[NonLettres]{CRAZE}
+ TRACE
+ CREAM
+ CRAZE
+ \end{GrilleSutom}
+ \end{example}
+
+ \option[false]{Strict}[true/false/--]
+
+ Par dĂ©faut, l'environnement ne vĂ©rifie pas si tous les mots sont la mĂȘme taille, donc les lettres \textit{en trop} n'ont pas de style particulier.
+
+ \begin{example}
+ \begin{GrilleSutom}[Strict=false]{CRAZE} % par defaut
+ GRAIL
+ CRAMPS
+ CRAM
+ CRABS
+ \end{GrilleSutom}
+ \end{example}
+
+ L'option booléenne \option{Strict} force un style particulier des lettre \textit{en trop}.
+
+ \begin{example}
+ \begin{GrilleSutom}[Strict]{CRAZE}
+ GRAIL
+ CRAMPS
+ CRAM
+ CRABS
+ \end{GrilleSutom}
+ \end{example}
+
+ \option[--]{Lignes}
+
+ Par défaut, l'environnement \keyword{wordle} affiche le nombre de lignes en adéquation avec le nombre de mots donnés. L'option \option{Lignes} permet de modifier le nombre de lignes (évenuellement vides).
+
+ \begin{example}
+ \begin{GrilleSutom}[Lignes=4]{ANVIL}
+ CRANE
+ NATAL
+ ANVIL
+ \end{GrilleSutom}
+ \end{example}
+
+ \begin{example}
+ \begin{GrilleSutom}[Lignes=2]{ANVIL}
+ CRANE
+ NATAL
+ ANVIL
+ \end{GrilleSutom}
+ \end{example}
+
+ \option[]{*}
+
+ Le style des case peut ĂȘtre annulĂ© en ajoutant un astĂ©risque,~\option{*}, en tant que mot.
+
+ \begin{example}
+ \begin{GrilleSutom}{ANVIL}
+ CRANE
+ NATAL
+ * % annule la mise en forme
+ ANNUL
+ ANVIL
+ \end{GrilleSutom}
+ \end{example}
+
+
+ %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+ \Section{Sensibilité à la casse}
+ \index{case~sensitive}
+ \index{case~sensitive!lower case}
+ \index{case~sensitive!natural case}
+ \index{case~sensitive!upper case}
+
+ Par dĂ©faut, les lettres peuvent ĂȘtre Ă©crites en majuscule ou en minuscule, comme saisies par l'utilisateur.
+
+ L'option (voir doc en anglais) \option{case~sensitive} permet de spécifier un paramétrage de la casse.
+
+ \begin{example}
+ \begin{GrilleSutom}[case sensitive=false]{youth} % par defaut
+ North
+ South
+ Youth
+ \end{GrilleSutom}
+ \end{example}
+
+ \begin{example}
+ \begin{GrilleSutom}[case sensitive]{youth}
+ North
+ South
+ Youth
+ \end{GrilleSutom}
+ \end{example}
+
+ Les options \textit{fines} \option{natural case} (défaut), \option{lower case}et \option{upper case} permettent de travailler plus finement sur la casse des lettres correctes et/ou mal placées.
+
+ \begin{example}
+ \begin{GrilleSutom}[lower case]{YOUTH}
+ North
+ South
+ Youth
+ \end{GrilleSutom}
+ \end{example}
+
+ \begin{example}
+ \begin{GrilleSutom}[upper case]{youth}
+ North
+ South
+ Youth
+ \end{GrilleSutom}
+ \end{example}
+
+ \begin{example}
+ \begin{GrilleSutom}[natural case]{youth} % par defaut
+ North
+ South
+ youth
+ \end{GrilleSutom}
+ \end{example}
+
+ %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+ \Section{Style \ctan{TikZ} complémentaire}
+
+ \option[]{tikz}[commandes TikZ]
+
+ \begin{example}
+ % \usetikzlibrary{backgrounds}
+ \begin{GrilleSutom}[
+ tikz={framed,
+ background rectangle/.style={
+ double,ultra thick, draw=SteelBlue
+ }
+ }]{youth}
+ North South youth
+ \end{GrilleSutom}
+ \end{example}
+
+ \pagebreak
+
+ \option[W]{Nom}
+
+ \begin{example}
+ \begin{GrilleSutom}[tikz={remember picture}]{CRAZE}
+ TRACE
+ CREAM
+ CRAZE
+ \end{GrilleSutom}
+ \end{example}
+
+ \begin{example}
+ \tikz[remember picture]\draw[overlay, very thick, opacity=0.5,->,red](0,0)node{Pas de M !!!} to [out=90, in=180](W-2-5);
+ \end{example}
+
+ \begin{example}
+ \begin{GrilleSutom}[name=M,
+ tikz={arr/.style={red,ultra thick,->}}
+ ]{MACAW}
+ [{
+ \draw[arr](M-1-3.south)--(M-3-2.north)--(M-4-2.north);
+ \draw[arr](M-1-1.south)--(M-3-5)--(M-4-3.north east);
+ }]
+ CRANE HOTLY BASIC MACAW
+ \end{GrilleSutom}
+ \end{example}
+
+ %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+ \Section{Le code}
+
+ Le package \keyword{wordle} est écrit en \LaTeX3. Beaucoup de commentaires permettent d'expliciter le fonctionnement du code. La coloration automatique des cases est un exercice amusant en \LaTeX3, motivépar un message issu de
+ \href{https://tex.stackexchange.com/questions/659860/wordle-like-colored-letter-boxes-in-latex/660056#660056}{tex.stackexchange.com}.
+
+ Le dépÎt \href{https://github.com/AndrewMathas/Wordle}{github.com/AndrewMathas/Wordle} est disponible pour signaler tout bug.
+
+ %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+ \printindex
+
+\end{document}