Help:Schema.org
Categories: Developer Help
Language: en | de
We are use Schema.org tags on WikiTree profiles. We're also trying to use the evolving extensions from historical-data.org.
Notes
Here's some explanation, and open questions.
- The tags are only on person profiles and photo pages. Free-space profiles are not marked-up yet. Neither are Watchlists, surname index pages, etc.
- image is only for the main profile photo on a profile. The Schema on photo pages is not connected.
- name is used for name as it appears at the top of the profile, i.e. Preferred First Name (Last Name at Birth) Current Last Name Suffix. The appearance of Last Name at Birth and Suffix are conditional.
- givenName is used for Proper First Name.
- familyName is used for Last Name at Birth.
- additionalName is used for Middle Name or middle initial.
- Nicknames and Other Last Names are not marked-up at all.Preferred First Name and Current Last Name are not marked-up independently; they're only part of name. We could use additionalNames for some or all of these, but then you couldn't uniquely identify the middle name. It's unfortunate that the Person Schema doesn't have more tags.
- gender is either male, female, or unknown.
- children is for an individual child. Each child is identified separately. Not sure why Schema.org doesn't use the singular form "child" like with parent, sibling, spouse.
- honorificSuffix is used for Suffix, even though the intended use examples are "M.D./PhD" etc.
- Google's rich snippets testing tool doesn't reject the presence of http://historical-data.org/Person.html as an additional itemtype next to http://schema.org/Person. Presumably it's just ignored. Is this really how it's supposed to be used when there are extensions to Schema?
- Nuclear relatives linked from a person profile do not themselves have full Person Schema. They just have url links and names. We're not breaking down the givenName, familyName, gender etc. on nuclear relatives. Presumably it's more efficient to just get those from the other profile.
- Dates are given in the form YYYY-MM-DD without any about/before/after modifiers. How should those be included? This has been talked about in certain circles; what is the standard?
Outline of tags
Here is the mark-up we're currently using on person profiles. <html itemscope itemtype="http://schema.org/Person" itemtype="http://historical-data.org/Person.html">
- <link itemprop="url" />
- <href/img itemprop="image" />
- <h1 itemprop="name"></h1>
- <span itemprop="honorificPrefix"></span>
- <span itemprop="givenName"></span>
- <span itemprop="additionalName"></span>
- <meta itemprop="familyName" />
- <span itemprop="honorificSuffix"></span>
- <meta itemprop="gender" />
- <time itemprop="birthDate" datetime="YYYY-MM-DD"></time>
- <span itemprop="birth" itemscope itemtype="http://schema.org/Event">
- <span itemprop="location" itemscope itemtype="http://schema.org/Place">
- <span itemprop="name"></span>
- </span>
- <span itemprop="location" itemscope itemtype="http://schema.org/Place">
- </span>
- <time itemprop="deathDate" datetime="YYYY-MM-DD"></time>
- <span itemprop="death" itemscope itemtype="http://schema.org/Event">
- <span itemprop="location" itemscope itemtype="http://schema.org/Place">
- <span itemprop="name"></span>
- </span>
- <span itemprop="location" itemscope itemtype="http://schema.org/Place">
- </span>
- <span itemprop="parent" itemscope itemtype="http://schema.org/Person">
- <href itemprop="url">
- <span itemprop="name"></span>
- </span>
- <span itemprop="sibling" itemscope itemtype="http://schema.org/Person">
- <href itemprop="url">
- <span itemprop="name"></span>
- </span>
- <span itemprop="spouse" itemscope itemtype="http://schema.org/Person">
- <href itemprop="url">
- <span itemprop="name"></span>
- </span>
- <span itemprop="marriage" itemscope itemtype="http://schema.org/Event">
- <time itemprop="startDate" datetime="YYYY-MM-DD"></time>
- <time itemprop="endDate" datetime="YYYY-MM-DD"></time>
- <span itemprop="location" itemscope itemtype="http://schema.org/Place">
- <span itemprop="name"></span>
- </span>
- </span>
- <span itemprop="children" itemscope itemtype="http://schema.org/Person">
- <href itemprop="url">
- <span itemprop="name"></span>
- </span>
</html>
This page was last modified 15:54, 3 February 2023. This page has been accessed 1,655 times.