Re: [jats-list] Element for wrapping a group of xref elements

Subject: Re: [jats-list] Element for wrapping a group of xref elements
From: Alf Eaton <eaton.alf@xxxxxxxxx>
Date: Thu, 21 Feb 2013 11:17:11 +0000
Here's a concrete example of why this would be useful:
<https://peerj.com/articles/3/>, accompanied by a discussion on
Twitter today, about letting readers choose how they want inline
citations to be displayed:
<https://twitter.com/pmgjones/status/304260774459744258>.

In the introduction to the article linked above, each sentence has
multiple references to support it. From the reader's point of view,
that's mostly noise, and it would be nice to be able to collapse each
group of citations down to a single symbol, which would expand to show
all the references on click/hover.

In the absence of an <xref-group> element, there's only one way to do
this with the current JATS DTD, which is to use multiple items in the
rid attribute:

<xref xref-type="bibr" rid="ref-1 ref-3 ref-4 ref-7 ref-10 ref-19
ref-20">(Collingridge, Kehl & McLennan, 1983; Anwyl, Lee & Rowan,
1988; Malenka et al., 1988; Anwyl, Mulkeen & Rowan, 1989; Malenka,
Lancaster & Zucker, 1992; Stevens, Tonegawa & Wang, 1994; Tsien,
Huerta & Tonegawa, 1996; Volianskis & Jensen, 2003)</xref>

and in fact the <label> for each citation is already in the <ref>
element, so the <xref> can be empty:

<xref xref-type="bibr" rid="ref-1 ref-3 ref-4 ref-7 ref-10 ref-19 ref-20"/>

which conveniently leaves the opportunity to state that "the text in
this inline citation must be displayed as-is when the <xref> contains
text", e.g. "as shown in <xref ref-type="bibr" rid="ref-4">Malenka,
1988</xref>".

That (empty xref elements, with multiple, space-separate ids in the
rid attribute; text content in the xref element when it must be
rendered as-is) seems like an appropriate way to store inline
citations.

However, downstream renderers of the XML aren't necessarily going to
know what to do with the empty <xref> in order to display the inline
citations. So, for the sake of compatibility with existing renderers,
perhaps an <xref-group> container for multiple <xref> elements is
still a useful proposal.

Alf

Current Thread