hcard-examples-in-wild: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
(added example grouping sections per to-do#hCard_2, reordered groupings into approximate flow, grouped Dbaron, Tantek and Technorati hCards)
Line 9: Line 9:
Want to get started with writing an [[hcard|hCard]]? Use the [http://microformats.org/code/hcard/creator hCard creator] to write up some contact information and publish it, or follow the [[hcard-authoring|hCard authoring tips]] to add hCard markup to your current contact page.
Want to get started with writing an [[hcard|hCard]]? Use the [http://microformats.org/code/hcard/creator hCard creator] to write up some contact information and publish it, or follow the [[hcard-authoring|hCard authoring tips]] to add hCard markup to your current contact page.


==New Examples==
== Examples To Act On ==


Please add new examples to the '''top''' of this section.
===New Examples===
 
Please add new examples to the '''top''' of this section so they can be reviewed!


* [http://eight6.com/contact/ eight6]'s contact page uses the hCard format.
* [http://eight6.com/contact/ eight6]'s contact page uses the hCard format.
Line 178: Line 180:
* [http://www.merchantcircle.com MerchantCircle] has embedded an hCard in every one of their 15+ million US business listings.
* [http://www.merchantcircle.com MerchantCircle] has embedded an hCard in every one of their 15+ million US business listings.


== Examples ==
===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|hCard FAQ]], or raise any queries on [[hcard-issues|hCard Issues]] or [[mailing-lists#microformats-discuss|the mailing list]], where people will be happy to help you.
 
* [http://www.alexa.com Alexa Internet] marked up its [http://www.alexa.com/site/company/managers managers' page] with hCard.
**Person's job title within "fn". [[User:AndyMabbett|Andy Mabbett]]
* [http://www.naturalengland.org.uk/press/default.htm Natural England] (new UK government agency, formed 2006-10-01).
** No "fn" - which makes it invalid.
* [http://www.matthewwest.co.uk Matthew West] has an hCard on his [http://www.matthewwest.co.uk/email contact] page.
**Flat- and building- number run on.
*[http://drop-off.co.uk G3:2] uses hCard with geo tags in the copyright and on the about me page
** Address data is hidden using CSS.
* [http://zdnet.co.uk/misc/contact/ ZDnet Contact Us Page] supports [[hcard|hCard]].
** by [http://www.subtleasafish.com/ James Myers] and [http://www.fromthefrontend.co.uk/2006/11/23/zdnet-uses-microformats/ David Long]
**Images and e-mail addresses are hidden; telephone numbers do not comply with [http://en.wikipedia.org/wiki/E.123 E.123]
* [http://gbraad.nl/ Gerard Braad] has published an example on his [http://gbraad.nl/site/?p=profile profile] page that is almost consistent with his original [http://gbraad.nl/files/gbraad.vcf vCard] file. Also progress is made for transforming his [http://files.gbraad.nl/foaf.rdf FoaF] file to a hCard encoded representation (also done for my spouse:[http://spouse.gbraad.nl/site/?p=profile 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 --[[User:RyanKing|RyanKing]] 17:19, 5 Jan 2006 (PST)
* [http://kinrowan.net/ Cori Schlegel] [http://kinrowan.net/blog/wp/archives/2005/07/08/a-problem-with-the-structured-blogging-plug-in-for-wordpress/ discusses how he has updated] [http://kinrowan.net/blog/contact 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') --[[User:RyanKing|RyanKing]] 15:15, 5 Jan 2006 (PST)
* The good ship [http://styrheim.com/test/leonid.html Leonid Miloslavskiy] spotted in the North Atlantic
** INVALID  --[[User:RyanKing|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 (i.e., it doesn't contain lat/long)
* [http://landsbank.fo/#hCard Landsbanki Føroya]
** INVALID - using embedded RDF/XML invalidly
* [http://chrischerry.name/ Chris Cherry's contact page with his hCard]
** <strike>WARNING - uses class="cell" instead of &lt;span class="type"&gt;cell&lt;/span&gt;</strike> Fixed -- [[User:Seriph|Chris Cherry]] 19:54, 15 Sep 2006 (PST)
* [http://www.bath.ac.uk/contact/ 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. --[[User:RyanKing|RyanKing]] 14:29, 5 Jan 2006 (PST)
** Error appears for external users only. Won't be fixed any time soon. -- [[User:PhilWilson|PhilWilson]] 00:03, 28 Jan 2006 (GMT)
* [http://richi.co.uk/blog/2005/12/structured-blogging.html Richi Jennings] has put up his attempt
** INVALID, missing "fn"--[[User:RyanKing|RyanKing]] 12:47, 5 Jan 2006 (PST)
* [http://www.yellowpencil.com/contact/ Yellow Pencil] Using microformats to present company contact information
** First hcard has empty "fn" and no "n". "fn" should be with "org" -- [[User: ScottReynen |ScottReynen]] 21:29, 19 Jun 2006 (CST)
 
=== Reviewed Examples ===
Reviewed New Examples which are fine can be moved here to indicate that they've been reviewed. Or take the next step and note which type of example in the wild each of these are, and then please move them to the "Grouped Examples" sectionl
 
* [http://vcardplus.info/show.asp?uid=Z9959-06323 Greg Bays], the author of vCardPlus! has made his sites vCard display page hCard complaint.  
* [http://vcardplus.info/show.asp?uid=Z9959-06323 Greg Bays], the author of vCardPlus! has made his sites vCard display page hCard complaint.  
* [http://www.nfwebsolutions.com/ New Frontier Web Solutions] uses hCard on their front page along with a link pointing to Brian Suda's [http://suda.co.uk/projects/X2V/get-vcard?uri=http://www.nfwebsolutions.com/ X2V].
* [http://www.nfwebsolutions.com/ New Frontier Web Solutions] uses hCard on their front page along with a link pointing to Brian Suda's [http://suda.co.uk/projects/X2V/get-vcard?uri=http://www.nfwebsolutions.com/ X2V].
Line 212: Line 256:
* [http://tantek.com/microformats/2005/syndicate/speakers-list.html Syndicate - Speaker List] as a set of hCards
* [http://tantek.com/microformats/2005/syndicate/speakers-list.html Syndicate - Speaker List] as a set of hCards
* [http://tagcamp.org/index.cgi?ContactList TagCamp contact list]
* [http://tagcamp.org/index.cgi?ContactList TagCamp contact list]
* [http://tantek.com/ Tantek's Thoughts] includes an inline author hCard at the bottom of the page.
* [http://technorati.com/ Technorati]'s [http://www.technorati.com/about/ About page] lists their '''Media Contact'''
* [http://www.deadringerart.com/ The Brothers McDowell] have hCards at their Contact page.
* [http://www.deadringerart.com/ The Brothers McDowell] have hCards at their Contact page.
* [http://twinsparc.com/ Twinsparc] put an hCard in the header and footer of all their pages.
* [http://twinsparc.com/ Twinsparc] put an hCard in the header and footer of all their pages.
Line 228: Line 270:
** by [[implementations#Nature Publishing Group|Nature Publishing Group]]
** by [[implementations#Nature Publishing Group|Nature Publishing Group]]
* [http://concerts.shrub.ca/shows Sunnyvale House Concerts] supports hCard and [[hcalendar|hCalendar]].
* [http://concerts.shrub.ca/shows Sunnyvale House Concerts] supports hCard and [[hcalendar|hCalendar]].
* The [http://technorati.com/about/ Technorati About page] has contact information marked up with hCard. By [[implementations#Technorati|Technorati]]
* The [http://technorati.com/press/ Technorati Press page] also has an hCard. By [[implementations#Technorati|Technorati]]
* The [http://technorati.com/about/staff.html Technorati Staff page] has many hCard. By [[implementations#Technorati|Technorati]]
* [http://www.bath.ac.uk/ University of Bath] [http://www.bath.ac.uk/contact/ Person Finder] supports hCard, e.g. see [http://www.bath.ac.uk/person/760874 Mrs A Smith] page.
* [http://www.bath.ac.uk/ University of Bath] [http://www.bath.ac.uk/contact/ Person Finder] supports hCard, e.g. see [http://www.bath.ac.uk/person/760874 Mrs A Smith] page.
* [http://www.monster-prague.cz/ Monster Prague Openings] supports hCard, e.g. home page, contact list to come.
* [http://www.monster-prague.cz/ Monster Prague Openings] supports hCard, e.g. home page, contact list to come.


===UTF8 Examples===
== Grouped Examples ==
This section organizes examples into several rough categories as follows. If an example fits in more than one cateogry, use the *last* matching category in this list that matches the specific hCard example(s) in the wild that you are trying to categorize.
# '''Individuals''' - one card per person, perhaps sort alphabetically by "family-name".  People with their own hCards (typically) on their own site.
# '''Organizations''' - one card per organization, alphabetical by "fn".  Organizations with their own hCard(s) (typically) on their own site.
# '''Institutions''' - which list more than one person, with a count estimating the # of hCards, e.g. 40k for Avon. Also indicate complexity of information supplied, eg. just name+number vs. complete details.  Alphabetically sorted by "org" with perhaps a few individuals listed in a single sub-bullet, comma delimited, sorted by "family-name".
# '''Online Profiles''' - which host profiles for more than one person, with a count estimating the # of hCards, e.g. 10m+ for Flickr.com.  Alphabetically sorted by "fn" with perhaps a few individuals listed in a single sub-bullet, comma delimited, sorted by "family-name".
# '''Online Venues''' - which provide listings for businesses or organizations, with a count estimating the # of venues, e.g. ~10k for Upcoming.org. Alphabetically sorted by service/site name, with perhaps a few specific venues listed in a single sub-bullet, comma delimited, sorted by "fn".
# '''Speakers Listings''' - event sites' speakers pages where the speakers are marked up with hCard.  Sort by date, sub-grouped by year.  Most recent first.  Perhaps a few individuals listed in a single sub-bullet each event, comma delimited, sorted by "family-name".
 
In addition there is a separate "UTF8 Examples" section that can be used to put another link to any hCard examples in the wild which exercise various non-ASCII7 / non-english characters for various property values.
 
As each section itself become quite large (we might be there already, once we sort through the above "Reviewed Examples"), it will probably be moved to a separate page, leaving its heading here in place, and replacing its contents here with a link to the separate page and perhaps a stats summary.
 
=== Individuals ===
* [http://dbaron.org/ David Baron]'s home page is marked up with hCard.
* [http://tantek.com/ Tantek Çelik]'s home page includes an inline author hCard at the bottom of the page.
* ...
 
=== Organizations ===
* [http://technorati.com Technorati] (3)
** [http://technorati.com/about/ about], [http://technorati.com/press/ press], and [http://technorati.com/about/contact.html contact] pages are marked up with hCard and have "Add to Address Book" links that use the [http://feed.technorati.com/contacts/ Technorati Contacts Feed service].
* ...
 
=== Institutions ===
* [http://technorati.com/about/staff.html Technorati's Staff page] has hCards for its employees (~31)
** E.g. [http://technorati.com/about/staff.html?s=adam_hertz#adam_hertz Adam Hertz], [http://technorati.com/about/staff.html?s=matthew_levine#matthew_levine Matthew Levin], [http://technorati.com/about/staff.html?s=ryan_king#ryan_king Ryan King], [http://technorati.com/about/staff.html?s=david_sifry#david_sifry David Sifry], etc.


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.
=== Online Profiles ===
* [http://tantek.com/ Tantek's Thoughts] encodes Çelik as inline UTF8.
* ...


==Examples with some problems==
=== Online Venues ===
* ...


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|hCard FAQ]], or raise any queries on [[hcard-issues|hCard Issues]] or [[mailing-lists#microformats-discuss|the mailing list]], where people will be happy to help you.  
=== Speakers Listings ===
==== 2007 ====
* ...
==== 2006 ====
* ...
==== 2005 ====
* ...


* [http://www.alexa.com Alexa Internet] marked up its [http://www.alexa.com/site/company/managers managers' page] with hCard.
===UTF8 Examples===
**Person's job title within "fn". [[User:AndyMabbett|Andy Mabbett]]
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.
* [http://www.naturalengland.org.uk/press/default.htm Natural England] (new UK government agency, formed 2006-10-01).
* [http://tantek.com/ Tantek's Thoughts] encodes Çelik as inline UTF8.
** No "fn" - which makes it invalid.
* [http://www.matthewwest.co.uk Matthew West] has an hCard on his [http://www.matthewwest.co.uk/email contact] page.
**Flat- and building- number run on.
*[http://drop-off.co.uk G3:2] uses hCard with geo tags in the copyright and on the about me page
** Address data is hidden using CSS.
* [http://zdnet.co.uk/misc/contact/ ZDnet Contact Us Page] supports [[hcard|hCard]].
** by [http://www.subtleasafish.com/ James Myers] and [http://www.fromthefrontend.co.uk/2006/11/23/zdnet-uses-microformats/ David Long]
**Images and e-mail addresses are hidden; telephone numbers do not comply with [http://en.wikipedia.org/wiki/E.123 E.123]
* [http://gbraad.nl/ Gerard Braad] has published an example on his [http://gbraad.nl/site/?p=profile profile] page that is almost consistent with his original [http://gbraad.nl/files/gbraad.vcf vCard] file. Also progress is made for transforming his [http://files.gbraad.nl/foaf.rdf FoaF] file to a hCard encoded representation (also done for my spouse:[http://spouse.gbraad.nl/site/?p=profile 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 --[[User:RyanKing|RyanKing]] 17:19, 5 Jan 2006 (PST)
* [http://kinrowan.net/ Cori Schlegel] [http://kinrowan.net/blog/wp/archives/2005/07/08/a-problem-with-the-structured-blogging-plug-in-for-wordpress/ discusses how he has updated] [http://kinrowan.net/blog/contact 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') --[[User:RyanKing|RyanKing]] 15:15, 5 Jan 2006 (PST)
* The good ship [http://styrheim.com/test/leonid.html Leonid Miloslavskiy] spotted in the North Atlantic
** INVALID  --[[User:RyanKing|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 (i.e., it doesn't contain lat/long)
* [http://landsbank.fo/#hCard Landsbanki Føroya]
** INVALID - using embedded RDF/XML invalidly
* [http://chrischerry.name/ Chris Cherry's contact page with his hCard]
** <strike>WARNING - uses class="cell" instead of &lt;span class="type"&gt;cell&lt;/span&gt;</strike> Fixed -- [[User:Seriph|Chris Cherry]] 19:54, 15 Sep 2006 (PST)
* [http://www.bath.ac.uk/contact/ 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. --[[User:RyanKing|RyanKing]] 14:29, 5 Jan 2006 (PST)
** Error appears for external users only. Won't be fixed any time soon. -- [[User:PhilWilson|PhilWilson]] 00:03, 28 Jan 2006 (GMT)
* [http://richi.co.uk/blog/2005/12/structured-blogging.html Richi Jennings] has put up his attempt
** INVALID, missing "fn"--[[User:RyanKing|RyanKing]] 12:47, 5 Jan 2006 (PST)
* [http://www.yellowpencil.com/contact/ Yellow Pencil] Using microformats to present company contact information
** First hcard has empty "fn" and no "n". "fn" should be with "org" -- [[User: ScottReynen |ScottReynen]] 21:29, 19 Jun 2006 (CST)


== Related Pages ==
== Related Pages ==
{{hcard-related-pages}}
{{hcard-related-pages}}

Revision as of 00:15, 14 February 2007

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.

Examples To Act On

New Examples

Please add new examples to the top of this section so they can be reviewed!

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.

  • Alexa Internet marked up its managers' page with hCard.
  • Natural England (new UK government agency, formed 2006-10-01).
    • No "fn" - which makes it invalid.
  • Matthew West has an hCard on his contact page.
    • Flat- and building- number run on.
  • G3:2 uses hCard with geo tags in the copyright and on the about me 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 (i.e., 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)

Reviewed Examples

Reviewed New Examples which are fine can be moved here to indicate that they've been reviewed. Or take the next step and note which type of example in the wild each of these are, and then please move them to the "Grouped Examples" sectionl

Grouped Examples

This section organizes examples into several rough categories as follows. If an example fits in more than one cateogry, use the *last* matching category in this list that matches the specific hCard example(s) in the wild that you are trying to categorize.

  1. Individuals - one card per person, perhaps sort alphabetically by "family-name". People with their own hCards (typically) on their own site.
  2. Organizations - one card per organization, alphabetical by "fn". Organizations with their own hCard(s) (typically) on their own site.
  3. Institutions - which list more than one person, with a count estimating the # of hCards, e.g. 40k for Avon. Also indicate complexity of information supplied, eg. just name+number vs. complete details. Alphabetically sorted by "org" with perhaps a few individuals listed in a single sub-bullet, comma delimited, sorted by "family-name".
  4. Online Profiles - which host profiles for more than one person, with a count estimating the # of hCards, e.g. 10m+ for Flickr.com. Alphabetically sorted by "fn" with perhaps a few individuals listed in a single sub-bullet, comma delimited, sorted by "family-name".
  5. Online Venues - which provide listings for businesses or organizations, with a count estimating the # of venues, e.g. ~10k for Upcoming.org. Alphabetically sorted by service/site name, with perhaps a few specific venues listed in a single sub-bullet, comma delimited, sorted by "fn".
  6. Speakers Listings - event sites' speakers pages where the speakers are marked up with hCard. Sort by date, sub-grouped by year. Most recent first. Perhaps a few individuals listed in a single sub-bullet each event, comma delimited, sorted by "family-name".

In addition there is a separate "UTF8 Examples" section that can be used to put another link to any hCard examples in the wild which exercise various non-ASCII7 / non-english characters for various property values.

As each section itself become quite large (we might be there already, once we sort through the above "Reviewed Examples"), it will probably be moved to a separate page, leaving its heading here in place, and replacing its contents here with a link to the separate page and perhaps a stats summary.

Individuals

  • David Baron's home page is marked up with hCard.
  • Tantek Çelik's home page includes an inline author hCard at the bottom of the page.
  • ...

Organizations

Institutions

Online Profiles

  • ...

Online Venues

  • ...

Speakers Listings

2007

  • ...

2006

  • ...

2005

  • ...

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.

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.