Template Contract

Each paper’s rights.json specifies a display.notice_template key. The key must match one of the values enumerated below. The aggregator script (tools/build-publications-index.py) fails CI if it encounters a key not listed here. Required fields for each template are listed alongside the rendered output.

To add a new template, extend this page in the same revision as the aggregator’s template registry. No template exists that is not surfaced here.

Renderings below show the canonical string with placeholder values in {curly braces}. At render time, each field is substituted from rights.json; the template body itself is not editable per paper.

Enumerated Templates

summary-only

Tier C default: DOI link only, no manuscript content hosted. Rendered at the foot of every Tier C paper page.

Used for: Tier C (default)

Required fields:

  • doi — DOI of the published work
  • journal — journal name
  • date_published — ISO 8601 date
Rendered notice
Summary only. This page does not host the article text or publisher figures. Refer to the version of record at doi.org/{doi}, published in {journal} on {date_published}.
cc-by-4.0-standard

Tier A rendering for articles published under CC BY 4.0. Standard attribution with author, title, source, licence, and modifications fields.

Used for: Tier A (CC BY 4.0 articles)

Required fields:

  • authors — full author list, final form as published
  • title — article title
  • journal — journal name
  • date_published — ISO 8601 date
  • doi — DOI of the published work
  • modifications — description of any modifications; omit if none
Rendered notice
{authors}. “{title}.” {journal} ({date_published}). doi.org/{doi}. Licensed under CC BY 4.0. {modifications_clause}

Where modifications_clause is either empty (no modifications) or “Modifications: {modifications}.”

aps-accepted-manuscript

Tier B rendering for APS journals (PRL, PRA, PRX, etc.) hosting the author-accepted manuscript under APS self-archiving terms.

Used for: Tier B (APS journals)

Required fields:

  • authors — full author list, final form as published
  • title — article title
  • journal — APS journal name
  • date_published — ISO 8601 date
  • doi — DOI of the published work
Rendered notice
Author-accepted manuscript of: {authors}, “{title},” {journal} ({date_published}). This is not the typeset version of record. The definitive version is available at doi.org/{doi}. © American Physical Society. Reuse governed by the APS Transfer of Copyright Agreement self-archiving terms.
springer-nature-accepted-manuscript

Tier B rendering for Springer Nature journals (Nature, Nature Communications under subscription terms, etc.) hosting the author-accepted manuscript subject to the publisher’s embargo.

Used for: Tier B (Springer Nature journals)

Required fields:

  • authors — full author list, final form as published
  • title — article title
  • journal — Springer Nature journal name
  • date_published — ISO 8601 date
  • doi — DOI of the published work
  • embargo_expired_on — ISO 8601 date the relevant embargo lifted
Rendered notice
Author-accepted manuscript of: {authors}, “{title},” {journal} ({date_published}). This is not the typeset version of record; the definitive version is available at doi.org/{doi}. © Springer Nature Limited. Posted under the publisher’s author self-archiving terms; embargo expired {embargo_expired_on}.

Template Governance

Adding, removing, or changing a template is a policy act. The procedure:

  1. Update this page in the same commit that extends the aggregator’s template registry.
  2. Record the change in the parent policy page under governance.
  3. CI verifies that every display.notice_template value in committed rights.json files corresponds to a template on this page; a stray value fails the check.

Free-text notices in rights.json are forbidden. Per-paper variation happens only through the field values a template consumes.