LaTeX Coffee Stains (2021) [pdf]

(ctan.math.illinois.edu)

388 points | by zahrevsky 3 days ago ago

97 comments

  • spudlyo 3 days ago 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 3 days ago 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 2 days ago ago

        Surely coffeescript would have been more appropriate?

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

      • anu7df 3 days ago ago

        Does coffee accelerate rusting?

      • tristanlukens 2 days ago ago

        Blazingly fast papers!

      • 3 days ago ago
        [deleted]
      • throwaway17_17 2 days ago 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 2 days ago ago

          You might like what people have cooked up with Racket.

    • fourthark 3 days ago ago

      Thankfully there is a Typst port of this package!

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

      • philistine 3 days ago 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 3 days ago 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 2 days ago 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 2 days ago 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 2 days ago 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 2 days ago 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 2 days ago 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 2 days ago 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 2 days ago ago

        > two splashes with light colours

        Blood. That's blood.

    • alexitosrv 3 days ago 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 3 days ago 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.

      • ted_dunning 3 days ago 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.

      • tombert 2 days ago 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

      • _flux 3 days ago 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 3 days ago 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 3 days ago 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.

    • asimeqi 3 days ago ago

      The best coffee stains by far are created directly in Postscript.

    • __mharrison__ 2 days ago ago

      I know it would be easier in typst than using this library... Ducks.

    • mrichman 3 days ago ago

      I came here to say this! I switched to Typst a couple of months ago and won't be going back.

  • Rygian 3 days ago ago

    Feature request: even/odd page stains that line up exactly as a single thru-stain.

    • aDyslecticCrow 3 days ago ago

      slightly fading for each page.

      • blitzar 3 days ago ago

        Page reordering for the inevitable large scale spill and hurried cleanup.

  • pdpi 3 days ago 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 3 days ago ago

      And wine glass stains are the only way to know your paper has been graded.

      • pwagland 2 days ago ago

        And tear stains, or the lack thereof, are the only sure sign of quality.

    • tengwar2 16 hours ago ago

      Could Garibaldi read Narn?

  • Drunk_Engineer 3 days ago ago
    • TwoFx 3 days ago 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 2 days ago ago

      Putting a circle around your logo is about as silly as putting a horizontal line under your signature.

  • ravila4 3 days ago 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 2 days ago ago
  • Vicinity9635 2 days ago 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 2 days ago 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 2 days ago ago

      Totally agree! I'm adding the coffee stains to my resume as we speak.

  • ChrisArchitect 3 days ago ago

    (2021) Some previous discussion: https://news.ycombinator.com/item?id=39316193

  • kubb 3 days ago ago

    Not drinking coffee is the only reason I’ve ever felt truly excluded at a software company. Everyone loves their coffee!

    • bombcar 3 days ago 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.

    • nitnelave 2 days ago 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!

  • zippyman55 3 days ago ago

    This looks like the old Lucent Technologies corporate logo. This would have been handy back in the day.

    • SanjayMehta 3 days ago ago

      Dogbert's "Brown ring of quality."

      Good times.

  • pureagave 3 days ago 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 3 days ago 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!

  • jprezant 2 days ago ago

    This is a good read for similar "fun" packages: https://tex.stackexchange.com/questions/67656/are-there-othe....

  • bmenrigh 3 days ago 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 3 days ago ago

      It's hard to imagine a reason for it being kept... proprietary?

      • bmenrigh 3 days ago 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 3 days ago 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 3 days ago ago

    Coffee stains should look like water color paints. The fluid deposits pigment more at dry boundaries as evaporation and absorption approach equilibrium.

  • velcrovan 3 days ago ago

    Reminds me of Windows 3.11 programs that would add random "coffee stains" to your "desktop" "wallpaper"

  • notorandit 2 days ago 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!

  • 2 days ago ago
    [deleted]
  • kkkqkqkqkqlqlql 3 days ago ago

    Finally, I can drink my yerba mate and not be dismissed as a researcher.

  • arunc 3 days ago ago

    To save our children in the academia, we need a "Rewrite In Typst" movement, the equivalent of rewrite in rust!

    • sieste 3 days ago 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...

      • kzrdude 2 days ago ago

        math without infernal backslashes is one of the reasons I love Typst

      • xigoi 2 days ago ago

        What’s the point of switching if you’re going to leave in the worst part?

      • tcfhgj 3 days ago ago

        maybe someone will write a package for latex math

        • TRiG_Ireland 2 days ago ago
          • aragilar 2 days ago ago

            Does it support amsmath?

            • TRiG_Ireland 2 days ago ago

              I think so, but I'm no expert in typesetting mathematics.

              • aragilar a day ago ago

                That's not exactly encouraging... My biggest gripe with typst is the various design choices which make writing maths much harder than LaTeX (and given many of the issues with LaTeX usability come from having to use poorly maintained legacy packages, not having basic functionality in the core of the replacement seems naive at best).

    • iberator 2 days ago ago

      Nearly all academia uses MS-OFFICE instead of TeX insanity. Only hardcore phds use it really

    • auguzanellato 2 days ago ago

      There’s a bit of resistance sadly. My supervisor is “forcing” me to use LaTeX for my MSc thesis sadly.

  • Seattle3503 3 days ago ago

    I think it would be cool to see a version for epub 3.3, which is mostly html/xhtml with some limitations

  • drob518 3 days ago ago

    My life is complete. I can die happy.

    • random_duck 2 days ago ago

      LaTex is complete it can die happy.

      • random_duck 2 days ago ago

        (This is a joke, please transfer LaTex's consciousness into a computer so it can live forever = w = )

  • anishgupta 2 days ago ago

    Here we go, trying to feel authenticity in our new world. Mistakes are beautiful

  • tuhgdetzhh 3 days ago ago

    "This page was intentionally left blank" is also an all time favorite of mine.

    • hanche 2 days ago 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 3 days ago ago

    Brilliant! And people say Lucent overpaid for their logo.

  • conformist 2 days ago ago

    Another essential package is realhats (replace boring \hat with real hats)!

    https://github.com/mscroggs/realhats

  • aaronblohowiak 3 days ago ago

    Interesting way to apply a water mark

  • jpfromlondon 2 days ago ago

    as amazing as these are, they do still look a little fecal.

  • TeamDman 2 days ago ago

    See also: using Mathematica for drawing the circles like in the movie Arrival

    https://youtu.be/r8nTifCIr0c

  • kasane_teto 3 days ago ago

    How nice.

  • dcuthbertson 2 days ago ago

    Now I want a package to add blood stains on my murder mystery screenplay.

  • 3 days ago ago
    [deleted]