Hi,

I think this is what you're looking for:

(pdf
  [{:footer{:text "page"
           :footer-separator " of "}
    :pages true}
  [:paragraph
   "hello"]]
  "pages.pdf")

The above produces a footer that reads page 1 of x.

right!
would I still be able to have a "regular" footer while doing it this way?
or those two are mutually exclusive?
apologies if my questions are trivial... just a newbie :)

It's one or the other. This way you can make a fancier footer that should do everything the regular footer does.

so how can i make a footer that is more than one line while still customizing the page number?
is there another key that could be used?

just figured a workaround... you can use both :table and :text
so a table with just a single column will do the trick... it's not pretty but it works :)

totally off-topic
but still related:
is it possible to use collate to merge a couple of pdfs,
and add the page numbering footer, that does count the total page and current page number?
that is on the overall resulting merged document.

Ah yeah a footer table is the way to go there. Regarding collating, I don't think there's a way to do that currently. It might be possible to provide page numbering as part of the API, so then you could generate both PDFs, collate them, and add page numbers after.

yeah,
in the same that you could add watermark when generating a pdf,
we should be able to add a layer on top of two or more pdfs merged into a single document, to put in page numbers.

Watermarks are already supported, so it could be a similar hook to that. There's a callback when each page is generated, and it could be exposed for an arbitrary function to post process the page.

I don't think I'll have time to look at this in the near future, but if you'd be up for making a pr I can help with that.