Noda Kopi LaTeX (LaTeX Coffee Stains)

• Paket untuk secara otomatis menambahkan noda kopi ke dokumen LaTeX, menyederhanakan proses yang sebelumnya dilakukan dengan menyisipkan gambar secara manual
• Menyediakan empat bentuk noda (A~D), dengan transparansi, ukuran, sudut rotasi, dan posisi yang dapat diatur secara rinci
• Setelah instalasi, deklarasikan \usepackage{coffeestains} dan tempatkan di halaman menggunakan tiap perintah noda (\coffeestainA~\coffeestainD)
• Dapat didistribusikan secara bebas tanpa batasan hak cipta, dan semua gambar noda dibuat, dipotret, serta diedit sendiri
• Terus ditingkatkan sejak versi pertama pada 2009, dan pada versi 0.5.1 tahun 2021 acuan rotasi noda diubah dari pusat halaman ke pusat noda

---

Pengantar (Introduction)

• Paket ini menyediakan fungsi untuk menambahkan efek noda kopi ke dokumen LaTeX
  • Dengan mencetak noda langsung pada dokumen, waktu penyisipan manual dapat dihemat
• Menyediakan empat jenis noda
  • Tipe A: noda melingkar 270° dan dua cipratan kecil
  • Tipe B: noda melingkar 60°
  • Tipe C: dua cipratan berwarna terang
  • Tipe D: cipratan kembar berwarna-warni

Cara penggunaan (Usage)

• Letakkan file coffeestains.sty di direktori proyek LaTeX atau instal ke distribusi, lalu tambahkan berikut ini ke header dokumen

  \usepackage{coffeestains}
  

• Tiap noda dimasukkan dengan perintah berikut

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

• Penjelasan parameter
  • alpha: transparansi (0~1)
  • scale: skala ukuran (default 1)
  • angle: sudut rotasi noda (0~360 derajat)
  • xoff, yoff: offset posisi berdasarkan pusat halaman (disarankan menyertakan satuan)
• Contoh perintah
  • \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}

Hak cipta (Copyright)

• Bebas didistribusikan, karena tidak mempercayai konsep “imaginary property”
• Semua noda dibuat dan dipotret langsung oleh Hanno Rein, lalu diproses dengan GIMP dan Inkscape
• Donasi hanya diterima dalam bentuk kopi, dengan alamat yang ditujukan kepada Hanno Rein di kampus Scarborough, University of Toronto, Kanada

Peningkatan yang diinginkan (Desired improvements)

• Saat ini hanya mendukung noda kopi, tetapi ke depan perlu diperluas agar dapat mencetak otomatis noda latte, teh, gazpacho, dan minyak
• Disebutkan perlunya pengembangan alat oleh komunitas LaTeX untuk mengotomatisasi bahkan noda yang biasanya dibubuhkan manual pada dokumen di ruang rapat atau tempat serupa

Riwayat perubahan (Change Log)

• 3 April 2009: Hanno Rein merilis versi pertama (0.1)
• 23 November 2010: Evan Sultanik mengembangkan versi kompatibel pdflatex (0.2)
• 24 Maret 2011: Luis Randez menambahkan fitur pengaturan ukuran, rotasi, dan transparansi (0.3)
• 25 Mei 2012: Adrian Robson menambahkan dukungan untuk noda yang tidak berpusat (0.4)
• 1 Mei 2021: Patrick Bideault merilis versi repositori git (0.5), mengubah acuan rotasi noda dari pusat halaman → pusat noda

Motto abadi (Eternal mottos)

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

Lain-lain

• Halaman terakhir dokumen memuat kalimat “This page intentionally left blank, but ruined by telling you so”
• Versi terbaru adalah 0.5.1 (25 Juni 2021)

[GN⁺]

Komentar Hacker News

