LaTeX-Kaffeeflecken (LaTeX Coffee Stains)

• Ein Paket, mit dem sich automatisch Kaffeeflecken zu LaTeX-Dokumenten hinzufügen lassen und das den bisher manuellen Vorgang des Einfügens von Bildern vereinfacht
• Bietet vier Fleckenformen (A–D) und ermöglicht eine fein abgestimmte Kontrolle über Transparenz, Größe, Rotationswinkel und Position
• Nach der Installation wird \usepackage{coffeestains} deklariert; anschließend werden die einzelnen Fleckenbefehle (\coffeestainA–\coffeestainD) zur Platzierung auf der Seite verwendet
• Kann ohne urheberrechtliche Einschränkungen frei verbreitet werden; alle Fleckenbilder wurden direkt erstellt, fotografiert und bearbeitet
• Seit der ersten Version von 2009 kontinuierlich verbessert; in Version 0.5.1 von 2021 wurde der Rotationsbezugspunkt des Flecks vom Seitenzentrum auf das Fleckzentrum geändert

---

Einführung (Introduction)

• Dieses Paket bietet eine Funktion zum Hinzufügen von Kaffeeflecken-Effekten zu LaTeX-Dokumenten
  • Durch das direkte Drucken von Flecken in das Dokument spart es Zeit gegenüber dem manuellen Einfügen
• Es werden vier Fleckentypen bereitgestellt
  • Typ A: kreisförmiger 270°-Fleck und zwei kleine Spritzer
  • Typ B: kreisförmiger 60°-Fleck
  • Typ C: zwei helle Spritzer
  • Typ D: bunte Zwillingsspritzer

Verwendung (Usage)

• Die Datei coffeestains.sty in das LaTeX-Projektverzeichnis legen oder in der Distribution installieren und dann Folgendes in den Dokumentkopf einfügen

  \usepackage{coffeestains}
  

• Jeder Fleck wird mit den folgenden Befehlen eingefügt

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

• Erläuterung der Parameter
  • alpha: Transparenz (0–1)
  • scale: Größenfaktor (Standardwert 1)
  • angle: Rotationswinkel des Flecks (0–360 Grad)
  • xoff, yoff: Positionsoffset relativ zum Seitenzentrum (Angabe einer Einheit empfohlen)
• Beispielbefehle
  • \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}

Urheberrecht (Copyright)

• Frei verbreitbar, da nicht an das Konzept von „imaginary property“ geglaubt wird
• Alle Flecken wurden von Hanno Rein selbst erstellt und fotografiert und anschließend mit GIMP und Inkscape bearbeitet
• Spenden werden nur in Form von Kaffee angenommen; als Adresse ist Hanno Rein am Campus Scarborough der University of Toronto in Kanada angegeben

Gewünschte Verbesserungen (Desired improvements)

• Derzeit werden nur Kaffeeflecken unterstützt, künftig sollte der automatische Druck aber auch auf Latte-, Tee-, Gazpacho- und Ölflecken ausgeweitet werden
• Es wird der Bedarf an Werkzeugen der LaTeX-Community erwähnt, um sogar Flecken zu automatisieren, die in Reparaturwerkstätten manuell auf Dokumente gelangen

Änderungsprotokoll (Change Log)

• 3. April 2009: Hanno Rein veröffentlicht die erste Version (0.1)
• 23. November 2010: Evan Sultanik entwickelt eine mit pdflatex kompatible Version (0.2)
• 24. März 2011: Luis Randez fügt Funktionen zur Steuerung von Größe, Rotation und Transparenz hinzu (0.3)
• 25. Mai 2012: Adrian Robson ergänzt Unterstützung für exzentrisch platzierte Flecken (0.4)
• 1. Mai 2021: Patrick Bideault veröffentlicht die Git-Repository-Version (0.5) und ändert den Rotationsbezugspunkt des Flecks von Seitenzentrum → Fleckzentrum

Ewige Mottos (Eternal mottos)

• „Coffee is great.“
• „Coffee will save the world.“

Sonstiges

• Auf der letzten Seite des Dokuments steht der Satz: „Diese Seite wurde absichtlich leer gelassen, aber durch diesen Hinweis verdorben.“
• Die aktuelle Version ist 0.5.1 (25. Juni 2021)

[GN⁺]

Hacker-News-Kommentare

