Page 1 of 2

PDF previews on composition page

Posted: 10 Jan 2018 12:28
by AlexMyltsev
Hi,

here is the composition page we all know and love:
Image

I suppose that most users will open it to download a printable score, but the page does not make it too easy. You have to understand that you need to click the PDF icon, hunt for it amid a host of other icons (half of them zoom icons or globes) and repeat this process for every edition you want to view. Lots of noisy links around do not help (no, I don't want to see other editions uploaded on 2016-08-26, thank you very much).

We can fix all that (and more) if we show a preview of the edition right here on the page:
Image

Now it is immediately apparent where to click for the PDF. In addition, you see the staff layout, the key, font/language of the lyrics etc. so you can choose the desired score without clicking through to every edition.

In order to achieve that, we need to store a 100 KB preview image for every edition and add a simple template to every edition.

I can make a bot that will crawl CPDL, generate and upload preview images and insert such templates. What do you think?

Re: PDF previews on composition page

Posted: 12 Jan 2018 17:52
by choralia
AlexMyltsev wrote:I can make a bot that will crawl CPDL, generate and upload preview images and insert such templates. What do you think?
ChoralWiki makes use of the MediaWiki software, which can automatically create preview images. However, ChoralWiki also includes a fairly large number of scores hosted on external servers. Quite often, external score files are not directly linked to the work page on ChoralWiki: one has to manually browse the external website to find the actual score file. To ensure that previews are available, and that they are not obsolete with respect to the externally hosted scores, we would need direct links to all externally hosted scores, in order to get a temporary copy and make the preview "on the fly" (external websites may not allow that we keep a copy on our servers). How do you think this can be done, and maintained over time, taking into account that external websites may change their internal structure, that they can be moved to other domains, etc.?

Max

Re: PDF previews on composition page

Posted: 13 Jan 2018 17:34
by Cdalitz
To me, this looks much more confusing: where is the user supposed to click on to download the score?
A right click on the preview image would only save the preview image, but not the PDF.

Re: PDF previews on composition page

Posted: 16 Jan 2018 11:35
by AlexMyltsev
choralia wrote:Quite often, external score files are not directly linked to the work page on ChoralWiki: one has to manually browse the external website to find the actual score file. To ensure that previews are available, and that they are not obsolete with respect to the externally hosted scores, we would need direct links to all externally hosted scores[...]. How do you think this can be done, and maintained over time, taking into account that external websites may change their internal structure, that they can be moved to other domains, etc.?
I think it probably can't be done, but it should not stop us from providing the best possible experience for thousands of scores hosted on CPDL or directly linked.
choralia wrote:external websites may not allow that we keep a copy on our servers
They can't really "forbid" previewing in the legal sense. Storing and showing a low-resolution preview for the first half-page of a score will be "fair use" under any applicable copyright legislation. But sure, for the sites that want to make things hard for the users and say so, we can generate no previews – good riddance if you ask me.

Re: PDF previews on composition page

Posted: 16 Jan 2018 12:27
by AlexMyltsev
Cdalitz wrote:To me, this looks much more confusing: where is the user supposed to click on to download the score?
Right on the preview. Here's a test page for you to try:
http://www.cpdl.org/wiki/index.php/User ... v/previews

The preview area is much larger than the tiny PDF icon, so, per Fitts's law, it is that much easier to target and click. And there is less clicking required too, since you can often choose the score just by scrolling through the page and comparing the previews (and scrolling is cheaper than clicking).

Even if you do not buy my reasoning, nothing is taken away from you: the tiny PDF icon is still there, you can hunt for it if you like.

Re: PDF previews on composition page

Posted: 23 Jan 2018 22:05
by vaarky
Thank you for the improvement suggestion. I personally value the less cluttered old way, which requires paging down less, but like the ability to see the previews. Would it be possible to have either (a) the editions listed at the top, kind of like a concise table of contents the way it appears now, and then have the more verbose version farther below for people who scroll or find that more intuitive or, better yet, (b) the user able to toggle on/off the preview to collapse to the concise version?

Re: PDF previews on composition page

Posted: 24 Jan 2018 13:06
by AlexMyltsev
vaarky wrote:Would it be possible to have either (a) the editions listed at the top, kind of like a concise table of contents the way it appears now, and then have the more verbose version farther below
Yes, this is easy to do. Here's how that might look:
http://www.cpdl.org/wiki/index.php/User ... iews_split
vaarky wrote:or, better yet, (b) the user able to toggle on/off the preview to collapse to the concise version?
I don't know how to do that with MediaWiki. Any ideas would be welcome.

Re: PDF previews on composition page

Posted: 24 Jan 2018 19:15
by vaarky
Thanks! I liked the revised format, even if we can't find a way to toggle previews off or if it's not worth the effort with this new format. Feedback from others on this hybrid interface approach?

Re: PDF previews on composition page

Posted: 24 Jan 2018 19:16
by vaarky
I mean that I like, present tense, this revised format.

Re: PDF previews on composition page

Posted: 13 Feb 2018 16:22
by AlexMyltsev
OK, so I have gone and added previews to a random recently changed page:
http://www.cpdl.org/wiki/index.php/Gres ... _di_Lasso)

Any ideas for improvement are very welcome. By default, I'm going to continue in this fashion.

For reference, here's the code I used:
https://github.com/avm/cpdl-preview-bot ... ter/bot.py

Re: PDF previews on composition page

Posted: 13 Feb 2018 19:17
by CHGiffen
At the very least, the CPDL number and Editor's name should appear, along with the ScoreInfo, beneath each preview.

Re: PDF previews on composition page

Posted: 14 Feb 2018 15:17
by AlexMyltsev
CHGiffen wrote:At the very least, the CPDL number and Editor's name should appear, along with the ScoreInfo, beneath each preview.
Here's another processed page, with the editor and CPDL number displayed:
http://www.cpdl.org/wiki/index.php/Chia ... _Gabrieli)

Re: PDF previews on composition page

Posted: 16 Feb 2018 08:52
by Nikolaus Hold
Yes, the previews look great, you could even say fantastic.

After looking at the source code, I am rather disillusioned and fear a maintenance problem. What should a usual CPDL-updloader do if a error is found and therefore a new version has to be uploaded? I would not know how to update the preview. And with the redundant information in the caption (PreviewScoreInfo, PreviewEditor) you run the risk that this will not be maintained in case of changes.

In my opinion, you should get rid of the redundant information; the only required preview identification is the CPDL number.
Maybe it is possible to create a template of the kind
{{PDFprev | cpdl-no | fileinfo }},
so only one line in the source code is needed per preview.

Re: PDF previews on composition page

Posted: 26 Feb 2018 15:09
by AlexMyltsev
Nikolaus Hold wrote:I am rather disillusioned and fear a maintenance problem. What should a usual CPDL-updloader do if a error is found and therefore a new version has to be uploaded? I would not know how to update the preview.
1) My impression is that most editions are "one shot": uploaded once and never updated. If this is true, updating the previews is less of a problem.
2) When an edition is updated, for example an error is found and fixed somewhere in the score, the first half-page will often remain unchanged, so the preview does not become obsolete. Major changes (like transposing or changing the staff layout) that require a preview update will probably warrant a separate edition.
3) When I allow the bot to operate automatically, it will crawl recently changed scores within minutes of an edit, keeping the preview section always fresh. The rate of uploads/updates is not that high.

Re: PDF previews on composition page

Posted: 27 Feb 2018 03:34
by D-fished
I'm IT illiterate, so pardon me if I'm completely off base, but what about a system like they have at IMSLP, where a preview image is about the size of a postage stamp but enlarges when you scroll over it?
Another concern I would have is that some pages have 15, 20, or even more editions. All those previews would create a lot of clutter.
Finally, a lot of my editions have title pages. I presume the preview would show only that, so a potential downloader would be none the wiser.