person - speced/respec GitHub Wiki
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 protected] 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
w3cidis strongly recommended for W3C documents — it links the editor to their W3C profileorcidcan be a full URL (https://orcid.org/0000-…) or just the identifier (0000-…)retiredDateis useful for keeping a former editor listed inline while showing when they left