LaTeX Coffee Stains (2021) [pdf]

(math.illinois.edu)

379 points | by zahrevsky 1 day ago

31 comments

  • 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.

    • 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.
      • vlod 52 minutes ago
        Surely coffeescript would have been more appropriate?

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

      • anu7df 1 day ago
        Does coffee accelerate rusting?
      • tristanlukens 11 hours ago
        Blazingly fast papers!
      • throwaway17_17 17 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.
        • eru 15 hours ago
          You might like what people have cooked up with Racket.
    • fourthark 1 day ago
      Thankfully there is a Typst port of this package!

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

      • philistine 23 hours 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.
        • doerig 23 hours 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"))
          • philistine 20 hours 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.
            • tcfhgj 20 hours 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?

              • antonvs 18 hours 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).
                • philistine 15 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.
                  • kzrdude 8 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.

                • mr_mitm 12 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.
      • widforss 13 hours ago
        > two splashes with light colours

        Blood. That's blood.

    • 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?
      • 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.

      • tombert 20 hours 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

      • 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.

      • _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.

      • 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...
      • 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.

    • __mharrison__ 15 hours ago
      I know it would be easier in typst than using this library... Ducks.
    • asimeqi 1 day ago
      The best coffee stains by far are created directly in Postscript.
    • 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.
  • Rygian 1 day ago
    Feature request: even/odd page stains that line up exactly as a single thru-stain.
    • aDyslecticCrow 1 day ago
      slightly fading for each page.
      • blitzar 1 day ago
        Page reordering for the inevitable large scale spill and hurried cleanup.
  • 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.
    • cossatot 1 day ago
      And wine glass stains are the only way to know your paper has been graded.
      • pwagland 21 hours ago
        And tear stains, or the lack thereof, are the only sure sign of quality.
  • Drunk_Engineer 1 day ago
    • TwoFx 23 hours 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.
    • amelius 20 hours ago
      Putting a circle around your logo is about as silly as putting a horizontal line under your signature.
  • 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.
  • lelandfe 20 hours ago
  • jprezant 2 hours ago
    This is a good read for similar "fun" packages: https://tex.stackexchange.com/questions/67656/are-there-othe....
  • TeamDman 41 minutes ago
    See also: using Mathematica for drawing the circles like in the movie Arrival

    https://youtu.be/r8nTifCIr0c

  • Vicinity9635 17 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.

    • Nitrolo 7 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).
    • benttoothpaste 5 hours ago
      Totally agree! I'm adding the coffee stains to my resume as we speak.
  • 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!
    • nitnelave 22 hours 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!
    • 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.

  • 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.
    • 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!
  • zippyman55 1 day ago
    This looks like the old Lucent Technologies corporate logo. This would have been handy back in the day.
    • SanjayMehta 1 day ago
      Dogbert's "Brown ring of quality."

      Good times.

  • notorandit 8 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!

    • Schlagbohrer 7 hours ago
      And a squashed fly every thousand pages or so
  • 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.

    • hughw 1 day ago
      It's hard to imagine a reason for it being kept... proprietary?
      • 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.

        • 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.
  • 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.
  • velcrovan 1 day ago
    Reminds me of Windows 3.11 programs that would add random "coffee stains" to your "desktop" "wallpaper"
  • kkkqkqkqkqlqlql 1 day ago
    Finally, I can drink my yerba mate and not be dismissed as a researcher.
  • anishgupta 16 hours ago
    Here we go, trying to feel authenticity in our new world. Mistakes are beautiful
  • arunc 1 day ago
    To save our children in the academia, we need a "Rewrite In Typst" movement, the equivalent of rewrite in rust!
    • sieste 23 hours 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...
    • iberator 8 hours ago
      Nearly all academia uses MS-OFFICE instead of TeX insanity. Only hardcore phds use it really
    • auguzanellato 22 hours ago
      There’s a bit of resistance sadly. My supervisor is “forcing” me to use LaTeX for my MSc thesis sadly.
  • ChrisArchitect 1 day ago
    (2021) Some previous discussion: https://news.ycombinator.com/item?id=39316193
  • drob518 1 day ago
    My life is complete. I can die happy.
    • random_duck 10 hours ago
      LaTex is complete it can die happy.
      • random_duck 10 hours ago
        (This is a joke, please transfer LaTex's consciousness into a computer so it can live forever = w = )
  • 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
  • jpfromlondon 9 hours ago
    as amazing as these are, they do still look a little fecal.
  • tuhgdetzhh 1 day ago
    "This page was intentionally left blank" is also an all time favorite of mine.
    • hanche 21 hours 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.

  • Zigurd 1 day ago
    Brilliant! And people say Lucent overpaid for their logo.
  • conformist 20 hours ago
    Another essential package is realhats (replace boring \hat with real hats)!

    https://github.com/mscroggs/realhats

  • aaronblohowiak 1 day ago
    Interesting way to apply a water mark
  • kasane_teto 1 day ago
    How nice.
  • dcuthbertson 18 hours ago
    Now I want a package to add blood stains on my murder mystery screenplay.