craigsapp / website-polish-scores

Front-end for digital transcriptions of the Polish Music Heritage in Open Access project
https://polishscores.org
3 stars 1 forks source link

IIIF logo on work page/list #100

Closed mkonik closed 2 years ago

mkonik commented 2 years ago

It might be helpful if there would be a IIIF logo (or another sign) displayed on the score list (and preferably also on work page) indicating whether this particular score has scans available through IIIF server. It should be added automatically after linking score with IIIF. Maybe another filter should be added in the future, allowing to show only scores with scans linked with IIIF.

craigsapp commented 2 years ago

That is good. Using the IIIF logo has some complexity: Usually the logo points to a link for the IIIF manifest, not to a webpage that uses the IIIF image:

https://polona.pl/item/melodiae-na-psalterz-polski,Nzk3MTM4ODQ/296/#info:metadata

Screen Shot 2022-01-21 at 12 59 18 AM

The red and blue IIIF logo on that page points to the Manifest that is used to load the images and metadata on that page:

https://polona.pl/iiif/item/Nzk3MTM4ODQ/manifest.json

Screen Shot 2022-01-21 at 1 00 52 AM
craigsapp commented 2 years ago

IIIF information is encoded in Humdrum reference records, such as:

https://github.com/pl-wnifc/humdrum-polish-scores/blob/fa800b013b620be2a463f96245fbfa002dfcce2f/pl-wn/kern/pl-wn--sd-xvi-qu-273--001_gomolka-mikolaj--szczesliwy-ktory-nie-byl-miedzy-zlymi-w-radzie.krn#L137-L138

!!!URL-scan: https://polona.pl/item/melodiae-na-psalterz-polski,Nzk3MTM4ODQ/16 Scan on Polona
!!!IIIF: https://polona.pl/iiif/item/Nzk3MTM4ODQ/manifest.json

The record URL-scan is a URL to the webpage that contains the scan of the source. The URL is not necessarily IIIF, but of course it should be.

The record IIIF is a URL to the manifest in which the work can be found.

There could be more refinements to this system such as using URL-iiif instead of URL-scan to emphasize that the link to the scan is utilizing IIIF.

Another enhancement is to have a separate entry for the starting page (or page range) of the work within the IIIF manifest, such as in this case:

!!!IIIF-page: 16

in VHV, the URL-scan record causes a picture icon to appear in the toolbar:

https://verovio.humdrum.org/?file=https://github.com/pl-wnifc/humdrum-polish-scores/blob/main/pl-wn/kern/pl-wn--sd-xvi-qu-273--001_gomolka-mikolaj--szczesliwy-ktory-nie-byl-miedzy-zlymi-w-radzie.krn

Screen Shot 2022-01-21 at 1 11 52 AM

Notice that mouse over will display the title which is optional text after the URL in the reference record ("Scan on Polona").

Screen Shot 2022-01-21 at 1 11 35 AM

There is no indication that it is a link to an IIIF-based webpage, and also there is no indication that the Humdrum score has IIIF bounding box information embedded in it. So this fact would be useful to indicate on the VHV website as well as on POPC2. This would mean that you can double click on a note in the score to bring up the scan of the system or staff that the note belongs to:

Screen Shot 2022-01-21 at 1 16 54 AM
craigsapp commented 2 years ago

Work pages now have icons for links to scans, implemented with commit https://github.com/craigsapp/website-polish-scores/commit/36a0a284f420e44c0343a30b4e2bd75019a5bbff

Example:

http://127.0.0.1:3434/?id=pl-sa--86-a-ii-26--006

Screen Shot 2022-01-23 at 9 21 28 PM

The picture icon under the shelfmark is a link to the scan that is embedded in the Humdrum file on the line:

!!!URL-scan: http://bc.bdsandomierz.pl/dlibra/publication/1364/edition/1332/content

Links to the page:

Screen Shot 2022-01-23 at 9 25 33 PM
craigsapp commented 2 years ago

Here is an example for Gomółka: http://127.0.0.1:3434/?id=15xx:353

Screen Shot 2022-01-23 at 9 27 14 PM

Which goes to this page:

https://polona.pl/item/melodiae-na-psalterz-polski,Nzk3MTM4ODQ/349

Screen Shot 2022-01-23 at 9 27 36 PM

Note that the link to the scan goes to the page in the volume which has the start of the digital score.

Also note an optional title to show when the image icon is hovered on:

!!!URL-scan: https://polona.pl/item/melodiae-na-psalterz-polski,Nzk3MTM4ODQ/349 Scan on Polona
Screen Shot 2022-01-23 at 9 33 21 PM

(how to have title translations it will need some more thought)

Also, multiple scan links can be given in the same file, and they will be listed as multiple picture icons under the shelfmark (and these would be more necessary to have title information to differentiate between each image).

Multiple images can be used for giving links to each page (when the score is generated from images of parts). If the parts are in the same manifest, then they can still be given individually when the URL allows accessing specific pages in the images (ideally all webpages for scans should allow this, but unfortunately they do not).

