[jats-list] Re: Customize long-desc for tabular content?

["Beck, Jeff (NIH/NLM/NCBI) [E] beck@xxxxxxxxxxxxxxxx" <jats-list-service@xxxxxxxxxxxxxxxxxxxxxx>]

Hi Mary

Working on the JATS4R Accessibility Recommendation, I was very excited about
the JATS element <long-desc>. Our task was to define a way to include all of
the necessary information into a JATS XML that could be used to make
accessible versions of the article. And there is a lot you can do with long
descriptions in HTML.

Originally I wanted to expand the <long-desc> model to support section-like
content. Unfortunately (well, probably fortunately), the JATS Standing
Committee does not just adopt things because I think they are a good idea at
the time. Probably there is more we can do with <long-desc>, but referencing a
section-like object either externally or in the XML document is very much in
line with the html presentation using img/@longdesc.

The dissonance that I have is the difference between how the links to internal
long-descriptions and external long-descriptions are tagged (see Example 4).

If you have real examples of real, rich long description content that can't be
modeled in the current JATS, please share it as a comment with the JATS
Standing Committee.

Jeff


________________________________
From: Mary Turton mary.turton@xxxxxxxxxxxxx
<jats-list-service@xxxxxxxxxxxxxxxxxxxxxx>
Sent: Thursday, May 9, 2024 5:12 AM
To: jats-list@xxxxxxxxxxxxxxxxxxxxxx <jats-list@xxxxxxxxxxxxxxxxxxxxxx>
Subject: [EXTERNAL] [jats-list] Customize long-desc for tabular content?


Hello,

Looking at W3C guides for complex images
(https://www.w3.org/WAI/tutorials/images/complex/) the suggestion is that
tabular setting can be useful to describe some images.

Reviewing the recently published JATS4R recommendations for long-desc suggests
the use of graphic/xref to link to content in a back/app-group/app, if
structured content is required. (For example:
https://jats4r.niso.org/accessibility/#example-4b-long-desc-within-the-xml-do
cument.)



In JATS1.2 and BITS1.0, there is no graphic/xref.



The content model for <long-desc> is PCDATA (in JATS publishing; with | x if
archive or BITS).



However, in JATS1.2 (publishing; and v1.3, v1.4d1), the content model for
<long-desc> includes the parameter entity %long-desc-elements with

'Remarks: This parameter entity is currently set as a null string, i.e., there
is no string content. However, a customization module could redefine this
parameter entity, thereby adding elements to the <long-desc> element.'
(https://jats.nlm.nih.gov/publishing/tag-library/1.2/pe/long-desc-elements.ht
ml)



Would creating a customization module be a good direction?  Is this something
that others have considered/done?



Before we create a customized module for the long-desc-elements parameter, is
there any current discussion about extending the content of this for new
versions of the DTDs?  Clearly we are concerned about compatibility of our
content going forward.  Are there any other considerations that you think we
should be aware of?



Thank you

Mary



Mary Turton

XML Architect

Content Services

Cambridge University Press & Assessment




Cambridge University Press & Assessment is the publishing and assessment
department of the University of Cambridge. The corporate title of the
University is The Chancellor, Masters, and Scholars of the University of
Cambridge. Our principal office is at Shaftesbury Road, Cambridge, CB2 8EA,
United Kingdom, with registered VAT number GB 823 8476 09. We are a
not-for-profit organisation and an exempt charity under the Charities Act
2011.

Disclaimer
This email is intended solely for the recipient and may contain confidential
information. If you have received this email in error, please let us know and
then delete the original email and any attachments. Do not use, copy or
disclose the contents of this email or any attachment. Any views or opinions
in this email are solely those of the author and do not necessarily represent
those of Cambridge, unless specifically stated.
JATS-List info and archive<http://www.mulberrytech.com/JATS/JATS-List/>
EasyUnsubscribe<http://lists.mulberrytech.com/unsub/jats-list/17344> (by
email<>)

CAUTION: This email originated from outside of the organization. Do not click
links or open attachments unless you recognize the sender and are confident
the content is safe.