IiifS3
This software library is designed to be used to generate IIIF compatible images stacks and metatdata from a collection of images, and then to upload those images to Amazon S3 for static serving.
Installation
This library assumes that you have ImageMagick installed. If you need to install it, follow the instructions:
on OSX, brew install imagemagick
should be sufficient.
If you have issues with TIFF files, try
brew update
brew reinstall --with-libtiff --ignore-dependencies imagemagick
If you plan to work with PDFs, you should also have a copy of GostScript installed.
on OSX, brew install gs
Add this line to your application's Gemfile:
gem 'iiif_s3'
And then execute:
$ bundle
Or install it yourself as:
$ gem install iiif_s3
Usage
IiifS3 assumes that you have an Amazon S3 account configured for use. By default, it uses the same locations that the Amazon S3 ruby library searches:
ENV['AWS_ACCESS_KEY_ID'] and ENV['AWS_SECRET_ACCESS_KEY'] The shared credentials ini file at ~/.aws/credentials (more information) From an instance profile when running on EC2. The SDK also searches the following locations for a region: ENV['AWS_REGION']
Contributing
- Fork it ( https://github.com/cmoa/iiif_s3/fork )
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create a new Pull Request