Ability to change header in the middle of the document

[mattiuusitalo]

We need to add chapter name to the header. It could be useful to add something like
[:new-header ....]

which contains the new header that will be applied after that.

[mattiuusitalo]

I suppose #154 covers a bit of this. It's only that I need the Document object itself also.

So if append-to-doc would be

(defn- append-to-doc [stylesheet references font-style width height item ^Document doc ^PdfWriter pdf-writer]
  (cond
    (= [:pagebreak] item) (.newPage doc)
    (= [:clear-double-page] item) (clear-double-page stylesheet references font-style width height item doc pdf-writer)
    :else (.add doc
                (make-section
                 (assoc font-style
                        :stylesheet stylesheet
                        :references references
                        :left-margin (.leftMargin doc)
                        :right-margin (.rightMargin doc)
                        :top-margin (.topMargin doc)
                        :bottom-margin (.bottomMargin doc)
                        :page-width width
                        :page-height height
                        :doc doc
                        :pdf-writer pdf-writer)
                 (or item [:paragraph item])))))

This feature wouldn't have to be in the core but provided by the client.

[mattiuusitalo]

Actually, looks like one can access the Document from PdfWriter

[yogthos]

Yeah, you can use that hook to get to the doc. If there's an improvement for ergonomics here that would be useful I'm open to a PR as well. :)

[mattiuusitalo]

I could add some info about this extensibility feature in the README as it is a bit buried at the moment? That would promote the feature even without making a new release.

[yogthos]

That would be much appreciated. 👍