Project

iiif_s3

0.01
No commit activity in last 3 years
No release in over 3 years
A generator for an IIIF level 0 compatible static server on Amazon S3.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.6
>= 0
>= 0
>= 0
>= 0
~> 0.10
>= 0

Runtime

 Project Readme

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

  1. Fork it ( https://github.com/cmoa/iiif_s3/fork )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request