Gribouille 0.3.0: A Grammar of Graphics for Typst

(mickael.canouil.fr)

183 points | by mcanouil 4 days ago ago

67 comments

  • NiloCK 2 hours ago ago

    Is typst a good tool for something like a flyer (eg, printable respecting fold lines) or more generically one-page posters?

    I see PDF as a blessed output, but it seems mostly in context of longer form typesetting-heavy workflows (books, papers), rather than design-heavy.

    • flexagoon 15 minutes ago ago

      Depends on what the poster is. If it's still mostly text content, just arranged in a certain way, then by all means you can. For example:

      https://typst.app/universe/package/poster-syndrome

      And here's one for foldable cards:

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

      (Not endorsing those specific packages, they're just the first ones I managed to find)

      For more free-form layouts, I just use Inkscape. It has built-in PDF export which works great. I assume other similar tools like Figma or Illustrator would also work well.

    • ink_13 2 hours ago ago

      Probably not. As you point out, it's a typesetting tool like LaTeX, not a page layout tool.

      You could probably write a template that does the right thing, but that's true of LaTeX as well.

  • matijsvzuijlen 11 hours ago ago

    Why are all the parameters full words except 'labs'? I find it jarring because to me 'lab' is short for laboratory, not label.

    • nxobject 7 hours ago ago

      I suspect for consistency with ggplot - the same reason why ‘aes’ is shorthand and everyone forgets that it stands for “aesthetic”.

      https://ggplot2.tidyverse.org/reference/labs.html

      • matijsvzuijlen 7 hours ago ago

        Thanks, that makes sense. I actually just parsed aes as related to encryption without even considering how weird that was given the contect.

        • nxobject 2 hours ago ago

          I get it – in my (limited) opinion, there's a lot that's quirkily (but avoidably) named about ggplot and the surrounding R ecosystem in general.

    • bestouff 10 hours ago ago

      He's open to API suggestions, you should open an issue

  • KolmogorovComp 31 minutes ago ago

    I actually think that with LLM we may very well hit a plateau in innovation here, because now the ugly syntax is not a hurdle anymore, since you don’t write it anymore by hand.

  • red_admiral 8 hours ago ago

    Always pleased to see Typst mentioned. TeX made a lot of choices that made sense at the time, but TeX macros and C #defines especially when nested and/or not properly bracketed to allow nesting are a mess when things go wrong.

    • kzrdude 41 minutes ago ago

      It is fun how in computer science terms, TeX and Typst are so incredibly far apart. TeX is a macro language that could be implemented in very little memory, while Typst literally memoizes every typst function's result; to the point where it will eat all available memory if the document and its editing increments needs it.

      This reflects the time in which they were developed.

    • flerovium114 7 hours ago ago

      In what setting are you mixing LaTeX and C code?

      • red_admiral 7 hours ago ago

        No, no, TeX macros nested within other TeX macros.

  • stared 8 hours ago ago

    Interesting! If I get it right, the API is in the spirit of Observable Plot (https://observablehq.com/plot/), less ggplot2.

    In any case, I'm curious whether aes is necessary, or whether it would suffice to drop this function entirely and just use keys in the mapping (similarly for labs). Or, more broadly, whether using patterns from other implementations of the Grammar of Graphics is a conscious decision, or some sort of legacy baggage.

  • spider-mario 10 hours ago ago

    What’s with the slanted figures until you hover over them?

  • jeremyscanvic 4 hours ago ago

    Is ggplot2 considered to be a nice interface to plot things compared to say matplotlib in Python? I'm asking out of curiosity, I haven't touched R much

    • stdbrouw 4 hours ago ago

      Yes, ggplot2 is lovely to work with for complex graphs. Whereas a classic plotting library will have one function to create a bar graph, another to create a line graph, etc., in ggplot instead you can stack layers, each with different properties, variables, shapes, data-dependent colors, scales, whatever you want. It also makes it easy to create grids of similar graphs.

    • mightyham an hour ago ago

      I find matplotlib to be clunky and verbose compared to ggplot. When using python, I will often use https://plotnine.org/ because it gives me a nice ggplot like API.

    • Arodex 2 hours ago ago

      The "grammar of graphics" conceptualized in ggplot is a very cohesive way to make (I think almost) any kind of graph, while remaining a high-level language/DSL.

  • elsoja 6 hours ago ago

    It seems to be fully written in native Typst, without any WASM backend. I wonder how is the performance like for complex plots or for documents with a large number of figures.

  • unrealhoang 13 hours ago ago

    This is awesome, is there a way to render the graphics/chart in svg so that we can implement something like hover & popup (with data information)?

    • alhidade 11 hours ago ago

      Typst supports SVG output natively.

      • red_admiral 8 hours ago ago

        From past experience (may be different now): Typst supports SVGs that are actually vanilla SVGs. The SVG standard lets you embed a HTML page and CSS as a <foreignObject>, which only renders properly in a browser or something that bundles one (surprise!). This is not the fault of Typst and I think Typst is correct not to go down that route.

        Just a heads up if you wonder why draw.io (diagrams.net) SVGs display as black boxes.

  • adamnemecek 12 hours ago ago

    Typst is the most important open source project of the last 5 years.

    I predict a future where markdown and latex are largely replaced by typst. And I couldn't be more excited.

    It is such a stepup from markdown and latex. Try it today if you are intrigued.

    • eikenberry 22 minutes ago ago

      How is it an step-up from markdown? Markdown (w/o any embedded html) is a simple text formatting that lets you read it as a plain text file with some minor formatting when rendered. Typst source files are not human readable in the same way and would be terrible at it. Typst is great when you need typesetting, but if you just want plain text, readable files it isn't it. E.g. markdown for notes, typst for papers.

    • cryo32 7 hours ago ago

      Not so sure.

      I work with a lot of people in academia who work with LaTeX. I haven't met anyone who knows Typst even exists. And the source material is usually just thrown in Word or LibreOffice.

      The problem is also momentum. Do you rewrite 30 years' of CTAN contributions, internal templates/styles and the toolchain off and start again or not? There's not much reason to. And you will hit the same brick walls doing so that you hit with TeX the first time round.

      If it is a greenfield, possibly, but all the orgs I've seen using LaTeX have been using TeX since the dawn of time and respect the accumulated knowledge rather than the distraction of a new tool.

      • k2enemy 4 hours ago ago

        I'm in academia and used to use LaTeX for everything, and have switched almost 100% to typst. Not many of my colleagues are aware of typst but a few use it.

        I think there is hope though. Grad students are slowly picking it up, and they are the future of academia. I've seen similar transitions away from Fortran and Matlab as grad students embrace different tools than what their advisors use.

      • lkm0 7 hours ago ago

        > accumulated knowledge

        my experience is the opposite. Due to LaTeX's arcane scripting and the lack of interest people have in learning it beyond "it compiles on overleaf", I'm seeing a lot of accumulated superstition. People copying and pasting preambles with useless packages, unused newcommands. Worse, people sometimes use their group's newcommands without being aware of the native functions, e.g. \beginmymatrix replacing \begin{pmatrix}. Even if change is slow, any amount of Typst adoption is good.

        • cryo32 7 hours ago ago

          If it's any consolation we use native stuff including pmatrix :). In fact most of our typesetting is very very plain LaTeX.

      • meling 3 hours ago ago

        I’m in academia and I try to convert everyone I know… I only recently started using it for a few things, and I used Claude to do some pretty advanced stuff that I wouldn’t have ventured to even try with latex. That is, I think a lot of the relevant CTAN packages can be developed using LLMs more quickly than you might expect.

        For next year, I plan to prepare a thesis template for our university and encourage students to try it instead of latex (most of our students use latex now).

      • vatsachak 7 hours ago ago

        Academia is stuck in the past in a lot of ways.

        • cryo32 7 hours ago ago

          I prefer to think of it as mature.

      • adamnemecek 2 hours ago ago

        > I haven't met anyone who knows Typst even exists.

        It was released in 2023 and became polished enough to use like last year. Yeah, adoption takes time but the technology is significantly better.

        > The problem is also momentum. Do you rewrite 30 years' of CTAN contributions, internal templates/styles and the toolchain off and start again or not?

        With latex you have to rely on third party. With typst you can write it yourself (or with an agent), like writing functions is not painful in typst.

    • sieve 8 hours ago ago

      I like typst. But I am not a fan of the syntax. I use it as an intermediate format on the way to PDF. A document markup language should avoid building a programming language inside it. Pick python, or lua, or whatever.

    • utopiah 12 hours ago ago

      I'm not sure either matter to be honest.

      It's cool sure, powerful also... but when anybody has access to both vector-based editor and raster-based editor ... but also tools that incorporate them, e.g. rich text editors ... but also entire toolchain going from compilers to libraries all the way to Web based notebook with their editors and running environment that can then output printable artifacts, I don't think there has to be "the" way. They might be a more popular way within a certain zeitgeist but... does one project has to "replace" another one?

      I guess I don't really get the passion some people have for "perfect" rendering. I'm fine with just text, then just readible equations below it, then an OK looking graph. I don't actually care if any of those are pixel perfect. I don't get it.

      IMHO in terms of actual knowledge transmission reproducibility and interactivity are way more important. They might not look as good and in fact introduce a TON of complexity but I believe it's better than yet another system that is slightly better looking while being slightly easier, for those people with a specific mindset, to setup and use.

      PS: still both Gribouille and Typst are cool projects! Just want to make sure I'm not sounding critical against those efforts.

      • poulpy123 8 hours ago ago

        I cannot tell the future of typst and gribouille, but for:

        > I'm fine with just text, then just readible equations below it, then an OK looking graph. I don't actually care if any of those are pixel perfect. I don't get it.

        what you describe is fine for a readme or a blog post, but for books, scientific articles, or any long format, having a good layout and typography will totally impact the end result

      • zhshnsnnaaka 11 hours ago ago

        I agree but to me it seems humanity has a terminal case of being unable to separate content from presentation. I can see it in this thread with clamoring for Typst in READMEs etc. If READMEs need to be anything they need to be plain bloody text. Markdown is the absolute maximum. Having some “header semantics” defined is fine as that’s universal in a document but let’s keep it simple guys, OK?

        Information needs to be plain and clear. Presentation can be fancy. Let’s keep these very, very different things separate. AI will thank you as well.

        • practal 10 hours ago ago

          I agree with that, that's why I am starting with plain syntax first in https://zero.practal.com, because that is really where all the information/logic lives. But there will also be a presentation layer on top of that, building on the information layer, so with time, I would expect it also to subsume much latex/typst functionality. The "header semantics" I already copied from Markdown.

      • red_admiral 8 hours ago ago

        If you've ever debugged TeX package conflicts because someone wants "that layout, except with those headers and this font", yes the whole stack needs replacing with something that does not hold all its state in global variables and has a sensible scripting language (LuaTeX never really took off).

      • TRiG_Ireland 11 hours ago ago

        My primary use for Typst is pretty agendas for my Toastmasters club. https://typst.app/project/rmyyeU17y51rl6ISSqGji9

        Typesetting isn't just for science. I like that it looks good; I enjoy the creative step of experimenting with document design; and Typst is just fun to use.

      • adamnemecek 12 hours ago ago

        > It's cool sure, powerful also... but when anybody has access to both vector-based editor and raster-based editor ... but also tools that incorporate them, e.g. rich text editors ... but also entire toolchain going from compilers to libraries all the way to Web based notebook with their editors and running environment that can then output printable artifacts, I don't think there has to be "the" way. They might be a more popular way within a certain zeitgeist but... does one project has to "replace" another one?

        cool, why do you think people use tikz? And like generating images programmatically from text is impossibly more powerful than using vector editors.

    • mastermage 12 hours ago ago

      For Latex I agree thats definitely. Markdown I am unsure as Markdown is not meant for creating documents but to just have a little Richt Text Markup in READMEs and other Text files. Typst needs a compile step and altough that one is fast as hell it is still different from Markdown that renders directly from the file without an intermediary.

      • josephg 11 hours ago ago

        Right; but markdown has expanded beyond that niche. Lots of projects use markdown for other stuff - like mdbook, or for blogs.

        I think markdown is a great format for readme files. But for real documentation, the added features of typst are fantastic. Like, being able to write scripts, have figures and custom styling, populate data from JSON files, plugins, typography, numbered sections, footnotes and all sorts of other stuff. Markdown doesn't even support comments properly!

        I want typst for blogging, long form articles and documentation. Markdown is great for small stuff. But it doesn't scale.

        • mastermage 11 hours ago ago

          Fascinating Ideas I love hearing opinions on this, it enriches me.

          I do belive that atleast simple files like for example READMEs will stay and perhaps are better to stay as Markdown. One advantage that has is that while scripting is cool, It make the document not plain text readable which is a tradeoff one can argue.

        • applicative 9 hours ago ago

          Ordinary markdowns have had /everything/ you mention for close to 20 years, except typesetting. Academic papers and books, novels, thousands of ebooks, have been written in single file markdowns for 15 years.

          Writing directly in typst is good for small things with intense typesetting like ... wedding invitations, advertisements. But it doesn't scale to serious composition by actual writers.

          Writing is not typesetting.

          All the forms need for the composition of all civilized text were present in word perfect 5.1, which unlike Word, Latex and Typst, permitted no typsetting during the process of writing. They were all recovered in the writers' markdowns nearly two decades ago.

          • cycomanic 8 hours ago ago

            I'm not sure what you mean. Markdown compared to typst or latex is extremely limited and using it for books or academic papers is very niche. I certainly would (and have for all my previous publications) prefer typst or latex over markdown. I also don't understand your point about not permitting typesetting during writing. Latex and text are the prime examples of separating writing from typesetting.

            • applicative 3 hours ago ago

              As an experiment, I recommend to you to put a markdown file into google translate and make pdf via your preferred markdown parser. Now make the corresponding typst document, put it through google translate and enjoy compilation hell.

            • applicative 4 hours ago ago

              It isn't niche. I'm an academic writer and there are thousands like me. Like all typst commentators on this site, you have literally just made something up. As for books, you could hardly be more wrong -- /thousands/ of self-published epubs on Amazon are written in absolutely nothing but markdown of one of the specialized varieties. The familiar markdown parsers know how to write out an epub. Self-publishing writers of all sorts have been principal participants of the lists for almost two decades.

              I would rather use microsoft word than write in raw typst, which is no different from trying to think in raw latex - even if in some fields it is necessary. I certainly cannot write unless I can output to docx.

              A hundred things would be completely impossible to me without a 'lifeless' text format like markdown. The inclusion of a turing complete programming language into document composition - the principal labor distinctive of advanced civilization - is obviously pure insanity, even if it is necessary in the mathematical case. What one needs are ways of introducing the exact features that e.g. wordperfect 5.1 had already completely perfected: paragraphing, sectioning, noting, emphasizing, citing, etc. These are the internal semantic features of actual expression of actual thought, things that must be preserved e.g. by a translator - as sexy typesetting need not be. Considier the question: What is that which must be preserved by a translator? It is the question: What is thought? If I am typing typsetting commands not relevant to this, I am not writing, I am not thinking, I am not constructing a reasoned argument: I am doing high quality page-scale finger painting.

              For example, I now consider it intellectual malpractice to give advanced students a translated text for close study, without also supplying the original in parallel. I can do this by simply zipping two markdown files together header to header, paragraph to paragraph with a simple script making html - the original in, say, smaller type narrower column at left margin.

              The translation can be changed or an alternative constructed or a new one produced automatically by one of the translation devices. This is an operation that is basically impossible with genuine typesetting, though each md file compiles to pdf e.g. via typst after a markdown->typst process.

              This is quite as impossible in typst as it is in latex - huge projects have been devoted to it in latex with complete failure - the necessity of pagination introduces the necessity of precise knowledge of both languages if the page break happens ... in medias sentence - such people e.g. the Loeb library used to have. With html it's a complete picnic, a literal zip operation with a markdown reader -- but of course isn't proper typsetting. The merit is that html is unpaginated. The file for each language itself makes a perfectly sound typst pdf with a keystroke.

              • harshreality 2 hours ago ago

                How are you doing meaning-aware pagination if you're zipping together markdown columns?

                A few minutes of asking an AI and writing a pair of simple typst docs with a few sections of #lorem() paragraphs resulted in what I think your ad-hoc scripting (in what language? add and your custom scripting to your collaborators' publishing stack) efforts do: a typst meta-document that pairs two simpler typst documents, section by section, paragraph by paragraph, each sub-document with its own column width and font size, paginated on paragraph breaks. You might balk at typst's embedded language, but it does avoid added dependencies and external scripting, and the language looks fairly simple a nice and functional.

                It might require a somewhat different design to accommodate a marginal-note kind of thing with irregular vertical spacing not paragraph-aligned, but I suspect that's quite possible too, probably with some markup to label notes and align them vertically with corresponding labels in the primary text.

          • Certhas 8 hours ago ago

            So LaTeX also doesn't scale to serious composition by actual writers?

            • applicative 8 hours ago ago

              If they need to do typsetting, as mathematicians in fact do. Mathematics breaks the civilized opposition of content and format, because it involves the invention of symbols on the fly. Reasoning about this is actually quite simple but the typst brigaders have no experience with the history of the topic.

              It is universal that the flood of largely automated hackernews typst brigaders cannot make a single post without flatly lying about every other existing instrument. On this site I have never read a single true statement by a typst brigader about latex or markdown, but I have read literally /hundreds/ of lies. If these accounts are real and not bots, the community is fated to die, unfortunately.

              I use typst countless times a day, but don't need to lie.

          • josephg 6 hours ago ago

            > Ordinary markdowns have had /everything/ you mention for close to 20 years, except typesetting.

            Huh? I roll to doubt. How do you do this stuff with markdown? I tried for ages but only got half-baked hacky "markdown extensions" which weren't even commonmark compliant. I've found nothing even remotely as powerful as typst in the markdown world.

            • applicative 4 hours ago ago

              I don't know, since I haven't used a form not commonmark compliant since the spec came out. Get back to me when you want to get your typst file translated or in e-reader format.

              • _flux 4 hours ago ago

                Typst html support is already available as an experimental feature, so e.g. EPUB probably isn't too much work in addition to that (as I understand it, it's basically zipped HTML with some metadata). It's also in the roadmap: https://typst.app/docs/roadmap/#:~:text=EPUB%20export .

                If the translator has access to a service like typst.app, then I don't see too many obstacles for translating. But I don't have any experience on doing translations.

        • Certhas 8 hours ago ago

          What's the state for generating websites from Typst?

      • adamnemecek 12 hours ago ago

        The problem with markdown is that it's not extensible and that there is no spec. Essentially all READMEs would be better off using typst, they would make for better READMEs.

        • sbysb 12 hours ago ago

          I do not think that is the problem with markdown lol. There are lots of problems with markdown, especially vanilla or the more limited versions of it - but really its super power is that it is readable with a regular text editor (or `cat`) and can be rendered without a compilation step.

          Markdown is not competing with latex or typst, it is competing with (and has won against) .txt files

          • Certhas 8 hours ago ago

            Actually basic typst is as readable as markdown, e.g. this is the example from the webapp:

              = The Typst Playground
            
              Welcome to the Typst Playground! This is a sandbox where you can experiment with Typst. You can type anywhere in the editor panel on the left. The preview panel to the right will update live.
              
              = Basics <basics>
              
              Typst is a _markup_ language. You use it to express not just the content, but also the structure and formatting of your document. For example, surrounding a word with underscores _emphasizes_ it with italics and starting a line with an equals sign creates a section heading.
              
              Typst has lightweight syntax like this for the most common formatting needs. Among other things, you can use it to:
              
              - *Strongly emphasize* some text
              - Refer to @basics
              - Typeset math: $a, b in { 1/2, sqrt(4 a b) }$
              
              That's just the surface though! Typst has powerful systems for scripting, styling, introspection, and more. In the realm of a Typst document, there is nothing you can't automate.
        • applicative 9 hours ago ago

          There have been theoretically precise published specs for serious markdowns for 15 years. The commonmark convention is a common specification for many including e.g the familiar simple github variant, which emphatically does have a completely perfect specification.

          • harshreality 20 minutes ago ago

            Commonmark isn't serious because it doesn't include several major quality of life improvements like [^1] for footnote/reference syntax. Pandoc should be the serious "common" markdown standard.

        • mastermage 11 hours ago ago

          As I said in a previous comment typst especialy with extending via scripting stops being plain text readable. A Markdown file (whatever flavor it may be) is still fundamentaly one vi,nano, Editor, Notepad++ away from being read with all its context included. It is a tradeoff that for READMES I would not want to make.

          • cycomanic 6 hours ago ago

            If you restrict typat to the basic functionally of markdown it is just as readable as plain text (not surprising considering that typat syntax was inspirered by markdown). However, once we include more unusual things I would argue that markdown becomes more illegible than typst (as for markdown you start adding html essentially).

        • tlarkworthy 11 hours ago ago

          Of course it's extensible, you can put HTML in it, and HTML is extensible.

          • adamnemecek 11 hours ago ago

            That is like saying "Ruby is not slow, you can write native extensions in C". No, Markdown is not extensible.

    • red_admiral 8 hours ago ago

      Markdown and Typst serve different markets - I don't need page layouts and font choices in a pull request, for example. Typst is however a good Markdown++ in that once a collection of markdown files grows to book size, it's easy enough to port.

      Typst challenging TeX would be my dream too - there's a lot of math you can port just be leaving off the backslashes. Mind you the kids these days know TeX primarily as "that language in overleaf".

    • aloisdg 6 hours ago ago

      Markdown is already seen as arcane by non technical folks. Which is sad btw.

      Typst is not going to replace it.

      That said I was not a huge latex user and nowadays I use typst a lot. Typst is everything I was expected from latex.

      The content is in markdown and loaded by typst with cmarker