[jats-list] Re: <contrib> insights welcome

["Sproat, Eliza X esproat@xxxxxxx" <jats-list-service@xxxxxxxxxxxxxxxxxxxxxx>]

Pleased to report the first time I tried this with the fix mentioned below it
didn't work. Then I realized I didn't apply it thoroughly (as JATS expected
surname ahead of given names and the data I had didn't follow that
convention).

Thank you Jeff, for pointing so clearly to the resolution-thank you also to
another who contacted me off list to counsel.

Look forward to learning more about JATS.

Eliza

From: Sproat, Eliza X esproat@xxxxxxx
<jats-list-service@xxxxxxxxxxxxxxxxxxxxxx>
Sent: Wednesday, February 22, 2023 13:23
To: jats-list@xxxxxxxxxxxxxxxxxxxxxx
Subject: [EXT] [jats-list] Re: <contrib> insights welcome

[Actual Sender is
jats-list-return-1753-esproat=cas.org@xxxxxxxxxxxxxxxxxxxxxx<mailto:jats-list
-return-1753-esproat=cas.org@xxxxxxxxxxxxxxxxxxxxxx>]
Thank you!

From: Beck, Jeff (NIH/NLM/NCBI) [E]
beck@xxxxxxxxxxxxxxxx<mailto:beck@xxxxxxxxxxxxxxxx>
<jats-list-service@xxxxxxxxxxxxxxxxxxxxxx<mailto:jats-list-service@xxxxxxxxxx
errytech.com>>
Sent: Wednesday, February 22, 2023 13:09
To: jats-list@xxxxxxxxxxxxxxxxxxxxxx<mailto:jats-list@xxxxxxxxxxxxxxxxxxxxxx>
Subject: [EXT] [jats-list] Re: <contrib> insights welcome

[Actual Sender is
jats-list-return-1752-esproat=cas.org@xxxxxxxxxxxxxxxxxxxxxx<mailto:jats-list
-return-1752-esproat=cas.org@xxxxxxxxxxxxxxxxxxxxxx>]
Hi Eliza

It looks like you have parsed names (<surname> and <given-names>) and are not
providing character data within the <string-name>, so probably the easiest way
to get rid of this error is to use <name> rather than <string-name> in
<contrib>.

Jeff


________________________________
From: Sproat, Eliza X esproat@xxxxxxx<mailto:esproat@xxxxxxx>
<jats-list-service@xxxxxxxxxxxxxxxxxxxxxx<mailto:jats-list-service@xxxxxxxxxx
errytech.com>>
Sent: Wednesday, February 22, 2023 12:34 PM
To: jats-list@xxxxxxxxxxxxxxxxxxxxxx<mailto:jats-list@xxxxxxxxxxxxxxxxxxxxxx>
<jats-list@xxxxxxxxxxxxxxxxxxxxxx<mailto:jats-list@xxxxxxxxxxxxxxxxxxxxxx>>
Subject: [EXTERNAL] [jats-list] <contrib> insights welcome

Greetings,



First time posting to list. New to role--incumbent left at head of pandemic.
Comfortable with the why of XML; look forward to growing skills in the how.
Would appreciate your ideas about the <contrib> tag.



Fixing errors returned by the PMC Style Checker to develop a template that
will be used downstream (for the xslt). This strategy has so far yielded
decent results. For example, an external-supplied xml file (jats 1.3)
initially returned a valid DTD (joy) along with 20 errors and 18 warnings.
After working through errors, new PMC result now indicates 11 errors and no
warnings. Feels like progress. Am a bit *familiar with the <contrib> tag, but
not much as I would like. Seek your input if you have any.



Sample of PMC-returned errors:

133: <string-name name-style="western">

> ^

> error: contrib content check: <contrib> must have one of the following:
[collab, collab-alternatives, name, name-alternatives, anonymous]. (Tagging
Guidelines) see
https://www.ncbi.nlm.nih.gov/pmc/pmcdoc/tagging-guidelines/article/tags.html#
el-contrib

> Go to the next error

show ....

143: <contrib-id authenticated="true"
contrib-id-type="orcid">https://gcc02.safelinks.protection.outlook.com/?url=h
ttps%3A%2F%2Forcid.org%2F0000-0002-9010-2865&data=05%7C01%7Cbeck%40ncbi.nlm.n
ih.gov%7C99f1ef47b5ac43d67db208db14fb1dda%7C14b77578977342d58507251ca2dc2b06%
7C0%7C0%7C638126841010133995%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQ
IjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C3000%7C%7C%7C&sdata=%2FJhUUsWivh
X0Wpdkq4k5Id8hQDSv%2FSQwOZTa1aUvLUA%3D&reserved=0</contrib-id<https://gcc02.s
afelinks.protection.outlook.com/?url=https%3A%2F%2Forcid.org%2F0000-0002-9010
-2865&data=05%7C01%7Cbeck%40ncbi.nlm.nih.gov%7C99f1ef47b5ac43d67db208db14fb1d
da%7C14b77578977342d58507251ca2dc2b06%7C0%7C0%7C638126841010133995%7CUnknown%
7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0
%3D%7C3000%7C%7C%7C&sdata=%2FJhUUsWivhX0Wpdkq4k5Id8hQDSv%2FSQwOZTa1aUvLUA%3D&
reserved=0%3c/contrib-id>>

