<html><head><meta name="color-scheme" content="light dark"></head><body><pre style="word-wrap: break-word; white-space: pre-wrap;">\documentclass[a4paper, 11pt, BCOR = 0 pt, DIV = 13, oneside, french]{scrartcl}
\usepackage{tikz}
\usepackage{fancyvrb}
\usetikzlibrary{arrows, shapes}
\usepackage[light, largesmallcaps]{kpfonts}
\usepackage{coffeestains}
\usepackage[useregional]{datetime2}
\usepackage{gitinfo2}
\usepackage{scrlayer-scrpage}
\usepackage{tcolorbox}
\usepackage[french]{babel}
\author{Patrick Bideault}
\usepackage{varioref}
\usepackage{hyperref}
\hypersetup{
	  pdftitle = LaTeX Coffee Stains,
          colorlinks,
	  linkcolor={brown!60!black},
          citecolor={brown!60!black},
          urlcolor={brown!60!black}
        }
\ifoot{\textsf{\textcolor{lightgray}{version \gitRel{} -- \DTMtoday}
  }}
\cfoot{}
\ofoot{\textsf{\thepage}}

\begin{document}

\title{LaTeX Coffee Stains}
\author{une extension de Hanno Rein\\
  entretenue par Patrick Bideault\\
  \texttt{pb-latex@gmx.fr}\\
  ~\\
  \url{https://framagit.org/Pathe/coffeestains}}
\renewcommand{\today}{version \gitRel{} -- \DTMtoday{}}
\maketitle

\coffeestainA{0.9}{0.85}{-5}{6.5cm}{2.3cm}
\label{stainA}
\section{Introduction}
Cette extension offre une fonctionnalitÃ© qui manquait Ã&nbsp; \LaTeX{} depuis
lurette. Elle ajoute des taches de cafÃ© aux documents. PlutÃ´t que de
d'ajouter manuellement ces taches, un temps prÃ©cieux est
Ã©conomisÃ© en les composant directement au sein des documents.

Quatre modÃ¨les de taches sont proposÃ©s :

\begin{itemize}
\item \verb|\coffeestainA|, une tache ronde formant un arc de $270^\circ$, ornÃ© de deux petites
  taches, comme \vpageref[sur la prÃ©sente page]{stainA} ;
\item \verb|\coffeestainB|, une tache formant un arc de $60^\circ$ environ, comme en
    \vpageref{stainB} ;
\item \verb|\coffeestainC|, deux taches de couleur pÃ¢le, visibles en \vpageref{stainC} ;
\item \verb|\coffeestainD|, et une tache double, trÃ¨s colorÃ©e, que l'on admirera en \vpageref{stainD}.
\end{itemize}

\section{Utilisation}
Pour utiliser cette extension, il suffit d'enregistrer le document
\texttt{coffeestains.sty} dans le rÃ©pertoire oÃ¹ vous souhaitez l'utiliser, aux
cÃ´tÃ© des fichiers \texttt{.tex} que vous dÃ©sirez orner de taches de cafÃ©.

Bien Ã©videmment, il est possible de l'installer avec votre distribution \TeX{} ;
pour ce faire, consultez son manuel d'utilisation.

Une fois l'extension prÃªte Ã&nbsp; l'emploi, ajoutez la ligne suivante dans le
prÃ©ambule de votre document :
\begin{verbatim}
\usepackage{coffeestains}
\end{verbatim}
\vfill{}

\begin{tcolorbox}
  La tache de cafÃ© ci-dessus a Ã©tÃ© obtenue grÃ¢ce Ã&nbsp; l'instruction suivante :

  \verb|\coffeestainA{0.9}{0.85}{-5}{6.5cm}{2.3cm}|
\end{tcolorbox}
\newpage{}
\coffeestainB{0.7}{1}{-30}{18 pt}{-135 pt}
\label{stainB}

Pour rehausser une page d'une tache de cafÃ©, veuillez ajouter au code d'une page
l'une des commandes suivantes :
\begin{verbatim}
\coffeestainA{transparence}{Ã©chelle}{angle}{abscisse}{ordonnÃ©e}
\coffeestainB{transparence}{Ã©chelle}{angle}{abscisse}{ordonnÃ©e}
\coffeestainC{transparence}{Ã©chelle}{angle}{abscisse}{ordonnÃ©e}
\coffeestainD{transparence}{Ã©chelle}{angle}{abscisse}{ordonnÃ©e}
\end{verbatim}

\begin{itemize}
\item le coefficient de \texttt{tranparence} est $\in [0,1]$;
\item l'\texttt{Ã©chelle} est le facteur de proportionnalitÃ© ; s'il vaut \texttt{1},
  la tache sera telle que crÃ©Ã©e par Hanno Rein en 2009 ;
\item l'\texttt{angle} de la tache est relatif au centre de celle-ci ; il est exprimÃ© en
  degrÃ©s $\in [0,360]$ ;
\item l'\texttt{abscisse} et l'\texttt{ordonnÃ©e} sont exprimÃ©es en
  fonction du centre de la page, qui a pour coordonnÃ©es $(0, 0)$. PrÃ©ciser une
  unitÃ© de mesure semble Ãªtre une bonne idÃ©e, mais nous ne saurions nous montrer
  trop directifs.
\end{itemize}

\section{Droits d'auteur}
Comme nous ne croyons guÃ¨re au droit de propriÃ©tÃ© en ce qui concerne les
crÃ©ations intellectuelles, il vous est loisible de redistribuer cette extension
comme bon vous semble. Toutes les taches sont faites maison, photographiÃ©es par
Hanno Rein et traitÃ©es via les logiciels gimp et Inkscape. Les dons ne seront
que de cafÃ© et sont Ã&nbsp; adresser Ã&nbsp; :
\begin{quote}
Hanno Rein\\
University of Toronto at Scarborough\\
DPES Physics and Astrophysics\\
1265 Military Trail\\
Toronto, Ontario M1C 1A4\\
Canada
\end{quote}

\section{AmÃ©liorations souhaitables}
L'utilitÃ© de cette extension n'est pas Ã&nbsp; dÃ©montrer. Malheureusement, de
nombreuses taches sont toujours ajoutÃ©es manuellement sur les documents : taches
de cassoulet, de kimchi, de vin\dots{} Ã&nbsp; l'avenir, toutes devraient Ãªtre composÃ©es directement.

Par ailleurs, nous ne saurions nous cantonner aux taches que crÃ©ent les
liquides : combien de documents graisseux voient leurs taches ajoutÃ©es
manuellement par des garagistes ? La communautÃ© des utilisateurs de \LaTeX{}
doit s'emparer de ce problÃ¨me et procurer Ã&nbsp; ces professionnels les outils qui leur
sont nÃ©cessaires.

\vfill{}

\begin{tcolorbox}
  La tache de cafÃ© ci-dessus a Ã©tÃ© obtenue grÃ¢ce Ã&nbsp; la commande suivante :

  \verb|\coffeestainB{0.7}{1}{-30}{18 pt}{-135 pt}|
\end{tcolorbox}
\newpage{}
\section{Historique des modifications}
\begin{itemize}
\item 3 avril 2009 : tÃ¢che initiale accomplie par Hanno Rein. Cette version est
  toujours disponible Ã&nbsp; l'adresse
  \url{http://legacy.hanno-rein.de/hanno-rein.de/archives/349}. Dans le dÃ©pÃ´t
  git actuel, cette version a pour rÃ©fÃ©rence 0.1.
\item 23 novembre 2010 : \texttt{coffee2.sty}, une version amÃ©liorÃ©e fonctionnant
  avec pdflatex. Merci Ã&nbsp; \href{http://www.sultanik.com/}{Evan Sultanik}! Cette
  version a de nos jours la rÃ©fÃ©rence 0.2.
\item 24 mars 2011 : \texttt{coffee3}, une nouvelle version amÃ©liorÃ©e utilisant
  pdflatex et permettant la mise Ã&nbsp; l'Ã©chelle et la rotation de chacune des
  taches, sans compter le contrÃ´le de leur transparence. Merci au \href{http://pcmap.unizar.es/~pilar/}{professeur Luis
    Randez}! La rÃ©fÃ©rence de cette version est dorÃ©navant 0.3.
\item 25 mai 2012 : \texttt{coffee4}, une version encore amÃ©liorÃ©e, due Ã&nbsp;
  \href{http://nepsweb.co.uk/homeapr/}{Adrian Robson}, qui Ã©crit : Â« je constate
  parvenir rarement Ã&nbsp; placer ma tasse de cafÃ© au centre exact de mes documents.
  C'est pourquoi j'ai amendÃ© coffee3.sty de maniÃ¨re Ã&nbsp; permettre la composition
  de taches de cafÃ© autrement que centrÃ©es Â». Cette
  version porte dÃ©sormais la rÃ©fÃ©rence 0.4.
\item 1\textsuperscript{er} mai 2021 : le package \texttt{coffeestains} est
  placÃ© sur un dÃ©pÃ´t git. La rotation des taches est dÃ©sormais relative aux
  taches elles-mÃªmes et non plus au centre de la page. Version 0.5 par Patrick Bideault.
\end{itemize}
\coffeestainC{1}{1}{180}{0}{-5 mm}
\label{stainC}

\section{Apophtegmes et maximes}
\noindent
Grand est le cafÃ©.

\vspace{5mm}

\noindent
Le cafÃ© sauvera le monde.

\vfill{}

\begin{tcolorbox}
  La tache de cafÃ© ornant la prÃ©sente page a Ã©tÃ© obtenue grÃ¢ce Ã&nbsp; la commande suivante :

  \verb|\coffeestainC{1}{1}{180}{0}{-5 mm}|
\end{tcolorbox}

\begin{tcolorbox}
La page suivante a Ã©tÃ© enluminÃ©e grÃ¢ce Ã&nbsp; l'instruction suivante :

  \verb|\coffeestainD{0.4}{0.5}{90}{3 cm}{4 cm}|
\end{tcolorbox}

\newpage{}
\pagestyle{empty}
~\\

\coffeestainD{0.4}{0.5}{90}{3 cm}{4 cm}
\label{stainD}

\vfill{}
\begin{center}
\textsc{C'est intentionnellement que cette page fut laissÃ©e vide}

mais il nous a fallu vous le faire savoir.
\end{center}

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