| 1 |
\documentclass[a4paper, 11pt, BCOR = 0 pt, DIV = 13, oneside, french]{scrartcl} |
| 2 |
\usepackage{tikz} |
| 3 |
\usepackage{fancyvrb} |
| 4 |
\usetikzlibrary{arrows, shapes} |
| 5 |
\usepackage[light, largesmallcaps]{kpfonts} |
| 6 |
\usepackage{coffeestains} |
| 7 |
\usepackage[useregional]{datetime2} |
| 8 |
\usepackage{gitinfo2} |
| 9 |
\usepackage{scrlayer-scrpage} |
| 10 |
\usepackage{tcolorbox} |
| 11 |
\usepackage[french]{babel} |
| 12 |
\author{Patrick Bideault} |
| 13 |
\usepackage{varioref} |
| 14 |
\usepackage{hyperref} |
| 15 |
\hypersetup{ |
| 16 |
pdftitle = LaTeX Coffee Stains, |
| 17 |
colorlinks, |
| 18 |
linkcolor={brown!60!black}, |
| 19 |
citecolor={brown!60!black}, |
| 20 |
urlcolor={brown!60!black} |
| 21 |
} |
| 22 |
\ifoot{\textsf{\textcolor{lightgray}{version \gitRel{} -- \DTMtoday} |
| 23 |
}} |
| 24 |
\cfoot{} |
| 25 |
\ofoot{\textsf{\thepage}} |
| 26 |
|
| 27 |
\begin{document} |
| 28 |
|
| 29 |
\title{LaTeX Coffee Stains} |
| 30 |
\author{une extension de Hanno Rein\\ |
| 31 |
entretenue par Patrick Bideault\\ |
| 32 |
\texttt{[email protected]}\\ |
| 33 |
~\\ |
| 34 |
\url{https://framagit.org/Pathe/coffeestains}} |
| 35 |
\renewcommand{\today}{version \gitRel{} -- \DTMtoday{}} |
| 36 |
\maketitle |
| 37 |
|
| 38 |
\coffeestainA{0.9}{0.85}{-5}{6.5cm}{2.3cm} |
| 39 |
\label{stainA} |
| 40 |
\section{Introduction} |
| 41 |
Cette extension offre une fonctionnalité qui manquait à \LaTeX{} depuis |
| 42 |
lurette. Elle ajoute des taches de café aux documents. Plutôt que de |
| 43 |
d'ajouter manuellement ces taches, un temps précieux est |
| 44 |
économisé en les composant directement au sein des documents. |
| 45 |
|
| 46 |
Quatre modèles de taches sont proposés : |
| 47 |
|
| 48 |
\begin{itemize} |
| 49 |
\item \verb|\coffeestainA|, une tache ronde formant un arc de $270^\circ$, orné de deux petites |
| 50 |
taches, comme \vpageref[sur la présente page]{stainA} ; |
| 51 |
\item \verb|\coffeestainB|, une tache formant un arc de $60^\circ$ environ, comme en |
| 52 |
\vpageref{stainB} ; |
| 53 |
\item \verb|\coffeestainC|, deux taches de couleur pâle, visibles en \vpageref{stainC} ; |
| 54 |
\item \verb|\coffeestainD|, et une tache double, très colorée, que l'on admirera en \vpageref{stainD}. |
| 55 |
\end{itemize} |
| 56 |
|
| 57 |
\section{Utilisation} |
| 58 |
Pour utiliser cette extension, il suffit d'enregistrer le document |
| 59 |
\texttt{coffeestains.sty} dans le répertoire où vous souhaitez l'utiliser, aux |
| 60 |
côté des fichiers \texttt{.tex} que vous désirez orner de taches de café. |
| 61 |
|
| 62 |
Bien évidemment, il est possible de l'installer avec votre distribution \TeX{} ; |
| 63 |
pour ce faire, consultez son manuel d'utilisation. |
| 64 |
|
| 65 |
Une fois l'extension prête à l'emploi, ajoutez la ligne suivante dans le |
| 66 |
préambule de votre document : |
| 67 |
\begin{verbatim} |
| 68 |
\usepackage{coffeestains} |
| 69 |
\end{verbatim} |
| 70 |
\vfill{} |
| 71 |
|
| 72 |
\begin{tcolorbox} |
| 73 |
La tache de café ci-dessus a été obtenue grâce à l'instruction suivante : |
| 74 |
|
| 75 |
\verb|\coffeestainA{0.9}{0.85}{-5}{6.5cm}{2.3cm}| |
| 76 |
\end{tcolorbox} |
| 77 |
\newpage{} |
| 78 |
\coffeestainB{0.7}{1}{-30}{18 pt}{-135 pt} |
| 79 |
\label{stainB} |
| 80 |
|
| 81 |
Pour rehausser une page d'une tache de café, veuillez ajouter au code d'une page |
| 82 |
l'une des commandes suivantes : |
| 83 |
\begin{verbatim} |
| 84 |
\coffeestainA{transparence}{échelle}{angle}{abscisse}{ordonnée} |
| 85 |
\coffeestainB{transparence}{échelle}{angle}{abscisse}{ordonnée} |
| 86 |
\coffeestainC{transparence}{échelle}{angle}{abscisse}{ordonnée} |
| 87 |
\coffeestainD{transparence}{échelle}{angle}{abscisse}{ordonnée} |
| 88 |
\end{verbatim} |
| 89 |
|
| 90 |
\begin{itemize} |
| 91 |
\item le coefficient de \texttt{tranparence} est $\in [0,1]$; |
| 92 |
\item l'\texttt{échelle} est le facteur de proportionnalité ; s'il vaut \texttt{1}, |
| 93 |
la tache sera telle que créée par Hanno Rein en 2009 ; |
| 94 |
\item l'\texttt{angle} de la tache est relatif au centre de celle-ci ; il est exprimé en |
| 95 |
degrés $\in [0,360]$ ; |
| 96 |
\item l'\texttt{abscisse} et l'\texttt{ordonnée} sont exprimées en |
| 97 |
fonction du centre de la page, qui a pour coordonnées $(0, 0)$. Préciser une |
| 98 |
unité de mesure semble être une bonne idée, mais nous ne saurions nous montrer |
| 99 |
trop directifs. |
| 100 |
\end{itemize} |
| 101 |
|
| 102 |
\section{Droits d'auteur} |
| 103 |
Comme nous ne croyons guère au droit de propriété en ce qui concerne les |
| 104 |
créations intellectuelles, il vous est loisible de redistribuer cette extension |
| 105 |
comme bon vous semble. Toutes les taches sont faites maison, photographiées par |
| 106 |
Hanno Rein et traitées via les logiciels gimp et Inkscape. Les dons ne seront |
| 107 |
que de café et sont à adresser à : |
| 108 |
\begin{quote} |
| 109 |
Hanno Rein\\ |
| 110 |
University of Toronto at Scarborough\\ |
| 111 |
DPES Physics and Astrophysics\\ |
| 112 |
1265 Military Trail\\ |
| 113 |
Toronto, Ontario M1C 1A4\\ |
| 114 |
Canada |
| 115 |
\end{quote} |
| 116 |
|
| 117 |
\section{Améliorations souhaitables} |
| 118 |
L'utilité de cette extension n'est pas à démontrer. Malheureusement, de |
| 119 |
nombreuses taches sont toujours ajoutées manuellement sur les documents : taches |
| 120 |
de cassoulet, de kimchi, de vin\dots{} à l'avenir, toutes devraient être composées directement. |
| 121 |
|
| 122 |
Par ailleurs, nous ne saurions nous cantonner aux taches que créent les |
| 123 |
liquides : combien de documents graisseux voient leurs taches ajoutées |
| 124 |
manuellement par des garagistes ? La communauté des utilisateurs de \LaTeX{} |
| 125 |
doit s'emparer de ce problème et procurer à ces professionnels les outils qui leur |
| 126 |
sont nécessaires. |
| 127 |
|
| 128 |
\vfill{} |
| 129 |
|
| 130 |
\begin{tcolorbox} |
| 131 |
La tache de café ci-dessus a été obtenue grâce à la commande suivante : |
| 132 |
|
| 133 |
\verb|\coffeestainB{0.7}{1}{-30}{18 pt}{-135 pt}| |
| 134 |
\end{tcolorbox} |
| 135 |
\newpage{} |
| 136 |
\section{Historique des modifications} |
| 137 |
\begin{itemize} |
| 138 |
\item 3 avril 2009 : tâche initiale accomplie par Hanno Rein. Cette version est |
| 139 |
toujours disponible à l'adresse |
| 140 |
\url{http://legacy.hanno-rein.de/hanno-rein.de/archives/349}. Dans le dépôt |
| 141 |
git actuel, cette version a pour référence 0.1. |
| 142 |
\item 23 novembre 2010 : \texttt{coffee2.sty}, une version améliorée fonctionnant |
| 143 |
avec pdflatex. Merci à \href{http://www.sultanik.com/}{Evan Sultanik}! Cette |
| 144 |
version a de nos jours la référence 0.2. |
| 145 |
\item 24 mars 2011 : \texttt{coffee3}, une nouvelle version améliorée utilisant |
| 146 |
pdflatex et permettant la mise à l'échelle et la rotation de chacune des |
| 147 |
taches, sans compter le contrôle de leur transparence. Merci au \href{http://pcmap.unizar.es/~pilar/}{professeur Luis |
| 148 |
Randez}! La référence de cette version est dorénavant 0.3. |
| 149 |
\item 25 mai 2012 : \texttt{coffee4}, une version encore améliorée, due à |
| 150 |
\href{http://nepsweb.co.uk/homeapr/}{Adrian Robson}, qui écrit : « je constate |
| 151 |
parvenir rarement à placer ma tasse de café au centre exact de mes documents. |
| 152 |
C'est pourquoi j'ai amendé coffee3.sty de manière à permettre la composition |
| 153 |
de taches de café autrement que centrées ». Cette |
| 154 |
version porte désormais la référence 0.4. |
| 155 |
\item 1\textsuperscript{er} mai 2021 : le package \texttt{coffeestains} est |
| 156 |
placé sur un dépôt git. La rotation des taches est désormais relative aux |
| 157 |
taches elles-mêmes et non plus au centre de la page. Version 0.5 par Patrick Bideault. |
| 158 |
\end{itemize} |
| 159 |
\coffeestainC{1}{1}{180}{0}{-5 mm} |
| 160 |
\label{stainC} |
| 161 |
|
| 162 |
\section{Apophtegmes et maximes} |
| 163 |
\noindent |
| 164 |
Grand est le café. |
| 165 |
|
| 166 |
\vspace{5mm} |
| 167 |
|
| 168 |
\noindent |
| 169 |
Le café sauvera le monde. |
| 170 |
|
| 171 |
\vfill{} |
| 172 |
|
| 173 |
\begin{tcolorbox} |
| 174 |
La tache de café ornant la présente page a été obtenue grâce à la commande suivante : |
| 175 |
|
| 176 |
\verb|\coffeestainC{1}{1}{180}{0}{-5 mm}| |
| 177 |
\end{tcolorbox} |
| 178 |
|
| 179 |
\begin{tcolorbox} |
| 180 |
La page suivante a été enluminée grâce à l'instruction suivante : |
| 181 |
|
| 182 |
\verb|\coffeestainD{0.4}{0.5}{90}{3 cm}{4 cm}| |
| 183 |
\end{tcolorbox} |
| 184 |
|
| 185 |
\newpage{} |
| 186 |
\pagestyle{empty} |
| 187 |
~\\ |
| 188 |
|
| 189 |
\coffeestainD{0.4}{0.5}{90}{3 cm}{4 cm} |
| 190 |
\label{stainD} |
| 191 |
|
| 192 |
\vfill{} |
| 193 |
\begin{center} |
| 194 |
\textsc{C'est intentionnellement que cette page fut laissée vide} |
| 195 |
|
| 196 |
mais il nous a fallu vous le faire savoir. |
| 197 |
\end{center} |
| 198 |
|
| 199 |
\vfill{} |
| 200 |
\end{document} |