TEKLIA provides a service to upload a large number of images directly on a IIIF image server. After the upload, the images are immediately available to be imported in Arkindex. This service is particularly useful when you do not already have a IIIF server hosting your images. The procedure to use this service is the following :
First you need to ask TEKLIA (you can reach us by email at team@teklia.com
or on our contact form ) for the creation of an account on this service. You will receive a user name (access-key) and a password (secret-key) by wormhole.app
The link on https://wormhole.app/ is valid only 24 hours. After this period, you will need to ask for a new link.
header | with graphical interfance | command line |
---|---|---|
Windows | Cyberduck, WinSCP | aws, mc, duck |
Mac OSX | Cyberduck | aws, mc, duck |
Linux | None | aws, mc, duck |
Cyberduck is a graphical application available on Microsoft Windows and Mac Os X.
install Cyberduck
start Cyberduck
open a new connection and configure it:
storage.teklia.com
For Windows systems, you can use WinSCP which is also a graphical application for managing distant documents on S3 bucket.
install WinSCP
start WinSCP
Create a new connection and configure it:
storage.teklia.com
Path
instead of virtual-host.Open directory/Bookmark
or press Ctrl + O
Upload
or with a drag and drop.duck --upload s3://storage.teklia.com/<your-bucket> <PATH to your data>
<your-bucket>
with the name of your bucket<PATH to your data>
with the path to your data locallymc
🔗mc alias set <alias-name> https://storage.teklia.com/ <access-key> <secret-key>
<alias-name>
with the name you want to use to call this specific service.<access-key>
and <secret-key>
with your credentialsmc ls <alias-name>/<bucket-name>/<PATH>
mirror
command mc mirror <your-file-or-directory> <alias-name>/<bucket-name>/<PATH>
cp
command: mc cp <alias-name>/<bucket-name>/<PATH> <your-file-or-directory>
aws
🔗aws configure --profile=<profile_name>
<access-key>
and <secret-key>
.Default region name
blank.json
aws --profile=<profile-name> --endpoint=https://storage.teklia.com/ s3 ls s3://<your-bucket>
sync
command: aws --profile=<profile-name> --endpoint=https://storage.teklia.com/ s3 sync <directory> s3://<your-bucket>/
aws --profile=<profile-name> --endpoint=https://storage.teklia.com/ s3 sync s3://<your-bucket>/<directory> .
Once your images are uploaded on storage.teklia.com
, they are immediately available through one of our IIIF servers.
For european customers, the IIIF base url is https://europe-gamma.iiif.teklia.com/iiif/2
.
To get your image URL, you'll need two information:
-data
)You then need to concatenate all 3 parts: IIIF base url + bucket name + image path
Let's say you have uploaded the image test.jpg
on the bucket clientX-data
, then your IIIF image url will be: https://europe-gamma.iiif.teklia.com/iiif/2/clientX-data%2Ftest.jpg
If you organized your content in folders, you need to url-encode the image path from the sever root to follow the IIIF spec.
If you uploaded the image project/folderX/imageY.png
in bucket clientX-data
, then your IIIF image url will be https://europe-gamma.iiif.teklia.com/iiif/2/clientX-data%2Fproject%2FfolderX%2FimageY.png
Finally to view the image in your web browser, and not only its metadata, you need to specify a IIIF operation
The simplest operation is to view the raw file without modification, as a JPEG (whatever your original file format): simply suffix your image url with /full/full/0/default.jpg
.
So for the image test.jpg
from clientX-data
this becomes: https://europe-gamma.iiif.teklia.com/iiif/2/clientX-data%2Ftest.jpg/full/full/0/default.jpg
To view your content in Arkindex, please send us an email at team@teklia.com
once your content is organized: we'll import your images into an Arkindex instance.