representative-hcard: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
(more content organization)
m (Replace <entry-title> with {{DISPLAYTITLE:}})
 
(8 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{inuse}}
{{DISPLAYTITLE:representative hCard}}
 
<h1>representative hCard</h1>


This page is for keeping track of the representative [[hcard|hCard]] effort, which is part of [[hcard-brainstorming]], specifically to figure out how to both explicitly specify and discover the representative hCard for a page.
This page is for keeping track of the representative [[hcard|hCard]] effort, which is part of [[hcard-brainstorming]], specifically to figure out how to both explicitly specify and discover the representative hCard for a page.


== problem statement ==
== problem statement ==
Short version: '''Given a URL, how do you determine which hCard is the representative hCard for that page?'''
'''Given a URL, how do you determine which hCard is the representative hCard for that page?'''


Longer: Given a URL to a page that represents a person, how do you determine which hCard on that page is the hCard for that person? Variants:
Longer: Given a URL to a page that represents a person (e.g. an [[hcard-supporting-user-profiles|hCard supporting user profile]]), how do you determine which hCard on that page is the hCard for that person?
* Given a URL to a person's [[hcard-supporting-user-profiles|hCard supporting user profile]], how do you determine which hCard on the profile page represents that person?
 
== how to ==
Ok I get it, show me how to both publish and find the representative hCard for a person on a page.
* how to publish: [[representative-hcard-authoring]]
* how to find/discover and parse: [[representative-hcard-parsing]]


== use cases ==
== use cases ==
Applications for auto-discovery of the representative hCard for the page
What are the real world use cases, applications, for auto-discovery of the representative hCard for the page?
* representative vCard auto extraction from the page
* '''[[social-network-portability]]''', in particular [[hcard-supporting-user-profiles#Services_that_import_hCard_profiles|import or preferably subscribe to a person's hCard]].
* profile icon discovery (e.g. what people use gravatar for and have proposed pavatar for).
** profile icon discovery (e.g. what people use gravatar for and have proposed pavatar for). This appears to just be a subset of the profile import/subscribe use case and is thus listed as a nested use case.
* [[social-network-portability]]
* '''representative vCard auto extraction''' from the page. given a page representing a person, if you can determine the representative hCard on the page, you can convert that hCard to a vCard automatically and aggregate it into an address book service or application.


== goals ==
== goals ==
* should leverage current hCard information publishing patterns
* should leverage current hCard information publishing patterns
* should not require any additional user interface elements (i.e. links) on any [[hcard-supporting-user-profiles|hCard supporting user profiles]].
* should not require any additional user interface elements (i.e. links) on any [[hcard-supporting-user-profiles|hCard supporting user profiles]].
* should not use any hidden metadata on the page
* should not use any hidden side files (e.g. random XML)


== methodology ==
== methodology ==
Line 29: Line 33:
* [[representative-hcard-formats]] - previous attempts at providing representative hCard or "person info" in general for a page that represents a person.
* [[representative-hcard-formats]] - previous attempts at providing representative hCard or "person info" in general for a page that represents a person.
* [[representative-hcard-brainstorming]] - proposals for solving the problem
* [[representative-hcard-brainstorming]] - proposals for solving the problem
== synonyms ==
This question has also been asked as:
* What is the authoritative hCard for a page?
* What is the authority of hCards on a page?
* hCard authority?


== related ==
== related ==
The '''representative hCard''' is merely the hCard that provides information about the person that the page ''represents''.


Related but slightly different concepts:
It is '''NOT''':
* contact for the page.  similarly, the person a page represents is usually the person to contact for/about the page.  as [[hcard-faq#Should_I_use_ADDRESS_for_hCards|documented in the hCard FAQ]], the contact for a page {{should}} be marked up with an  <code>&lt;address&gt;</code> hCard.
* '''contact''' for the page.  similarly, the person a page represents is usually the person to contact for/about the page.  as [[hcard-faq#Should_I_use_ADDRESS_for_hCards|documented in the hCard FAQ]], the contact for a page {{should}} be marked up with an  <code>&lt;address&gt;</code> hCard.
* author hCard.  typically the person that a page represents is also the author of the page. possible (theoretical until someone finds/cites real world) examples: biographies, e.g. a page that represents person A is authored by person B.
* '''author''' hCard.  typically the person that a page represents is also the author of the page. possible (theoretical until someone finds/cites real world) examples: biographies, e.g. a page that represents person A is authored by person B.
** common misconception: ''"[http://microformats.org/discuss/mail/microformats-discuss/2007-July/010170.html using &lt;address&gt; works when the person is the principal author of the page]"''.  This is misleading at best. It may "work", but <code>&lt;address&gt;</code> means <em>contact</em> for the page (as documented above), not necessarily the <em>author</em>.  The two might coincidentally (even typically) be the same, but are not semantically equivalent.
** common misconception: ''"[http://microformats.org/discuss/mail/microformats-discuss/2007-July/010170.html using &lt;address&gt; works when the person is the principal author of the page]"''.  This is misleading at best. It may "work", but <code>&lt;address&gt;</code> means <em>contact</em> for the page (as documented above), not necessarily the <em>author</em>.  The two might coincidentally (even typically) be the same, but are not semantically equivalent.
* owner hCard.  more often than not, the person that a page represents is also the person that owns (meaning has primary control over, in the property sense) the page.
* '''owner''' hCard.  more often than not, the person that a page represents is also the person that owns (meaning has primary control over, in the property sense) the page.
 
"'''representative hCard'''", "contact hCard", "author hCard", and "owner hCard" are all ''different'' semantics and can be different people for any given page, even if for many pages some or all of them might be the same person.
 
For more on these semantic distinctions, see [[hcards-and-pages]].


== see also ==
== see also ==
* [[representative-hcard-examples]]
{{representative-hcard-related-pages}}
* [[representative-hcard-formats]]
* [[representative-hcard-brainstorming]]
* [[hcard]]
* [[hcard-brainstorming]]
* [[hcard-brainstorming]]

Latest revision as of 16:32, 18 July 2020


This page is for keeping track of the representative hCard effort, which is part of hcard-brainstorming, specifically to figure out how to both explicitly specify and discover the representative hCard for a page.

problem statement

Given a URL, how do you determine which hCard is the representative hCard for that page?

Longer: Given a URL to a page that represents a person (e.g. an hCard supporting user profile), how do you determine which hCard on that page is the hCard for that person?

how to

Ok I get it, show me how to both publish and find the representative hCard for a person on a page.

use cases

What are the real world use cases, applications, for auto-discovery of the representative hCard for the page?

  • social-network-portability, in particular import or preferably subscribe to a person's hCard.
    • profile icon discovery (e.g. what people use gravatar for and have proposed pavatar for). This appears to just be a subset of the profile import/subscribe use case and is thus listed as a nested use case.
  • representative vCard auto extraction from the page. given a page representing a person, if you can determine the representative hCard on the page, you can convert that hCard to a vCard automatically and aggregate it into an address book service or application.

goals

  • should leverage current hCard information publishing patterns
  • should not require any additional user interface elements (i.e. links) on any hCard supporting user profiles.
  • should not use any hidden metadata on the page
  • should not use any hidden side files (e.g. random XML)

methodology

Methodology for a solution: The preferred option is to use only visible semantic HTML (POSH).

effort

synonyms

This question has also been asked as:

  • What is the authoritative hCard for a page?
  • What is the authority of hCards on a page?
  • hCard authority?

related

The representative hCard is merely the hCard that provides information about the person that the page represents.

It is NOT:

  • contact for the page. similarly, the person a page represents is usually the person to contact for/about the page. as documented in the hCard FAQ, the contact for a page SHOULD be marked up with an <address> hCard.
  • author hCard. typically the person that a page represents is also the author of the page. possible (theoretical until someone finds/cites real world) examples: biographies, e.g. a page that represents person A is authored by person B.
  • owner hCard. more often than not, the person that a page represents is also the person that owns (meaning has primary control over, in the property sense) the page.

"representative hCard", "contact hCard", "author hCard", and "owner hCard" are all different semantics and can be different people for any given page, even if for many pages some or all of them might be the same person.

For more on these semantic distinctions, see hcards-and-pages.

see also