@@ -44,8 +44,6 @@ Other operating systems and versions are supported as well, but not described in
44
44
45
45
### Install general software packages
46
46
First, install the required software via the Ubuntu package manager.
47
- ` libfreetype6-dev ` is a dependency for the gd graphics processing library that Omeka S uses as PHP extension.
48
- The other ones are dependencies for other PHP extensions that Omeka S uses for compression or image processing.
49
47
``` bash
50
48
sudo apt-get install \
51
49
libfreetype6-dev \
@@ -54,13 +52,16 @@ sudo apt-get install \
54
52
libjpeg-dev \
55
53
libtiff-dev
56
54
```
55
+ ` libfreetype6-dev ` is a dependency for the gd graphics processing library that Omeka S uses as PHP extension.
56
+ The other ones are dependencies for other PHP extensions that Omeka S uses for compression or image processing.
57
+
57
58
58
59
### JPEG 2000 compatibility
59
60
The default ImageMagick version in Ubuntu 20.04 lacks jp2 support, so we need to compile and install specific versions of
60
61
ImageMagick, libvips and libopenjp2 to make it work.
61
62
62
63
** If you're using Debian or a higher version of Ubuntu** , you might be able to install the versions from your OS's package
63
- manager directly and can probably continue with the next section ** Configure Apache and PHP** .
64
+ manager directly and can probably continue with the next section called ** ' Configure Apache and PHP' ** .
64
65
65
66
#### 1. Imagemagick
66
67
Build ImageMagick with JP2 support:
@@ -113,7 +114,7 @@ dpkg --list | grep libopenjp2
113
114
#### 3. libvips
114
115
libvips is a fast image processing library with low memory needs ([ website] ( https://www.libvips.org/ ) ). The version
115
116
offered by the Ubuntu 20.04 package repos is not compatible with the ImageMagick version we installed above, so we need
116
- to build it from source ourselves .
117
+ to build it from source.
117
118
118
119
Compiling and
119
120
building this package is rather complex, so we're happy to offer you a .deb package we compiled ourselves.
@@ -179,7 +180,7 @@ Restart the Apache web server
179
180
sudo systemctl restart apache2
180
181
```
181
182
182
- In order to prevent errors like 'CSRF: Value is required and can't be empty' when editing Omeka S items consisting of many
183
+ In order to prevent errors like _ 'CSRF: Value is required and can't be empty'_ when editing Omeka S items that consist of many
183
184
media files, you need to increase maximum allowed input.
184
185
185
186
Edit the file ` /etc/php/8.2/fpm/conf.d/99-omeka.ini ` and insert the following
@@ -208,18 +209,19 @@ This module implements the [IIIF Content Search API](https://iiif.io/api/)
208
209
[ ** UniversalViewer** ] ( https://github.com/Daniel-KM/Omeka-S-module-UniversalViewer/releases ) version 3.6.9 as the IIIF-
209
210
compliant image viewer.
210
211
211
- ** Remark** . Please be aware that this is a proven and working combination of module versions. Deviating from these
212
- versions might result in broken functionality. For instance, version 3.6.18 of IiifServer is known to break the
212
+ ** Remark** . Please be aware that the above is a proven and working combination of module versions. Deviating from these
213
+ versions might result in broken functionality. For instance, IiifServer version 3.6.18 is known to break
213
214
Mirador's OCR helper plugin and versions 3.6.19 and 3.6.20 break IiifSearch functionality. Other "golden combinations"
214
- might exist and we hope that these bugs appear less in future versions of these modules.
215
+ might exist and we hope that these strict dependencies die off in future versions of these modules.
215
216
216
217
217
218
### Configuration in Omeka S
218
219
Some settings have to be made in Omeka S to make everything run smoothly. Login to your Omeka S admin backend and
219
220
navigate to the following sections.
220
221
221
222
** Site settings**
222
- Repeat this for every site in your Omeka S instance
223
+
224
+ _ Repeat this for every site in your Omeka S instance_
223
225
- Uncheck “Show - Embed media on item pages (legacy)”
224
226
- Enable the following plugins at “Players - Mirador plugins for v3“:
225
227
- Download files
@@ -254,14 +256,14 @@ Repeat this for every site in your Omeka S instance
254
256
255
257
256
258
### Final words
257
- Following this extensive manual has hopefully resulted in a working IIIF-OmekaS instance. Now you can start your
259
+ Following this extensive manual has hopefully resulted in a working IIIF-Omeka S instance. Now you can start your
258
260
IIIF-journey by creating new items in Omeka S and uploading image files to it. The IIIF-manifests will be populated with
259
261
the item- and media-metadata you enter in Omeka S. Mirador or Universal will render the images you've attached to the item.
260
262
261
263
Good luck and have fun!
262
264
263
- Some sample URLs:
264
- - Frontend view: https://digitalcollections.library.maastrichtuniversity.nl/s/medicine/item/3525
265
- - IIIF manifest: https://digitalcollections.library.maastrichtuniversity.nl/iiif/2/3525/manifest
265
+ ![ herbarius] ( assets/img/posts/herbarius-web.jpg )
266
266
267
- ![ herbarius] ( assets/img/posts/herbarius-web.jpg )
267
+ Some sample URLs:
268
+ - Frontend view: [ https://digitalcollections.library.maastrichtuniversity.nl/s/medicine/item/3525 ] ( https://digitalcollections.library.maastrichtuniversity.nl/s/medicine/item/3525 )
269
+ - IIIF manifest: [ https://digitalcollections.library.maastrichtuniversity.nl/iiif/2/3525/manifest ] ( https://digitalcollections.library.maastrichtuniversity.nl/iiif/2/3525/manifest )
0 commit comments