representative-hcard-brainstorming: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
m (phrasing tweak and commented alternative wording.)
(add links to summary -authoring and -parsing pages)
Line 2: Line 2:
{{TOC-right}}
{{TOC-right}}
Proposals for indicating on pages that represent individual people which [[hcard|hCards]] represents that person.  Part of the [[representative-hcard]] effort.
Proposals for indicating on pages that represent individual people which [[hcard|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 ==
== proposals ==
Line 36: Line 40:
== see also ==
== see also ==
* [[representative-hcard]]
* [[representative-hcard]]
* [[representative-hcard-authoring]]
* [[representative-hcard-parsing]]
* [[representative-hcard-examples]]
* [[representative-hcard-examples]]
* [[representative-hcard-formats]]
* [[representative-hcard-formats]]

Revision as of 12:28, 20 November 2007

representative hCard brainstorming

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

summary

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:

  1. uid=url=source. 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.
  2. 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 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 representative of both the "to" page and the page that the hCard is on.
  3. otherwise there is no representative hCard.

rel me and url source else first

Originally collaboratively evolved on the hcard-brainstorming page:

  1. 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.)
  2. 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.)
  3. 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:

  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