This repository is the source location for the IIIF 3.0 recipes. The aim is to show how to model various use cases in workable IIIF presentation assets.
Please see the Cookbook Process.
There are some includes that are helpful to ensure a consistent style between recipes. These include:
This provides a standard link to the JSON and also to viewers. A full example is as follows:
{% include manifest_links.html viewers="UV, Mirador, Tify, Curation" manifest="manifest.json" %}
and this would produce the following line:
JSON-LD | View in Universal Viewer | View in Mirador | View in Tify | View in IIIF Curation Viewer
The manifest parameter allows you to pass a relative link to the manifest and the viewers parameter is a list of Viewer links to show. Delete any viewers that don't support the recipe and remove the viewers parameter entirely if no viewers support the recipe.
This will embed a JavaScript JSON viewer which will show line numbers and format the JSON. A basic example is as follows:
{% include jsonviewer.html src="manifest.json" %}
Where src is the relative path to the JSON file. It is also possible to add a config parameter if you would like to customise the view further. An example of this is to highlight the first 5 lines:
{% include jsonviewer.html src="manifest.json" config='data-line="1-4"' %}
See the prism.js website for a full list of configuration options.
To make the process of making the manifests resolvable during all stages of the deployment (local, test and preview deployment) there are a number of Jekyll variables available for use in JSON files. These include:
id.url- the current resolvable URL for this resource e.g. https://preview.iiif.io/cookbook/master/recipe/0001-mvm-image/manifest.jsonid.path- the URL to the current directory of the file e.g. https://preview.iiif.io/cookbook/master/recipe/0001-mvm-image/. This can be useful for linking to annotation or collection JSON in the current directory.
For an example of these variables in practice please see:
https://github.com/IIIF/cookbook-recipes/blob/master/recipe/0001-mvm-image/manifest.json
There are a number of fixtures held centrally to help assist you in creating a recipe. This includes Audio and Video files and also a IIIF Image server. To see details of these fixtures please go to:
The cookbook site is available at:
bundle install
bundle exec jekyll serve
Then connect to http://localhost:4000/
This repository can be viewed using the following pattern:
https://preview.iiif.io/cookbook/<branch_name>/
for all branches but master. For example to see the themed version: