hcard-examples-in-wild

From Microformats Wiki
Revision as of 18:05, 23 December 2006 by Tantek (talk | contribs)
Jump to navigation Jump to search

hCard Examples in the wild

This page is an informative section of the hCard specification.

The following sites have published hCards, and thus are a great place to start for anyone looking for examples "in the wild" to try parsing, indexing, organizing etc.

If people or organizations on your site are marked up with hCard (even just your own contact information), feel free to add it to the top of this list. Please be sure to include at least one URL to a page on your site that includes actual hCard markup. Examples added without a URL to a page with hCard markup may be removed.

Want to get started with writing an hCard? Use the hCard creator to write up some contact information and publish it, or follow the hCard authoring tips to add hCard markup to your current contact page.

New Examples

Please add new examples to the top of this section.

Examples

UTF8 Examples

These examples all contain one or more characters in UTF8 that are outside the ASCII7 range and make for excellent test cases to make sure you are handling UTF8 properly throughout your hCard parsing and transforming. And especially if you are generating vCards, these test cases will help you make sure you are generating UTF8 vCards in such a way that can be recognized by UTF8 supporting vCard applications.

Examples with some problems

Entries may be moved here if there's a problem with the way hCards are used on the page concerned. If the page is yours, and you want to improve it, see the hCard FAQ, or raise any queries on hCard Issues or the mailing list, where people will be happy to help you.

  • G3:2 uses hCard with geo tags in the copyright and on the about me page
    • Address data is hidden using CSS.
  • wizardishungry/blog has the author's hCard in the footer of every page.
    • Address data is hidden using CSS.
  • ZDnet Contact Us Page supports hCard.
  • Gerard Braad has published an example on his profile page that is almost consistent with his original vCard file. Also progress is made for transforming his FoaF file to a hCard encoded representation (also done for my spouse:Yong Yuan)
    • (2005-09-27) PASSED, PASSED
    • WARNINGS
      • uses 'n given-name' and 'n family-name' instead of nesting the given- and family- names inside the 'n'
      • has one 'tel' value with a bunch of values stuffed in
      • probably more problems --RyanKing 17:19, 5 Jan 2006 (PST)
  • Cori Schlegel discusses how he has updated his contact page with hCard
    • INVALID - using 'prefix' instead of 'honorific-prefix' and type's in classnames (in both adr and tel) and has two photo's (the second could be 'logo') --RyanKing 15:15, 5 Jan 2006 (PST)
  • The good ship Leonid Miloslavskiy spotted in the North Atlantic
    • INVALID --RyanKing 00:50, 27 Oct 2005 (PDT)
      • class="family" should probably be family-name
      • the "n" property is missing and the "n" optimization can't be applied
      • the first geo propery is empty, the second one is invalid (ie, it doesn't contain lat/long)
  • Landsbanki Føroya
    • INVALID - using embedded rdf/xml invalidly
  • Chris Cherry's contact page with his hCard
    • WARNING - uses class="cell" instead of <span class="type">cell</span> Fixed -- Chris Cherry 19:54, 15 Sep 2006 (PST)
  • University of Bath Person Finder results are encoded with hCards so you can easily create a vCard from any result.
    • ERROR - attempt to use Implied-N optimization where that's not possible. --RyanKing 14:29, 5 Jan 2006 (PST)
    • Error appears for external users only. Won't be fixed any time soon. -- PhilWilson 00:03, 28 Jan 2006 (GMT)
  • Richi Jennings has put up his attempt
    • INVALID, missing FN --RyanKing 12:47, 5 Jan 2006 (PST)
  • Yellow Pencil Using microformats to present company contact information
    • First hcard has empty "fn" and no "n". "fn" should be with "org" -- ScottReynen 21:29, 19 Jun 2006 (CST)

Related Pages

The hCard specification is a work in progress. As additional aspects are discussed, understood, and written, they will be added. These thoughts, issues, and questions are kept in separate pages.