If you're thinking of donations or sending me money - no need. You can look at the GitHub Issues Page and see the "help wanted" tags.
#Ruby pdfwriter license#
Please respect his license and copyright.
#Ruby pdfwriter install#
I wanted to install the gem, but I had issues with the internet and ended up copying the code itself into the combine_pdf_decrypt class file.Ĭredit to his wonderful is given here. Stefan Leitner wrote the outline merging code supporting PDFs which contain a ToC.Ĭaige Nichols wrote an amazing RC4 gem which I used in my code.
#Ruby pdfwriter free#
The code itself should be very straight forward, but feel free to ask whatever you want. The documentation is lacking and the comments in the code are poor guidlines. If you want to help with the code, please be aware:
There is very little support for encrypted files and very very basic and limited support for compressed files.
#Ruby pdfwriter pdf#
Some PDF files are encrypted and some are compressed (the use of filters). You can see a Demo for a "Bates stumping web-app" and read through it's code. New_pdf << CombinePDF.load(pdf_file, allow_optional_content: true)Īttachments.each PDFParser.new, CombinePDF.load and CombinePDF.parse methods: new_pdf = CombinePDF.new You can optionally pass an allow_optional_content parameter to the Raised if one of these files are detected. Some PDF files contain optional content sections which cannot always be merged reliably. If you prefer to save the PDF data to a file, you can always use the save method as we did in our earlier examples. To combine PDF files (or data): pdf = CombinePDF.new That being said, I'm using the library happily after testing against different solutions. If this library causes loss of data or burns down your house, I'm not to blame - as pointed to by the MIT license. The same applies to PDF links and the table of contents, which all have global attributes and could be corrupted or lost when combining PDF data.
However, PDF files are quite complex creatures and no guaranty is provided.įor example, PDF Forms are known to have issues and form data might be lost when attempting to combine PDFs with filled form data (also, forms are global objects, not page specific, so one should combine the whole of the PDF for any data to have any chance of being preserved). Hence, PDF files that have heavily nested objects, as well as those that where combined in a way that results in cyclic nesting, might explode the stack - resulting in an exception or program failure.ĬombinePDF is written natively in Ruby and should (presumably) work on all Ruby platforms that follow Ruby 2.0 compatibility. The CombinePDF gem runs recursive code to both parse and format the PDF files. I find it better to err on the side of caution, although for optional content PDFs an exception is avoidable using CombinePDF.load(pdf_file, allow_optional_content: true). Sometimes the CombinePDF will raise an exception even if the PDF could be parsed (i.e., when PDF optional content exists). Some encrypted PDF files (usually the ones you can't view without a password) will fail quietly instead of noisily. Some links will be lost when ripping pages out of PDF files and merging them with another PDF. Keeping this information requires merging the PDF objects rather then their pages. Some links and data (URL links and PDF "Named Destinations") are stored at the root of a PDF and they aren't linked back to from the page. You can fix this by adding content to the pages before merging the PDF files (i.e. When unifying the same TOC data more then once, one of the references will be unified with the other (meaning that if the pages look the same, both references will link to the same page instead of linking to two different pages). I couldn't fix this because this is how PDF forms work (filling a field fills in the data in any field with the same name), but frankly, I kinda liked the issue. When combining PDF Forms, form data might be unified. I tried fixing this to the best of my ability, but I'm not sure it all works just yet. When reading PDF Forms, some form data might be lost. Please hit me up if you would like to join in and eventually take over. I love this gem, but I feel it's time I took a step back from maintaining it and concentrate on my music and other things I want to develop. However, during the last three years or so I have been maintaining the project for no reason at all, except that I enjoyed sharing it with the community. I wrote this gem because I needed to solve an issue with bates-numbering existing PDF documents. I need help maintaining the CombinePDF Ruby gem. Install with ruby gems: gem install combine_pdf CombinePDF - the ruby way for merging PDF filesĬombinePDF is a nifty model, written in pure Ruby, to parse PDF files and combine (merge) them with other PDF files, watermark them or stamp them (all using the PDF file format and pure Ruby code).
0 kommentar(er)
