@@ -39,6 +39,12 @@ Metadata Values
39 Used as the contents of the [`<email>`][elem:given-names]
39 Used as the contents of the [`<email>`][elem:given-names]
43+ : list of affiliation identifiers; marks the organizations
44+ with which an author is affiliated. Each identifier in this
45+ list must also occur as the `id` of an affiliation listed in
46+ the top-level `affiliation` list.
43 : identifier linking to the contributor's correspondence
49 : identifier linking to the contributor's correspondence
44 information. The info itself must be stored in as an item in
50 information. The info itself must be stored in as an item in
@@ -48,6 +54,73 @@ Metadata Values
48 [`rid`][attr:rid] attribute is set to `cor-<ID>`, where
54 [`rid`][attr:rid] attribute is set to `cor-<ID>`, where
49 `<ID>` is the stringified value of this attribute.
55 `<ID>` is the stringified value of this attribute.
58+: the list of organizations with which contributors are
59+ affiliated. Each institution is added as an [`<aff>`] element to
60+ the author's contrib-group.
62+ The fields are given in the order in which they are included in
66+ : internal identifier; used as the [`<aff>`] element's `id`
67+ value, prefixed with `aff-`.
70+ : name of the research group or other low-level organizational
71+ structure; used as value of an [`<institution>`] element with
72+ [`content-type`][attr:content-type] set to `group`.
75+ : name of the department or other mid-level organizational
76+ structure; used as value of an [`<institution>`] element with
77+ [`content-type`][attr:content-type] set to `dept`.
80+ : name of the company, university, or other top-level
81+ organizational structure; used as value of an
82+ [`<institution>`] element. The institution element is wrapped
83+ in an [`<institution-wrap>`] element; any identifiers, like
84+ `ringgold` or `ror`, are added to the wrapper and must hence
85+ belong to this organization (not the department or group).
88+ : International Standard Name Identifier of the organization.
89+ Added via an [`<institution-id>`] element with
90+ [`institution-id-type`](attr:institution-id-type) set to
94+ : [Ringgold] identifier of the organization. Added via an
95+ [`<institution-id>`] element with
96+ [`institution-id-type`](attr:institution-id-type) set to
100+ : Research Organization Registry identifier of the
101+ organization. Added via an [`<institution-id>`] element with
102+ [`institution-id-type`](attr:institution-id-type) set to
106+ : The organization's street address; each list item is wrapped
107+ in an [`<addr-line>`] element, separated by a comma and
111+ : City in which the organization is located; used only if
112+ `street-address` is not given, in which case the value is
113+ wrapped in a [`<city>`] element.
116+ : Country in which the organization is located; used as the
117+ value of a [`<country>`] element.
120+ : Two letter ISO-3166-1 country identifier; used as the
121+ [`country`][attr:country] attribute in element [`<country>`]
122+ (if the latter is present).
51`copyright`
124`copyright`
52: Licensing and copyright information. This information is
125: Licensing and copyright information. This information is
53 rendered via the [`<permissions>`][elem:permissions] element.
126 rendered via the [`<permissions>`][elem:permissions] element.
@@ -258,7 +331,10 @@ Required metadata values:
258 `journal.pmc`.
331 `journal.pmc`.
259- One or more of `journal.pissn`, `journal.eissn`.
332- One or more of `journal.pissn`, `journal.eissn`.
334+[Ringgold]: https://ringgold.com/
335+[attr:content-type]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/attribute/content-type.html
261[attr:fn-type]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/attribute/fn-type.html
336[attr:fn-type]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/attribute/fn-type.html
337+[attr:institution-id-type]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/attribute/institution-id-type.html
262[attr:iso-8601-date]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/attribute/iso-8601-date.html
338[attr:iso-8601-date]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/attribute/iso-8601-date.html
263[attr:journal-id-type]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/attribute/journal-id-type.html
339[attr:journal-id-type]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/attribute/journal-id-type.html
264[attr:kwd-group-type]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/attribute/kwd-group-type.html
340[attr:kwd-group-type]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/attribute/kwd-group-type.html
@@ -297,3 +373,11 @@ Required metadata values:
297[elem:subject]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/subject.html
373[elem:subject]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/subject.html
298[elem:surname]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/surname.html
374[elem:surname]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/surname.html
299[elem:xref]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/xref.html
375[elem:xref]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/xref.html
377+[`<addr-line>`]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/addr-line.html
378+[`<aff>`]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/aff.html
379+[`<city>`]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/city.html
380+[`<country>`]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/country.html
381+[`<institution-id>`]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/institution-id.html
382+[`<institution-wrap>`]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/institution-wrap.html
383+[`<institution>`]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/institution.html