IUBLibTech / newton_chymistry

New version of 'The Chymistry of Isaac Newton', using XProc pipelines to generate a website based on TEI XML encodings of Newton's alchemical manuscripts, and Apache Solr as a search engine.
2 stars 0 forks source link

Editorial annotations need to be pop-ups #112

Closed aewingate closed 2 years ago

aewingate commented 2 years ago

From our discussion today, here is the situation with the editorial annotations: In the live site, if you click on the note icon, a small yellow pop-up will appear. (Example taken from Keynes 19 aka ALCH00008, fol. 1r) image

But if you go to Carbon and Possum, clicking on the note takes you to the notes section at the very bottom of the page. image The note in context image Where you go after you click the note icon

The live site, Carbon, and Possum all have this bottom section, and the bottom section should be there, but clicking on the note icon on a given editorial annotation in the manuscript should create a pop-up like in the live site, not automatically take you to the bottom of the page.

aewingate commented 2 years ago

And I forgot to add, the editorial annotations are the ones that are encoded with <ref type="annotation" target="#someXML:ID"/> in the text, and then as <note type="annotation" xml:id="someXML:ID" n="fol. , l. " anchored="true">

image In-text image In the back matter

tubesoft commented 2 years ago

As we assumed in the meeting, it does not really seem to be a bug, and Con coded like that. The following XSLT code is the part rendering the reference.

https://github.com/IUBLibTech/newton_chymistry/blob/9ec14b20178f8b90bce76ab5b3abb3a8c7d6896e/xslt/p5-to-html.xsl#L608-L615

This code creates the link to the footnote and tooltip. To make sure, we agree that we are adding a pop-up view instead of the link, right?

If so, I am going to modify the code.

aewingate commented 2 years ago

Yes, we want a pop-up, not a link. Thanks!

tubesoft commented 2 years ago

In my local environment, it goes like this so far:

image
aewingate commented 2 years ago

That seems perfect!

tubesoft commented 2 years ago

In the meeting, we found that the link does not work in a <note> tag. I have to work on it.

tubesoft commented 2 years ago

I managed to fix the problems that we previously discussed: 1) Now we can go back to the annotated location in the text clicking "^" in the footnote; 2) The link to the cross-referenced location is now available in the popup like below:

image

By the way, @aewingate, besides this issue, it might be needed to modify the TEI code for the multi-column parts.

image

It is currently rendered as three columns: folio number milestone, left column, and right column. To fix it, we might need to switch certain elements' locations. For detail, see #77, especially my post there. Also, ALCH00091.xml in xubmit is supposed to be already fixed. It should be a good example to compare.

aewingate commented 2 years ago

On 1), great! On 2), is that dark grey pop-up being created by clicking on the "1v" in the lighter pop-up? I like the idea of the secondary pop-up, but I wonder if the team would prefer that you were taken to the actual location on 1v. Also, within the dark grey pop-up, it is printing both options inside of <choice> like <abbr> and <expan>.

On the multi-column issue, I will check ALCH00008 to see how it's encoded. I see what you mean from your post on issue 77.

aewingate commented 2 years ago

@tubesoft, I just looked at the encoding of ALCH00008 and ALCH000091 and their rendering on Carbon. It doesn't look like the issue has been fixed in ALCH00091 because there are still <milestone> inside the <div> with rend="parallel-docs" and it's rendering as three columns like in your screenshot of ALCH00008 above. Maybe we should bring this up with @wehooper tomorrow to see if there's a faster way to deal with this than re-encoding by hand?

tubesoft commented 2 years ago

@aewingate, I should have elaborated it! "1v" is a link that makes you jump to the actual location. The grey popup appears when your mouse pointer is on the link. Probably you can find the same effect in the footnote even on Carbon.

Thank you for pointing out printing all the contents of the elements, which I did not realize. Since I merely copied the feature of footnote, I would probably be nice to create another independent issue.

tubesoft commented 2 years ago

As for double column and milestone issue, @wehooper should have run some script to switch div and milestone, as far as I remember. I think it is worthwhile asking him about it.

wehooper commented 2 years ago

The double-column and milestone placement issues were raised and resolved in November, 2020. They were a separate problem and didn't affect the note-popup's behavior.

wehooper commented 2 years ago

The note popups work as described in the fix in Chrome, Firefox, Edge, and Opera.

wehooper commented 2 years ago

We can close this issue.