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)

[GN⁺]

Commentaires sur Hacker News

• Étonnant que personne ne l’ait encore mentionné. Faire des taches de café avec Typst est plutôt amusant
  Si LaTeX n’était pas le standard dans le milieu académique ou dans les revues consacrées aux taches, on serait probablement déjà passés à Typst
  Bien sûr, on peut aussi faire des taches de café en HTML, mais pas en Markdown
  • En ce moment, je réécris tous mes articles en Rust. L’expérience d’obtenir des taches de café sûres pour la mémoire était assez réjouissante
  • Heureusement, il existe un port pour Typst. Voir le package fleck pour Typst
  • Typst nécessite une inscription ? C’est basé sur le web ? Je trouve un peu déroutant qu’on parle de « développement ouvert » tout en ayant une page de connexion. Je serais curieux d’avoir votre avis sur la différence entre LaTeX et Typst
  • Ça a l’air bien plus simple à faire dans Typst qu’en utilisant cette bibliothèque. L’histoire du canard n’est qu’une blague
  • Les meilleures taches de café se font toujours à la main en Postscript
• Proposition de fonctionnalité — il faudrait un effet de tache recto-verso où les pages impaires et paires s’alignent exactement pour donner l’impression d’une seule tache
  • Un léger effet d’estompage sur chaque page rendrait le tout plus naturel
• Les taches de café sont le seul moyen vraiment fiable de savoir si un document a réellement été lu, ou s’il a simplement été imprimé
  Autrefois, un collègue à l’université ajoutait parfois ce genre de taches à un document comme marque de « lecture confirmée »
  • Une trace de verre de vin indique que le document a été corrigé
• Je partage un lien connexe — Brown Ring of Quality
  • J’ai peut-être raté la blague, mais la plupart des logos de cette page semblent inspirés par le cercle ensō de l’art zen
  • Entourer un logo d’un cercle me paraît être un choix de design ridicule, au même titre que souligner sa signature
• L’original date de 2009 — lien d’archive
  Je partage aussi d’anciens fils HN liés au sujet : anciens billets, discussion connexe 1, discussion connexe 2
• C’est joli à voir, mais en réalité il ne s’agit que de placer un fichier vectoriel prédéfini
  Je me demande s’il serait possible de générer procéduralement des taches de café réalistes
  • Tout à fait possible. Je recommande d’essayer soi-même
• On dirait encore un travail à moitié terminé. Il manque en plus :
  • des taches de thé
  • des miettes de pain écrasées entre les pages
  • des traces de sauce tomate
  • des cheveux, etc.
    Imprimer directement ce genre de choses sur les pages ferait gagner du temps par rapport à les ajouter à la main
  • Et ce serait parfait s’il y avait aussi, une fois toutes les mille pages, une trace de mouche écrasée
• J’aime vraiment beaucoup ce projet. Mon CV est maintenu en LaTeX depuis plus de 20 ans
  On peut le versionner, il n’y a pas les problèmes de mise en forme chaotiques de Word, et c’est totalement déterministe, donc le résultat reste constant
  Aujourd’hui, les LLM facilitent aussi les conversions et corrigent automatiquement les avertissements. Même sans boire de café, je recommande vivement un CV en LaTeX
  • Je me demande s’il y a des modèles à recommander. J’écris aussi le mien en LaTeX, mais je n’en suis satisfait qu’à 98 % environ
• Il m’est arrivé de me sentir exclu dans des entreprises de logiciels parce que je ne bois pas de café. Tout le monde adore ça
  • Pareil pour moi. On peut remplacer par du thé, mais ce n’est pas tout à fait la même expérience. Parfois, je tiens avec du soda light, mais ce n’est pas très souvent proposé en entreprise
  • Tu peux aussi te promener avec une théière chinoise et expliquer les différences entre les méthodes traditionnelles et modernes du pu-erh pour gagner ton propre respect
• Ce genre de projet me fait plaisir à voir. Au milieu des années 1990, quand j’étais étudiant et tout juste entré dans l’industrie, Internet regorgeait souvent de ce type de petits projets ludiques
  • À l’époque, nous produisions des données synthétiques pour l’entraînement OCR sur divers systèmes d’écriture
    Nous convertissions des pages web en PDF avec différentes polices, puis nous ajoutions du flou avec ImageMagick
    Et bien sûr, nous utilisions aussi ce programme de taches de café