percollate icon indicating copy to clipboard operation
percollate copied to clipboard

Published 20 hours ago • verified publisher icon danburzo

PDF: Add a Table of Contents to the metadata

Open danburzo opened this issue 6 years ago • 9 comments

A PDF generated from many web pages would benefit from a Table of Contents, implemented as PDF bookmarks. We'll probably need to post-process the PDF with something like HummusJS to write the TOC. (Also, I'd appreciate if someone with more experience would explain whether its license is compatible with our MIT License)

Related: #25

danburzo avatar Oct 16 '18 10:10 danburzo

Thanks @danburzo for all of your hard work on this project.

I wanted to share that this library looks really promising for our use case of a CI publication pipeline that generates PDFs. We have explored leveraging html/css and converting to PDF and it gets us 80% of the way there. Other features such as page-sandboxed footnotes are also very hard to come by.

Our current biggest obstacle is just what you stated here, we are unable to generate a ToC. The libraries that do handle ToC are proprietary and typically not compatible to be distributed with our open source software.

We will be watching this project and even willing to contribute when opportunity arises. Thanks again!

klappy avatar Oct 22 '18 16:10 klappy

We may be able to have some luck with Apache PDFBox, but it's written in Java and I'm not sure yet if/how we'll be able to use it.

danburzo avatar Oct 23 '18 13:10 danburzo

I've implemented a basic TOC functionnality: https://github.com/danburzo/percollate/pull/81

Not sure that's what you had in mind, but for my use case it's gonna be usefull, hope it helps.

guybedo avatar Oct 29 '18 01:10 guybedo

Hi @guybedo, thank you for the contribution! This issue specifically refers to a PDF functionality to show an Outline in the PDF structure itself rather than a separate page in the PDF. But your addition is very welcome as well :-)

danburzo avatar Oct 30 '18 14:10 danburzo

@danburzo did you get this working? Looking to do something similar with hummusJS

larryboymi avatar Jan 25 '19 19:01 larryboymi

@larryboymi — unfortunately, no. I'm currently caught in dayjob work, and did not have a chance to explore this further. Any sort of insight / contribution on this subject is greatly appreciated!

danburzo avatar Jan 26 '19 08:01 danburzo

Thanks for responding... I think I'll try to create an example with hummus and then share with you... Was just hoping to shortcut lol

larryboymi avatar Jan 26 '19 13:01 larryboymi

I created an npm module with this functionality. Check it out and give feedback, thanks! I'll try to add some examples of how to do it in your regular flow, but the base index.js file shows the usage.

larryboymi avatar Apr 04 '19 21:04 larryboymi

Chrome 85 / puppeteer 5.2.1 you can produce tagged PDFs, and it seems an outline based on that is in the works

danburzo avatar Jul 31 '20 16:07 danburzo