Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Bursts a PDF into single page files.
Ruby
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
bin
lib
spec
.gitignore
CHANGELOG.md
Gemfile
LICENSE
README.md
Rakefile
pdf-burst.gemspec

README.md

PDF::Burst

What?

PDF::Burst is a gem that lets you split a PDF document with several pages into single page files.

Why?

We needed this functionality for the development of Lehtilompakko, and did not want any Java app to do the job.

How?

Simple! Once you install the 'pdf-burst' gem, all you need is:

require 'pdf-burst'
PDF::Burst.new("/path/to/my/document.pdf").run!

By default, the PDF files will be output to your current working directory. But that's not what you want, is it?

PDF::Burst.new("document.pdf", :output => "/tmp").run!

Better, huh?

Another default is the page name. They'll all be nicely named like "page_1.pdf", "page_2.pdf". We let you change that too:

PDF::Burst.new("document.pdf", :filename => "doc.%04d").run!

Would output them like this: "doc.0001.pdf", "doc.0002.pdf", etc.

If you want thumbnails to be generated for each page, just use the thumbnail option with the thumbnail size.

PDF::Burst.new("document.pdf", :thumbnail => "128x128").run!

This requires ImageMagick to be installed, as it uses the 'convert' command.

Special thanks

Thanks to Hopeinen Norsu for letting us release this as open-source.

License

Check the LICENSE file. It's the MIT license.

Something went wrong with that request. Please try again.