LaTeX Coffee Stains (2021) [pdf]
384 points
1 day ago
| 29 comments
| ctan.math.illinois.edu
| HN
spudlyo
1 day ago
[-]
I'm surprised nobody has yet mentioned how pleasant it is to create coffee stains using Typst, and if only LaTeX wasn't the de-facto standard in academia and stain-related journals, they would have already switched to it.

Of course, you can create coffee stains in HTML as well, but it's not something you can do in Markdown.

reply
bachmeier
1 day ago
[-]
I've been rewriting all my papers in Rust. It's been a pleasant experience getting memory safe coffee stains on my papers.
reply
vlod
7 hours ago
[-]
Surely coffeescript would have been more appropriate?

[0]: https://coffeescript.org/

reply
anu7df
1 day ago
[-]
Does coffee accelerate rusting?
reply
semi-extrinsic
1 day ago
[-]
Depends on the acidity.
reply
tristanlukens
18 hours ago
[-]
Blazingly fast papers!
reply
throwaway17_17
23 hours ago
[-]
I know it was probably said just as a joke, but are you really writing papers using Rust? I don’ t use Rust, BUT if you’ve got a better way to write symbol heavy type theory and/or logic than having to make PNG’s and put them in as images in a word processor I would love to hear about it.
reply
eru
22 hours ago
[-]
You might like what people have cooked up with Racket.
reply
fourthark
1 day ago
[-]
Thankfully there is a Typst port of this package!

https://typst.app/universe/package/fleck/

