ST: New page: {{lowercase|title=hCard}} '''hCard''' (short for '''''HTML vCard''''') is a microformat for publishing the contact details of people, companies, organizations, and places, in [[HTML|(...

2008-03-30T05:25:56Z

New page: {{lowercase|title=hCard}} '''hCard''' (short for '''''HTML vCard''''') is a microformat for publishing the contact details of people, companies, organizations, and places, in [[HTML|(...

New page

{{lowercase|title=hCard}}
'''hCard''' (short for '''''HTML vCard''''') is a [[microformat]] for publishing the contact details of people, companies, organizations, and places, in [[HTML|(X)HTML]], [[Atom (standard)|Atom]], [[RSS (file format)|RSS]], or arbitrary [[Extensible Markup Language|XML]]. hCard does this using a 1:1 representation of [[vCard]] ([[Request for Comments|RFC]] 2426) properties and values.

It allows parsing tools (for example other websites, or [[Firefox]]'s [[Operator (extension)|Operator extension]]) to extract the details, and display them using some other website or [[map]]ping tool, index or search them, or to load them into an address book program, for instance.

== Example ==
Consider the HTML:

<nowiki>
<div>
<div>Joe Doe</div>
<div>The Example Company</div>
<div>604-555-1234</div>
<a href="http://example.com/">http://example.com/</a>
</div>
</nowiki>

With microformat markup, that becomes:

<nowiki>
<div class="vcard">
<div class="fn">Joe Doe</div>
<div class="org">The Example Company</div>
<div class="tel">604-555-1234</div>
<a class="url" href="http://example.com/">http://example.com/</a>
</div>
</nowiki>

Here the formal name (''fn''), organization (''org''), telephone number (''tel'') and [[URL|web address]] (''url'') have been identified using specific class names; and the whole thing is wrapped in <code>class="vcard"</code> which indicate that the other classes form an hcard, and are not just coincidentally named. If the hCard is for an organisation or venue, the ''fn'' and ''org'' classes are used on the same element, as in <code><nowiki><span class="fn org">Wikipedia</span></nowiki></code> or <code><nowiki><span class="fn org">Wembley Stadium</span></nowiki></code>. Other, optional, hCard classes also exist.

It is now possible for software, for example browser plug-ins, to extract the information, and transfer it to other applications, such as an address book.

==Geo + adr==
The [[Geo (microformat)|Geo microformat]] is a part of the hCard specification, and is often used to include the coordinates of a location within an hCard.

The ''adr'' part of hCard can also be used as a stand-alone microformat.

==Live example==

Here are the Wikimedia Foundation's contact details, as a live hCard:

<blockquote style="font-weight:bold">
<div class="vcard">
<div class="fn org">Wikimedia Foundation Inc.</div>
<div class="adr">
<div class="street-address">200 2nd Ave. South #358</div>
<div> <span class="locality">St. Petersburg</span>, <span class="region">FL</span> <span class="postal-code">33701-4313</span></div>
<div class="country-name">USA</div>
</div>
<div>Phone: <span class="tel">+1-727-231-0101</span></div>
<div>Email: <span class="email">info@wikimedia.org</span></div>
<div><span class="tel"><span class="type">Fax</span>: <span class="value">+1-727-258-0207</span></span></div>
</div>
</blockquote>

The mark-up (wrapped for clarity) used is:

<pre><nowiki>
<div class="vcard">
<div class="fn org">Wikimedia Foundation Inc.</div>
<div class="adr">
<div class="street-address">200 2nd Ave. South #358</div>
<div>
<span class="locality">St. Petersburg</span>,
<span class="region">FL</span> <span class="postal-code">33701-4313</span>
</div>
<div class="country-name">USA</div>
</div>
<div>Phone: <span class="tel">+1-727-231-0101</span></div>
<div>Email: <span class="email">info@wikimedia.org</span></div>
<div>
<span class="tel"><span class="type">Fax</span>:
<span class="value">+1-727-258-0207</span></span>
</div>
</div>
</nowiki></pre>

(Ordinarily, one would use

<pre><nowiki>
<abbr class="region" title="Florida">FL</abbr>
</nowiki></pre>

so that the output included <code>region="Florida"</code>, but the <code>abbr</code> element is not supported on Wikipedia.)

Note that, in this example, the formal name (''fn'') and organisation (''org'') properties are combined on one element, indicating that this is the hCard for an organisation, not a person.

==Other attributes==
Other commonly used hCard attributes include
*<code>bday</code> - a person's birth date
*<code>email</code>
*<code>honorific-prefix</code>
*<code>honorific-suffix </code>
*<code>label</code> - for [[granularity#Data Granularity|non-granular]] addresses
*<code>logo</code>
*<code>nickname</code>
*<code>note</code> - free text
*<code>photo</code>
*<code>post-office-box</code>

==See also==
* [[DataPortability]]

==References==
* Microformats: Empowering Your Markup for Web 2.0 (2007) by John Allsopp p. 125

== External links ==
* [http://microformats.org/wiki/hcard hCard spec on microformats.org]
* [http://microformats.org/wiki/hcard-cheatsheet hCard cheat-sheet]
* Some have recommended using hCard Microformat for the sake of local search engine optimization. While there's no clear benefit to local search placement from using hCard, this [http://searchengineland.com/071015-123143.php article on hCard and local search] outlines reasons why it's a good idea to incorporate.

[[Category:Microformats]]

[[es:HCard]]
[[fr:HCard]]
[[lv:HCard]]
[[pl:HCard]]
[[simple:HCard]]
[[zh:HCard]]

HCard - Revision history

ST: New page: {{lowercase|title=hCard}} '''hCard''' (short for '''''HTML vCard''''') is a microformat for publishing the contact details of people, companies, organizations, and places, in [[HTML|(...