Manchas de café para LaTeX (LaTeX Coffee Stains)

• Un paquete que permite agregar automáticamente manchas de café a documentos LaTeX, simplificando el proceso que antes requería insertar imágenes manualmente
• Ofrece cuatro formas de manchas (A~D), con ajuste fino de transparencia, tamaño, ángulo de rotación y posición
• Tras instalarlo, se declara \usepackage{coffeestains} y se colocan en la página con cada comando de mancha (\coffeestainA~\coffeestainD)
• Se puede redistribuir libremente sin restricciones de copyright, y todas las imágenes de manchas fueron creadas, fotografiadas y editadas directamente
• Desde su primera versión en 2009 ha seguido mejorando, y en la versión 0.5.1 de 2021 el criterio de rotación de la mancha cambió del centro de la página al centro de la mancha

---

Introducción (Introduction)

• Este paquete ofrece la función de añadir un efecto de manchas de café a documentos LaTeX
  • Al imprimir las manchas directamente en el documento, ahorra el tiempo de inserción manual
• Proporciona cuatro tipos de manchas
  • Tipo A: mancha circular de 270° y dos pequeñas salpicaduras
  • Tipo B: mancha circular de 60°
  • Tipo C: dos salpicaduras de color claro
  • Tipo D: salpicaduras gemelas multicolores

Uso (Usage)

• Coloca el archivo coffeestains.sty en el directorio del proyecto LaTeX o instálalo en la distribución, y luego añade lo siguiente en el encabezado del documento

  \usepackage{coffeestains}
  

• Cada mancha se inserta con los siguientes comandos

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

• Descripción de parámetros
  • alpha: transparencia (0~1)
  • scale: escala de tamaño (valor predeterminado: 1)
  • angle: ángulo de rotación de la mancha (0~360 grados)
  • xoff, yoff: desplazamiento de posición respecto al centro de la página (se recomienda especificar unidades)
• Comandos de ejemplo
  • \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

• Redistribución libre posible, ya que no se cree en el concepto de “propiedad imaginaria”
• Todas las manchas fueron creadas y fotografiadas directamente por Hanno Rein y luego procesadas con GIMP e Inkscape
• Las donaciones se aceptan solo en forma de café, y se indica la dirección de Hanno Rein en el campus Scarborough de la Universidad de Toronto, Canadá

Mejoras futuras deseadas (Desired improvements)

• Actualmente solo se admiten manchas de café, pero en el futuro haría falta ampliar la impresión automática a manchas de latte, té, gazpacho y aceite
• También se menciona la necesidad de que la comunidad de LaTeX desarrolle herramientas para automatizar incluso las manchas que se estampan manualmente en documentos en institutos de matemáticas y similares

Historial de cambios (Change Log)

• 3 de abril de 2009: Hanno Rein publica la primera versión (0.1)
• 23 de noviembre de 2010: Evan Sultanik desarrolla la versión compatible con pdflatex (0.2)
• 24 de marzo de 2011: Luis Randez añade funciones de ajuste de tamaño, rotación y transparencia (0.3)
• 25 de mayo de 2012: Adrian Robson añade soporte para manchas descentradas (0.4)
• 1 de mayo de 2021: Patrick Bideault publica la versión del repositorio git (0.5) y cambia el criterio de rotación de la mancha de centro de la página → centro de la mancha

Lemas eternos (Eternal mottos)

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

Otros

• La última página del documento incluye la frase: “Esta página fue dejada en blanco intencionalmente, pero se arruinó al avisártelo”
• La versión más reciente es la 0.5.1 (25 de junio de 2021)

[GN⁺]

Comentarios en Hacker News

