4 puan yazan GN⁺ 2026-01-08 | 1 yorum | WhatsApp'ta paylaş
  • LaTeX belgelerine otomatik olarak kahve lekeleri ekleyebilen bir paket; daha önce görselleri elle eklemeyi gerektiren süreci basitleştiriyor
  • Dört leke biçimi (A~D) sunuyor ve opaklık, boyut, dönüş açısı ve konum üzerinde ayrıntılı ayar yapılabiliyor
  • Kurulumdan sonra \usepackage{coffeestains} tanımlanıyor ve her leke komutu (\coffeestainA~\coffeestainD) kullanılarak sayfaya yerleştiriliyor
  • Telif kısıtı olmadan serbestçe dağıtılabiliyor ve tüm leke görselleri doğrudan üretilmiş, fotoğraflanmış ve düzenlenmiş
  • 2009’daki ilk sürümden bu yana sürekli geliştirildi; 2021 sürümü 0.5.1 ile leke dönüş ekseni sayfa merkezinden leke merkezine değiştirildi

Giriş (Introduction)

  • Bu paket, LaTeX belgelerine kahve lekesi efekti ekleme işlevi sunuyor
    • Lekeleri belgeye doğrudan basarak elle ekleme için harcanan zamanı azaltıyor
  • Dört leke türü sunuluyor
    • A tipi: 270° dairesel leke ve iki küçük sıçrama izi
    • B tipi: 60° dairesel leke
    • C tipi: açık renkli iki sıçrama izi
    • D tipi: çok renkli ikiz sıçrama izi

Kullanım (Usage)

  • coffeestains.sty dosyasını LaTeX proje dizinine koyun veya dağıtıma kurun, ardından belge başlığına şunu ekleyin
    \usepackage{coffeestains}
    
  • Her leke şu komutla eklenir
    \coffeestainA{alpha}{scale}{angle}{xoff}{yoff}
    \coffeestainB{alpha}{scale}{angle}{xoff}{yoff}
    \coffeestainC{alpha}{scale}{angle}{xoff}{yoff}
    \coffeestainD{alpha}{scale}{angle}{xoff}{yoff}
    
  • Parametre açıklamaları
    • alpha: opaklık (0~1)
    • scale: boyut ölçeği (varsayılan 1)
    • angle: lekenin dönüş açısı (0~360 derece)
    • xoff, yoff: sayfa merkezi referans alınarak konum ofseti (birim belirtilmesi önerilir)
  • Örnek komutlar
    • \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}

Telif (Copyright)

  • Serbest dağıtıma açık; “hayali mülkiyet (imaginary property)” kavramına inanılmıyor
  • Tüm lekeler Hanno Rein tarafından doğrudan hazırlanmış ve fotoğraflandıktan sonra GIMP ve Inkscape ile işlenmiş
  • Bağışlar yalnızca kahve şeklinde kabul ediliyor; adres, Kanada Toronto Üniversitesi Scarborough kampüsündeki Hanno Rein olarak belirtilmiş

Gelecekte istenen iyileştirmeler (Desired improvements)

  • Şu anda yalnızca kahve lekeleri destekleniyor; ancak latte, çay, gazpacho ve yağ lekeleri gibi başka türlerin de gelecekte otomatik baskı hedefi olarak eklenmesi gerektiği belirtiliyor
  • Tamirhaneler gibi yerlerde belgelere elle basılan lekeleri de otomatikleştirecek LaTeX topluluğu araçları geliştirme ihtiyacından söz ediliyor

Değişiklik geçmişi (Change Log)

  • 3 Nisan 2009: Hanno Rein ilk sürümü (0.1) yayımladı
  • 23 Kasım 2010: Evan Sultanik pdflatex uyumlu sürümü (0.2) geliştirdi
  • 24 Mart 2011: Luis Randez boyut, dönüş ve opaklık ayarlarını ekledi (0.3)
  • 25 Mayıs 2012: Adrian Robson merkezden kayık leke desteği ekledi (0.4)
  • 1 Mayıs 2021: Patrick Bideault git deposu sürümünü (0.5) yayımladı; leke dönüş eksenini sayfa merkezi → leke merkezi olarak değiştirdi

Ebedi mottolar (Eternal mottos)

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

Diğer

  • Belgenin son sayfasında “Bu sayfa bilerek boş bırakıldı, ancak bunu söyleyerek mahvettik” ifadesi yer alıyor
  • En güncel sürüm 0.5.1 (25 Haziran 2021)

