hcards-and-pages - Revision history

Nick: Clarified mainly that author is content author, not page author.

2009-10-08T16:38:10Z

Clarified mainly that author is content author, not page author.

← Older revision		Revision as of 16:38, 8 October 2009
Line 24:		Line 24:

	=== author ===		=== author ===
	~~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'' means 'content author', not 'page author' (as those terms are often used in Web design work). For 'page author', see [[hcards-and-pages#contact\|''contact'']].
	* ~~common~~ misconception: ''"[http://microformats.org/discuss/mail/microformats-discuss/2007-July/010170.html using <address> works when the person is the principal author of the page]"''. This is misleading at best. It may "work", but <code><address></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.
			The person that a page represents may or may not also be the author of the page. Possible (theoretical until someone finds/cites real world) examples of not being the same include biographies, viz., the content representing person A is authored by person B.

			* Common misconception: ''"[http://microformats.org/discuss/mail/microformats-discuss/2007-July/010170.html using <address> works when the person is the principal author of the page]"''. This is misleading at best. It may "work", but <code><address></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 ===		=== owner ===

TobyInk: /* implementations */ author hcard

2008-07-08T13:53:53Z

implementations: author hcard

← Older revision		Revision as of 13:53, 8 July 2008
Line 34:		Line 34:
	== implementations ==		== implementations ==

	[http://buzzword.org.uk/cognition/ Cognition] is able to determine the representative and contact hCard(s) for a page, using algorithms similar to those described on this page.		[http://buzzword.org.uk/cognition/ Cognition] is able to determine the representative and contact hCard(s) for a page, using algorithms similar to those described on this page. The author hCard can be specified by assigning an <code>id</code> attribute to the hCard root element and linking to that fragment identifier using <code>rel="author"</code> or <code>rev="made"</code>.

	== related pages ==		== related pages ==

TobyInk: Implementations

2008-06-08T14:34:38Z

Implementations

← Older revision		Revision as of 14:34, 8 June 2008
Line 31:		Line 31:

	Though clearly it is possible to have one person own a page (perhaps the manager of the website), and yet have another person be the contact for the page (perhaps a system administrator or webmaster).		Though clearly it is possible to have one person own a page (perhaps the manager of the website), and yet have another person be the contact for the page (perhaps a system administrator or webmaster).

			== implementations ==

			[http://buzzword.org.uk/cognition/ Cognition] is able to determine the representative and contact hCard(s) for a page, using algorithms similar to those described on this page.

	== related pages ==		== related pages ==

Tantek: hAtom misuses address element

2008-06-08T00:39:46Z

hAtom misuses address element

← Older revision		Revision as of 00:39, 8 June 2008
Line 37:		Line 37:
	* [[hcard-brainstorming]]		* [[hcard-brainstorming]]
	* [[hcard-supporting-user-profiles]]		* [[hcard-supporting-user-profiles]]
			* [[hatom-issues#misuse_of_address_element\|hAtom issues: misuse of address element]]

Tantek: drafted starting with material from representative-hcard

2008-06-08T00:12:40Z

drafted starting with material from representative-hcard

New page

<h1>hCards and pages</h1>

Web pages often represent people, are written by people, owned by people, and/or have a point of contact (for maintenance or other issues).

While these are often the same person, they can be (and sometimes are) different people, and thus it is useful to document these distinctions.

== hCards for pages ==

=== represent ===
[[hCard]] is very often used to markup user profile pages. See [[hcard-supporting-user-profiles]] for many example user profiles, often on social networking sites, marked up with hCard.

Such profile pages ''represent'' a person, and thus the use of hCard to markup that person is called a ''representative hCard''. See the [[representative hCard]] page for more details on how to markup such hCards differently from other hCards on the page, and how to find and parse representative hCards.

=== contact ===
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><address></code> hCard.

There are numerous cases of pages that represent one person but have a different contact, or perhaps no explicit contact at all.

For example, Wikipedia has numerous biography pages which represent individuals, but obviously (given Wikipedia's editing/maintenance conventions) those individuals are not the contacts for their biography pages. The most obvious example of this are biographies of deceased individuals who clearly cannot be a contact for such pages, e.g. [http://en.wikipedia.org/wiki/Carl_Sagan Carl Sagan].

In such cases, only the ''contact'' for the page should be marked up with the <code><address></code> element, and certainly ''not'' the representative hCard (if any).

If there is no contact for the page, then there should be no <code><address></code> element on the page (or perhaps an empty <code><address></code> element may be an acceptable way of explicitly indicating that there is no contact for the page).

=== author ===
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 <address> works when the person is the principal author of the page]"''. This is misleading at best. It may "work", but <code><address></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 ===
Often the person that a page represents is also the person that owns (meaning has primary control over or decision-making authority about) the page.

Though clearly it is possible to have one person own a page (perhaps the manager of the website), and yet have another person be the contact for the page (perhaps a system administrator or webmaster).

== related pages ==
* [[hCard]]
* [[representative-hcard]]
* [[hcard-brainstorming]]
* [[hcard-supporting-user-profiles]]