• Sorprende que nadie lo haya mencionado todavía. Hacer manchas de café con Typst es bastante divertido
  Si LaTeX no fuera el estándar en la academia o en las revistas relacionadas con manchas, probablemente ya me habría pasado a Typst
  Claro que también se pueden hacer manchas de café en HTML, pero en Markdown no es posible
  • Últimamente estoy reescribiendo todos mis papers en Rust. Fue bastante agradable la experiencia de obtener manchas de café con seguridad de memoria
  • Por suerte hay un port para Typst. Se puede ver el paquete fleck para Typst
  • ¿Typst requiere registrarse? ¿Es basado en la web? Me confunde un poco que hablen de “desarrollo abierto” y aun así haya una página de inicio de sesión. Me gustaría saber qué piensan sobre la diferencia entre LaTeX y Typst
  • Parece mucho más fácil hacerlo en Typst que usar esta biblioteca. Lo del pato es solo una broma
  • Las mejores manchas de café siguen siendo las hechas directamente en Postscript
• Propuesta de funcionalidad: ojalá hubiera un efecto de manchas a doble cara donde las páginas impares y pares encajaran exactamente y se vieran como una sola mancha
  • Si cada página tuviera un efecto de desvanecimiento ligero, se vería más natural
• Las manchas de café son la única forma realmente confiable de distinguir si un documento de verdad fue leído o si solo fue impreso
  Antes, un colega de la universidad a veces agregaba estas manchas a los documentos para usarlas como señal de “certificado de lectura”
  • Una marca de copa de vino indica que ese documento ya fue calificado
• Comparto un enlace relacionado: Brown Ring of Quality
  • Puede que no haya entendido el chiste, pero la mayoría de los logos de esa página parecen inspirados en el círculo ensō del arte zen
  • Me parece que ponerle un círculo al logo es una decisión de diseño ridícula, tanto como subrayar debajo de una firma
• El original es material de 2009: enlace de archivo
  También comparten hilos anteriores de HN relacionados: colección de publicaciones anteriores, discusión relacionada 1, discusión relacionada 2
• Se ve genial, pero en realidad no es más que colocar un archivo vectorial predefinido
  Me pregunto si sería posible generar proceduralmente manchas de café que parezcan reales
  • Totalmente posible. Recomiendo intentarlo uno mismo
• Todavía parece un trabajo a medio terminar. Además de esto, hace falta:
  • manchas de té negro
  • migas de pan aplastadas entre las hojas
  • marcas de salsa de tomate
  • cabellos, etc.
    Si estas cosas se imprimieran directamente en la página, se ahorraría mucho tiempo de agregarlas a mano
  • Para que fuera perfecto, haría falta también una marca de mosca aplastada cada mil páginas más o menos
• Este proyecto realmente me encanta. Llevo más de 20 años manteniendo mi currículum en LaTeX
  Se puede versionar, no tiene los problemas caóticos de formato de Word, y es completamente determinista, así que el resultado es consistente
  Hoy en día también es fácil convertirlo usando LLM y hasta corregir automáticamente las advertencias. Aunque no tomes café, recomiendo mucho un currículum en LaTeX
  • Me pregunto si hay alguna plantilla recomendable. Yo también lo hago en LaTeX, pero estoy satisfecho solo en un 98%
• He sentido cierta sensación de exclusión en empresas de software por no tomar café. A todo el mundo le encanta el café
  • A mí me pasa algo parecido. Puede reemplazarse por té, pero no es exactamente la misma experiencia. A veces sobrevivo con refresco de dieta, pero en la empresa no suelen ofrecerlo mucho
  • Mejor aún, puedes cargar una tetera china y hablar de las diferencias entre las formas tradicionales y modernas del pu-erh, y así conseguir tu propio respeto
• Me da gusto ver proyectos así. Cuando era estudiante y recién empezaba en la industria a mediados de los 90, en internet solía haber muchos proyectos de broma divertidos como este
  • En ese tiempo estábamos creando datos sintéticos para entrenar OCR en varios sistemas de escritura
    Convertíamos páginas web a PDF con distintas tipografías y les agregábamos desenfoque con ImageMagick
    Y por supuesto, también usábamos este programa de manchas de café