pocake / ruby_powerpoint

A PowerPont parser in Ruby.

<img src=“https://badge.fury.io/rb/ruby_powerpoint.svg” alt=“Gem Version” /> <img src=“https://ruby-gem-downloads-badge.herokuapp.com/ruby_powerpoint?type=total&total_label=downloads” alt=“Downloads” />

RubyPowerpoint – Parser for Powerpoint (pptx) files.¶ ↑

ruby_powerpoint is a Ruby gem that can extract title, content and images from Powerpoint (pptx) slides.

Installation¶ ↑

RubyPowerpoint can be used from the command line or as part of a Ruby web framework. To install the gem using terminal, run the following command:

gem install ruby_powerpoint

To use it in Rails, add this line to your Gemfile:

gem "ruby_powerpoint"

Basic Usage¶ ↑

RubyPowerpoint can parse a PowerPoint file (pptx) by extracting text and images from each slide:

require 'ruby_powerpoint'

deck = RubyPowerpoint::Presentation.new "specs/fixtures/sample.pptx"

deck.slides.each do |slide|
  slide.content # => ["Presentation Notes...", "12345"]
  slide.title # => "Prsentation Header"
  slide.images # => ["\xE3=\xA8h\x8E\x17\...."] Byte Stream
  # Saving the image byte stream to a file:
  File.open('temp.jpg', 'w'){|f| f.puts slide.images[0].read}
end

Contributing¶ ↑

Contributions are welcomed. You can fork a repository, add your code changes to the forked branch, ensure all existing unit tests pass, create new unit tests cover your new changes and finally create a pull request.

After forking and then cloning the repository locally, install Bundler and then use it to install the development gem dependencies:

gem install bundler
bundle install

Once this is complete, you should be able to run the test suite:

rake

Bug Reporting¶ ↑

Please use the Issues page to report bugs or suggest new enhancements.

License¶ ↑

RubyPowerpoint has been published under MIT License