@@ -39,6 +39,12 @@ Metadata Values
3939 Used as the contents of the [`<email>`][elem:given-names]
4040 element.
4141
42+ `affiliation`
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.
47+
4248 `cor-id`
4349 : identifier linking to the contributor's correspondence
4450 information. The info itself must be stored in as an item in
@@ -48,6 +54,73 @@ Metadata Values
4854 [`rid`][attr:rid] attribute is set to `cor-<ID>`, where
4955 `<ID>` is the stringified value of this attribute.
5056
57+`affiliation`
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.
61+
62+ The fields are given in the order in which they are included in
63+ the output.
64+
65+ `id`
66+ : internal identifier; used as the [`<aff>`] element's `id`
67+ value, prefixed with `aff-`.
68+
69+ `group`
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`.
73+
74+ `department`
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`.
78+
79+ `organization`
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).
86+
87+ `isni`
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
91+ `ISNI`.
92+
93+ `ringgold`
94+ : [Ringgold] identifier of the organization. Added via an
95+ [`<institution-id>`] element with
96+ [`institution-id-type`](attr:institution-id-type) set to
97+ `Ringgold`.
98+
99+ `ror`
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
103+ `ROR`.
104+
105+ `street-address`
106+ : The organization's street address; each list item is wrapped
107+ in an [`<addr-line>`] element, separated by a comma and
108+ space (`, `).
109+
110+ `city`
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.
114+
115+ `country`
116+ : Country in which the organization is located; used as the
117+ value of a [`<country>`] element.
118+
119+ `country-code`
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).
123+
51124`copyright`
52125: Licensing and copyright information. This information is
53126 rendered via the [`<permissions>`][elem:permissions] element.
@@ -258,7 +331,10 @@ Required metadata values:
258331 `journal.pmc`.
259332- One or more of `journal.pissn`, `journal.eissn`.
260333
334+[Ringgold]: https://ringgold.com/
335+[attr:content-type]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/attribute/content-type.html
261336[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
262338[attr:iso-8601-date]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/attribute/iso-8601-date.html
263339[attr:journal-id-type]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/attribute/journal-id-type.html
264340[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:
297373[elem:subject]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/subject.html
298374[elem:surname]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/surname.html
299375[elem:xref]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/xref.html
376+
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