• Erstaunlich, dass das noch niemand erwähnt hat. Mit Typst Kaffeeflecken zu erzeugen, macht ziemlich viel Spaß
  Wenn LaTeX nicht der Standard in der Wissenschaft oder in fleckenbezogenen Journals wäre, wäre ich wohl schon zu Typst gewechselt
  Natürlich kann man auch in HTML Kaffeeflecken erzeugen, aber in Markdown geht das nicht
  • Ich schreibe inzwischen alle meine Papers in Rust neu. Die Erfahrung, speichersichere Kaffeeflecken zu bekommen, war ziemlich vergnüglich
  • Zum Glück gibt es einen Port für Typst. Siehe das Typst-fleck-Paket
  • Benötigt Typst eine Registrierung? Ist es webbasiert? Es ist etwas verwirrend, dass es eine Login-Seite gibt, obwohl von „offener Entwicklung“ die Rede ist. Mich würde interessieren, wie ihr über die Unterschiede zwischen LaTeX und Typst denkt
  • Es scheint viel einfacher zu sein, das in Typst zu machen, als diese Bibliothek zu benutzen. Die Sache mit der Ente ist nur ein Witz
  • Die besten Kaffeeflecken macht man immer noch direkt in Postscript
• Funktionsvorschlag — es sollte einen Doppelseiten-Flecken-Effekt geben, bei dem ungerade und gerade Seiten exakt zusammenpassen und wie ein einziger Fleck wirken
  • Ein leichtes Verblassen pro Seite würde es noch natürlicher wirken lassen
• Kaffeeflecken sind die einzige verlässliche Methode, um festzustellen, ob ein Dokument wirklich gelesen oder nur ausgedruckt wurde
  Ein Kollege an der Universität hat früher gelegentlich solche Flecken in Dokumente eingefügt und sie als „Gelesen-Bestätigung“ verwendet
  • Weinglasflecken sind das Zeichen dafür, dass das Dokument bewertet wurde
• Hier ist ein passender Link — Brown Ring of Quality
  • Vielleicht habe ich den Witz verpasst, aber die meisten Logos auf dieser Seite scheinen vom Ensō-Kreis der Zen-Kunst inspiriert zu sein
  • Einen Kreis um ein Logo zu ziehen, ist meiner Meinung nach eine ebenso lächerliche Designentscheidung wie eine Unterstreichung unter einer Unterschrift
• Das Original stammt aus dem Jahr 2009 — Archivlink
  Hier sind auch frühere HN-Threads dazu: Sammlung früherer Beiträge, verwandte Diskussion 1, verwandte Diskussion 2
• Sieht schick aus, aber eigentlich wird nur eine vordefinierte Vektordatei platziert
  Ich frage mich, ob man realistisch aussehende Kaffeeflecken prozedural erzeugen könnte
  • Absolut möglich. Ich würde empfehlen, es selbst auszuprobieren
• Wirkt noch wie ein halb fertiges Projekt. Zusätzlich braucht es noch:
  • Teeflecken
  • zwischen die Seiten gepresste Brotkrümel
  • Tomatensoßen-Spuren
  • Haare usw.
    Wenn man solche Dinge direkt auf die Seiten druckt, spart das viel Zeit gegenüber dem manuellen Hinzufügen
  • Für die perfekte Wirkung sollte etwa einmal pro tausend Seiten auch eine zerquetschte Fliege dabei sein
• Ich mag dieses Projekt wirklich. Meinen Lebenslauf pflege ich seit über 20 Jahren in LaTeX
  Er ist versionskontrollierbar, vermeidet das chaotische Formatierungsverhalten von Word und ist vollständig deterministisch, sodass die Ergebnisse konsistent bleiben
  Heute kann man mit LLMs Umwandlungen leicht erledigen und sogar Warnungen automatisch beheben lassen. Auch ohne Kaffee ist ein LaTeX-Lebenslauf sehr zu empfehlen
  • Mich würde interessieren, ob es Vorlagen gibt, die ihr empfehlen könnt. Ich schreibe meinen auch in LaTeX, bin aber nur zu etwa 98 % zufrieden
• Ich habe mich in Softwarefirmen schon ausgeschlossen gefühlt, weil ich keinen Kaffee trinke. Alle lieben Kaffee
  • Geht mir ähnlich. Man kann zwar auf Tee ausweichen, aber es ist nicht ganz dasselbe. Manchmal rette ich mich mit Diät-Limonade, aber die wird im Büro nicht besonders gut bereitgestellt
  • Alternativ kannst du eine chinesische Teekanne mitbringen und über die Unterschiede zwischen traditionellen und modernen Methoden für Pu-Erh-Tee sprechen, dann bekommst du deinen eigenen Respekt
• Solche Projekte zu sehen, freut mich. Mitte der 90er, als ich Student und am Anfang meiner Karriere war, gab es im Internet oft solche spaßigen Scherzprojekte
  • Damals haben wir synthetische Daten für OCR-Training in verschiedenen Schriftsystemen erzeugt
    Wir haben Webseiten mit unterschiedlichen Schriftarten in PDFs umgewandelt und mit ImageMagick Unschärfe hinzugefügt
    Und natürlich haben wir auch dieses Kaffeeflecken-Programm verwendet