representative-hcard-brainstorming: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
(drafted with info from representative-hcard and hcard-brainstorming)
 
(document Ryan and Tantek's simple auto-discovery proposal using rel me and uid and url)
Line 5: Line 5:
== proposals ==
== 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.
Ways to auto discover the representative hCard for a page, that is the hCard that is the person (or organization) that the page represents.
=== rel me and url uid ===
By Ryan King, Tantek Çelik 2007-10-23.
The basic technique for finding the representative hCard for a page:
* use the first hCard on the page which has uid=url=source. That is, the <code>uid</code> property value of the hCard is also a <code>url</code> property value for the hCard, and that URL is the URL of the page as well.
* otherwise use the first hCard which has a rel="me" class="url". That is, the first hCard that has a <code>url</code> property on an <code>a href</code> which also has <code>rel="me"</code>.  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 a <code>url</code> property value for an hCard then that hCard {{must}} be about both the "to" page and the page that the hCard is on.
* otherwise there is no representative hCard.


== user scenario ==
== user scenario ==
User scenario:
User scenario:
Here is a scenario that outlines the proposed representative hCard auto-discovery process:
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
# I (as user) give the URL of my homepage or hCard or other profile URL, to a site that wants a profile icon

Revision as of 01:50, 25 October 2007

representative hCard brainstorming

Proposals for indicating on pages that represent individual people which hCards represents that person. Part of the representative-hcard effort.

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.

rel me and url uid

By Ryan King, Tantek Çelik 2007-10-23.

The basic technique for finding the representative hCard for a page:

  • use the first hCard on the page which has uid=url=source. That is, the uid property value of the hCard is also a url property value for the hCard, and that URL is the URL of the page as well.
  • otherwise use the first hCard which has a rel="me" class="url". That is, the first hCard that has a url property on an a href which also has rel="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 a url property value for an hCard then that hCard MUST be about both the "to" page and the page that the hCard is on.
  • otherwise there is no representative hCard.

user scenario

User scenario: Here is a scenario that outlines a proposed representative hCard auto-discovery process:

  1. I (as user) give the URL of my homepage or hCard or other profile URL, to a site that wants a profile icon
  2. That site goes and gets it (e.g. using hKit), and then:
    1. 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.)
    2. 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.)
    3. 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.)
    4. 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).
  3. The site looks in the hCard for a "logo" property and uses the first one if it finds any.
  4. Otherwise it looks for a "photo" property and uses the first one if it finds any.
  5. 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.

see also