wax:derivatives

There are two tasks namespaced under wax:derivatives, namely wax:derivatives:simple and wax:derivatives:iiif which represent the two options for generating collection image derivatives. You will only run one of these tasks per collection and you should only need to run it once.

wax:derivatives:simple

bundle exec rake wax:derivatives:simple YOUR_COLLECTION_NAME

When you run the line above for your collection, the task will:

1. Look for the directory of source images you specified in your _config.yml file under collections > YOUR_COLLECTION_NAME > images > source (See: Updating your configuration)

2. Generate two copies of each image (full size and thumbnail, with 1140px and 250px widths, respectively) into the directory img/derivatives/simple

3. Automatically add two fields (full and thumbnail) to each of your metadata records with the relative paths to the image derivatives.

(e.g., bundle exec rake wax:derivatives:simple qatar)

wax:derivatives:iiif

bundle exec rake wax:derivatives:iiif YOUR_COLLECTION_NAME

When you run the line above for your collection, the task will:

1. Look for the directory of source images you specified in your _config.yml file under collections > YOUR_COLLECTION_NAME > images > source (See: Updating your configuration)

2. Generate many IIIF derivatives, image tiles, and JSON representations of the collection items into the directory img/derivatives/iiif.

3. Automatically add three fields (full, thumbnail, and manifest) to each of your metadata records with the relative paths to the full and thumbnail size image derivatives and the IIIF manifest.

(e.g., bundle exec rake wax:derivatives:iiif qatar)

Which one should I use?

Simple derivatives

IIIF derivatives