• Aneh juga belum ada yang menyebut ini. Membuat noda kopi dengan Typst ternyata cukup menyenangkan
  Kalau LaTeX bukan standar di dunia akademik atau jurnal yang berhubungan dengan noda, rasanya saya sudah pindah ke Typst
  Tentu saja noda kopi juga bisa dibuat di HTML, tapi tidak bisa di Markdown
  • Akhir-akhir ini saya menulis ulang semua paper saya dalam Rust. Pengalaman mendapatkan noda kopi yang aman dari segi memori ternyata cukup menghibur
  • Untungnya ada port untuk Typst. Bisa lihat paket fleck Typst
  • Apakah Typst perlu daftar akun? Apakah ini berbasis web? Agak membingungkan melihat ada halaman login sambil mengusung “pengembangan terbuka”. Penasaran bagaimana pendapat orang soal perbedaan LaTeX dan Typst
  • Sepertinya jauh lebih mudah melakukan ini di Typst daripada memakai pustaka ini. Soal bebek itu cuma bercanda
  • Noda kopi terbaik tetap yang dibuat langsung dengan Postscript
• Usulan fitur — akan keren kalau ada efek noda dua sisi, jadi halaman ganjil/genap saling pas dan terlihat seperti satu noda yang sama
  • Kalau tiap halaman ada efek sedikit memudar, hasilnya mungkin akan terlihat lebih alami
• Noda kopi adalah satu-satunya cara yang benar-benar pasti untuk membedakan apakah dokumen benar-benar dibaca, atau cuma dicetak saja
  Dulu ada rekan di kampus yang kadang menambahkan noda seperti ini ke dokumen sebagai tanda “sudah dibaca”
  • Bekas gelas anggur berarti dokumen itu sudah dinilai
• Membagikan tautan yang relevan — Brown Ring of Quality
  • Mungkin saya melewatkan leluconnya, tapi sebagian besar logo di halaman itu tampaknya terinspirasi dari lingkaran ensō dalam seni Zen
  • Menaruh lingkaran di sekitar logo menurut saya adalah pilihan desain yang konyol, sama seperti memberi garis bawah pada tanda tangan
• Yang asli berasal dari 2009 — tautan arsip
  Juga membagikan thread HN sebelumnya yang terkait: kumpulan posting sebelumnya, diskusi terkait 1, diskusi terkait 2
• Kelihatannya keren, tapi sebenarnya cuma menempatkan file vektor yang sudah didefinisikan sebelumnya
  Saya penasaran apakah mungkin menghasilkan noda kopi yang terlihat nyata secara prosedural
  • Sangat mungkin. Saya sarankan coba sendiri
• Rasanya ini masih seperti pekerjaan yang baru setengah jadi. Yang masih perlu ditambahkan di sini:
  • noda teh hitam
  • remah roti yang terjepit di antara kertas
  • bekas saus tomat
  • helai rambut, dan sebagainya
    Kalau hal-hal seperti ini langsung dicetak di halaman, bisa menghemat banyak waktu dibanding menambahkannya secara manual
  • Akan sempurna kalau tiap seribu halaman ada satu bekas lalat gepeng juga
• Saya benar-benar suka proyek ini. Resume saya sudah dikelola dengan LaTeX selama lebih dari 20 tahun
  Bisa dikendalikan dengan version control, tidak ada masalah format Word yang kacau. Semuanya benar-benar deterministik, jadi hasilnya konsisten
  Sekarang konversi juga mudah dengan bantuan LLM, dan perbaikan peringatan bisa diotomatisasi. Bahkan kalau tidak minum kopi, resume LaTeX tetap sangat saya rekomendasikan
  • Penasaran apakah ada template yang layak direkomendasikan. Saya juga menulis dengan LaTeX, tapi baru puas sekitar 98%
• Saya pernah merasa terasing di perusahaan perangkat lunak hanya karena tidak minum kopi. Semua orang suka kopi
  • Saya juga begitu. Memang bisa diganti teh, tapi tetap tidak sepenuhnya sama. Kadang saya bertahan dengan diet soda, tapi di kantor biasanya itu tidak tersedia
  • Atau bawa saja teko teh Tiongkok dan bahas perbedaan cara tradisional dan modern untuk pu-erh, pasti bisa mendapat rasa hormat versi saya sendiri
• Senang melihat proyek seperti ini. Saat masih mahasiswa dan baru masuk industri pada pertengahan 90-an, internet sering punya proyek iseng yang menyenangkan seperti ini
  • Waktu itu kami sedang membuat data sintetis untuk pelatihan OCR dalam berbagai skrip tulisan
    Halaman web kami ubah menjadi PDF dengan berbagai font, lalu menambahkan efek blur memakai ImageMagick
    Dan tentu saja, kami juga memakai program noda kopi ini