1 yorum

 
GN⁺ 2026-01-08
Hacker News görüşleri
  • Buna kimsenin daha değinmemiş olmasına şaşırdım. Typst ile kahve lekeleri yapmak oldukça eğlenceli Akademide ya da leke odaklı dergilerde LaTeX standart olmasaydı muhtemelen çoktan Typst'e geçerdim Elbette HTML'de de kahve lekeleri yapabilirsiniz ama Markdown'da bu mümkün değil
    • Ben bu aralar tüm makalelerimi Rust ile yeniden yazıyorum. Bellek güvenli kahve lekeleri elde etme deneyimi epey keyifliydi
    • Neyse ki Typst için bir port var. Typst fleck paketi'ne bakabilirsiniz
    • Typst kayıt gerektiriyor mu? Web tabanlı mı? “Açık geliştirme” deyip giriş sayfası olması biraz kafa karıştırıcı. LaTeX ile Typst arasındaki farklar hakkında ne düşündüğünüzü merak ediyorum
    • Bunu bu kütüphaneyle yapmaktansa Typst'te yapmak çok daha kolay görünüyor. Ördek kısmı sadece şakaydı
    • En iyi kahve lekeleri hâlâ doğrudan Postscript ile yapılanlardır
  • Bir özellik önerisi: tek bir leke gibi görünen, tek/çift sayfalarda tam hizalanan bir çift taraflı leke efekti olsa güzel olurdu
    • Her sayfada hafif bir solma efekti olsa daha doğal görünebilir
  • Kahve lekesi, bir belgenin gerçekten okunup okunmadığını yoksa sadece yazdırılıp yazdırılmadığını ayırt etmenin tek güvenilir yoludur Eskiden üniversiteden bir arkadaşım bazen belgelere bu tür lekeler ekleyip bunu bir “okundu sertifikası” gibi kullanırdı
    • Şarap kadehi lekesi, belgenin notlandırıldığını gösterir
  • İlgili bir bağlantı: Brown Ring of Quality
    • Şakayı kaçırmış olabilirim ama o sayfadaki logoların çoğu sanki Zen sanatındaki ensō çemberinden ilham almış gibi görünüyor
    • Bir logonun etrafına daire çizmenin, imzanın altını çizmek kadar gülünç bir tasarım tercihi olduğunu düşünüyorum
  • Aslı 2009 tarihli — arşiv bağlantısı İlgili eski HN başlıkları da burada: önceki gönderiler, ilgili tartışma1, ilgili tartışma2
  • Güzel görünüyor ama aslında yaptığı şey önceden tanımlanmış bir vektör dosyasını yerleştirmekten ibaret Gerçekçi görünen kahve lekelerini prosedürel olarak üretmenin mümkün olup olmadığını merak ediyorum
    • Kesinlikle mümkün. Bunu kendiniz denemenizi tavsiye ederim
  • Hâlâ yarım kalmış bir iş gibi duruyor. Şunlar da lazım:
    • çay lekeleri
    • sayfaların arasına sıkışmış ekmek kırıntıları
    • domates sosu izleri
    • saç telleri vb. Bunları doğrudan sayfaya basmak, elle ekleme süresinden büyük tasarruf sağlar
    • Her bin sayfada bir kadar ezilmiş sinek izi de olsa kusursuz olurdu
  • Bu projeyi gerçekten sevdim. Özgeçmişimi 20 yılı aşkın süredir LaTeX ile yönetiyorum Sürüm kontrolü yapılabiliyor ve Word'ün kaotik biçimlendirme sorunları yok. Tamamen deterministik, yani sonuçlar tutarlı Artık LLM'lerle dönüştürmek de kolay, uyarıları düzeltmek de otomatik yapılabiliyor. Kahve içmiyor olsanız bile LaTeX özgeçmişini şiddetle tavsiye ederim
    • Önerebileceğiniz bir şablon var mı? Ben de LaTeX kullanıyorum ama yaklaşık %98 memnunum
  • Kahve içmediğim için yazılım şirketlerinde kendimi dışlanmış hissettiğim oldu. Herkes kahveyi seviyor
    • Bende de benzeri var. Çay bir ölçüde yerine geçebiliyor ama tamamen aynı deneyim değil. Bazen diyet gazoz ile idare ediyorum ama şirketlerde pek bulunmuyor
    • Bunun yerine bir Çin demliği taşıyıp geleneksel ve modern pu-erh demleme yöntemleri arasındaki farkları anlatırsanız, kendinize özgü bir saygınlık kazanabilirsiniz
  • Böyle projeleri görmek hoşuma gidiyor. 90'ların ortasında öğrenciyken ve sektöre yeni girerken internette bu tür eğlenceli şaka projeleri sık görülürdü
    • O zamanlar çeşitli yazı sistemleri için OCR eğitimine yönelik sentetik veri üretiyorduk Web sayfalarını farklı yazı tipleriyle PDF'ye dönüştürüp, ImageMagick ile bulanıklık ekliyorduk Ve tabii ki bu kahve lekesi programını da kullanıyorduk