Hi @ltenzil ,

CombinePDF was designed as a "Hacking" tool rather than an Authoring tool, as a response to Prawn dropping their template support.

My original need was simple, I needed to add cover pages and numbering to existing PDF files (and sometimes stamp an overlay over every page).

I'm happy to see the library grow ad support more features. Merging outlines was one of these features.

Hoever, authoring an outline from scratch wasn't something I considered before.

I will be happy to add this feature to upcoming releases, but it will be a while before I can relearn this part of the design and implement something that makes sense and allows for "trees" rather than just a single flat outline (if someone authors a PR, that would be great).

I'm leaving this question open as a reminder to implement this feature and as an invitation for possible contributors.

Until that day, it's possible for anyone to "Hack" an outline without any help from a helper API.

It isn't as easy without an API, but it should be possible to link a page object to an outline by analyzing an existing outline and following the same pattern. The page will (probably) be linked using a small Hash object {is_reference_only: true, referenced_object: page}.

Other options (such as location inside the page) might be harder to reproduce without some trial and error.

Good Luck!
B.