representative-hcard-brainstorming: Difference between revisions
(Author hCard / Contact hCard) |
|||
| Line 54: | Line 54: | ||
An hCard linked to with rel="author" (for hysterical raisins, rev="made" should also be recognised), is the author hCard. A page may have multiple authors. rel="author" and rev="made" are defined by HTML 5. | An hCard linked to with rel="author" (for hysterical raisins, rev="made" should also be recognised), is the author hCard. A page may have multiple authors. rel="author" and rev="made" are defined by HTML 5. | ||
hAtom already uses class="author vcard" to identify the feed author, which also has the advantage (or maybe limitation) that it does not have an existing 'applies to the whole page' semantic like rel does (consider a page of blog posts with different authors). | |||
=== contact hcard === | === contact hcard === | ||
Revision as of 17:25, 25 March 2008
representative hCard brainstorming
Proposals for indicating on pages that represent individual people which hCards represents that person. Part of the representative-hcard effort.
summary
- representative-hcard-authoring for the current best proposal for how to publish a representative hCard
- representative-hcard-parsing for the current best proposal for how to find a representative hCard on a page.
proposals
Ways to auto discover the representative hCard for a page, that is the hCard that is the person (or organization) that the page represents.
url uid source and rel me
By Ryan King, Tantek Çelik 2007-10-23.
The basic technique for finding the representative hCard for a page:
- uid=url=source. use the first hCard on the page which has uid=url=source. That is, the
uidproperty value of the hCard is also aurlproperty value for the hCard, and that URL is the URL of the page as well. - rel="me" on class="url". otherwise use the first hCard which has a rel="me" class="url". That is, the first hCard that has a
urlproperty on ana hrefwhich also hasrel="me". Since a rel-me hyperlink MUST be from a page that represents a person to another page that represents the same person, if that "to" page is aurlproperty value for an hCard then that hCard MUST be representative of both the "to" page and the page that the hCard is on. - otherwise no representative hCard can be identified.
rel me and url source else first
Originally collaboratively evolved on the hcard-brainstorming page:
- rel="me" on class="url". check to see if there is an hCard with a "url" property on a rel="me" hyperlink (since rel="me" only works from a whole page to a whole page, if an hCard contains such a URL, then that hCard must represent the page. see XFN identity consolidation for more details.), and uses it if it finds it. (if there is more than one such hCard on the page? for now use the first such hCard.)
- url=source. check to see if there is an hCard with a "url" property that points to the current page, and use it if you find it. similar to the above rel="me" case, if an hCard is pointing to the current page, then it is likely that the hCard is about the current page. (if there is more than one such hCard on the page? for now use the first such hCard.)
- otherwise use the first hCard you find (which in cases of profile URLs which have a single hCard like on Flickr and Technorati, will work as expected). (what about pages that don't represent individual people but have hCards? won't this result in false positives?)
user scenario
User scenario: Here is a scenario that outlines a proposed representative hCard auto-discovery process:
- I (as user) give the URL of my homepage or hCard or other profile URL, to a site that wants a profile icon
- That site goes and gets it (e.g. using hKit), and then:
- checks to see if there is an hCard with a "url" property on a rel="me" hyperlink (since rel="me" only works from a whole page to a whole page, if an hCard contains such a URL, then that hCard must represent the page. see XFN identity consolidation for more details.), and uses it if it finds it. (if there is more than one such hCard on the page? for now use the first such hCard.)
- checks to see if there is an hCard with a "url" property that points to the current page, and uses it if it finds it. similar to the above rel="me" case, if an hCard is pointing to the current page, then it is likely that the hCard is about the current page. (if there is more than one such hCard on the page? for now use the first such hCard.)
- checks to see if there is an <address> hCard (thus meaning contact for the page), and uses it if it finds it. (what if there is more than one such hCard on the page? e.g. such as the multiple address hCards for hAtom entries. for now use the first such hCard.)
- otherwise uses the first hCard it finds (which in cases of profile URLs which have a single hCard like on Flickr and Technorati, will work as expected).
- The site looks in the hCard for a "logo" property and uses the first one if it finds any.
- Otherwise it looks for a "photo" property and uses the first one if it finds any.
- Otherwise the site uses a default icon, but subscribes to the URL with the hCard and checks it for a "logo" or "photo", say, once a day.
class=representative vcard
Use of an additional class name, say class="representative vcard" (as an alternative to, or in addition to, the above patterns), would deal with the problems with the above proposals, as raised on representative-hcard-issues. It would also be quickly reusable for class="representative vevent" and other such microformats. A rule would require only one use of class="representative", per microformat, per page. Andy Mabbett 16:10, 2 Feb 2008 (PST)
- As per Semantic XHTML Design Principles, wouldn't id="representative" be better than a class? TobyInk 09:01, 18 Feb 2008 (PST)
- A page could have a representative hCard and a representative hCalendar (or some other pair of representative microformats); but ID can only be used once. A workaround (I state this for the record, not as a recommendation) would be
ID="representative-hcard", etc. Andy Mabbett 09:31, 18 Feb 2008 (PST)
- A page could have a representative hCard and a representative hCalendar (or some other pair of representative microformats); but ID can only be used once. A workaround (I state this for the record, not as a recommendation) would be
author hcard / contact hcard
TobyInk 10:24, 22 Mar 2008 (PDT):
Related to the concept of a representative hCard are the concept of the author hcard and contact hcard for a page. In many cases, all three will be the same hCard, though sometime they will differ. Here are some ideas for how to identify the author and contact hcards. (This section perhaps should be spun off as its own page?)
author hcard
An hCard linked to with rel="author" (for hysterical raisins, rev="made" should also be recognised), is the author hCard. A page may have multiple authors. rel="author" and rev="made" are defined by HTML 5.
hAtom already uses class="author vcard" to identify the feed author, which also has the advantage (or maybe limitation) that it does not have an existing 'applies to the whole page' semantic like rel does (consider a page of blog posts with different authors).
contact hcard
An hCard found in an <address> element represents the contact for the page, or for a major section of the page.