reply
philistine
1 day ago
[-]
That package still has the core limitation of Typst: images can only be placed top-middle-bottom and left-centre-right. Typst still has yet to support arbitrarily placed images.
reply
doerig
1 day ago
[-]
You mean absolutely positioning it? You can do that with the place function and displacing it with dx/dy from the origin (https://typst.app/docs/reference/layout/place). Example: #place(top + left, dy: 2cm, dx: 4cm, image("image.png"))
reply
philistine
1 day ago
[-]
That seems usable for manual layout, but it looks painful to use to place images without knowing exactly where they might end up on a page. I reuse my LaTeX code to make volumes of books, and I never touch the code. It's fire and forget for me, which this does not seem to solve.
reply
tcfhgj
1 day ago
[-]
> but it looks painful to use to place images without knowing exactly where they might end up on a page.

they end up exactly at the specified location?

reply
antonvs
1 day ago
[-]
Presumably they're referring to the ability to parameterize the target page size. In that case, absolute coordinates don't work well (if at all).
reply
philistine
22 hours ago
[-]
Parameterize! That's a new word I didn't know. It adequately describes how I typeset my books, and I must not be alone. The ability to tell LaTeX to drop a picture around here, to the best of its ability, with the possibility of moving it down a paragraph or two if it doesn't fit is vital for me.
reply
kzrdude
14 hours ago
[-]
I think that's a missing feature of Typst yes, to have figures be either "here" or "top next page" automatically, with that priority. It can't do that. The confusing part was that this has nothing to do with the images of this coffee stain package, because they are foreground/background and can be placed freely on the page (any corner or any custom offset from any corner; i.e from top left corner you can use page coordinates).

The coffee stains overlay/underlay text, so no layout problems at all.

reply
mr_mitm
18 hours ago
[-]
But the dx/dy arguments also take percentages besides absolut lengths. I still don't get what the the other poster means by that fundamental limitation. I think they're confused about absolute positioning of background images vs floating figures. But typst has the analog setting of `[htbp]`, so the same "fire and forget" workflow is possible.
reply
widforss
19 hours ago
[-]
> two splashes with light colours

Blood. That's blood.

reply
alexitosrv
1 day ago
[-]
Typst requires a signup? It's web? It says developed in the open, but the main page also offers a login. What can you about latex vs typst?
reply
buo
1 day ago
[-]
The compiler is open-source and can be run locally. You need an account if you want to use their web editor, which is nice (it shows error messages where they occur along with an explanation and link to docs, and also shows a real-time updated preview).

As for Latex vs Typst, as a language Typst is much better, compiles very quickly, and has sane error messages. However, Typst still has a few rough edges, and can't do everything you can with Latex + packages (yet).

I've been using Typst for most of my documents for a few months and I've been generally happy with it.

reply
cbolton
13 hours ago
[-]
You can use the online editor without login: https://typst.app/play/
reply
tombert
1 day ago
[-]
I have never really used the web thing personally. I always use the command line version, and it works perfectly fine and it's FOSS.

I find the syntax to Typst to be generally better than LaTeX. I don't like its equations as much, but Typst has one huge advantage that makes it easier to forgive its faults: it compiles several orders of magnitude faster than LaTeX. This might not sound like much but it honestly sort of changes how you even think about problems. I keep Neovim open on the left, run `typst watch` in the background, and Evince on the right, and my updates show up immediately upon saving.

Also, adding plugins and libraries is trivial. All you have to do is declare it at the top of the file and it will automatically fetch it, which is considerably easier than LaTeX.

I don't like the default font it ships with, but it's easy enough to add a Latin Modern font and get something that looks like LaTeX.

Before Typst, I had typically been using Pandoc with Markdown to write my documents, and that served me well for quite awhile, but it had the disadvantage of being extremely slow to compile. A slide deck that I gave last year [1] would take a bit more than a minute to compile. This became an issue because I had to make a few small last-minute changes and having to wait an entire minute to view them actually made it so I was really pushing against the wire.

If I had done my slides in Typst, they would have compiled in about 40 milliseconds, they wouldn't have looked any worse, and I'd have a syntax not dissimilar to Markdown. I'm pretty much a convert at this point.

[1] https://git.sr.ht/~tombert/lambda_days_2025

reply
ted_dunning
1 day ago
[-]
No. Typst is an open source application.

There is a very prominent web site that offers a hosted version without much clarity about the fact that you can run it yourself. The hosted version offers collaborative editing similar to what Overleaf provides which is incredibly useful.

See https://github.com/typst/typst for the CLI version

There is a page with pre-compiled binaries as well and on Macs, you can install using homebrew.

reply
_flux
1 day ago
[-]
The financial aspect of the project is the service they sell, core is open: https://github.com/typst/typst

What the core lacks is the web service that offers e.g. collaborative editing.

reply
quantummagic
1 day ago
[-]
Typst is an application you can use on your local machine without any signup. The compiler is hosted on GitHub. The Typst web app (the online editor at typst.app) is closed source and offered as a paid with cloud storage, collaboration, autocomplete, etc...
reply
kzrdude
1 day ago
[-]
You can start using typst by installing it using rust tooling (that's one way to install it): `cargo install typst-cli`

Or install it using vscode's extensions, or install it for neovim using mason. That's a few commonly used distribution paths.

reply
__mharrison__
21 hours ago
[-]
I know it would be easier in typst than using this library... Ducks.
reply
asimeqi
1 day ago
[-]
The best coffee stains by far are created directly in Postscript.
reply
ahazred8ta
1 day ago
[-]
Hanno's original coffee ring page from 2009. https://web.archive.org/web/20100719202509/http://hanno-rein...
reply
ihaveajob
1 day ago
[-]
I'd say the best ones are created by coffee...
reply
jbrnh
1 day ago
[-]
There was the GIMP Coffee stain filter (though it looks like it is not included in Gimp 3). https://docs.gimp.org/2.10/en/script-fu-coffee-stain.html
reply
mrichman
1 day ago
[-]
I came here to say this! I switched to Typst a couple of months ago and won't be going back.
reply
Rygian
1 day ago
[-]
Feature request: even/odd page stains that line up exactly as a single thru-stain.
reply
aDyslecticCrow
1 day ago
[-]
slightly fading for each page.
reply
blitzar
1 day ago
[-]
Page reordering for the inevitable large scale spill and hurried cleanup.
reply
pdpi
1 day ago
[-]
Everybody knows that coffee stains are the only surefire way to tell whether a paper has been read or just printed out and ignored. A colleague in uni (way back in early 00s) would add these to her documents every once in a while to give them the "has been read" stamp of approval.
reply
cossatot
1 day ago
[-]
And wine glass stains are the only way to know your paper has been graded.
reply
pwagland
1 day ago
[-]
And tear stains, or the lack thereof, are the only sure sign of quality.
reply
Drunk_Engineer
1 day ago
[-]
reply
TwoFx
1 day ago
[-]
Maybe I'm just missing the joke, but it feels worth pointing out that almost all of the logos on that page are clearly inspired by the ensō circle from Zen art.
reply
amelius
1 day ago
[-]
Putting a circle around your logo is about as silly as putting a horizontal line under your signature.
reply
ravila4
1 day ago
[-]
This looks nice, but it is just placing some pre-defined vector files. I wonder if it could be possible to procedurally generate realistic coffee stains.
reply
ted_dunning
1 day ago
[-]
Absolutely!

Go for it!

reply
lelandfe
1 day ago
[-]
reply
Vicinity9635
23 hours ago
[-]
Love this. My resume has been in LaTeX for over 20 years now.

Underappreciated IMHO. You can version control it, no dealing with wild Word shenanigans. Totally deterministic. Just find a style, insert your bullets and you have a nice sharable PDF.

Nowadays you can even have your preferred LLM do the conversion for you. LaTeX is finicky and I've had it fix warnings in mine that I couldn't be bothered to.

Good stuff, highly recommend a LaTeX resume, whether or not you drink coffee.

reply
Nitrolo
13 hours ago
[-]
Any particular template you'd recommend? My resume is LaTeX too but I'm not 100% happy with it (about 98% happy and much happier than with anything else however).
reply
Vicinity9635
12 hours ago
[-]
I can't find the one I used now. But I just searched "latex resume template" and picked one that I liked. Some good ones at https://www.overleaf.com/gallery/tagged/cv
reply
benttoothpaste
11 hours ago
[-]
Totally agree! I'm adding the coffee stains to my resume as we speak.
reply
jprezant
9 hours ago
[-]
This is a good read for similar "fun" packages: https://tex.stackexchange.com/questions/67656/are-there-othe....
reply
kubb
1 day ago
[-]
Not drinking coffee is the only reason I’ve ever felt truly excluded at a software company. Everyone loves their coffee!
reply
nitnelave
1 day ago
[-]
You need to go all-in on tea and make your own mark. Get a fancy Chinese teapot with holes in the spout to use loose leaf tea, and start getting snobby about traditional vs modern techniques of Pu'er tea, and you'll get your own brand of respect!
reply
bombcar
1 day ago
[-]
I'm in the same boat; I can pretend with tea but it's not really the same experience.

Diet soda sometimes works, but often isn't provided as easily.

reply
pureagave
1 day ago
[-]
This is wonderful to see. I was a student and then entered into the tech industry in the mid 90's and at that time the Internet had fun whimsical things like this almost weekly.
reply
mcswell
1 day ago
[-]
Obviously this was whimsical when it came out. However...we were creating synthetic data for training and testing OCR in multiple scripts. We would take a web page in some language with a non-Roman script, and reproduce it as multiple PDFs using different fonts. We also added various kinds of blurring, using ImageMagick and---of course---this very coffee stains program!
reply
zippyman55
1 day ago
[-]
This looks like the old Lucent Technologies corporate logo. This would have been handy back in the day.
reply
SanjayMehta
1 day ago
[-]
Dogbert's "Brown ring of quality."

Good times.

reply
notorandit
14 hours ago
[-]
Half done job or just a starting point! We need also:

* tea strains

* bread crumbles (squashed among paper leaves)

* tomato sauce drops

* hair

> A lot of time can be saved by printing [extra stuff] directly on the page rather than adding them manually!

reply
Schlagbohrer
13 hours ago
[-]
And a squashed fly every thousand pages or so
reply
bmenrigh
1 day ago
[-]
I'm happy this is public domain. In 2023 I used the stain images as the basis for a CTF challenge (for BSidesSF). The encoded flag given to participants was https://github.com/BSidesSF/ctf-2023-release/blob/main/alien...

Unfortunately the challenge was a bit too hard and went unsolved during the competition.

reply
hughw
1 day ago
[-]
It's hard to imagine a reason for it being kept... proprietary?
reply
bmenrigh
1 day ago
[-]
A lot of people want to slap licenses on things without really thinking about what the license will do (or prevent), in practice.

I like the author's note about the license: "As we do not believe in imaginary property, this package belongs to the public domain."

I think it's much more common to see a Creative Commons license on this sort of thing.

reply
viraptor
1 day ago
[-]
And even then, when people have good intentions they don't anyways know about edge cases. Please give things a licence in addition to placing it in public domain, because in some countries (like Australia) you can't release your rights that way.
reply
deckar01
1 day ago
[-]
Coffee stains should look like water color paints. The fluid deposits pigment more at dry boundaries as evaporation and absorption approach equilibrium.
reply
velcrovan
1 day ago
[-]
Reminds me of Windows 3.11 programs that would add random "coffee stains" to your "desktop" "wallpaper"
reply
kkkqkqkqkqlqlql
1 day ago
[-]
Finally, I can drink my yerba mate and not be dismissed as a researcher.
reply
anishgupta
22 hours ago
[-]
Here we go, trying to feel authenticity in our new world. Mistakes are beautiful
reply
arunc
1 day ago
[-]
To save our children in the academia, we need a "Rewrite In Typst" movement, the equivalent of rewrite in rust!
reply
sieste
1 day ago
[-]
If only they had stuck with latex maths syntax instead of inventing their own, I would have switched ages ago and encouraged others to do the same...
reply
kzrdude
1 day ago
[-]
math without infernal backslashes is one of the reasons I love Typst
reply
xigoi
1 day ago
[-]
What’s the point of switching if you’re going to leave in the worst part?
reply
tcfhgj
1 day ago
[-]
maybe someone will write a package for latex math
reply
TRiG_Ireland
1 day ago
[-]
reply
aragilar
14 hours ago
[-]
Does it support amsmath?
reply
TRiG_Ireland
7 hours ago
[-]
I think so, but I'm no expert in typesetting mathematics.
reply
iberator
15 hours ago
[-]
Nearly all academia uses MS-OFFICE instead of TeX insanity. Only hardcore phds use it really
reply
auguzanellato
1 day ago
[-]
There’s a bit of resistance sadly. My supervisor is “forcing” me to use LaTeX for my MSc thesis sadly.
reply
TeamDman
7 hours ago
[-]
See also: using Mathematica for drawing the circles like in the movie Arrival

https://youtu.be/r8nTifCIr0c

reply
ChrisArchitect
1 day ago
[-]
(2021) Some previous discussion: https://news.ycombinator.com/item?id=39316193
reply
drob518
1 day ago
[-]
My life is complete. I can die happy.
reply
random_duck
17 hours ago
[-]
LaTex is complete it can die happy.
reply
random_duck
17 hours ago
[-]
(This is a joke, please transfer LaTex's consciousness into a computer so it can live forever = w = )
reply
Seattle3503
1 day ago
[-]
I think it would be cool to see a version for epub 3.3, which is mostly html/xhtml with some limitations
reply
tuhgdetzhh
1 day ago
[-]
"This page was intentionally left blank" is also an all time favorite of mine.
reply
hanche
1 day ago
[-]
There’s an old story about that. Possibly apocryphal, but here goes:

IBM mainframes used to come with documentation in ring binders. Some pages might indeed be marked “This page intentionally blank”. And they would from time to time send out update packages to their customers, with instructions to replace pages so-and-so with the included replacements. On the replacement pages, text that had been altered would be marked with a change bar in the margin.

Lo and behold, one day an update package was received, replacing one completely blank page with one bearing the text “This page intentionally blank”. Complete with a change bar in the margin.

reply
jpfromlondon
16 hours ago
[-]
as amazing as these are, they do still look a little fecal.
reply
Zigurd
1 day ago
[-]
Brilliant! And people say Lucent overpaid for their logo.
reply
conformist
1 day ago
[-]
Another essential package is realhats (replace boring \hat with real hats)!

https://github.com/mscroggs/realhats

reply
aaronblohowiak
1 day ago
[-]
Interesting way to apply a water mark
reply
alansaber
1 day ago
[-]
Coffee mark*
reply
kasane_teto
1 day ago
[-]
How nice.
reply
dcuthbertson
1 day ago
[-]
Now I want a package to add blood stains on my murder mystery screenplay.
reply