> ^

> error: contrib content check: <contrib> must have one of the following:
[collab, collab-alternatives, name, name-alternatives, anonymous]. (Tagging
Guidelines) see
https://www.ncbi.nlm.nih.gov/pmc/pmcdoc/tagging-guidelines/article/tags.html#
el-contrib



====Sample original XML====

<string-name name-style="western">

                                                <given-names>Eileen</given-na
mes>

                                                <surname>Rogers</surname>

                                        </string-name>

                                        <x xml:space="preserve">, </x>

                                        <xref ref-type="aff" rid="AFF10">

                                                <sup>10</sup>

                                        </xref>

                                </contrib>

                                <contrib contrib-type="author">

                                        <string-name name-style="western">

                                                <given-names>Michaela</given-
names>

                                                <surname>Praus</surname>

                                        </string-name>

                                        <x xml:space="preserve"> &amp; </x>

                                        <xref ref-type="aff" rid="AFF11">

                                                <sup>11</sup>

                                        </xref>

                                </contrib>

                                <contrib contrib-type="author" corresp="yes">

                                        <contrib-id contrib-id-type="orcid"
authenticated="false">https://gcc02.safelinks.protection.outlook.com/?url=htt
ps%3A%2F%2Forcid.org%2F0000-0002-9010-2865&data=05%7C01%7Cbeck%40ncbi.nlm.nih
.gov%7C99f1ef47b5ac43d67db208db14fb1dda%7C14b77578977342d58507251ca2dc2b06%7C
0%7C0%7C638126841010133995%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIj
oiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C3000%7C%7C%7C&sdata=%2FJhUUsWivhX0
Wpdkq4k5Id8hQDSv%2FSQwOZTa1aUvLUA%3D&reserved=0</contrib-id<https://gcc02.saf
elinks.protection.outlook.com/?url=https%3A%2F%2Forcid.org%2F0000-0002-9010-2
865&data=05%7C01%7Cbeck%40ncbi.nlm.nih.gov%7C99f1ef47b5ac43d67db208db14fb1dda
%7C14b77578977342d58507251ca2dc2b06%7C0%7C0%7C638126841010133995%7CUnknown%7C
TWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3
D%7C3000%7C%7C%7C&sdata=%2FJhUUsWivhX0Wpdkq4k5Id8hQDSv%2FSQwOZTa1aUvLUA%3D&re
served=0%3c/contrib-id>>

                                        <string-name name-style="western">

                                                <given-names>Mikhail
A</given-names>

                                                <surname>Rojavin</surname>

                                        </string-name>

                                        <xref ref-type="corresp"
rid="COR1">*</xref>

                                        <xref ref-type="aff" rid="AFF9">

                                                <sup>9</sup>

                                        </xref>

                                </contrib>



I am looking for ways to resolve the <contrib> errors without mangling the
data. Any tags I might add would seem to muddy the intent of the original. I
already played around with a couple of things (order of authenticated="false"
ahead of contrib-id-type; and seeing what happened when "false" replaced with
"true") but neither improved the situation.



Thank you,

E. Sproat



* for example, colleague helped me see that <contrib-group> requires <contrib>
tag nested between when <collab> tag present.



** PS: Would appreciate too any of your favorite xml or jats book
recommendations (or sites other than the obvious
https://www.ncbi.nlm.nih.gov/pmc/tools/stylechecker/ ,
https://jats.nlm.nih.gov/publishing/1.3/,
https://www.ncbi.nlm.nih.gov/pmc/pmcdoc/tagging-guidelines/article/tags.html#
el-contrib and W3C).















Confidentiality Notice: This electronic message transmission, including any
attachment(s), may contain confidential, proprietary, or privileged
information from CAS, a division of the American Chemical Society ("ACS"). If
you have received this transmission in error, be advised that any disclosure,
copying, distribution, or use of the contents of this information is strictly
prohibited. Please destroy all copies of the message and contact the sender
immediately by either replying to this message or calling 614-447-3600.


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.
JATS-List info and archive<http://www.mulberrytech.com/JATS/JATS-List/>
EasyUnsubscribe<http://lists.mulberrytech.com/unsub/jats-list/3507682> (by
email)

Confidentiality Notice: This electronic message transmission, including any
attachment(s), may contain confidential, proprietary, or privileged
information from CAS, a division of the American Chemical Society ("ACS"). If
you have received this transmission in error, be advised that any disclosure,
copying, distribution, or use of the contents of this information is strictly
prohibited. Please destroy all copies of the message and contact the sender
immediately by either replying to this message or calling 614-447-3600.
JATS-List info and archive<http://www.mulberrytech.com/JATS/JATS-List/>
EasyUnsubscribe<http://lists.mulberrytech.com/unsub/jats-list/3507682> (by
email<>)
Confidentiality Notice: This electronic message transmission, including any
attachment(s), may contain confidential, proprietary, or privileged
information from CAS, a division of the American Chemical Society ("ACS"). If
you have received this transmission in error, be advised that any disclosure,
copying, distribution, or use of the contents of this information is strictly
prohibited. Please destroy all copies of the message and contact the sender
immediately by either replying to this message or calling 614-447-3600.