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)