This is a beta version of migrating these workshop materials to a new platform. If you run into issues please file an issue or click on the edit link above and submit a pull request. You can use the previous version of the workshop materials as a fallback.
The approach here is to pregenerate different image sizes and tiles and create an info.json
This static implementation is often called a “Level 0” Image API implementation.
You can search the IIIF Awesome list for code to create static images and tiles. If you look at the full example below you’ll see one such implementation.
Download this zip file.
Unzip the file into your “iiif-workshop” directory. (You can use whatever tool you usually use to unzip an archive.)
Explore the files in the “starfish” directory.
You can use a file browser or the command line. If you use the command line to explore you can try to run
tree starfish to see the full directory structure down to the files.
What are you finding in the directory?
Start a simple web server (if it isn’t still running) pointing at your “iiif-workshop” directory.
Now reload this workshop page and it should work in these viewers.
The info.json for this static example expects the server to be http://localhost:3000. If your web server is listening on a different port, you’ll need to change that.
If the included starfish.zip file doesn’t work you can find the original with symlinks in this repository: https://github.com/zimeon/iiif/tree/master/demo-static/starfish
Try zooming in for it to work in Leaflet:
Skip this section and go to the next if you have the above version working.
Example of static image server: https://github.com/zimeon/iiif/tree/master/demo-static
In a terminal type in the following:
git clone email@example.com:zimeon/iiif.git iiif-python cd iiif-python/demo-static
If you have Python 2:
python -m SimpleHTTPServer
python -m http.server
Open one of the sample images and pan and zoom around. Watch in the console as the different tiles that are delivered.
How does the client know what images to request?
If you’re on Linux or a Mac open up the starfish directory in a terminal and type type:
tree starfish. You should see output of the directory structure and files that make up all of the tiles. Partial output looks like this:
starfish ├── 0,0,1024,1024 │ └── 1024, │ └── 0 │ └── default.jpg ├── 0,0,2048,2048 │ └── 1024, │ └── 0 │ └── default.jpg ├── 0,1024,1024,1024 │ └── 1024, │ └── 0 │ └── default.jpg ├── 0,2048,1024,1024 │ └── 1024, │ └── 0 │ └── default.jpg ├── 0,2048,2048,1952 │ └── 1024, │ └── 0 │ └── default.jpg ...
At the time of this writing the Carnegie Museum of Art uses a static image server. Here’s an example of one of their
You can see if it is still a static (level 0) implementation by looking for the
profile that includes “http://iiif.io/api/image/2/level0.json”.