Taches de café LaTeX (LaTeX Coffee Stains)

• Un package permettant d’ajouter automatiquement des taches de café à des documents LaTeX, ce qui simplifie le processus auparavant manuel d’insertion d’images
• Il propose quatre formes de taches (A à D) et permet d’ajuster finement la transparence, la taille, l’angle de rotation et la position
• Après installation, il suffit de déclarer \usepackage{coffeestains} puis d’utiliser les commandes de taches (\coffeestainA à \coffeestainD) pour les placer sur la page
• Libre de droits et redistribuable sans restriction, et toutes les images de taches ont été créées, photographiées et retouchées directement par leur auteur
• Amélioré en continu depuis la première version de 2009, le version 0.5.1 de 2021 modifie le point de rotation des taches, qui passe du centre de la page au centre de la tache

---

Introduction

• Ce package permet d’ajouter un effet de taches de café à des documents LaTeX
  • En imprimant directement les taches dans le document, il fait gagner le temps d’une insertion manuelle
• Quatre types de taches sont proposés
  • Type A : une tache circulaire de 270° avec deux petites éclaboussures
  • Type B : une tache circulaire de 60°
  • Type C : deux éclaboussures de couleur claire
  • Type D : une paire d’éclaboussures multicolores

Utilisation

• Placez le fichier coffeestains.sty dans le répertoire du projet LaTeX ou installez-le dans votre distribution, puis ajoutez ce qui suit dans l’en-tête du document

  \usepackage{coffeestains}
  

• Chaque tache s’insère avec les commandes suivantes

  \coffeestainA{alpha}{scale}{angle}{xoff}{yoff}
  \coffeestainB{alpha}{scale}{angle}{xoff}{yoff}
  \coffeestainC{alpha}{scale}{angle}{xoff}{yoff}
  \coffeestainD{alpha}{scale}{angle}{xoff}{yoff}
  

• Description des paramètres
  • alpha : transparence (0 à 1)
  • scale : facteur d’échelle (valeur par défaut : 1)
  • angle : angle de rotation de la tache (0 à 360 degrés)
  • xoff, yoff : décalage de position par rapport au centre de la page (il est recommandé de préciser l’unité)
• Exemples de commandes
  • \coffeestainA{0.9}{0.85}{-25}{5cm}{1.3cm}
  • \coffeestainB{0.7}{1}{-30}{18pt}{-135pt}
  • \coffeestainC{1}{1}{180}{0}{-5mm}
  • \coffeestainD{0.4}{0.5}{90}{3cm}{4cm}

Copyright

• Redistribution libre possible, l’auteur ne croit pas au concept de « propriété imaginaire »
• Toutes les taches ont été créées et photographiées par Hanno Rein, puis traitées avec GIMP et Inkscape
• Les dons ne sont acceptés que sous forme de café, à l’attention de Hanno Rein sur le campus de Scarborough de l’Université de Toronto, au Canada

Améliorations souhaitées

• Pour l’instant, seules les taches de café sont prises en charge, mais il faudrait à l’avenir étendre l’impression automatique à des taches de latte, de thé, de gaspacho ou d’huile
• Le texte mentionne aussi la nécessité, pour la communauté LaTeX, de développer des outils automatisant même les taches apposées manuellement sur les documents dans des lieux comme les garages de réparation

Historique des modifications

• 3 avril 2009 : Hanno Rein publie la première version (0.1)
• 23 novembre 2010 : Evan Sultanik développe une version compatible avec pdflatex (0.2)
• 24 mars 2011 : Luis Randez ajoute le réglage de la taille, de la rotation et de la transparence (0.3)
• 25 mai 2012 : Adrian Robson ajoute la prise en charge des taches décentrées (0.4)
• 1er mai 2021 : Patrick Bideault publie la version dépôt git (0.5) et modifie le point de rotation des taches, qui passe du centre de la page au centre de la tache

Mottos éternels

• « Coffee is great. »
• « Coffee will save the world. »

Divers

• La dernière page du document contient la phrase : « Cette page a été intentionnellement laissée blanche, mais le fait de vous l’indiquer l’a gâchée »
• La dernière version est la 0.5.1 (25 juin 2021)