For modern editions, a list of multliple source scans could be given.

Note that PDFs of scans do have an automatic way of opening to a specific page in the PDF:

https://helpx.adobe.com/acrobat/kb/link-html-pdf-page-acrobat.html

craigsapp commented 2 years ago

Note that

http://bc.bdsandomierz.pl/dlibra/publication/1364/edition/1332/content

Is not an IIIF-based scan. Do you want to differentiate between IIIF and non-IIIF based image URLs?

It might be helpful if there would be a IIIF logo (or another sign) displayed on the score list

Now implemented on the work pages, which has the obvious benefit of looking at the scan in case of encoding errors.

For what purpose do you want to have a scan marker on the browse page? I can do it, but I would need to have a clear idea of why/how it would be used. Ideally all of these score would have images available online... Also, adding scan and/or scan links on the browse page will increase the size of the work index (which in turn will slow down loading of the browse index).

craigsapp commented 2 years ago

Also note that most NIFC URL-images links are not publicaly accessible:

http://127.0.0.1:3434/?id=pl-kozmzk--mzk-m-346--032

which has this scan link:

https://repozytorium.nifc.pl/islandora/object/pl-kozmzk%3A7453/datastream/PDF/view

Screen Shot 2022-01-23 at 9 56 07 PM

Will these be made public by March? Or will there be a separate IIIF-based webpage for the images? And/or are there going to be PMP or similar pages that have reduced image PDFs of the images?

craigsapp commented 2 years ago

Is not an IIIF-based scan. Do you want to differentiate between IIIF and non-IIIF based image URLs?

One reason to specifically indicate IIIF availability is to allow people to be aware that they could double click to download a JPG image of a staff (or page) containing the note clicked on (if xyhw interpretations are also encoded in the digital score). This currently is only available on the Melodiae na psalterz polski webpages, such as:

http://127.0.0.1:3434/?id=15xx:311

Screen Shot 2022-01-23 at 10 28 02 PM
jacekiwaszko1 commented 2 years ago

Also note that most NIFC URL-images links are not publicaly accessible

This is strange - the URL https://repozytorium.nifc.pl/islandora/object/pl-kozmzk%3A7453/datastream/PDF/view should be accessible for you. I will investigate, why it isn't.

Aside from this, most scan URLs in the files (the ones starting with http://repozytorium.nifc.pl/skany/) are temporary, just for editing purposes. The links are leading to the FTP server from where zip with small jpegs can be downloaded. What's more those URLs are invalid - to download the zip file you need to modify the URL:

http://repozytorium.nifc.pl/skany/pl-wumfc--r313 -> http://repozytoriumplikow.nifc.pl/skany/pl-wumfc--r313

I'm going to replace them with URLs to the webpage presenting the images. At the same time, all scans made by us during the project (and uploaded to the repository system) will be available through the IIIF server.

Is not an IIIF-based scan. Do you want to differentiate between IIIF and non-IIIF based image URLs?

And can we do both? For sources digitized by us, but also for Polona scans it would be useful to link both - the webpage and the IIIF manifest (using IIIF logo?).

craigsapp commented 2 years ago

This is strange - the URL https://repozytorium.nifc.pl/islandora/object/pl-kozmzk%3A7453/datastream/PDF/view should be accessible for you. I will investigate, why it isn't.

I can see this link (did you just fix it?):

Screen Shot 2022-01-24 at 6 53 11 AM

And can we do both? For sources digitized by us, but also for Polona scans it would be useful to link both - the webpage and the IIIF manifest (using IIIF logo?).

You can give multiple URL-scan reference records, and each one will generate a link on the work page.

If you want to distinguish between IIIF-based and non-IIIF scan links, then there would need to be two separate reference records:

!!!URL-scan:  link to scan webpage of unknown technology
!!!URL-scan-iiif: link to scan webpage that uses IIIF image server
!!!URL-scan-pdf: link to a PDF containing a scan
!!!URL-pdf:  link to a PDF that contains either a scan or a vector-graphics typesetting

Then I could give separate icons for each category of scan type.

Displaying the iiif logo on the page will be useful if there is an !!!IIIF: entry on the webpage (which gives the URL of a IIIF manifest). Showing this label would indicate that the score has been linked to the score with xywh interpretations using that manifest.

However, the proper use of the iiif logo is to link to a manifest. This manifest can be then loaded into various IIIF viewing software such as Mirador. Example on Polona:

https://polona.pl/item/melodiae-na-psalterz-polski,Nzk3MTM4ODQ/241/#info:metadata

Notice the iiif icon on the page:

Screen Shot 2022-01-24 at 7 04 22 AM

This links to the manifest for the scans on this page, which is a JSON file:

https://polona.pl/iiif/item/Nzk3MTM4ODQ/manifest.json

Screen Shot 2022-01-24 at 7 05 18 AM

The general user will be confused by clicking on such a link that takes you to this page.