Debian Codegraph @

texmf-dist/doc/latex/coffeestains/coffeestains-fr.tex

raw
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}