Skip to content
Marcos Caceres edited this page Mar 27, 2026 · 17 revisions

Person objects

A person object is used by editors, authors, and formerEditors. Only name is required.

Full example

var respecConfig = {
  editors: [
    {
      name: "Alice Smith",
      url: "https://alice.example/",
      company: "Example Corp",
      companyURL: "https://example.org/",
      w3cid: 12345,
      orcid: "https://orcid.org/0000-0001-2345-6789",
      note: "Invited Expert",
      extras: [
        {
          name: "Personal blog",
          href: "https://alice.example/blog",
          class: "blog",
        }
      ],
    },
  ],
};

Fields

Field Type Required Description
name string Yes Full name of the person
url string No Personal URL. Use mailto:email@example.org for email links.
company string No Employer or affiliation
companyURL string No URL of the employer
w3cid number No W3C account ID. Find yours at w3.org/users/myprofile. Enables contributor stats.
orcid string No ORCID iD — full URL or bare ID (e.g. 0000-0001-2345-6789). Displays an ORCID icon.
note string No Short text shown in parentheses after the name (e.g. "Invited Expert", "until 2023")
extras Extra[] No Additional links shown after the person entry
retiredDate string No "YYYY-MM-DD" — marks the person as retired from this date. Shows them as "until [date]".

extras format

Each entry in extras is an object:

Field Type Required Description
name string Yes Link text (may contain HTML)
href string No URL for the link
class string No CSS class(es) on the resulting element

Notes

  • w3cid is strongly recommended for W3C documents — it links the editor to their W3C profile
  • orcid can be a full URL (https://orcid.org/0000-…) or just the identifier (0000-…)
  • retiredDate is useful for keeping a former editor listed inline while showing when they left

Guides

Configuration options

W3C Configuration options

Linting rules

Internal properties

Handled by ReSpec for you.

Special <section> IDs

HTML elements

Custom Elements

HTML attributes

CSS Classes

Special properties

Clone this wiki locally