Microformats Wiki - User contributions [en]

hresume-skill-brainstorm

2011-03-10T15:24:32Z

Steve Ganz: Added LinkedIn implementation example.

This page is for brainstorming about various uses and details of hResume skills property.

== Tagspace issue ==

When you review how skills are authored in resume they are equally expressed either as terms or narrative sentences. The following examples where taken from a small sample [1] of online resumes:

* Object development
* CSS
* C# developer with 5 years team commercial experience
* Quick to recognize problems and execute solutions
* English – Very good
* Speak, read and write English fluently

As [[User:CiaranMc|Ciaran McNulty]] mentioned in the [[hresume-issues|hResume Issues]] page,” in reality authors end up linking to places like Wikipedia”. You are also unlikely to create a tagspace just to support the publishing of your resume. This is true whether you’re adding a resume to a blog or building a large resume hosting service.

On top of which tagspaces do not work well with the narrative style of expressing skills used by some authors. Although rel-tag can create interesting cross linkages it is no use if it cannot be practically used for the majority of use cases when authoring a human readable document.

That said, [http://www.linkedin.com/skills/| LinkedIn recently implemented a tag space for skills] and as a result will finally be able to implement skills according to the current hResume draft specification. The markup is as follows:

<pre>
<ul class="competencies skills">
<li class="competency">
<h3><a class="skill" rel="tag" href="/skills/skill/HTML">HTML</a></h3>
<span class="proficiency">
(Expert, 8 years experience)
</span>
</li>
<li class="competency">
<h3><a class="skill" rel="tag" href="/skills/skill/CSS">CSS</a></h3>
<span class="proficiency">
(Advanced, 6 years experience)
</span>
</li>
<li class="competency">
<h3><a class="skill" rel="tag" href="/skills/skill/JavaScript">JavaScript</a></h3>
<span class="proficiency">
(Intermediate, 4 years experience)
</span>
</li>
<li class="competency">
<h3><a class="skill" rel="tag" href="/skills/skill/XSLT">XSLT</a></h3>
<span class="proficiency">
(Beginner, 2 years experience)
</span>
</li>
</ul>
</pre>

A much easier to implement alternative would be to use a simple text property instead of the rel-tag. This would be a more practical solution, as suggested below:

<pre>
<p class=”skill”>Application development</p>

<p class=”skill”>C# developer with 5 years team commercial experience </p>
</pre>

== Separating language from skills ==

If you have read many resumes you will appreciate how varied the labelling of skills sections are. There is one common division that I think should be reflected in the schema, the separation of languages from other skills.

From a sample of 10,000 structured resume’s entered into one of our systems (Madgex) 42% entered a skill, 35.2% entered a language skill and 18.9% entered a professional skill. This system is based in Europe and has an international reach. Please remember that structured entry systems can encourage a bias that would not be seen in a sample of freeform resumes. Even the small sample [1] of 10 freeform resumes picked at random had 3 that listed language skills.

We could redesign ‘skills’ into two separate properties; ‘skills’ and’ language’ and use a common compound structure “competency” to describe both or we could use the type pattern to define the type of skill.

Using a competency structure
<pre>
<p class=” competency skill”>Application development > </p>

<p class=” competency language”>French</p>
</pre>
So the hResume spec would have two properties; ‘ skills’ and ‘language’ which would be of the type competency, just like the contact property in hResume is of the type hCard

Using a type pattern
<pre>
<p class=”skill”>
<span class=”summary”>Application development</span>
<span class=”type”> skill</span>
</p>

<p class=”skill”>
<span class=”summary”>French</span> -
<span class=”type”> language</span>
</p>
</pre>

I think that the type pattern would be very verbose with large lists of skills therefore I would suggest the creation of the competency structure.

== Rating skills==

Rating skills are very common, it helps to give the reader an understanding of the level of competency claimed by the author. The Microformats community already has a nice rating pattern in hReview that can be applied to a competency structure. It allows a value of (0.0 - 5.0) to be applied to an item.

<pre>
<p class=” competency skill”>
<span class=”summary”>Application development</span> -
<abbr class=”rating” title=”1”>Basic</span>
</p>

<p class=” competency language”>
<span class=”summary”>French</span> -
<abbr class=”rating” title=”5”> Fluent </span>
</p>
</pre>

I wish I could backup the use of ratings with a good set of stats. Our structured resumes place an optional rating next to each skill entered. The UI of these systems encourages users to rate their skills and gives a bias to any results. Consequently, 97.7% of skills in our sample 10,000 structured resumes are rated by authors. I did look at using a Natural Language Parser to exact some stats from a collection of freeform resumes, but the error rate on parsing skills ratings is high and would not give a true result. Therefore the only reliable stats I have are that 2 out of my 10 randomly picked online resumes used ratings.

== Durations==

It is common to express skills in terms of years/months of experience. This can be industry specific and is most often found in IT. It would be relatively simple to add an ISO Duration to the competency structure. We already use this data format in hCalendar.

<pre>
<p class=” competency skill”>
<span class=”summary”>Application development</span> -
<abbr class=”duration” title=”P3Y”>3 Years </span>
</p>
</pre>

Again, I am unable to back this up with a good set of stats. Duration is less commonly used than rating, but is still important in certain industry sectors.
I would like to purpose a new competency structure to replace the current ‘skills’ property in hResume. We add two separate properties skills and language that use a common structure “competency”

* competency
** Summary (text)
** Rating (0.0 to 5.0)
** Duration (ISO Duration)

Examples:
<pre>
<p class=” competency skill”>
<span class=”summary”>Application development</span> -
<abbr class=”rating” title=”3”> Intimidate </span>
</p>

<p class=” competency skill”>
<span class=”summary”>Application development</span> -
<abbr class=”duration” title=”P3Y”>3 Years </span>
</p>

<p class=” competency language”>
<span class=”summary”>French</span> -
<abbr class=”rating” title=”5”> Fluent </span>
</p>
</pre>

== Implied competency optimization ==

It would be worth considering a new implied optimization rule for competency similar to the one used on the org property in hCard. Where an author only wants to use a value without rating or duration the summary property can be omitted and the value placed directly in the parent element, i.e. both structures below would be valid.

<pre>
<p class=” competency language”>
<span class=”summary”>French</span> -
</p>

<p class=” competency language”>French</p>
</pre>

== [1] Examples ==

Due to data protection issues you can always publish examples resumes. Therefore below is list of random online resumes as a point of reference. These can be referenced on a public forum.

These resume have all been written freeform, come from different industries and represent individuals from different nationalities.

Janne Kotiaho - Professor<br>
http://users.jyu.fi/~jkotiaho/cv.html

Donald Henslay - Aviation Consultant<br>
http://www.safeskyllc.com/don's_resume.htm

Jeremy Nevill - Software Architect<br>
http://www.nevill.co.uk/

Tristan Nitot - Company President<br>
http://www.nitot.com/cv/

Lezli Renee (Thomas) Gill - Teacher<br>
http://www.valdosta.edu/~lrgill/Resume.html

Lucie Moussu - Assistant Professor<br>
http://www.moussu.net/TP/curriculumvitae.html

Susan Sparkes-Hoskin - Business Development<br>
http://www.telusplanet.net/public/shoskins/Sue_Hoskins_Resume_2008.rtf

Jeff Colen - Tour Promotions<br>
http://www.jcolen.com/Resume.htm

Michael Barnett - Sales Training<br>
http://www.michaelcbarnett.com/resume

Okwaisie Timothy - Metallurgist<br>
http://www.min-eng.com/cvs/okwaisie.doc

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

events/2008-06-24-weekly-meetup-dinner

2008-06-24T18:06:00Z

Steve Ganz: /* attendees */

<h1>microformats weekly meetup dinner</h1>
{{TOC-right}}
One of several microformats [[events]].

==Subscribe==
You can:
*Add this event to your Calendar: http://feeds.technorati.com/events/microformats.org/wiki/events/2008-06-24-weekly-meetup-dinner
*Subscribe to this event: webcal://feeds.technorati.com/events/microformats.org/wiki/events/2008-06-24-weekly-meetup-dinner

== details ==
<div class="vevent">
;When
:<span class="dtstart">2008-06-24T18:30-0700</span>–<span class=dtend>2008-06-24T20:30-0700</span>
;Where
:<span class="location vcard"><span class="fn org">Chaat Cafe</span>, <span class="adr"><span class="street-address">320 3rd St.</span>, <span class="locality">San Francisco</span>, <span class="region">CA</span> <span class="postal-code">94107</span> <span class="country-name">USA</span></span></span>
;What
:<span class="summary">microformats weekly meetup dinner</span>
;Web
:<span class="url">http://pownce.com/t/notes/2558970/</span>
:<span class="url">http://upcoming.yahoo.com/event/831549</span>
</div>

'''[http://technorati.com/events/microformats.org/wiki/events/2008-06-24-weekly-meetup-dinner Add this event to your diary or calendar program]''' http://www.boogdesign.com/images/buttons/microformat_hcalendar.png

== weekly meetup ==
I've been thinking about the idea of a regular microformats dinner for community members (old and new) to meet IRL and discuss whatever is on their mind regarding microformats.

The community and adoption have grown considerably over the last year, and news of adoptions (and once in a while challenges) come up frequently enough ([http://news.google.com/news?q=microformats&ie=UTF-8&scoring=n at least once a week]) that there would be no shortage of new topics to discuss on a weekly basis.

By making this a regular (every week) event, people know it is happening regularly and can thus come whichever ones are convenient for them, and not worry about missing any one in particular.

From having informally asked a few folks in the SF area and on IRC it seems Tuesdays at 6:30pm work best, with a rotating venue to keep it interesting.

Suggested SF venues (suggester). Add your opinions and additional suggestions:
* '''Chaat Cafe''' (Ryan King) - current choice
** +1 Tantek
* Crepes on Cole (Eran Globen)
** +1 Tantek
* ...

I encourage folks to organize meetup dinners wherever there is sufficient local critical mass.

There has been some interest expressed in organizing dinners in the following cities:
* San Diego - [[User:EdwardOConnor]]
* London - Phae

== tags ==
Please use ''all'' of the following tags when tagging related content (blog posts, photos):



tags: '''microformatsdinner20080623 microformatsdinner microformatsmeetup microformats'''

If you Twitter with [[twitter-syntax#Hash_tags|hash tags]], mention '''#EVENTSPECIFICTAG''' (with the "#") in tweets about the event.

== attendees ==
Add yourself alphabetically sorted by family name if you plan on attending or attended.


* [[User:Tantek|Tantek]]
* [[User:Steve_Ganz|Steve Ganz]]

== photographs ==
Please use ''all'' of the following tags when tagging related photos:

tags: '''microformatsdinner20080623 microformatsdinner microformatsmeetup microformats'''


* ...

== notes ==
Session comments and Q&A.
* ...

== articles and blog posts ==
Articles and blog posts following up on the meetup. Newest first.

Please use ''all'' of the following tags when tagging related blog posts:

tags: '''microformatsdinner20080623 microformatsdinner microformatsmeetup microformats'''

* ...



== related pages==
{{events-related-pages}}

hcard-xfn-supporting-friends-lists

2008-05-01T02:16:30Z

Steve Ganz: /* Services with XFN supporting friends lists */

<h1>hCard+XFN supporting friends lists</h1>
{{TOC-right}}

Welcome! If you have an account on any of the following services, you already have a list of your friends' hCards with your relationship to them in XFN which you can provide to other services to save time by either importing or subscribing to social network information so you can change it on one site, and have other sites automatically updated, rather than having to re-add/remove all your social network contacts multiple times every time you meet a new person, decide to unfriend someone etc.

== Services with hCard+XFN supporting friends lists ==
The following web sites support publishing hCard+XFN friends lists and are thus suitable for importing/subscribing to other sites that support hCard+XFN. Alphabetically sorted. Feel free to add sites with hCard+XFN supporting friends lists here. Please include a link to the site home page, and instructions for retrieving your the URL of your hCard+XFN supporting friends list on that site.

<div style="font-size:larger">
* http://identoo.com/images/icons/services/corkd.gif [http://www.corkd.com/ Cork'd] - login and copy the URL which should start with <nowiki>http://www.corkd.com/people/</nowiki>
* http://identoo.com/images/icons/services/dopplr.gif [http://dopplr.com Dopplr] - login and note that your user page has hCard and XFN for your contacts
* [http://gaia.com/ Gaia Community] - e.g. http://sphorbis.gaia.com/ - built by [http://www.zaadz.com Zaadz]
* http://pulse.plaxo.com/pulse/img/event_icons/LastFM.gif [http://www.last.fm/ Last FM] - login, click the "Friends" tab, and copy the URL which should look like: <nowiki>http://www.last.fm/user/[username]/friends/</nowiki>
* http://pulse.plaxo.com/pulse/img/event_icons/Magnolia.gif [http://ma.gnolia.com/ Ma.gnolia] - View your contacts page <nowiki>http://ma.gnolia.com/people/[username]/contacts</nowiki> . Note [[hcard-xfn-supporting-friends-lists-issues#Magnolia|issue(s)]].
* [http://www.nsyght.com/ Nsyght] - Visit your profile page and select "view all" on the friends component. Should look like this: <nowiki>http://www.nsyght.com/friends/[username]/</nowiki>, e.g. [http://nsyght.com/users/lisa sample profile].
* [http://www.qmpeople.com/ qmpeople] - Uses hCard+XFN for profiles (<nowiki>http://www.qmpeople.com/users/[username]</nowiki> - e.g. [http://www.qmpeople.com/users/laserion laserion])
* [http://soup.io Soup] - On user profile if the "Friends list" element is displayed (on by default), else at <nowiki>/friends</nowiki>
* http://pulse.plaxo.com/pulse/img/event_icons/Twitter.gif [http://twitter.com/ Twitter] - login, click on "Your profile" at the top, and copy the URL
* http://lifestrea.ms/animated_favicon1.gif [http://lifestrea.ms/ lifestrea.ms] - you have one user profile per social group that you want to share information with: <nowiki>http://lifestrea.ms/user/[username]/</nowiki>. Examples: [http://lifestrea.ms/user/thomas.huhn/ public profile] or [http://lifestrea.ms/user/solution-media.thomas.huhn/ professional profile] of the same person.
</div>

== Services that import hCard+XFN supporting friends lists ==
The following web sites let you import hCard+XFN friends lists, e.g. from the above sites, and make use of both the XFN information and the hCards in the friends lists. Alphabetically sorted. Feel free to add sites supporting hCard+XFN import here. Please include a link to the site home page, and instructions for how to import friends on the site.

=== import ===
The following sites do one time imports of friends lists.

* http://identoo.com/images/icons/services/dopplr.gif [http://dopplr.com Dopplr] - as [http://blog.dopplr.com/index.php/2007/06/23/importing-your-social-network-from-other-sites/ announced] login and go to <nowiki>http://www.dopplr.com/account/fellows_from_hcard</nowiki> to import (site is private beta)

* [http://t.heproject.com/ The Project] - Login with your OpenID and the site automatically tries to subscribe to your XFN friends list where it intersects with their userbase
** appears to fail logging in with a delegated OpenID, e.g. http://tantek.com/ - unable to verify import friends list support. [[User:Tantek|Tantek]] 10:03, 1 Feb 2008 (PST)

=== import and subscribe ===
The following sites support both importing and subscribing to friends lists.
* None currently.

=== delegation ===
The following sites support fully delegating your friends list to an external hCard+XFN friends list.
* None currently.

== Services with XFN supporting friends lists ==
These sites support XFN markup on friends lists. It is a superset of the sites that support XFN <em>and</em> hCard on friends lists.
<div style="font-size:larger">
* [http://3eep.com/ 3eep] - each user's friends are linked to with XFN is located at <nowiki>http://3eep.com/users/[username]</nowiki>
* http://identoo.com/images/icons/services/corkd.gif [http://www.corkd.com/ Cork'd] - login and copy the URL which should start with <nowiki>http://www.corkd.com/people/</nowiki>
* [http://couchsurfing.com CouchSurfing] profiles have XFN Friendly friends lists (e.g. [http://www.couchsurfing.com/people/guaka Guaka's]).
* http://identoo.com/images/icons/services/dopplr.gif [http://dopplr.com Dopplr] - login and note that your user page has hCard and XFN for your contacts
* http://flugpo.com/images/flugpo_icon.gif [http://flugpo.com Flugpo] - check your friends page linked from your profile.
* [http://gaia.com/ Gaia Community] - e.g. http://sphorbis.gaia.com/ - built by [http://www.zaadz.com Zaadz]
* http://identoo.com/images/icons/services/identoo.gif [http://identoo.com/ Identoo] - e.g. [http://identoo.com/dirk.olbertz sample profile]
* http://www.linkedin.com/img/pic/pic_in_17x17.gif [http://www.linkedin.com/ LinkedIn] - LinkedIn Connections use XFN and are marked up with rel="contact".
* http://pulse.plaxo.com/pulse/img/event_icons/LastFM.gif [http://www.last.fm/ Last FM] - login, click the "Friends" tab, and copy the URL which should look like: <nowiki>http://www.last.fm/user/[username]/friends/</nowiki>
* http://pulse.plaxo.com/pulse/img/event_icons/LiveJournal.gif [http://livejournal.com LiveJournal] (see [[implementations#LiveJournal|LiveJournal]] implementation entry) - login, click on the "Profile" link, and copy the URL which should start with <nowiki>http://USERNAME.livejournal.com/profile</nowiki> where USERNAME is your LJ username. E.g. [http://daveman692.livejournal.com/profile]. LiveJournal profiles have complete friends lists marked up in XFN.
* http://pulse.plaxo.com/pulse/img/event_icons/Magnolia.gif [http://ma.gnolia.com/ Ma.gnolia] - View your contacts page <nowiki>http://ma.gnolia.com/people/[username]/contacts</nowiki> . Note [[hcard-xfn-supporting-friends-lists-issues#Magnolia|issue(s)]].
* [http://meetlisten.com Meetlisten] - e.g. http://meetlisten.com/home/profile.php?id=1 and (e.g. [http://meetlisten.com/home/friends.php?id=6 MAKACOW-Brazil's]).
* [http://www.nsyght.com/ Nsyght] - Visit your profile page and select "view all" on the friends component. Should look like this: <nowiki>http://www.nsyght.com/friends/[username]/</nowiki>, e.g. [http://nsyght.com/users/lisa sample profile].
* http://identoo.com/images/icons/services/odeo.gif [http://odeo.com Odeo] — the "peep's" list of each user is marked up with XFN (rel="contact") e.g. http://odeo.com/profile/JeremyKeith . See [http://odeo.com/blog/2005/07/adding-microformats-to-odeo.html announcing blog post].
* http://pulse.plaxo.com/pulse/img/event_icons/Pownce.gif [http://pownce.com/ Pownce] - login, click on the "Home" link at the top, and copy the URL.
* [http://www.qmpeople.com/ qmpeople] - Uses XFN for public friendships - e.g. http://www.qmpeople.com/users/laserion
* [http://soup.io Soup] - On user profile if the "Friends list" element is displayed (on by default), else at <nowiki>/friends</nowiki>
* http://pulse.plaxo.com/pulse/img/event_icons/Twitter.gif [http://twitter.com/ Twitter] - login, click on "Your profile" at the top, and copy the URL
* [http://videntity.org/ Videntity.org] - e.g. http://danda.videntity.org/ (see also [http://wiki.www.videntity.org/wiki/Social_Networking_Unlimited Videntity XFN support documentation]).
* [http://wordpress.com Wordpress.com] and any other blogs using Wordpress 1.5 or later have XFN supporting blog rolls (for friends and [[rel-me]]).
* http://lifestrea.ms/animated_favicon1.gif [http://lifestrea.ms/ lifestrea.ms] - one friends list per social group that you want to share information with: <nowiki>http://lifestrea.ms/user/[username]/</nowiki>. Examples: [http://lifestrea.ms/user/thomas.huhn/ public profile] or [http://lifestrea.ms/user/solution-media.thomas.huhn/ professional profile] of the same person.
</div>

== Services that import XFN supporting friends lists ==
The following web sites support importing your existing XFN supporting friends lists, e.g. from the above sites. Alphabetically sorted. Feel free to add sites supporting XFN import here. Please include a link to the site home page, and instructions for how to import friends on the site.
=== import ===
The following sites do one time imports of friends lists.
* None currently.
=== import and subscribe ===
The following sites support both importing and subscribing to friends lists.
* None currently.
=== delegation ===
The following sites support fully delegating your friends list to an external XFN friends list.
* None currently.

== Services with XFN rel="me" to multiple external sites ==
The following services have a UI for entering any number of websites/homepages/blogs and publish it as part of your profile, linking to it with [[rel-me]].
<div style="font-size:larger">
* http://pulse.plaxo.com/pulse/img/event_icons/Digg.gif [http://digg.com/ Digg] - e.g. http://digg.com/users/tantek
* http://identoo.com/images/icons/services/identoo.gif [http://identoo.com/ Identoo] - e.g. [http://identoo.com/dirk.olbertz sample profile]
* http://www.linkedin.com/img/pic/pic_in_17x17.gif [http://www.linkedin.com/ LinkedIn] - e.g. http://www.linkedin.com/in/steveganz rel="me" is applied to "My Website" and "My Blog" on your public profile.
* http://pulse.plaxo.com/pulse/img/event_icons/plaxo.gif [http://plaxo.com/ Plaxo] - e.g. http://joseph.myplaxo.com/
* http://pulse.plaxo.com/pulse/img/event_icons/Pownce.gif [http://pownce.com/ Pownce] - login, go to your profile, and copy the URL which should start with <nowiki>http://pownce.com/</nowiki>
* http://technorati.com/tools/mozsearch/technorati.png [http://technorati.com/ Technorati] - e.g. http://technorati.com/people/technorati/tantek
* http://www.postreach.com/images/logo_typepad.gif [http://typepad.com/ TypePad] - e.g. http://www.markpasc.typepad.com/
* [http://videntity.org/ Videntity.org] - e.g. http://danda.videntity.org/
* http://openid.net/wp-content/uploads/vox.png [http://vox.com/ Vox] - e.g. http://anil.vox.com/
* [http://wordpress.com Wordpress.com] and any other blogs using Wordpress 1.5 or later have XFN supporting blog rolls (for friends and [[rel-me]]).
* http://lifestrea.ms/animated_favicon1.gif [http://lifestrea.ms/ lifestrea.ms] - supporting all your appearances on the web. Examples: [http://lifestrea.ms/user/thomas.huhn/ public profile] or [http://lifestrea.ms/user/solution-media.thomas.huhn/ professional profile] of the same person.
</div>

== Services with XFN rel="me" to one external site ==
The following services have a UI for entering one website/homepage/blog and publish it as part of your profile, linking to it with [[rel-me]].
<div style="font-size:larger">
* http://pulse.plaxo.com/pulse/img/event_icons/Digg.gif [http://digg.com/ Digg] - e.g. http://digg.com/users/tantek
* [http://eventful.com/ Eventful] - login, click on your username, and copy that URL.
* http://pulse.plaxo.com/pulse/img/event_icons/Flickr.gif [http://flickr.com/ Flickr] - login, click "Your Photos", click "Profile", and copy the URL which should be <nowiki>http://flickr.com/people/[username]/</nowiki>
** Flickr supports rel="me" identity consolidation with your webpage that you enter into your profile, and with your Flickr contacts page. See [http://flickr.com/photos/factoryjoe/113866484/ screenshot of Flickr UI in Flock browser using Flocktails extension - March 17th 2006].
* http://identoo.com/images/icons/services/identoo.gif [http://identoo.com/ Identoo] - e.g. [http://identoo.com/dirk.olbertz sample profile]
* [http://jpgmag.com JPG Magazine]
* http://pulse.plaxo.com/pulse/img/event_icons/LastFM.gif [http://www.last.fm/ Last.FM] - login, go to your profile, and copy the URL which should start with <nowiki>http://www.last.fm/user/</nowiki>
** Last.FM supports rel="me" identity consolidation with your webpage that you enter into your profile, and with your Last.FM friends page.
* http://pulse.plaxo.com/pulse/img/event_icons/Magnolia.gif [http://ma.gnolia.com/ Ma.gnolia] - see [http://ma.gnolia.com/blog/2006/08/21/a-microadvance-in-our-microformats supports rel=me announcement].
* [http://nsyght.com Nsyght] - e.g. [http://nsyght.com/users/lisa sample profile].
* http://pulse.plaxo.com/pulse/img/event_icons/plaxo.gif [http://plaxo.com/ Plaxo] - e.g. http://joseph.myplaxo.com/
* http://pulse.plaxo.com/pulse/img/event_icons/Pownce.gif [http://pownce.com/ Pownce] - login, go to your profile, and copy the URL which should start with <nowiki>http://pownce.com/</nowiki>
** Pownce [http://pownce.com/t/notes/644806/ supports rel="me" for LOTS of other profiles].
* [http://www.qmpeople.com/ qmpeople] - e.g. http://www.qmpeople.com/users/laserion
* [http://soup.io Soup] - on user profile
* http://technorati.com/tools/mozsearch/technorati.png [http://technorati.com/ Technorati] - e.g. http://technorati.com/people/technorati/tantek
* http://www.postreach.com/images/logo_typepad.gif [http://typepad.com/ TypePad] - e.g. http://www.markpasc.typepad.com/
* http://pulse.plaxo.com/pulse/img/event_icons/Twitter.gif [http://twitter.com/ Twitter] - login, click on "Your profile" at the top, and copy the URL
* [http://videntity.org/ Videntity.org] - e.g. http://danda.videntity.org/
* http://openid.net/wp-content/uploads/vox.png [http://vox.com/ Vox] - e.g. http://anil.vox.com/
* [http://wordpress.com Wordpress.com] and any other blogs using Wordpress 1.5 or later have XFN supporting blog rolls (for friends and [[rel-me]]).
* http://lifestrea.ms/animated_favicon1.gif [http://lifestrea.ms/ lifestrea.ms] - supporting all your external appearances on the web. Examples: [http://lifestrea.ms/user/thomas.huhn/ public profile] or [http://lifestrea.ms/user/solution-media.thomas.huhn/ professional profile] of the same person.
</div>

== Implement hCard XFN supporting friends lists ==
Want to implement hCard+XFN on your site so you can list it here?

# '''Markup friends with hCard.''' See the [[hcard-authoring|hCard authoring]] page for how to mark-up names, links, icons of people in friends lists with hCard.
# '''XFN on friend links.''' Friends lists should be marked up with XFN per [[xfn-clarifications#mapping_community_site_.22friends.22|XFN clarifications: mapping community site friends]]. See also the [http://www.gmpg.org/xfn/join XFN: Getting Started] page for how to markup links to people with XFN. See also the [[hcard-examples#hCard_and_XFN|hCard examples: hCard and XFN]] which demonstrates this and the previous step quite well.
# '''rel="me" to a user's other URLs'''. Hyperlinks to users' home pages or blogs should have the XFN <code>rel="me"</code> attribute to support user-driven (since the user chooses the URL to link to) identity consolidation.
# '''rel="me" on "View All Friends..." links'''. If a user profile page on your site links to a separate page for that user's friends list, add <code>rel="me"</code> to that link.
# '''rel="me" on friends list pagination links'''. If your site paginates a user's friend list into multiple pages, be sure to add <code>rel="me next"</code> to your "Next" pagination hyperlinks, and similarly <code>rel="me prev"</code> to your "Previous" pagination hyperlinks.

Please also consider implementing [[hcard-supporting-user-profiles|hCard user profiles]].

== Implement import XFN friends lists ==
Want to implement importing (and preferably subscribing to) XFN friends lists on your site so you can list it here?

In addition to implementing hCard XFN supporting friends lists yourself (see above), do the following:

# '''Provide a user interface to "Import Friends"''' (like a button or menu item)
# '''When chosen, provide a text input field for the user to enter their profile URL''' (such as their blog or XFN friends list URL). If you already have the user's "Website", pre-fill the field with it, or if the user has many "Other Profiles", pre-fill the field with the first, and let the user pick any of them with a Select pop-up menu, or provide the user the option to just import XFN from all of them at once.
# '''Parse the [[XFN]] at the URL(s) given''' (links with rel="contact" or "acquaintance" or "friend" etc.) and check to see if there are any users on your site with any of those links as their rel="me" "Website" or among their rel="me" "Other Profiles" and add them to a list of people to invite. Crawl any symmetrical rel="me" links, especially symmetrical rel="me next" and/or rel="me prev" friends list pagination links for additional URLs to parse for XFN. Consider also parsing those URLs simultaneously for hCards that have those XFN links as class="url" hCard properties, and if the hCards have additional contact information such as instant messaging or email, add them to the list of people to invite.
# '''Present the list of people to invite''', perhaps sorted by "closeness" of XFN relationships (e.g. list family relationships before just romantic relationships before just friends before just professional relationships before just acquaintances before just contacts before just met etc.) with a "Add Friend" button next to each. When clicked, use [[XHR]] to add that person without altering the overall list, and change the Add button into a Cancel button. Perhaps put an "Add all" button at the top (or bottom) to let the user simply add everyone listed with one click.
# '''Consider also providing a checkbox "<nowiki>[x]</nowiki> Subscribe to XFN friends"''' which would automatically run this import perhaps once a day and notify the user of new contacts found that they may want to add, and similarly present an "Add all" button.

== Sites that should support hCard and XFN ==
See [[hcard-advocacy#hCard_XFN_friends_lists|hCard advocacy - hCard XFN friends lists]].

== For more information ==
In addition to the previous "Implement" sections, see the [[hcard-authoring|hCard authoring]] page for how to mark-up information about a person with hCard, and [http://gmpg.org/xfn/join XFN getting started] page for how to mark-up friend links with XFN.

Join the [http://microformats.org/discuss microformats community], in particular the #microformats IRC channel on irc://irc.freenode.net#microformats and the [http://microformats.org/mailman/listinfo/microformats-dev/ microformats-dev mailing list], and send a message stating that you'd like to add hCard to the profiles and hCard+XFN supporting friends lists (and importing thereof) to your website.

Please also consider implementing [[hcard-supporting-user-profiles|hCard supporting user profiles]].

See [[hcard-xfn-supporting-friends-lists-issues|hCard+XFN supporting friends lists issues]] for issues, problems with implementations.

== See also ==
* [[xfn|XFN]] ([http://gmpg.org/xfn/ spec], [[xfn-faq|FAQ]], [[xfn-implementations|implementations]] - there are a few more in there that need to be copied and expanded in this page.)
* [[hcard-supporting-user-profiles]]
* [[hcard|hCard]] ([[hcard-authoring|authoring]], [[hcard-faq|FAQ]])
* [[social-network-portability]]
* [[data-portability]]
* [[user-interface]]

hcard-xfn-supporting-friends-lists

2008-05-01T02:16:16Z

Steve Ganz: /* Services with XFN rel="me" to multiple external sites */

<h1>hCard+XFN supporting friends lists</h1>
{{TOC-right}}

Welcome! If you have an account on any of the following services, you already have a list of your friends' hCards with your relationship to them in XFN which you can provide to other services to save time by either importing or subscribing to social network information so you can change it on one site, and have other sites automatically updated, rather than having to re-add/remove all your social network contacts multiple times every time you meet a new person, decide to unfriend someone etc.

== Services with hCard+XFN supporting friends lists ==
The following web sites support publishing hCard+XFN friends lists and are thus suitable for importing/subscribing to other sites that support hCard+XFN. Alphabetically sorted. Feel free to add sites with hCard+XFN supporting friends lists here. Please include a link to the site home page, and instructions for retrieving your the URL of your hCard+XFN supporting friends list on that site.

<div style="font-size:larger">
* http://identoo.com/images/icons/services/corkd.gif [http://www.corkd.com/ Cork'd] - login and copy the URL which should start with <nowiki>http://www.corkd.com/people/</nowiki>
* http://identoo.com/images/icons/services/dopplr.gif [http://dopplr.com Dopplr] - login and note that your user page has hCard and XFN for your contacts
* [http://gaia.com/ Gaia Community] - e.g. http://sphorbis.gaia.com/ - built by [http://www.zaadz.com Zaadz]
* http://pulse.plaxo.com/pulse/img/event_icons/LastFM.gif [http://www.last.fm/ Last FM] - login, click the "Friends" tab, and copy the URL which should look like: <nowiki>http://www.last.fm/user/[username]/friends/</nowiki>
* http://pulse.plaxo.com/pulse/img/event_icons/Magnolia.gif [http://ma.gnolia.com/ Ma.gnolia] - View your contacts page <nowiki>http://ma.gnolia.com/people/[username]/contacts</nowiki> . Note [[hcard-xfn-supporting-friends-lists-issues#Magnolia|issue(s)]].
* [http://www.nsyght.com/ Nsyght] - Visit your profile page and select "view all" on the friends component. Should look like this: <nowiki>http://www.nsyght.com/friends/[username]/</nowiki>, e.g. [http://nsyght.com/users/lisa sample profile].
* [http://www.qmpeople.com/ qmpeople] - Uses hCard+XFN for profiles (<nowiki>http://www.qmpeople.com/users/[username]</nowiki> - e.g. [http://www.qmpeople.com/users/laserion laserion])
* [http://soup.io Soup] - On user profile if the "Friends list" element is displayed (on by default), else at <nowiki>/friends</nowiki>
* http://pulse.plaxo.com/pulse/img/event_icons/Twitter.gif [http://twitter.com/ Twitter] - login, click on "Your profile" at the top, and copy the URL
* http://lifestrea.ms/animated_favicon1.gif [http://lifestrea.ms/ lifestrea.ms] - you have one user profile per social group that you want to share information with: <nowiki>http://lifestrea.ms/user/[username]/</nowiki>. Examples: [http://lifestrea.ms/user/thomas.huhn/ public profile] or [http://lifestrea.ms/user/solution-media.thomas.huhn/ professional profile] of the same person.
</div>

== Services that import hCard+XFN supporting friends lists ==
The following web sites let you import hCard+XFN friends lists, e.g. from the above sites, and make use of both the XFN information and the hCards in the friends lists. Alphabetically sorted. Feel free to add sites supporting hCard+XFN import here. Please include a link to the site home page, and instructions for how to import friends on the site.

=== import ===
The following sites do one time imports of friends lists.

* http://identoo.com/images/icons/services/dopplr.gif [http://dopplr.com Dopplr] - as [http://blog.dopplr.com/index.php/2007/06/23/importing-your-social-network-from-other-sites/ announced] login and go to <nowiki>http://www.dopplr.com/account/fellows_from_hcard</nowiki> to import (site is private beta)

* [http://t.heproject.com/ The Project] - Login with your OpenID and the site automatically tries to subscribe to your XFN friends list where it intersects with their userbase
** appears to fail logging in with a delegated OpenID, e.g. http://tantek.com/ - unable to verify import friends list support. [[User:Tantek|Tantek]] 10:03, 1 Feb 2008 (PST)

=== import and subscribe ===
The following sites support both importing and subscribing to friends lists.
* None currently.

=== delegation ===
The following sites support fully delegating your friends list to an external hCard+XFN friends list.
* None currently.

== Services with XFN supporting friends lists ==
These sites support XFN markup on friends lists. It is a superset of the sites that support XFN <em>and</em> hCard on friends lists.
<div style="font-size:larger">
* [http://3eep.com/ 3eep] - each user's friends are linked to with XFN is located at <nowiki>http://3eep.com/users/[username]</nowiki>
* http://identoo.com/images/icons/services/corkd.gif [http://www.corkd.com/ Cork'd] - login and copy the URL which should start with <nowiki>http://www.corkd.com/people/</nowiki>
* [http://couchsurfing.com CouchSurfing] profiles have XFN Friendly friends lists (e.g. [http://www.couchsurfing.com/people/guaka Guaka's]).
* http://identoo.com/images/icons/services/dopplr.gif [http://dopplr.com Dopplr] - login and note that your user page has hCard and XFN for your contacts
* http://flugpo.com/images/flugpo_icon.gif [http://flugpo.com Flugpo] - check your friends page linked from your profile.
* [http://gaia.com/ Gaia Community] - e.g. http://sphorbis.gaia.com/ - built by [http://www.zaadz.com Zaadz]
* http://identoo.com/images/icons/services/identoo.gif [http://identoo.com/ Identoo] - e.g. [http://identoo.com/dirk.olbertz sample profile]
* [http://www.linkedin.com/ LinkedIn] - LinkedIn Connections use XFN and are marked up with rel="contact".
* http://pulse.plaxo.com/pulse/img/event_icons/LastFM.gif [http://www.last.fm/ Last FM] - login, click the "Friends" tab, and copy the URL which should look like: <nowiki>http://www.last.fm/user/[username]/friends/</nowiki>
* http://pulse.plaxo.com/pulse/img/event_icons/LiveJournal.gif [http://livejournal.com LiveJournal] (see [[implementations#LiveJournal|LiveJournal]] implementation entry) - login, click on the "Profile" link, and copy the URL which should start with <nowiki>http://USERNAME.livejournal.com/profile</nowiki> where USERNAME is your LJ username. E.g. [http://daveman692.livejournal.com/profile]. LiveJournal profiles have complete friends lists marked up in XFN.
* http://pulse.plaxo.com/pulse/img/event_icons/Magnolia.gif [http://ma.gnolia.com/ Ma.gnolia] - View your contacts page <nowiki>http://ma.gnolia.com/people/[username]/contacts</nowiki> . Note [[hcard-xfn-supporting-friends-lists-issues#Magnolia|issue(s)]].
* [http://meetlisten.com Meetlisten] - e.g. http://meetlisten.com/home/profile.php?id=1 and (e.g. [http://meetlisten.com/home/friends.php?id=6 MAKACOW-Brazil's]).
* [http://www.nsyght.com/ Nsyght] - Visit your profile page and select "view all" on the friends component. Should look like this: <nowiki>http://www.nsyght.com/friends/[username]/</nowiki>, e.g. [http://nsyght.com/users/lisa sample profile].
* http://identoo.com/images/icons/services/odeo.gif [http://odeo.com Odeo] — the "peep's" list of each user is marked up with XFN (rel="contact") e.g. http://odeo.com/profile/JeremyKeith . See [http://odeo.com/blog/2005/07/adding-microformats-to-odeo.html announcing blog post].
* http://pulse.plaxo.com/pulse/img/event_icons/Pownce.gif [http://pownce.com/ Pownce] - login, click on the "Home" link at the top, and copy the URL.
* [http://www.qmpeople.com/ qmpeople] - Uses XFN for public friendships - e.g. http://www.qmpeople.com/users/laserion
* [http://soup.io Soup] - On user profile if the "Friends list" element is displayed (on by default), else at <nowiki>/friends</nowiki>
* http://pulse.plaxo.com/pulse/img/event_icons/Twitter.gif [http://twitter.com/ Twitter] - login, click on "Your profile" at the top, and copy the URL
* [http://videntity.org/ Videntity.org] - e.g. http://danda.videntity.org/ (see also [http://wiki.www.videntity.org/wiki/Social_Networking_Unlimited Videntity XFN support documentation]).
* [http://wordpress.com Wordpress.com] and any other blogs using Wordpress 1.5 or later have XFN supporting blog rolls (for friends and [[rel-me]]).
* http://lifestrea.ms/animated_favicon1.gif [http://lifestrea.ms/ lifestrea.ms] - one friends list per social group that you want to share information with: <nowiki>http://lifestrea.ms/user/[username]/</nowiki>. Examples: [http://lifestrea.ms/user/thomas.huhn/ public profile] or [http://lifestrea.ms/user/solution-media.thomas.huhn/ professional profile] of the same person.
</div>

== Services that import XFN supporting friends lists ==
The following web sites support importing your existing XFN supporting friends lists, e.g. from the above sites. Alphabetically sorted. Feel free to add sites supporting XFN import here. Please include a link to the site home page, and instructions for how to import friends on the site.
=== import ===
The following sites do one time imports of friends lists.
* None currently.
=== import and subscribe ===
The following sites support both importing and subscribing to friends lists.
* None currently.
=== delegation ===
The following sites support fully delegating your friends list to an external XFN friends list.
* None currently.

== Services with XFN rel="me" to multiple external sites ==
The following services have a UI for entering any number of websites/homepages/blogs and publish it as part of your profile, linking to it with [[rel-me]].
<div style="font-size:larger">
* http://pulse.plaxo.com/pulse/img/event_icons/Digg.gif [http://digg.com/ Digg] - e.g. http://digg.com/users/tantek
* http://identoo.com/images/icons/services/identoo.gif [http://identoo.com/ Identoo] - e.g. [http://identoo.com/dirk.olbertz sample profile]
* http://www.linkedin.com/img/pic/pic_in_17x17.gif [http://www.linkedin.com/ LinkedIn] - e.g. http://www.linkedin.com/in/steveganz rel="me" is applied to "My Website" and "My Blog" on your public profile.
* http://pulse.plaxo.com/pulse/img/event_icons/plaxo.gif [http://plaxo.com/ Plaxo] - e.g. http://joseph.myplaxo.com/
* http://pulse.plaxo.com/pulse/img/event_icons/Pownce.gif [http://pownce.com/ Pownce] - login, go to your profile, and copy the URL which should start with <nowiki>http://pownce.com/</nowiki>
* http://technorati.com/tools/mozsearch/technorati.png [http://technorati.com/ Technorati] - e.g. http://technorati.com/people/technorati/tantek
* http://www.postreach.com/images/logo_typepad.gif [http://typepad.com/ TypePad] - e.g. http://www.markpasc.typepad.com/
* [http://videntity.org/ Videntity.org] - e.g. http://danda.videntity.org/
* http://openid.net/wp-content/uploads/vox.png [http://vox.com/ Vox] - e.g. http://anil.vox.com/
* [http://wordpress.com Wordpress.com] and any other blogs using Wordpress 1.5 or later have XFN supporting blog rolls (for friends and [[rel-me]]).
* http://lifestrea.ms/animated_favicon1.gif [http://lifestrea.ms/ lifestrea.ms] - supporting all your appearances on the web. Examples: [http://lifestrea.ms/user/thomas.huhn/ public profile] or [http://lifestrea.ms/user/solution-media.thomas.huhn/ professional profile] of the same person.
</div>

== Services with XFN rel="me" to one external site ==
The following services have a UI for entering one website/homepage/blog and publish it as part of your profile, linking to it with [[rel-me]].
<div style="font-size:larger">
* http://pulse.plaxo.com/pulse/img/event_icons/Digg.gif [http://digg.com/ Digg] - e.g. http://digg.com/users/tantek
* [http://eventful.com/ Eventful] - login, click on your username, and copy that URL.
* http://pulse.plaxo.com/pulse/img/event_icons/Flickr.gif [http://flickr.com/ Flickr] - login, click "Your Photos", click "Profile", and copy the URL which should be <nowiki>http://flickr.com/people/[username]/</nowiki>
** Flickr supports rel="me" identity consolidation with your webpage that you enter into your profile, and with your Flickr contacts page. See [http://flickr.com/photos/factoryjoe/113866484/ screenshot of Flickr UI in Flock browser using Flocktails extension - March 17th 2006].
* http://identoo.com/images/icons/services/identoo.gif [http://identoo.com/ Identoo] - e.g. [http://identoo.com/dirk.olbertz sample profile]
* [http://jpgmag.com JPG Magazine]
* http://pulse.plaxo.com/pulse/img/event_icons/LastFM.gif [http://www.last.fm/ Last.FM] - login, go to your profile, and copy the URL which should start with <nowiki>http://www.last.fm/user/</nowiki>
** Last.FM supports rel="me" identity consolidation with your webpage that you enter into your profile, and with your Last.FM friends page.
* http://pulse.plaxo.com/pulse/img/event_icons/Magnolia.gif [http://ma.gnolia.com/ Ma.gnolia] - see [http://ma.gnolia.com/blog/2006/08/21/a-microadvance-in-our-microformats supports rel=me announcement].
* [http://nsyght.com Nsyght] - e.g. [http://nsyght.com/users/lisa sample profile].
* http://pulse.plaxo.com/pulse/img/event_icons/plaxo.gif [http://plaxo.com/ Plaxo] - e.g. http://joseph.myplaxo.com/
* http://pulse.plaxo.com/pulse/img/event_icons/Pownce.gif [http://pownce.com/ Pownce] - login, go to your profile, and copy the URL which should start with <nowiki>http://pownce.com/</nowiki>
** Pownce [http://pownce.com/t/notes/644806/ supports rel="me" for LOTS of other profiles].
* [http://www.qmpeople.com/ qmpeople] - e.g. http://www.qmpeople.com/users/laserion
* [http://soup.io Soup] - on user profile
* http://technorati.com/tools/mozsearch/technorati.png [http://technorati.com/ Technorati] - e.g. http://technorati.com/people/technorati/tantek
* http://www.postreach.com/images/logo_typepad.gif [http://typepad.com/ TypePad] - e.g. http://www.markpasc.typepad.com/
* http://pulse.plaxo.com/pulse/img/event_icons/Twitter.gif [http://twitter.com/ Twitter] - login, click on "Your profile" at the top, and copy the URL
* [http://videntity.org/ Videntity.org] - e.g. http://danda.videntity.org/
* http://openid.net/wp-content/uploads/vox.png [http://vox.com/ Vox] - e.g. http://anil.vox.com/
* [http://wordpress.com Wordpress.com] and any other blogs using Wordpress 1.5 or later have XFN supporting blog rolls (for friends and [[rel-me]]).
* http://lifestrea.ms/animated_favicon1.gif [http://lifestrea.ms/ lifestrea.ms] - supporting all your external appearances on the web. Examples: [http://lifestrea.ms/user/thomas.huhn/ public profile] or [http://lifestrea.ms/user/solution-media.thomas.huhn/ professional profile] of the same person.
</div>

== Implement hCard XFN supporting friends lists ==
Want to implement hCard+XFN on your site so you can list it here?

# '''Markup friends with hCard.''' See the [[hcard-authoring|hCard authoring]] page for how to mark-up names, links, icons of people in friends lists with hCard.
# '''XFN on friend links.''' Friends lists should be marked up with XFN per [[xfn-clarifications#mapping_community_site_.22friends.22|XFN clarifications: mapping community site friends]]. See also the [http://www.gmpg.org/xfn/join XFN: Getting Started] page for how to markup links to people with XFN. See also the [[hcard-examples#hCard_and_XFN|hCard examples: hCard and XFN]] which demonstrates this and the previous step quite well.
# '''rel="me" to a user's other URLs'''. Hyperlinks to users' home pages or blogs should have the XFN <code>rel="me"</code> attribute to support user-driven (since the user chooses the URL to link to) identity consolidation.
# '''rel="me" on "View All Friends..." links'''. If a user profile page on your site links to a separate page for that user's friends list, add <code>rel="me"</code> to that link.
# '''rel="me" on friends list pagination links'''. If your site paginates a user's friend list into multiple pages, be sure to add <code>rel="me next"</code> to your "Next" pagination hyperlinks, and similarly <code>rel="me prev"</code> to your "Previous" pagination hyperlinks.

Please also consider implementing [[hcard-supporting-user-profiles|hCard user profiles]].

== Implement import XFN friends lists ==
Want to implement importing (and preferably subscribing to) XFN friends lists on your site so you can list it here?

In addition to implementing hCard XFN supporting friends lists yourself (see above), do the following:

# '''Provide a user interface to "Import Friends"''' (like a button or menu item)
# '''When chosen, provide a text input field for the user to enter their profile URL''' (such as their blog or XFN friends list URL). If you already have the user's "Website", pre-fill the field with it, or if the user has many "Other Profiles", pre-fill the field with the first, and let the user pick any of them with a Select pop-up menu, or provide the user the option to just import XFN from all of them at once.
# '''Parse the [[XFN]] at the URL(s) given''' (links with rel="contact" or "acquaintance" or "friend" etc.) and check to see if there are any users on your site with any of those links as their rel="me" "Website" or among their rel="me" "Other Profiles" and add them to a list of people to invite. Crawl any symmetrical rel="me" links, especially symmetrical rel="me next" and/or rel="me prev" friends list pagination links for additional URLs to parse for XFN. Consider also parsing those URLs simultaneously for hCards that have those XFN links as class="url" hCard properties, and if the hCards have additional contact information such as instant messaging or email, add them to the list of people to invite.
# '''Present the list of people to invite''', perhaps sorted by "closeness" of XFN relationships (e.g. list family relationships before just romantic relationships before just friends before just professional relationships before just acquaintances before just contacts before just met etc.) with a "Add Friend" button next to each. When clicked, use [[XHR]] to add that person without altering the overall list, and change the Add button into a Cancel button. Perhaps put an "Add all" button at the top (or bottom) to let the user simply add everyone listed with one click.
# '''Consider also providing a checkbox "<nowiki>[x]</nowiki> Subscribe to XFN friends"''' which would automatically run this import perhaps once a day and notify the user of new contacts found that they may want to add, and similarly present an "Add all" button.

== Sites that should support hCard and XFN ==
See [[hcard-advocacy#hCard_XFN_friends_lists|hCard advocacy - hCard XFN friends lists]].

== For more information ==
In addition to the previous "Implement" sections, see the [[hcard-authoring|hCard authoring]] page for how to mark-up information about a person with hCard, and [http://gmpg.org/xfn/join XFN getting started] page for how to mark-up friend links with XFN.

Join the [http://microformats.org/discuss microformats community], in particular the #microformats IRC channel on irc://irc.freenode.net#microformats and the [http://microformats.org/mailman/listinfo/microformats-dev/ microformats-dev mailing list], and send a message stating that you'd like to add hCard to the profiles and hCard+XFN supporting friends lists (and importing thereof) to your website.

Please also consider implementing [[hcard-supporting-user-profiles|hCard supporting user profiles]].

See [[hcard-xfn-supporting-friends-lists-issues|hCard+XFN supporting friends lists issues]] for issues, problems with implementations.

== See also ==
* [[xfn|XFN]] ([http://gmpg.org/xfn/ spec], [[xfn-faq|FAQ]], [[xfn-implementations|implementations]] - there are a few more in there that need to be copied and expanded in this page.)
* [[hcard-supporting-user-profiles]]
* [[hcard|hCard]] ([[hcard-authoring|authoring]], [[hcard-faq|FAQ]])
* [[social-network-portability]]
* [[data-portability]]
* [[user-interface]]

hcard-xfn-supporting-friends-lists

2008-05-01T02:08:05Z

Steve Ganz: /* Services with XFN supporting friends lists */

<h1>hCard+XFN supporting friends lists</h1>
{{TOC-right}}

Welcome! If you have an account on any of the following services, you already have a list of your friends' hCards with your relationship to them in XFN which you can provide to other services to save time by either importing or subscribing to social network information so you can change it on one site, and have other sites automatically updated, rather than having to re-add/remove all your social network contacts multiple times every time you meet a new person, decide to unfriend someone etc.

== Services with hCard+XFN supporting friends lists ==
The following web sites support publishing hCard+XFN friends lists and are thus suitable for importing/subscribing to other sites that support hCard+XFN. Alphabetically sorted. Feel free to add sites with hCard+XFN supporting friends lists here. Please include a link to the site home page, and instructions for retrieving your the URL of your hCard+XFN supporting friends list on that site.

<div style="font-size:larger">
* http://identoo.com/images/icons/services/corkd.gif [http://www.corkd.com/ Cork'd] - login and copy the URL which should start with <nowiki>http://www.corkd.com/people/</nowiki>
* http://identoo.com/images/icons/services/dopplr.gif [http://dopplr.com Dopplr] - login and note that your user page has hCard and XFN for your contacts
* [http://gaia.com/ Gaia Community] - e.g. http://sphorbis.gaia.com/ - built by [http://www.zaadz.com Zaadz]
* http://pulse.plaxo.com/pulse/img/event_icons/LastFM.gif [http://www.last.fm/ Last FM] - login, click the "Friends" tab, and copy the URL which should look like: <nowiki>http://www.last.fm/user/[username]/friends/</nowiki>
* http://pulse.plaxo.com/pulse/img/event_icons/Magnolia.gif [http://ma.gnolia.com/ Ma.gnolia] - View your contacts page <nowiki>http://ma.gnolia.com/people/[username]/contacts</nowiki> . Note [[hcard-xfn-supporting-friends-lists-issues#Magnolia|issue(s)]].
* [http://www.nsyght.com/ Nsyght] - Visit your profile page and select "view all" on the friends component. Should look like this: <nowiki>http://www.nsyght.com/friends/[username]/</nowiki>, e.g. [http://nsyght.com/users/lisa sample profile].
* [http://www.qmpeople.com/ qmpeople] - Uses hCard+XFN for profiles (<nowiki>http://www.qmpeople.com/users/[username]</nowiki> - e.g. [http://www.qmpeople.com/users/laserion laserion])
* [http://soup.io Soup] - On user profile if the "Friends list" element is displayed (on by default), else at <nowiki>/friends</nowiki>
* http://pulse.plaxo.com/pulse/img/event_icons/Twitter.gif [http://twitter.com/ Twitter] - login, click on "Your profile" at the top, and copy the URL
* http://lifestrea.ms/animated_favicon1.gif [http://lifestrea.ms/ lifestrea.ms] - you have one user profile per social group that you want to share information with: <nowiki>http://lifestrea.ms/user/[username]/</nowiki>. Examples: [http://lifestrea.ms/user/thomas.huhn/ public profile] or [http://lifestrea.ms/user/solution-media.thomas.huhn/ professional profile] of the same person.
</div>

== Services that import hCard+XFN supporting friends lists ==
The following web sites let you import hCard+XFN friends lists, e.g. from the above sites, and make use of both the XFN information and the hCards in the friends lists. Alphabetically sorted. Feel free to add sites supporting hCard+XFN import here. Please include a link to the site home page, and instructions for how to import friends on the site.

=== import ===
The following sites do one time imports of friends lists.

* http://identoo.com/images/icons/services/dopplr.gif [http://dopplr.com Dopplr] - as [http://blog.dopplr.com/index.php/2007/06/23/importing-your-social-network-from-other-sites/ announced] login and go to <nowiki>http://www.dopplr.com/account/fellows_from_hcard</nowiki> to import (site is private beta)

* [http://t.heproject.com/ The Project] - Login with your OpenID and the site automatically tries to subscribe to your XFN friends list where it intersects with their userbase
** appears to fail logging in with a delegated OpenID, e.g. http://tantek.com/ - unable to verify import friends list support. [[User:Tantek|Tantek]] 10:03, 1 Feb 2008 (PST)

=== import and subscribe ===
The following sites support both importing and subscribing to friends lists.
* None currently.

=== delegation ===
The following sites support fully delegating your friends list to an external hCard+XFN friends list.
* None currently.

== Services with XFN supporting friends lists ==
These sites support XFN markup on friends lists. It is a superset of the sites that support XFN <em>and</em> hCard on friends lists.
<div style="font-size:larger">
* [http://3eep.com/ 3eep] - each user's friends are linked to with XFN is located at <nowiki>http://3eep.com/users/[username]</nowiki>
* http://identoo.com/images/icons/services/corkd.gif [http://www.corkd.com/ Cork'd] - login and copy the URL which should start with <nowiki>http://www.corkd.com/people/</nowiki>
* [http://couchsurfing.com CouchSurfing] profiles have XFN Friendly friends lists (e.g. [http://www.couchsurfing.com/people/guaka Guaka's]).
* http://identoo.com/images/icons/services/dopplr.gif [http://dopplr.com Dopplr] - login and note that your user page has hCard and XFN for your contacts
* http://flugpo.com/images/flugpo_icon.gif [http://flugpo.com Flugpo] - check your friends page linked from your profile.
* [http://gaia.com/ Gaia Community] - e.g. http://sphorbis.gaia.com/ - built by [http://www.zaadz.com Zaadz]
* http://identoo.com/images/icons/services/identoo.gif [http://identoo.com/ Identoo] - e.g. [http://identoo.com/dirk.olbertz sample profile]
* [http://www.linkedin.com/ LinkedIn] - LinkedIn Connections use XFN and are marked up with rel="contact".
* http://pulse.plaxo.com/pulse/img/event_icons/LastFM.gif [http://www.last.fm/ Last FM] - login, click the "Friends" tab, and copy the URL which should look like: <nowiki>http://www.last.fm/user/[username]/friends/</nowiki>
* http://pulse.plaxo.com/pulse/img/event_icons/LiveJournal.gif [http://livejournal.com LiveJournal] (see [[implementations#LiveJournal|LiveJournal]] implementation entry) - login, click on the "Profile" link, and copy the URL which should start with <nowiki>http://USERNAME.livejournal.com/profile</nowiki> where USERNAME is your LJ username. E.g. [http://daveman692.livejournal.com/profile]. LiveJournal profiles have complete friends lists marked up in XFN.
* http://pulse.plaxo.com/pulse/img/event_icons/Magnolia.gif [http://ma.gnolia.com/ Ma.gnolia] - View your contacts page <nowiki>http://ma.gnolia.com/people/[username]/contacts</nowiki> . Note [[hcard-xfn-supporting-friends-lists-issues#Magnolia|issue(s)]].
* [http://meetlisten.com Meetlisten] - e.g. http://meetlisten.com/home/profile.php?id=1 and (e.g. [http://meetlisten.com/home/friends.php?id=6 MAKACOW-Brazil's]).
* [http://www.nsyght.com/ Nsyght] - Visit your profile page and select "view all" on the friends component. Should look like this: <nowiki>http://www.nsyght.com/friends/[username]/</nowiki>, e.g. [http://nsyght.com/users/lisa sample profile].
* http://identoo.com/images/icons/services/odeo.gif [http://odeo.com Odeo] — the "peep's" list of each user is marked up with XFN (rel="contact") e.g. http://odeo.com/profile/JeremyKeith . See [http://odeo.com/blog/2005/07/adding-microformats-to-odeo.html announcing blog post].
* http://pulse.plaxo.com/pulse/img/event_icons/Pownce.gif [http://pownce.com/ Pownce] - login, click on the "Home" link at the top, and copy the URL.
* [http://www.qmpeople.com/ qmpeople] - Uses XFN for public friendships - e.g. http://www.qmpeople.com/users/laserion
* [http://soup.io Soup] - On user profile if the "Friends list" element is displayed (on by default), else at <nowiki>/friends</nowiki>
* http://pulse.plaxo.com/pulse/img/event_icons/Twitter.gif [http://twitter.com/ Twitter] - login, click on "Your profile" at the top, and copy the URL
* [http://videntity.org/ Videntity.org] - e.g. http://danda.videntity.org/ (see also [http://wiki.www.videntity.org/wiki/Social_Networking_Unlimited Videntity XFN support documentation]).
* [http://wordpress.com Wordpress.com] and any other blogs using Wordpress 1.5 or later have XFN supporting blog rolls (for friends and [[rel-me]]).
* http://lifestrea.ms/animated_favicon1.gif [http://lifestrea.ms/ lifestrea.ms] - one friends list per social group that you want to share information with: <nowiki>http://lifestrea.ms/user/[username]/</nowiki>. Examples: [http://lifestrea.ms/user/thomas.huhn/ public profile] or [http://lifestrea.ms/user/solution-media.thomas.huhn/ professional profile] of the same person.
</div>

== Services that import XFN supporting friends lists ==
The following web sites support importing your existing XFN supporting friends lists, e.g. from the above sites. Alphabetically sorted. Feel free to add sites supporting XFN import here. Please include a link to the site home page, and instructions for how to import friends on the site.
=== import ===
The following sites do one time imports of friends lists.
* None currently.
=== import and subscribe ===
The following sites support both importing and subscribing to friends lists.
* None currently.
=== delegation ===
The following sites support fully delegating your friends list to an external XFN friends list.
* None currently.

== Services with XFN rel="me" to multiple external sites ==
The following services have a UI for entering any number of websites/homepages/blogs and publish it as part of your profile, linking to it with [[rel-me]].
<div style="font-size:larger">
* http://pulse.plaxo.com/pulse/img/event_icons/Digg.gif [http://digg.com/ Digg] - e.g. http://digg.com/users/tantek
* http://identoo.com/images/icons/services/identoo.gif [http://identoo.com/ Identoo] - e.g. [http://identoo.com/dirk.olbertz sample profile]
* http://pulse.plaxo.com/pulse/img/event_icons/plaxo.gif [http://plaxo.com/ Plaxo] - e.g. http://joseph.myplaxo.com/
* http://pulse.plaxo.com/pulse/img/event_icons/Pownce.gif [http://pownce.com/ Pownce] - login, go to your profile, and copy the URL which should start with <nowiki>http://pownce.com/</nowiki>
* http://technorati.com/tools/mozsearch/technorati.png [http://technorati.com/ Technorati] - e.g. http://technorati.com/people/technorati/tantek
* http://www.postreach.com/images/logo_typepad.gif [http://typepad.com/ TypePad] - e.g. http://www.markpasc.typepad.com/
* [http://videntity.org/ Videntity.org] - e.g. http://danda.videntity.org/
* http://openid.net/wp-content/uploads/vox.png [http://vox.com/ Vox] - e.g. http://anil.vox.com/
* [http://wordpress.com Wordpress.com] and any other blogs using Wordpress 1.5 or later have XFN supporting blog rolls (for friends and [[rel-me]]).
* http://lifestrea.ms/animated_favicon1.gif [http://lifestrea.ms/ lifestrea.ms] - supporting all your appearances on the web. Examples: [http://lifestrea.ms/user/thomas.huhn/ public profile] or [http://lifestrea.ms/user/solution-media.thomas.huhn/ professional profile] of the same person.
</div>

== Services with XFN rel="me" to one external site ==
The following services have a UI for entering one website/homepage/blog and publish it as part of your profile, linking to it with [[rel-me]].
<div style="font-size:larger">
* http://pulse.plaxo.com/pulse/img/event_icons/Digg.gif [http://digg.com/ Digg] - e.g. http://digg.com/users/tantek
* [http://eventful.com/ Eventful] - login, click on your username, and copy that URL.
* http://pulse.plaxo.com/pulse/img/event_icons/Flickr.gif [http://flickr.com/ Flickr] - login, click "Your Photos", click "Profile", and copy the URL which should be <nowiki>http://flickr.com/people/[username]/</nowiki>
** Flickr supports rel="me" identity consolidation with your webpage that you enter into your profile, and with your Flickr contacts page. See [http://flickr.com/photos/factoryjoe/113866484/ screenshot of Flickr UI in Flock browser using Flocktails extension - March 17th 2006].
* http://identoo.com/images/icons/services/identoo.gif [http://identoo.com/ Identoo] - e.g. [http://identoo.com/dirk.olbertz sample profile]
* [http://jpgmag.com JPG Magazine]
* http://pulse.plaxo.com/pulse/img/event_icons/LastFM.gif [http://www.last.fm/ Last.FM] - login, go to your profile, and copy the URL which should start with <nowiki>http://www.last.fm/user/</nowiki>
** Last.FM supports rel="me" identity consolidation with your webpage that you enter into your profile, and with your Last.FM friends page.
* http://pulse.plaxo.com/pulse/img/event_icons/Magnolia.gif [http://ma.gnolia.com/ Ma.gnolia] - see [http://ma.gnolia.com/blog/2006/08/21/a-microadvance-in-our-microformats supports rel=me announcement].
* [http://nsyght.com Nsyght] - e.g. [http://nsyght.com/users/lisa sample profile].
* http://pulse.plaxo.com/pulse/img/event_icons/plaxo.gif [http://plaxo.com/ Plaxo] - e.g. http://joseph.myplaxo.com/
* http://pulse.plaxo.com/pulse/img/event_icons/Pownce.gif [http://pownce.com/ Pownce] - login, go to your profile, and copy the URL which should start with <nowiki>http://pownce.com/</nowiki>
** Pownce [http://pownce.com/t/notes/644806/ supports rel="me" for LOTS of other profiles].
* [http://www.qmpeople.com/ qmpeople] - e.g. http://www.qmpeople.com/users/laserion
* [http://soup.io Soup] - on user profile
* http://technorati.com/tools/mozsearch/technorati.png [http://technorati.com/ Technorati] - e.g. http://technorati.com/people/technorati/tantek
* http://www.postreach.com/images/logo_typepad.gif [http://typepad.com/ TypePad] - e.g. http://www.markpasc.typepad.com/
* http://pulse.plaxo.com/pulse/img/event_icons/Twitter.gif [http://twitter.com/ Twitter] - login, click on "Your profile" at the top, and copy the URL
* [http://videntity.org/ Videntity.org] - e.g. http://danda.videntity.org/
* http://openid.net/wp-content/uploads/vox.png [http://vox.com/ Vox] - e.g. http://anil.vox.com/
* [http://wordpress.com Wordpress.com] and any other blogs using Wordpress 1.5 or later have XFN supporting blog rolls (for friends and [[rel-me]]).
* http://lifestrea.ms/animated_favicon1.gif [http://lifestrea.ms/ lifestrea.ms] - supporting all your external appearances on the web. Examples: [http://lifestrea.ms/user/thomas.huhn/ public profile] or [http://lifestrea.ms/user/solution-media.thomas.huhn/ professional profile] of the same person.
</div>

== Implement hCard XFN supporting friends lists ==
Want to implement hCard+XFN on your site so you can list it here?

# '''Markup friends with hCard.''' See the [[hcard-authoring|hCard authoring]] page for how to mark-up names, links, icons of people in friends lists with hCard.
# '''XFN on friend links.''' Friends lists should be marked up with XFN per [[xfn-clarifications#mapping_community_site_.22friends.22|XFN clarifications: mapping community site friends]]. See also the [http://www.gmpg.org/xfn/join XFN: Getting Started] page for how to markup links to people with XFN. See also the [[hcard-examples#hCard_and_XFN|hCard examples: hCard and XFN]] which demonstrates this and the previous step quite well.
# '''rel="me" to a user's other URLs'''. Hyperlinks to users' home pages or blogs should have the XFN <code>rel="me"</code> attribute to support user-driven (since the user chooses the URL to link to) identity consolidation.
# '''rel="me" on "View All Friends..." links'''. If a user profile page on your site links to a separate page for that user's friends list, add <code>rel="me"</code> to that link.
# '''rel="me" on friends list pagination links'''. If your site paginates a user's friend list into multiple pages, be sure to add <code>rel="me next"</code> to your "Next" pagination hyperlinks, and similarly <code>rel="me prev"</code> to your "Previous" pagination hyperlinks.

Please also consider implementing [[hcard-supporting-user-profiles|hCard user profiles]].

== Implement import XFN friends lists ==
Want to implement importing (and preferably subscribing to) XFN friends lists on your site so you can list it here?

In addition to implementing hCard XFN supporting friends lists yourself (see above), do the following:

# '''Provide a user interface to "Import Friends"''' (like a button or menu item)
# '''When chosen, provide a text input field for the user to enter their profile URL''' (such as their blog or XFN friends list URL). If you already have the user's "Website", pre-fill the field with it, or if the user has many "Other Profiles", pre-fill the field with the first, and let the user pick any of them with a Select pop-up menu, or provide the user the option to just import XFN from all of them at once.
# '''Parse the [[XFN]] at the URL(s) given''' (links with rel="contact" or "acquaintance" or "friend" etc.) and check to see if there are any users on your site with any of those links as their rel="me" "Website" or among their rel="me" "Other Profiles" and add them to a list of people to invite. Crawl any symmetrical rel="me" links, especially symmetrical rel="me next" and/or rel="me prev" friends list pagination links for additional URLs to parse for XFN. Consider also parsing those URLs simultaneously for hCards that have those XFN links as class="url" hCard properties, and if the hCards have additional contact information such as instant messaging or email, add them to the list of people to invite.
# '''Present the list of people to invite''', perhaps sorted by "closeness" of XFN relationships (e.g. list family relationships before just romantic relationships before just friends before just professional relationships before just acquaintances before just contacts before just met etc.) with a "Add Friend" button next to each. When clicked, use [[XHR]] to add that person without altering the overall list, and change the Add button into a Cancel button. Perhaps put an "Add all" button at the top (or bottom) to let the user simply add everyone listed with one click.
# '''Consider also providing a checkbox "<nowiki>[x]</nowiki> Subscribe to XFN friends"''' which would automatically run this import perhaps once a day and notify the user of new contacts found that they may want to add, and similarly present an "Add all" button.

== Sites that should support hCard and XFN ==
See [[hcard-advocacy#hCard_XFN_friends_lists|hCard advocacy - hCard XFN friends lists]].

== For more information ==
In addition to the previous "Implement" sections, see the [[hcard-authoring|hCard authoring]] page for how to mark-up information about a person with hCard, and [http://gmpg.org/xfn/join XFN getting started] page for how to mark-up friend links with XFN.

Join the [http://microformats.org/discuss microformats community], in particular the #microformats IRC channel on irc://irc.freenode.net#microformats and the [http://microformats.org/mailman/listinfo/microformats-dev/ microformats-dev mailing list], and send a message stating that you'd like to add hCard to the profiles and hCard+XFN supporting friends lists (and importing thereof) to your website.

Please also consider implementing [[hcard-supporting-user-profiles|hCard supporting user profiles]].

See [[hcard-xfn-supporting-friends-lists-issues|hCard+XFN supporting friends lists issues]] for issues, problems with implementations.

== See also ==
* [[xfn|XFN]] ([http://gmpg.org/xfn/ spec], [[xfn-faq|FAQ]], [[xfn-implementations|implementations]] - there are a few more in there that need to be copied and expanded in this page.)
* [[hcard-supporting-user-profiles]]
* [[hcard|hCard]] ([[hcard-authoring|authoring]], [[hcard-faq|FAQ]])
* [[social-network-portability]]
* [[data-portability]]
* [[user-interface]]

hcard-xfn-supporting-friends-lists

2008-05-01T02:07:41Z

Steve Ganz: /* Services with XFN supporting friends lists */

<h1>hCard+XFN supporting friends lists</h1>
{{TOC-right}}

Welcome! If you have an account on any of the following services, you already have a list of your friends' hCards with your relationship to them in XFN which you can provide to other services to save time by either importing or subscribing to social network information so you can change it on one site, and have other sites automatically updated, rather than having to re-add/remove all your social network contacts multiple times every time you meet a new person, decide to unfriend someone etc.

== Services with hCard+XFN supporting friends lists ==
The following web sites support publishing hCard+XFN friends lists and are thus suitable for importing/subscribing to other sites that support hCard+XFN. Alphabetically sorted. Feel free to add sites with hCard+XFN supporting friends lists here. Please include a link to the site home page, and instructions for retrieving your the URL of your hCard+XFN supporting friends list on that site.

<div style="font-size:larger">
* http://identoo.com/images/icons/services/corkd.gif [http://www.corkd.com/ Cork'd] - login and copy the URL which should start with <nowiki>http://www.corkd.com/people/</nowiki>
* http://identoo.com/images/icons/services/dopplr.gif [http://dopplr.com Dopplr] - login and note that your user page has hCard and XFN for your contacts
* [http://gaia.com/ Gaia Community] - e.g. http://sphorbis.gaia.com/ - built by [http://www.zaadz.com Zaadz]
* http://pulse.plaxo.com/pulse/img/event_icons/LastFM.gif [http://www.last.fm/ Last FM] - login, click the "Friends" tab, and copy the URL which should look like: <nowiki>http://www.last.fm/user/[username]/friends/</nowiki>
* http://pulse.plaxo.com/pulse/img/event_icons/Magnolia.gif [http://ma.gnolia.com/ Ma.gnolia] - View your contacts page <nowiki>http://ma.gnolia.com/people/[username]/contacts</nowiki> . Note [[hcard-xfn-supporting-friends-lists-issues#Magnolia|issue(s)]].
* [http://www.nsyght.com/ Nsyght] - Visit your profile page and select "view all" on the friends component. Should look like this: <nowiki>http://www.nsyght.com/friends/[username]/</nowiki>, e.g. [http://nsyght.com/users/lisa sample profile].
* [http://www.qmpeople.com/ qmpeople] - Uses hCard+XFN for profiles (<nowiki>http://www.qmpeople.com/users/[username]</nowiki> - e.g. [http://www.qmpeople.com/users/laserion laserion])
* [http://soup.io Soup] - On user profile if the "Friends list" element is displayed (on by default), else at <nowiki>/friends</nowiki>
* http://pulse.plaxo.com/pulse/img/event_icons/Twitter.gif [http://twitter.com/ Twitter] - login, click on "Your profile" at the top, and copy the URL
* http://lifestrea.ms/animated_favicon1.gif [http://lifestrea.ms/ lifestrea.ms] - you have one user profile per social group that you want to share information with: <nowiki>http://lifestrea.ms/user/[username]/</nowiki>. Examples: [http://lifestrea.ms/user/thomas.huhn/ public profile] or [http://lifestrea.ms/user/solution-media.thomas.huhn/ professional profile] of the same person.
</div>

== Services that import hCard+XFN supporting friends lists ==
The following web sites let you import hCard+XFN friends lists, e.g. from the above sites, and make use of both the XFN information and the hCards in the friends lists. Alphabetically sorted. Feel free to add sites supporting hCard+XFN import here. Please include a link to the site home page, and instructions for how to import friends on the site.

=== import ===
The following sites do one time imports of friends lists.

* http://identoo.com/images/icons/services/dopplr.gif [http://dopplr.com Dopplr] - as [http://blog.dopplr.com/index.php/2007/06/23/importing-your-social-network-from-other-sites/ announced] login and go to <nowiki>http://www.dopplr.com/account/fellows_from_hcard</nowiki> to import (site is private beta)

* [http://t.heproject.com/ The Project] - Login with your OpenID and the site automatically tries to subscribe to your XFN friends list where it intersects with their userbase
** appears to fail logging in with a delegated OpenID, e.g. http://tantek.com/ - unable to verify import friends list support. [[User:Tantek|Tantek]] 10:03, 1 Feb 2008 (PST)

=== import and subscribe ===
The following sites support both importing and subscribing to friends lists.
* None currently.

=== delegation ===
The following sites support fully delegating your friends list to an external hCard+XFN friends list.
* None currently.

== Services with XFN supporting friends lists ==
These sites support XFN markup on friends lists. It is a superset of the sites that support XFN <em>and</em> hCard on friends lists.
<div style="font-size:larger">
* [http://3eep.com/ 3eep] - each user's friends are linked to with XFN is located at <nowiki>http://3eep.com/users/[username]</nowiki>
* http://identoo.com/images/icons/services/corkd.gif [http://www.corkd.com/ Cork'd] - login and copy the URL which should start with <nowiki>http://www.corkd.com/people/</nowiki>
* [http://couchsurfing.com CouchSurfing] profiles have XFN Friendly friends lists (e.g. [http://www.couchsurfing.com/people/guaka Guaka's]).
* http://identoo.com/images/icons/services/dopplr.gif [http://dopplr.com Dopplr] - login and note that your user page has hCard and XFN for your contacts
* http://flugpo.com/images/flugpo_icon.gif [http://flugpo.com Flugpo] - check your friends page linked from your profile.
* [http://gaia.com/ Gaia Community] - e.g. http://sphorbis.gaia.com/ - built by [http://www.zaadz.com Zaadz]
* http://identoo.com/images/icons/services/identoo.gif [http://identoo.com/ Identoo] - e.g. [http://identoo.com/dirk.olbertz sample profile]
* [http://www.linkedin.com/ LinkedIn] - LinkedIn Connections use XFN are marked up with rel="contact".
* http://pulse.plaxo.com/pulse/img/event_icons/LastFM.gif [http://www.last.fm/ Last FM] - login, click the "Friends" tab, and copy the URL which should look like: <nowiki>http://www.last.fm/user/[username]/friends/</nowiki>
* http://pulse.plaxo.com/pulse/img/event_icons/LiveJournal.gif [http://livejournal.com LiveJournal] (see [[implementations#LiveJournal|LiveJournal]] implementation entry) - login, click on the "Profile" link, and copy the URL which should start with <nowiki>http://USERNAME.livejournal.com/profile</nowiki> where USERNAME is your LJ username. E.g. [http://daveman692.livejournal.com/profile]. LiveJournal profiles have complete friends lists marked up in XFN.
* http://pulse.plaxo.com/pulse/img/event_icons/Magnolia.gif [http://ma.gnolia.com/ Ma.gnolia] - View your contacts page <nowiki>http://ma.gnolia.com/people/[username]/contacts</nowiki> . Note [[hcard-xfn-supporting-friends-lists-issues#Magnolia|issue(s)]].
* [http://meetlisten.com Meetlisten] - e.g. http://meetlisten.com/home/profile.php?id=1 and (e.g. [http://meetlisten.com/home/friends.php?id=6 MAKACOW-Brazil's]).
* [http://www.nsyght.com/ Nsyght] - Visit your profile page and select "view all" on the friends component. Should look like this: <nowiki>http://www.nsyght.com/friends/[username]/</nowiki>, e.g. [http://nsyght.com/users/lisa sample profile].
* http://identoo.com/images/icons/services/odeo.gif [http://odeo.com Odeo] — the "peep's" list of each user is marked up with XFN (rel="contact") e.g. http://odeo.com/profile/JeremyKeith . See [http://odeo.com/blog/2005/07/adding-microformats-to-odeo.html announcing blog post].
* http://pulse.plaxo.com/pulse/img/event_icons/Pownce.gif [http://pownce.com/ Pownce] - login, click on the "Home" link at the top, and copy the URL.
* [http://www.qmpeople.com/ qmpeople] - Uses XFN for public friendships - e.g. http://www.qmpeople.com/users/laserion
* [http://soup.io Soup] - On user profile if the "Friends list" element is displayed (on by default), else at <nowiki>/friends</nowiki>
* http://pulse.plaxo.com/pulse/img/event_icons/Twitter.gif [http://twitter.com/ Twitter] - login, click on "Your profile" at the top, and copy the URL
* [http://videntity.org/ Videntity.org] - e.g. http://danda.videntity.org/ (see also [http://wiki.www.videntity.org/wiki/Social_Networking_Unlimited Videntity XFN support documentation]).
* [http://wordpress.com Wordpress.com] and any other blogs using Wordpress 1.5 or later have XFN supporting blog rolls (for friends and [[rel-me]]).
* http://lifestrea.ms/animated_favicon1.gif [http://lifestrea.ms/ lifestrea.ms] - one friends list per social group that you want to share information with: <nowiki>http://lifestrea.ms/user/[username]/</nowiki>. Examples: [http://lifestrea.ms/user/thomas.huhn/ public profile] or [http://lifestrea.ms/user/solution-media.thomas.huhn/ professional profile] of the same person.
</div>

== Services that import XFN supporting friends lists ==
The following web sites support importing your existing XFN supporting friends lists, e.g. from the above sites. Alphabetically sorted. Feel free to add sites supporting XFN import here. Please include a link to the site home page, and instructions for how to import friends on the site.
=== import ===
The following sites do one time imports of friends lists.
* None currently.
=== import and subscribe ===
The following sites support both importing and subscribing to friends lists.
* None currently.
=== delegation ===
The following sites support fully delegating your friends list to an external XFN friends list.
* None currently.

== Services with XFN rel="me" to multiple external sites ==
The following services have a UI for entering any number of websites/homepages/blogs and publish it as part of your profile, linking to it with [[rel-me]].
<div style="font-size:larger">
* http://pulse.plaxo.com/pulse/img/event_icons/Digg.gif [http://digg.com/ Digg] - e.g. http://digg.com/users/tantek
* http://identoo.com/images/icons/services/identoo.gif [http://identoo.com/ Identoo] - e.g. [http://identoo.com/dirk.olbertz sample profile]
* http://pulse.plaxo.com/pulse/img/event_icons/plaxo.gif [http://plaxo.com/ Plaxo] - e.g. http://joseph.myplaxo.com/
* http://pulse.plaxo.com/pulse/img/event_icons/Pownce.gif [http://pownce.com/ Pownce] - login, go to your profile, and copy the URL which should start with <nowiki>http://pownce.com/</nowiki>
* http://technorati.com/tools/mozsearch/technorati.png [http://technorati.com/ Technorati] - e.g. http://technorati.com/people/technorati/tantek
* http://www.postreach.com/images/logo_typepad.gif [http://typepad.com/ TypePad] - e.g. http://www.markpasc.typepad.com/
* [http://videntity.org/ Videntity.org] - e.g. http://danda.videntity.org/
* http://openid.net/wp-content/uploads/vox.png [http://vox.com/ Vox] - e.g. http://anil.vox.com/
* [http://wordpress.com Wordpress.com] and any other blogs using Wordpress 1.5 or later have XFN supporting blog rolls (for friends and [[rel-me]]).
* http://lifestrea.ms/animated_favicon1.gif [http://lifestrea.ms/ lifestrea.ms] - supporting all your appearances on the web. Examples: [http://lifestrea.ms/user/thomas.huhn/ public profile] or [http://lifestrea.ms/user/solution-media.thomas.huhn/ professional profile] of the same person.
</div>

== Services with XFN rel="me" to one external site ==
The following services have a UI for entering one website/homepage/blog and publish it as part of your profile, linking to it with [[rel-me]].
<div style="font-size:larger">
* http://pulse.plaxo.com/pulse/img/event_icons/Digg.gif [http://digg.com/ Digg] - e.g. http://digg.com/users/tantek
* [http://eventful.com/ Eventful] - login, click on your username, and copy that URL.
* http://pulse.plaxo.com/pulse/img/event_icons/Flickr.gif [http://flickr.com/ Flickr] - login, click "Your Photos", click "Profile", and copy the URL which should be <nowiki>http://flickr.com/people/[username]/</nowiki>
** Flickr supports rel="me" identity consolidation with your webpage that you enter into your profile, and with your Flickr contacts page. See [http://flickr.com/photos/factoryjoe/113866484/ screenshot of Flickr UI in Flock browser using Flocktails extension - March 17th 2006].
* http://identoo.com/images/icons/services/identoo.gif [http://identoo.com/ Identoo] - e.g. [http://identoo.com/dirk.olbertz sample profile]
* [http://jpgmag.com JPG Magazine]
* http://pulse.plaxo.com/pulse/img/event_icons/LastFM.gif [http://www.last.fm/ Last.FM] - login, go to your profile, and copy the URL which should start with <nowiki>http://www.last.fm/user/</nowiki>
** Last.FM supports rel="me" identity consolidation with your webpage that you enter into your profile, and with your Last.FM friends page.
* http://pulse.plaxo.com/pulse/img/event_icons/Magnolia.gif [http://ma.gnolia.com/ Ma.gnolia] - see [http://ma.gnolia.com/blog/2006/08/21/a-microadvance-in-our-microformats supports rel=me announcement].
* [http://nsyght.com Nsyght] - e.g. [http://nsyght.com/users/lisa sample profile].
* http://pulse.plaxo.com/pulse/img/event_icons/plaxo.gif [http://plaxo.com/ Plaxo] - e.g. http://joseph.myplaxo.com/
* http://pulse.plaxo.com/pulse/img/event_icons/Pownce.gif [http://pownce.com/ Pownce] - login, go to your profile, and copy the URL which should start with <nowiki>http://pownce.com/</nowiki>
** Pownce [http://pownce.com/t/notes/644806/ supports rel="me" for LOTS of other profiles].
* [http://www.qmpeople.com/ qmpeople] - e.g. http://www.qmpeople.com/users/laserion
* [http://soup.io Soup] - on user profile
* http://technorati.com/tools/mozsearch/technorati.png [http://technorati.com/ Technorati] - e.g. http://technorati.com/people/technorati/tantek
* http://www.postreach.com/images/logo_typepad.gif [http://typepad.com/ TypePad] - e.g. http://www.markpasc.typepad.com/
* http://pulse.plaxo.com/pulse/img/event_icons/Twitter.gif [http://twitter.com/ Twitter] - login, click on "Your profile" at the top, and copy the URL
* [http://videntity.org/ Videntity.org] - e.g. http://danda.videntity.org/
* http://openid.net/wp-content/uploads/vox.png [http://vox.com/ Vox] - e.g. http://anil.vox.com/
* [http://wordpress.com Wordpress.com] and any other blogs using Wordpress 1.5 or later have XFN supporting blog rolls (for friends and [[rel-me]]).
* http://lifestrea.ms/animated_favicon1.gif [http://lifestrea.ms/ lifestrea.ms] - supporting all your external appearances on the web. Examples: [http://lifestrea.ms/user/thomas.huhn/ public profile] or [http://lifestrea.ms/user/solution-media.thomas.huhn/ professional profile] of the same person.
</div>

== Implement hCard XFN supporting friends lists ==
Want to implement hCard+XFN on your site so you can list it here?

# '''Markup friends with hCard.''' See the [[hcard-authoring|hCard authoring]] page for how to mark-up names, links, icons of people in friends lists with hCard.
# '''XFN on friend links.''' Friends lists should be marked up with XFN per [[xfn-clarifications#mapping_community_site_.22friends.22|XFN clarifications: mapping community site friends]]. See also the [http://www.gmpg.org/xfn/join XFN: Getting Started] page for how to markup links to people with XFN. See also the [[hcard-examples#hCard_and_XFN|hCard examples: hCard and XFN]] which demonstrates this and the previous step quite well.
# '''rel="me" to a user's other URLs'''. Hyperlinks to users' home pages or blogs should have the XFN <code>rel="me"</code> attribute to support user-driven (since the user chooses the URL to link to) identity consolidation.
# '''rel="me" on "View All Friends..." links'''. If a user profile page on your site links to a separate page for that user's friends list, add <code>rel="me"</code> to that link.
# '''rel="me" on friends list pagination links'''. If your site paginates a user's friend list into multiple pages, be sure to add <code>rel="me next"</code> to your "Next" pagination hyperlinks, and similarly <code>rel="me prev"</code> to your "Previous" pagination hyperlinks.

Please also consider implementing [[hcard-supporting-user-profiles|hCard user profiles]].

== Implement import XFN friends lists ==
Want to implement importing (and preferably subscribing to) XFN friends lists on your site so you can list it here?

In addition to implementing hCard XFN supporting friends lists yourself (see above), do the following:

# '''Provide a user interface to "Import Friends"''' (like a button or menu item)
# '''When chosen, provide a text input field for the user to enter their profile URL''' (such as their blog or XFN friends list URL). If you already have the user's "Website", pre-fill the field with it, or if the user has many "Other Profiles", pre-fill the field with the first, and let the user pick any of them with a Select pop-up menu, or provide the user the option to just import XFN from all of them at once.
# '''Parse the [[XFN]] at the URL(s) given''' (links with rel="contact" or "acquaintance" or "friend" etc.) and check to see if there are any users on your site with any of those links as their rel="me" "Website" or among their rel="me" "Other Profiles" and add them to a list of people to invite. Crawl any symmetrical rel="me" links, especially symmetrical rel="me next" and/or rel="me prev" friends list pagination links for additional URLs to parse for XFN. Consider also parsing those URLs simultaneously for hCards that have those XFN links as class="url" hCard properties, and if the hCards have additional contact information such as instant messaging or email, add them to the list of people to invite.
# '''Present the list of people to invite''', perhaps sorted by "closeness" of XFN relationships (e.g. list family relationships before just romantic relationships before just friends before just professional relationships before just acquaintances before just contacts before just met etc.) with a "Add Friend" button next to each. When clicked, use [[XHR]] to add that person without altering the overall list, and change the Add button into a Cancel button. Perhaps put an "Add all" button at the top (or bottom) to let the user simply add everyone listed with one click.
# '''Consider also providing a checkbox "<nowiki>[x]</nowiki> Subscribe to XFN friends"''' which would automatically run this import perhaps once a day and notify the user of new contacts found that they may want to add, and similarly present an "Add all" button.

== Sites that should support hCard and XFN ==
See [[hcard-advocacy#hCard_XFN_friends_lists|hCard advocacy - hCard XFN friends lists]].

== For more information ==
In addition to the previous "Implement" sections, see the [[hcard-authoring|hCard authoring]] page for how to mark-up information about a person with hCard, and [http://gmpg.org/xfn/join XFN getting started] page for how to mark-up friend links with XFN.

Join the [http://microformats.org/discuss microformats community], in particular the #microformats IRC channel on irc://irc.freenode.net#microformats and the [http://microformats.org/mailman/listinfo/microformats-dev/ microformats-dev mailing list], and send a message stating that you'd like to add hCard to the profiles and hCard+XFN supporting friends lists (and importing thereof) to your website.

Please also consider implementing [[hcard-supporting-user-profiles|hCard supporting user profiles]].

See [[hcard-xfn-supporting-friends-lists-issues|hCard+XFN supporting friends lists issues]] for issues, problems with implementations.

== See also ==
* [[xfn|XFN]] ([http://gmpg.org/xfn/ spec], [[xfn-faq|FAQ]], [[xfn-implementations|implementations]] - there are a few more in there that need to be copied and expanded in this page.)
* [[hcard-supporting-user-profiles]]
* [[hcard|hCard]] ([[hcard-authoring|authoring]], [[hcard-faq|FAQ]])
* [[social-network-portability]]
* [[data-portability]]
* [[user-interface]]

events/2008-03-10-sxsw-building-blocks

2008-03-10T20:30:51Z

Steve Ganz: /* attendees */

<h1>SXSW Interactive 2008</h1>
{{TOC-right}}
An informal gathering of microformats contributors at SXSW Interactive, 2008.

== details ==
<div class="vevent">
;When
:<span class="dtstart"><span class="value">2008-03-10</span>, 6:05pm</span>
;Where
:<span class="location vcard">At the Lego Building Blocks pit, <span class="fn org">Austin Convention Center</span>, <span class="adr"><span class="street-name">4th and Trinity</span>, <span class="locality">Austin</span>, <span class="region">Texas</span> <span class="country-name">USA</span></span></span>
;What
:<span class="summary">SxSWi Microformats Building Blocks</span>
;Web
:<span class="url">http://2008.sxsw.com/</span>
</div>

== tags ==
Please use ''all'' of the following tags when tagging related content (blog posts, photos):

tags: '''sxsw sxsw08 sxsw2008 sxswi sxswi08 sxswi2008 microformats'''

== attendees ==
Add yourself alphabetically sorted by family name if you are attending (with dates attending in parentheses)

* [[User:Tantek|Tantek Çelik]]
* [[User:Phae|Frances Berriman]]
* [[User:Steve_Ganz|Steve Ganz]]
* [[User:BenWard|Ben Ward]]

== photographs ==
Please use ''all'' of the following tags when tagging related photos:

tags: '''sxsw sxsw08 sxsw2008 sxswi sxswi08 sxswi2008 microformats'''


* ...

== notes ==
Session comments and Q&A.
* ...

== articles and blog posts ==
Articles and blog posts following up on the meetup. Newest first.

Please use ''all'' of the following tags when tagging related blog posts:

tags: '''sxsw sxsw08 sxsw2008 sxswi sxswi08 sxswi2008 microformats'''

* ...



== related pages==
{{events-related-pages}}

events/2008-03-10-sxsw-building-blocks

2008-03-10T20:30:23Z

Steve Ganz:

<h1>SXSW Interactive 2008</h1>
{{TOC-right}}
An informal gathering of microformats contributors at SXSW Interactive, 2008.

== details ==
<div class="vevent">
;When
:<span class="dtstart"><span class="value">2008-03-10</span>, 6:05pm</span>
;Where
:<span class="location vcard">At the Lego Building Blocks pit, <span class="fn org">Austin Convention Center</span>, <span class="adr"><span class="street-name">4th and Trinity</span>, <span class="locality">Austin</span>, <span class="region">Texas</span> <span class="country-name">USA</span></span></span>
;What
:<span class="summary">SxSWi Microformats Building Blocks</span>
;Web
:<span class="url">http://2008.sxsw.com/</span>
</div>

== tags ==
Please use ''all'' of the following tags when tagging related content (blog posts, photos):

tags: '''sxsw sxsw08 sxsw2008 sxswi sxswi08 sxswi2008 microformats'''

== attendees ==
Add yourself alphabetically sorted by family name if you are attending (with dates attending in parentheses)

* [[User:Tantek|Tantek Çelik]]
* [[User:Phae|Frances Berriman]]
* [[User:BenWard|Ben Ward]]
* [[User:Steve_Ganz|Steve Ganz]]

== photographs ==
Please use ''all'' of the following tags when tagging related photos:

tags: '''sxsw sxsw08 sxsw2008 sxswi sxswi08 sxswi2008 microformats'''


* ...

== notes ==
Session comments and Q&A.
* ...

== articles and blog posts ==
Articles and blog posts following up on the meetup. Newest first.

Please use ''all'' of the following tags when tagging related blog posts:

tags: '''sxsw sxsw08 sxsw2008 sxswi sxswi08 sxswi2008 microformats'''

* ...



== related pages==
{{events-related-pages}}

User:Steve Ganz

2007-12-30T06:33:30Z

Steve Ganz:

[http://steve.ganz.name/ Steve Ganz]

{{cc-public-domain-release}}

User:Steve Ganz

2007-07-21T01:46:43Z

Steve Ganz:

[http://steve.ganz.name/ Steve Ganz]

{{public-domain-release}}

hresume

2007-07-10T18:40:18Z

Steve Ganz: Adding LinkedIn Public Profiles to Implementations

<h1> hResume </h1>

hResume is a microformat for publishing resumes and CVs. hResume is one of several open microformat standards suitable for embedding in (X)HTML, Atom, RSS, and arbitrary XML.

Want to get started with writing an hResume? Use the [http://hresume.weblogswork.com/hresumecreator/ hResume Creator] to create your hResume and publish it, or follow the hResume authoring tips to add hResume markup to your web page or blog.

<h2> Microformats Draft Specification </h2>

; Editor/Author: [http://theryanking.com Ryan King]
; Acknowledgments: See [http://microformats.org/wiki/hresume#Acknowledgements acknowledgments].

Microformats [http://microformats.org/wiki/hresume#Copyright copyright] and [http://microformats.org/wiki/hresume#Patents patents] statements apply.

__TOC__

== Status ==
Draft, version 0.1.

== Introduction ==
=== Semantic XHTML Design Principles ===
{{SemanticXHTMLDesignPrinciples}}

== Format ==
=== In General ===
The hResume format is based on a set of fields common to numerous resumes published today on the web. Where possible field names have been chosen and reused from preexisting microformats.

=== Schema ===
The hResume schema consists of the following:

* hResume
** summary. optional. text.
** contact info. required. '''Must''' use [[hcard|hCard]]. '''Should''' use <code class="element"><address></code> + [[hcard|hCard]].
** experience. optional. One or more [[hcalendar]] events with the class name '<code class="class-name">experience</code>', with an embedded [[hcard|hCard]] indicating the job title, name of company, address of company etc.
** education. optional One or more [[hcalendar]] events with the class name '<code class="class-name">education</code>', with an embedded [[hcard|hCard]] indicating the name of school, address of school etc.
** skills. optional. phrases or keywords using the [[rel-tag]] microformat with the class name '<code class="class-name">skill</code>'.
** affiliations. optional. the class name <code class="class-name">affiliation</code> along with an [[hcard]] of the organization
** publications. optional. One or more citations. Use cite tag.

=== Field details ===
The fields of the hResume schema represent the following:

* '''<code class="class-name">hresume</code>''':: root class name
* '''<code class="class-name">summary</code>''':: The class name <code class="class-name">summary</code> is used to mark up an overview of qualifications and objectives.
* '''contact''':: Current contact info in an [[hCard]]. '''Should''' use <code class="element"><address></code> with [[hCard]] when possible.
* '''<code class="class-name">education</code>''':: the class name '<code class="class-name">education</code>' is applied to an [[hcalendar]] event.
* '''<code class="class-name">experience</code>''':: the class name '<code class="class-name">experience</code>' is applied to an [[hcalendar]] event. Job titles/positions should use an [[hCard]].
* '''<code class="class-name">skill</code>''':: An hResume may be tagged using the [[rel-tag]] microformat and the '<code class="class-name">skill</code>' class name.
* '''<code class="class-name">affiliation</code>''':: The class name <code="class-name">affiliation</code> is used along with an [[hcard]] of the organization
* '''<code class="class-name">publications</code>''':: just use <code class="element"><cite></code>. When there is a [[citation]] microformat, then that can be used in combination with the cite element to further markup the components of the citation.

=== XMDP Profile ===
* [[hresume-profile]] (@TODO)

=== Notes ===
This section is informative.

*...

== Examples ==
=== Summary ===
An example summary:

<pre><nowiki>
<p class="summary">
I have 10 years experience with all Web 2.0 technologies– I've been working with Ajax since 1996,
designing with pastels while others will still using tiled background images and frames...
</p>
</nowiki></pre>

=== Contact ===
<pre><nowiki>
<address class="vcard">
<span class="fn">Pedro Sanchez</span>
<span class="adr">
<span class="street-address">123 Fake St.</span>
<span class="locality">Preston</span>, <span class="region">Idaho</span> <span class="postal-code">83263</span>
</span>
<span>Email: <a class="email" href="mailto:joe@example.com">pedro@vote-for-pedro.com</a></span>
<span>Homepage: <a class="url" href="http://vote-for-pedro.com/">vote-for-pedro.com</a></span>
<span>Phone: <span class="tel">+01.208.555.4567</span></span>
</address>
</nowiki></pre>

=== Education ===
<pre><nowiki>
<ol class="vcalendar">
<li class="education vevent">
<a class="url summary" href="http://example.edu/">Preston High School</a>
(<abbr class="dtstart" title="2001-01-24">2001</abbr> - <abbr class="dtend" title="2005-05-25">2005</abbr>)
</li>
...
</nowiki></pre>

=== Experience ===
==== Basic ====
A basic experience event:

<pre><nowiki>
<ol class="vcalendar">
<li class="experience vevent">
<span class="summary">President</span>,
<span class="location">Preston High School</span>,
<abbr class="dtstart" title="2004-09-01">May 2004</abbr> - <abbr title="2005-05-25">present</abbr>
</li>
...
</nowiki></pre>

==== Job Titles ====
To express one or more job titles/positions in the same experience event you should use [[hCard]]s. [[hcard]] requires the <code class="class-name">fn</code> ("formatted name") field, but it isn't reasonable to repeat your name for every job title you mark up in [[hResume|hresume]]. So, you may use an <code class="element"><object></code> and the class name '<code class="class-name">include</code>' with a reference to the <code class="class-name">fn</code> somewhere else on the page.

For example, this [[hCard]] refers to another [[hCard]]

<pre>
<span class="vcard">
<object data="#j" class="include"></object>
<span class="org">Preston High School</span>
<span class="title">Class President</span>
</span>
</pre>

Where "<code class="attr-value">j</code>" is the id attribute value of the "<code class="mf-prop">fn n</code>" element of the contact [[hCard]] at the top of the page, e.g. (shown here as a verbose [[hCard]] for purposes of illustration that the reference may be to a subtree, not just a text node):

<pre><nowiki>
<address class="vcard">
<span class="fn n" id="j">
<span class="given-name">Pedro</span>
<span class="family-name">Sanchez</span>
</span>
</address>
</nowiki></pre>

This method of hCard property indirection via an object element [[include-pattern|has been generalized]] to apply to any/all string/text properties in hCard.
Note: the object data attribute MUST be a local ID reference. External references (which would require a consuming application to load an external resource) are currently not supported by this method.

=== Skills ===
Some sample skills tags:
<pre><nowiki>
I have skills in <a class="skill" rel="tag" href="http://en.wikipedia.org/wiki/Bow_%28weapon%29">bow hunting</a>
and <a class="skill" rel="tag" href="http://en.wikipedia.org/wiki/Nunchucks">nunchucks</a>.
</nowiki></pre>

=== Affiliations ===
<pre><nowiki>
<span class="affiliation vcard"><span class="fn org">National Honor Society</span></span>
</nowiki></pre>

=== Publications ===
<pre><nowiki>
<cite>Breeding Ligers for Fun and Magic</cite>, Idaho Press, 2004.
</nowiki></pre>

== Examples in the wild ==
See [[hresume-examples-in-wild]]

== Implementations ==
This section is '''informative'''.

The following implementations have been developed which either generate or parse hResumes. If you have an hResume implementation, feel free to add it to the top of this list. Once the list grows too big, we'll make a separate wiki page.

* [http://linkedin.com LinkedIn] generates hResume for all Public Profiles. [http://www.linkedin.com/in/steveganz LinkedIn Public Profile Example].

* [http://www.antix.co.uk Anthony Johnston] has implemented hResume (Creation and Import) in the [http://cv.antix.co.uk Antix CV Builder], an example resume using this site can be found [http://cv.antix.co.uk/ant here]
** The example resume is ''invalid''; job titles are marked with an hCard that is missing a "fn" (either directly or via object). --[[User:Gazza|Gazza]] 04:23, 1 May 2007 (PDT)

* The [http://spurinc.com Spur] team has created an hResume WordPress plugin located at [http://hresume.weblogswork.com/?page_id=3 hResume Plugin]. See an example of the hResume markup [http://hresume.weblogswork.com/?page_id=6 here]. Neat feature of the hResume plugin is that it automatically creates a new page for the resume - no cutting and pasting...

* The [http://www.ssdesigninteractive.com/ssdesign Sajid Saiyed] has created an hResume WordPress plugin located at [http://www.ssdesigninteractive.com/ssdesign/?p=96 Microformat Resume Plugin]. See an example of the hResume markup [http://www.ssdesigninteractive.com/ssdesign/?page_id=95 here].

* Spur also created a standalone hResume Creator located at [http://hresume.weblogswork.com/hresumecreator/ hResume Creator]. The creator will generate hResume markup ready to cut and paste into your webpage.

== Copyright ==
{{MicroFormatCopyrightStatement2006}}

== Patents ==
{{MicroFormatPatentStatement}}

== References ==
=== Normative References ===
* [[hcard|hCard]]
* [[hcalendar|hCalendar]]
* [[include-pattern|include pattern]]
* [http://www.w3.org/TR/REC-html40/ HTML 4]
* [http://www.w3.org/TR/xhtml1/ XHTML]
* [http://gmpg.org/xmdp/ XMDP]
* [[rel-tag| Rel-Tag]]
* @TODO

=== Informative References ===
@TODO

== Acknowledgements ==
=== Concept ===
* [http://theryanking.com/ Ryan King], [http://technorati.com Technorati]
* [http://tantek.com/ Tantek Çelik], [http://technorati.com Technorati]
* James Levine [http://simplyhired.com Simply Hired]
* [http://epeus.blogspot.com/ Kevin Marks], [http://technorati.com Technorati]

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

== Further Reading ==
* See also [http://www.technorati.com/cosmos/referer.html blogs discussing this page].

hresume-issues

2007-06-22T06:00:29Z

Steve Ganz: /* Issues */

<h1> hResume issues </h1>

These are externally raised issues about [[hresume|hResume]] with broadly varying degrees of merit. Thus some issues are REJECTED for a number of obvious reasons (but still documented here in case they are re-raised), and others contain longer discussions. Some issues may be ACCEPTED and perhaps cause changes or improved explanations in the spec. Submitted issues may (and probably will) be edited and rewritten for better terseness, clarity, calmness, rationality, and as neutral a point of view as possible. Write your issues well. — [http://tantek.com/log/ Tantek]

See related [[hcalendar-issues]].
See related [[hcard-issues]].

__TOC__

== Issues ==

* {{OpenIssue}} 2007-06-21 raised by [[User:Steve_Ganz|Steve Ganz]].
*# ''rel-tag can be difficult to implement for "skill" ''
*#* In Draft, version 0.1 it is required that each "skill" be marked up with rel-tag. While this is a good idea, and easy to do for individuals, it poses some challenges in the real world for large publishers of user generated resume data. If rel-tag was optional for "skills", it would be easier to implement.

* {{OpenIssue}} 2007-01-04 raised by [[User:NTollervey|ntoll]].
*# ''With regard to the "skill" attributes in a resume: often skills have an indication of the level of attainment - be it as a descriptive "tag" or a duration denoting the length of experience of the referenced skill. In fact, abstracting out a "skill" microformat might be useful for re-use in the job-listing (Vacancy?) microformat. That way, job requirements can be married to CVs. Although not a job-site, I like Sourceforge.net's skill inventory feature (that captures both a level and length of experience) although I think its implementation is horrendous.''

* {{OpenIssue}} 2006-10-19 raised by [[RyanKing]].
*# ''There's currently no way to say 'present' in hCalendar''
*#* Many job experience listings will include jobs that the person is presently working at. Ciaran McNulty [http://microformats.org/discuss/mail/microformats-discuss/2006-October/006477.html correctly pointed out] that a blank DTEND does not indicate that the event is still ongoing. We need to find an easy way to make this work in hResume.

* {{OpenIssue}} 2006-10-19 raised by [[User:Steve_Ganz|Steve Ganz]].
*# ''There's currently no way to distinguish different hCard types in hResume''
*#* In Draft, version 0.1 it is specified that a parent element of <code>address</code> should be used to the distinguish an hCard as the subject's contact info. This proves problematic to implement because <code>address</code> cannot contain block level elements. To avoid sacrificing semantic value by restricting the child elements of an hCard to inline elements, we need to settle on an alternate method to classify a subject's hCard as thier contact info.
*#* In any given experience there may be one or more hCards. One which would be the subject's hCard for that experience and the other for a supervisor or manager, etc. We need a way to distinguish different hCards in a given experience.
:::* Agreed, when adding my references in hCard to the bottom of my hResume it became apparent there was no way I could mark 'my' hCard as the one belonging to the subject of the hResume. Perhaps @class="hcard subject" as a child of the hResume? [[User:CiaranMc|Ciaran McNulty]]

== Template ==

Please use this format (copy and paste this to the end of the list to add your issues):
* {{OpenIssue}} YYYY-MM-DD raised by [http://yourhomepage.example.com YOURNAME].
*# ''Issue 1: Here is the first issue I have.''
*# ''Issue 2: Here is the second issue I have.''

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

hresume-issues

2007-06-21T23:38:29Z

Steve Ganz: /* Issues */ Adding rel-tag on 'skills' issue

<h1> hResume issues </h1>

These are externally raised issues about [[hresume|hResume]] with broadly varying degrees of merit. Thus some issues are REJECTED for a number of obvious reasons (but still documented here in case they are re-raised), and others contain longer discussions. Some issues may be ACCEPTED and perhaps cause changes or improved explanations in the spec. Submitted issues may (and probably will) be edited and rewritten for better terseness, clarity, calmness, rationality, and as neutral a point of view as possible. Write your issues well. — [http://tantek.com/log/ Tantek]

See related [[hcalendar-issues]].
See related [[hcard-issues]].

__TOC__

== Issues ==

* {{OpenIssue}} 2007-06-21 raised by [[Steve Ganz]].
*# ''rel-tag can be difficult to implement for "skill" ''
*#* In Draft, version 0.1 it is required that each "skill" be marked up with rel-tag. While this is a good idea, and easy to do for individuals, it poses some challenges in the real world for large publishers of user generated resume data. If rel-tag was optional for "skills", it would be easier to implement.

* {{OpenIssue}} 2007-01-04 raised by [[User:NTollervey|ntoll]].
*# ''With regard to the "skill" attributes in a resume: often skills have an indication of the level of attainment - be it as a descriptive "tag" or a duration denoting the length of experience of the referenced skill. In fact, abstracting out a "skill" microformat might be useful for re-use in the job-listing (Vacancy?) microformat. That way, job requirements can be married to CVs. Although not a job-site, I like Sourceforge.net's skill inventory feature (that captures both a level and length of experience) although I think its implementation is horrendous.''

* {{OpenIssue}} 2006-10-19 raised by [[RyanKing]].
*# ''There's currently no way to say 'present' in hCalendar''
*#* Many job experience listings will include jobs that the person is presently working at. Ciaran McNulty [http://microformats.org/discuss/mail/microformats-discuss/2006-October/006477.html correctly pointed out] that a blank DTEND does not indicate that the event is still ongoing. We need to find an easy way to make this work in hResume.

* {{OpenIssue}} 2006-10-19 raised by [[Steve Ganz]].
*# ''There's currently no way to distinguish different hCard types in hResume''
*#* In Draft, version 0.1 it is specified that a parent element of <code>address</code> should be used to the distinguish an hCard as the subject's contact info. This proves problematic to implement because <code>address</code> cannot contain block level elements. To avoid sacrificing semantic value by restricting the child elements of an hCard to inline elements, we need to settle on an alternate method to classify a subject's hCard as thier contact info.
*#* In any given experience there may be one or more hCards. One which would be the subject's hCard for that experience and the other for a supervisor or manager, etc. We need a way to distinguish different hCards in a given experience.
:::* Agreed, when adding my references in hCard to the bottom of my hResume it became apparent there was no way I could mark 'my' hCard as the one belonging to the subject of the hResume. Perhaps @class="hcard subject" as a child of the hResume? [[User:CiaranMc|Ciaran McNulty]]

== Template ==

Please use this format (copy and paste this to the end of the list to add your issues):
* {{OpenIssue}} YYYY-MM-DD raised by [http://yourhomepage.example.com YOURNAME].
*# ''Issue 1: Here is the first issue I have.''
*# ''Issue 2: Here is the second issue I have.''

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

events/2007-03-12-sxsw-growth-evolution-of

2007-03-28T13:38:16Z

Steve Ganz: /* Attending */

<h1>The Growth and Evolution of Microformats at SXSW 2007</h1>

One of several microformats [[events]].

__TOC__

== Summary ==
The Growth and Evolution of Microformats is a [http://2007.sxsw.com/interactive/programming/panels/ confirmed panel presentation] session to be held at the 2007 [http://2007.sxsw.com/ SXSW] Interactive Festival, on Monday, March 12th from 2:00-3:00pm in Austin, Texas.

== Tags ==
Please use ''all'' of the following tags when tagging content (blog posts, photos) published related to the microformats session at SXSW interactive 2007:

tags: '''microformats sxsw sxsw07 sxsw2007 sxswi sxswi07 sxswi2007 microformats-sxsw microformats-sxsw2007 microformats-sxswi microformats-sxswi2007'''

== Panelists ==
In order of appearance:
*[[User:Tantek|Tantek Çelik]] (moderator)
*[[User:MikeKaply|Michael Kaply]]
*[http://www.glennjones.net/ Glenn Jones]
*[[User:Phae|Frances Berriman]]
*[[User:Adactio|Jeremy Keith]] (surprise guest panelist)

== Short Session Description ==
Was required to be 25 words or less:

Microformats.org has ushered in the rapid adoption of key formats for publishing and sharing [[rel-tag|tags]], [[rel-license|licenses]], [[hcard|contacts]], [[xfn|relationships]], [[hcalendar|events]] and [[hreview|reviews]]. What happens next?

== Longer Session Description ==
In its first year, microformats.org ushered in the rapid adoption of key formats for publishing and sharing [[rel-tag|tags]], [[rel-license|licenses]], [[hcard|contacts]], [[xfn|relationships]], [[hcalendar|events]] and [[hreview|reviews]] on the Web. See what new microformats are being developed for [[hresume|resumes]], [[hlisting|classified listings]], [[media-info|music, and media]], as well as how tens of millions of established microformats on web sites of individuals, companies, and organizations are driving innovations in desktop applications and advancing personal data portability.

== Attending ==
Please add your name here if you are attending this session, speaking or not.

*[[User:Tantek|Tantek Çelik]] (moderator)
*[[User:MikeKaply|Michael Kaply]]
*[http://www.glennjones.net/ Glenn Jones]
*[[User:Phae|Frances Berriman]]
*[[User:Adactio|Jeremy Keith]] (surprise guest panelist)
*[[User:Veeliam|William Lawrence]]
*[[User:RyanKing|Ryan King]]
*[[User:Cgriego|Chris Griego]]
*[[User:Mike Linksvayer|Mike Linksvayer]]
*[[User:DanC|Dan Connolly]] (attempted to volunteer for Jeremy Keith's phone demo, but was disqualified due to being a known member of the microformats community and with W3C :)
*[[User:AdamDarowski|Adam Darowski]]
*[[User:SuperPhly|Cody Marx Bailey]] - Dumbass who volunteered for Jeremy's phone demo with a development site then go "deer in the headlights" and couldn't remember sibility.com... yeah!
*[[User:Steve Ganz|Steve Ganz]]

=== Photo of Attendees ===
And create a note around yourself in these photos:
<div>
[http://flickr.com/photos/tantek/436784378/ http://farm1.static.flickr.com/160/436784378_80ec442446.jpg][http://flickr.com/photos/tantek/436784366/ http://farm1.static.flickr.com/161/436784366_bcf03265b0.jpg]
</div>

== Session Notes ==
Tantek did a brief and incomplete history of microformats through t-shirts, for the following:

* http://sxsw.com/ (2003)
* http://gmpg.org/xfn/
* http://blo.gs/
* http://wordpress.org/
* http://eventful.com/
* http://simplebits.com/
* http://microformats.org/
* http://flickr.com/
* http://technorati.com/
* http://odeo.com/
* http://supernova2006.com/
* http://stanford.edu

Mike Kaply

Glenn Jones

Frances Berriman

Q&A (see below)

== Session Comments and Q&A ==
* ...

== Photos ==
[http://www.flickr.com/photos/meyerweb/419771185/ http://farm1.static.flickr.com/132/419771185_da0b2be939_m_d.jpg] [http://www.flickr.com/photos/rcrowley/423201101/ http://farm1.static.flickr.com/165/423201101_931e1d09e5_m_d.jpg]
[http://www.flickr.com/photos/thechunk/420604647/ http://farm1.static.flickr.com/179/420604647_10441d1ffe_m_d.jpg] [http://www.flickr.com/photos/thechunk/420604224/ http://farm1.static.flickr.com/162/420604224_df888058c1_m_d.jpg]
[http://www.flickr.com/photos/ptg/420129138/ http://farm1.static.flickr.com/159/420129138_24fc218517_m.jpg]
[http://www.flickr.com/photos/mn_francis/425446977/ http://farm1.static.flickr.com/155/425446977_50dc90856e_m.jpg]

== Blog Posts ==
Put most recent first.
* [http://techory.com/sxsw/?p=35 SXSW Notes - Notes from SXSW Interactive in Austin, TX - The Growth and Evolution of Microformats] - good capture of the Q&A
** Lazyweb - please transcribe / cleanup Q&A documented in this blogpost to the Q&A section above.
* [http://johnzeratsky.com/archives/001521.php JUST THIS ONE - Microformats]
* [http://blog.wired.com/music/2007/03/microformats_go.html WIRED Blog - Microformats Go Large]
* [http://www.centernetworks.com/sxsw-monday-recap-techquila-microformats-bats-and-the-expo-hall SXSW Monday Recap - Techquila, Microformats, Dogster, Bats and the Expo Hall]
* [http://www.commonplacebook.com/journal/200pm_the_growt.shtm 2:00pm - The Growth and Evolution of Microformats Panel Notes (SXSWi 2007)]
* [http://www.darowski.com/tracesofinspiration/2007/03/12/sxswi-the-growth-and-evolution-of-microformats/ Adam Darowski "SXSWi: The Growth and Evolution of Microformats"] I didn't take the most detailed notes, but this session certainly inspired a few questions. Great job, guys.
* [http://muffinresearch.co.uk/archives/2007/03/12/sxswi-07-notes-the-growth-and-evolution-of-microformats/ SXSWi 07 Notes: The Growth and Evolution of Microformats] - fairly thorough notes
** Lazyweb - please transcribe / cleanup Q&A documented in this blogpost to the Q&A section above.

== Podcasts ==
* [http://www.podtech.net/home/technology/2477/microformats-guru-tantek-celik "Microformats Guru Tantek Celik"] PodTech.net interview just after the session.

events/2007-03-12-sxsw-growth-evolution-of

2007-03-28T13:36:01Z

Steve Ganz: /* Attending */

<h1>The Growth and Evolution of Microformats at SXSW 2007</h1>

One of several microformats [[events]].

__TOC__

== Summary ==
The Growth and Evolution of Microformats is a [http://2007.sxsw.com/interactive/programming/panels/ confirmed panel presentation] session to be held at the 2007 [http://2007.sxsw.com/ SXSW] Interactive Festival, on Monday, March 12th from 2:00-3:00pm in Austin, Texas.

== Tags ==
Please use ''all'' of the following tags when tagging content (blog posts, photos) published related to the microformats session at SXSW interactive 2007:

tags: '''microformats sxsw sxsw07 sxsw2007 sxswi sxswi07 sxswi2007 microformats-sxsw microformats-sxsw2007 microformats-sxswi microformats-sxswi2007'''

== Panelists ==
In order of appearance:
*[[User:Tantek|Tantek Çelik]] (moderator)
*[[User:MikeKaply|Michael Kaply]]
*[http://www.glennjones.net/ Glenn Jones]
*[[User:Phae|Frances Berriman]]
*[[User:Adactio|Jeremy Keith]] (surprise guest panelist)

== Short Session Description ==
Was required to be 25 words or less:

Microformats.org has ushered in the rapid adoption of key formats for publishing and sharing [[rel-tag|tags]], [[rel-license|licenses]], [[hcard|contacts]], [[xfn|relationships]], [[hcalendar|events]] and [[hreview|reviews]]. What happens next?

== Longer Session Description ==
In its first year, microformats.org ushered in the rapid adoption of key formats for publishing and sharing [[rel-tag|tags]], [[rel-license|licenses]], [[hcard|contacts]], [[xfn|relationships]], [[hcalendar|events]] and [[hreview|reviews]] on the Web. See what new microformats are being developed for [[hresume|resumes]], [[hlisting|classified listings]], [[media-info|music, and media]], as well as how tens of millions of established microformats on web sites of individuals, companies, and organizations are driving innovations in desktop applications and advancing personal data portability.

== Attending ==
Please add your name here if you are attending this session, speaking or not.

*[[User:Tantek|Tantek Çelik]] (moderator)
*[[User:MikeKaply|Michael Kaply]]
*[http://www.glennjones.net/ Glenn Jones]
*[[User:Phae|Frances Berriman]]
*[[User:Adactio|Jeremy Keith]] (surprise guest panelist)
*[[User:Veeliam|William Lawrence]]
*[[User:RyanKing|Ryan King]]
*[[User:Cgriego|Chris Griego]]
*[[User:Mike Linksvayer|Mike Linksvayer]]
*[[User:DanC|Dan Connolly]] (attempted to volunteer for Jeremy Keith's phone demo, but was disqualified due to being a known member of the microformats community and with W3C :)
*[[User:AdamDarowski|Adam Darowski]]
*[[User:SuperPhly|Cody Marx Bailey]] - Dumbass who volunteered for Jeremy's phone demo with a development site then go "deer in the headlights" and couldn't remember sibility.com... yeah!
*[[User:SteveGanz|Steve Ganz]]

=== Photo of Attendees ===
And create a note around yourself in these photos:
<div>
[http://flickr.com/photos/tantek/436784378/ http://farm1.static.flickr.com/160/436784378_80ec442446.jpg][http://flickr.com/photos/tantek/436784366/ http://farm1.static.flickr.com/161/436784366_bcf03265b0.jpg]
</div>

== Session Notes ==
Tantek did a brief and incomplete history of microformats through t-shirts, for the following:

* http://sxsw.com/ (2003)
* http://gmpg.org/xfn/
* http://blo.gs/
* http://wordpress.org/
* http://eventful.com/
* http://simplebits.com/
* http://microformats.org/
* http://flickr.com/
* http://technorati.com/
* http://odeo.com/
* http://supernova2006.com/
* http://stanford.edu

Mike Kaply

Glenn Jones

Frances Berriman

Q&A (see below)

== Session Comments and Q&A ==
* ...

== Photos ==
[http://www.flickr.com/photos/meyerweb/419771185/ http://farm1.static.flickr.com/132/419771185_da0b2be939_m_d.jpg] [http://www.flickr.com/photos/rcrowley/423201101/ http://farm1.static.flickr.com/165/423201101_931e1d09e5_m_d.jpg]
[http://www.flickr.com/photos/thechunk/420604647/ http://farm1.static.flickr.com/179/420604647_10441d1ffe_m_d.jpg] [http://www.flickr.com/photos/thechunk/420604224/ http://farm1.static.flickr.com/162/420604224_df888058c1_m_d.jpg]
[http://www.flickr.com/photos/ptg/420129138/ http://farm1.static.flickr.com/159/420129138_24fc218517_m.jpg]
[http://www.flickr.com/photos/mn_francis/425446977/ http://farm1.static.flickr.com/155/425446977_50dc90856e_m.jpg]

== Blog Posts ==
Put most recent first.
* [http://techory.com/sxsw/?p=35 SXSW Notes - Notes from SXSW Interactive in Austin, TX - The Growth and Evolution of Microformats] - good capture of the Q&A
** Lazyweb - please transcribe / cleanup Q&A documented in this blogpost to the Q&A section above.
* [http://johnzeratsky.com/archives/001521.php JUST THIS ONE - Microformats]
* [http://blog.wired.com/music/2007/03/microformats_go.html WIRED Blog - Microformats Go Large]
* [http://www.centernetworks.com/sxsw-monday-recap-techquila-microformats-bats-and-the-expo-hall SXSW Monday Recap - Techquila, Microformats, Dogster, Bats and the Expo Hall]
* [http://www.commonplacebook.com/journal/200pm_the_growt.shtm 2:00pm - The Growth and Evolution of Microformats Panel Notes (SXSWi 2007)]
* [http://www.darowski.com/tracesofinspiration/2007/03/12/sxswi-the-growth-and-evolution-of-microformats/ Adam Darowski "SXSWi: The Growth and Evolution of Microformats"] I didn't take the most detailed notes, but this session certainly inspired a few questions. Great job, guys.
* [http://muffinresearch.co.uk/archives/2007/03/12/sxswi-07-notes-the-growth-and-evolution-of-microformats/ SXSWi 07 Notes: The Growth and Evolution of Microformats] - fairly thorough notes
** Lazyweb - please transcribe / cleanup Q&A documented in this blogpost to the Q&A section above.

== Podcasts ==
* [http://www.podtech.net/home/technology/2477/microformats-guru-tantek-celik "Microformats Guru Tantek Celik"] PodTech.net interview just after the session.

mailing-list-unmoderation

2007-03-19T15:52:08Z

Steve Ganz:

Andy Mabbett was moderated (rather than banned for a week) in early 2007 on the microformats mailing lists at the time for both his frequent off-topic posts, and his ignoring of several warnings from admins to please stop doing so. Ernie P. (a longstanding overwhelmingly positive contributor to the community) has proposed unmoderating Andy at this point.
* +1 Ernie P.
* +1 David Janes
* +1 Nic James Ferrier
* +1 Tantek
* +1 Scott Reynen
* +1 Steve Ganz
* ... add your opinion (+1 unmoderate, 0 no opinion, -1 keep moderated) and your name

hresume

2007-01-30T03:05:51Z

Steve Ganz: /* Examples in the wild */

<h1> hResume </h1>

hResume is a microformat for publishing resumes and CVs. hResume is one of several open microformat standards suitable for embedding in (X)HTML, Atom, RSS, and arbitrary XML.

Want to get started with writing an hResume? Use the [http://hresume.weblogswork.com/hresumecreator/ hResume Creator] to create your hResume and publish it, or follow the hResume authoring tips to add hResume markup to your web page or blog.

<h2> Microformats Draft Specification </h2>

; Editor/Author: [http://theryanking.com Ryan King]
; Acknowledgments: See [http://microformats.org/wiki/hresume#Acknowledgements acknowledgments].

Microformats [http://microformats.org/wiki/hresume#Copyright copyright] and [http://microformats.org/wiki/hresume#Patents patents] statements apply.

__TOC__

== Status ==
Draft, version 0.1.

== Introduction ==
=== Semantic XHTML Design Principles ===
{{SemanticXHTMLDesignPrinciples}}

== Format ==
=== In General ===
The hResume format is based on a set of fields common to numerous resumes published today on the web. Where possible field names have been chosen and reused from preexisting microformats.

=== Schema ===
The hResume schema consists of the following:

* hResume
** summary. optional. text.
** contact info. required. '''Must''' use [[hcard|hCard]]. '''Should''' use <code class="element"><address></code> + [[hcard|hCard]].
** experience. optional. One or more [[hcalendar]] events with the class name '<code class="class-name">experience</code>', with an embedded [[hcard|hCard]] indicating the job title, name of company, address of company etc.
** education. optional One or more [[hcalendar]] events with the class name '<code class="class-name">education</code>', with an embedded [[hcard|hCard]] indicating the name of school, address of school etc.
** skills. optional. phrases or keywords using the [[rel-tag]] microformat with the class name '<code class="class-name">skill</code>'.
** affiliations. optional. the class name <code class="class-name">affiliation</code> along with an [[hcard]] of the organization
** publications. optional. One or more citations. Use cite tag.

=== Field details ===
The fields of the hResume schema represent the following:

* '''<code class="class-name">hresume</code>''':: root class name
* '''<code class="class-name">summary</code>''':: The class name <code class="class-name">summary</code> is used to mark up an overview of qualifications and objectives.
* '''contact''':: Current contact info in an [[hCard]]. '''Should''' use <code class="element"><address></code> with [[hCard]] when possible.
* '''<code class="class-name">education</code>''':: the class name '<code class="class-name">education</code>' is applied to an [[hcalendar]] event.
* '''<code class="class-name">experience</code>''':: the class name '<code class="class-name">experience</code>' is applied to an [[hcalendar]] event. Job titles/positions should use an [[hCard]].
* '''<code class="class-name">skill</code>''':: An hResume may be tagged using the [[rel-tag]] microformat and the '<code class="class-name">skill</code>' class name.
* '''<code class="class-name">affiliation</code>''':: The class name <code="class-name">affiliation</code> is used along with an [[hcard]] of the organization
* '''<code class="class-name">publications</code>''':: just use <code class="element"><cite></code>. When there is a [[citation]] microformat, then that can be used in combination with the cite element to further markup the components of the citation.

=== XMDP Profile ===
* [[hresume-profile]] (@TODO)

=== Notes ===
This section is informative.

*...

== Examples ==
=== Summary ===
An example summary:

<pre><nowiki>
<p class="summary">
I have 10 years experience with all Web 2.0 technologies– I've been working with Ajax since 1996,
designing with pastels while others will still using tiled background images and frames...
</p>
</nowiki></pre>

=== Contact ===
<pre><nowiki>
<address class="vcard">
<span class="fn">Pedro Sanchez</span>
<span class="adr">
<span class="street-address">123 Fake St.</span>
<span class="locality">Preston</span>, <span class="region">Idaho</span> <span class="postal-code">83263</span>
</span>
<span>Email: <a class="email" href="mailto:joe@example.com">pedro@vote-for-pedro.com</a></span>
<span>Homepage: <a class="url" href="http://vote-for-pedro.com/">vote-for-pedro.com</a></span>
<span>Phone: <span class="tel">+01.208.555.4567</span></span>
</address>
</nowiki></pre>

=== Education ===
<pre><nowiki>
<ol class="vcalendar">
<li class="education vevent">
<a class="url summary" href="http://example.edu/">Preston High School</a>
(<abbr class="dtstart" title="2001-01-24">2001</abbr> - <abbr class="dtend" title="2005-05-25">2005</abbr>)
</li>
...
</nowiki></pre>

=== Experience ===
==== Basic ====
A basic experience event:

<pre><nowiki>
<ol class="vcalendar">
<li class="experience vevent">
<span class="summary">President</span>,
<span class="location">Preston High School</span>,
<abbr class="dtstart" title="2004-09-01">May 2004</abbr> - <abbr title="2005-05-25">present</abbr>
</li>
...
</nowiki></pre>

==== Job Titles ====
To express one or more job titles/positions in the same experience event you should use [[hCard]]s. [[hcard]] requires the <code class="class-name">fn</code> ("formatted name") field, but it isn't reasonable to repeat your name for every job title you mark up in [[hResume|hresume]]. So, you may use an <code class="element"><object></code> and the class name '<code class="class-name">include</code>' with a reference to the <code class="class-name">fn</code> somewhere else on the page.

For example, this [[hCard]] refers to another [[hCard]]

<pre>
<span class="vcard">
<object data="#j" class="include"></object>
<span class="org">Preston High School</span>
<span class="title">Class President</span>
</span>
</pre>

Where "<code class="attr-value">j</code>" is the id attribute value of the "<code class="mf-prop">fn n</code>" element of the contact [[hCard]] at the top of the page, e.g. (shown here as a verbose [[hCard]] for purposes of illustration that the reference may be to a subtree, not just a text node):

<pre><nowiki>
<address class="vcard">
<span class="fn n" id="j">
<span class="given-name">Pedro</span>
<span class="family-name">Sanchez</span>
</span>
</address>
</nowiki></pre>

This method of hCard property indirection via an object element [[include-pattern|has been generalized]] to apply to any/all string/text properties in hCard.
Note: the object data attribute MUST be a local ID reference. External references (which would require a consuming application to load an external resource) are currently not supported by this method.

=== Skills ===
Some sample skills tags:
<pre><nowiki>
I have skills in <a class="skill" rel="tag" href="http://en.wikipedia.org/wiki/Bow_%28weapon%29">bow hunting</a>
and <a class="skill" rel="tag" href="http://en.wikipedia.org/wiki/Nunchucks">nunchucks</a>.
</nowiki></pre>

=== Affiliations ===
<pre><nowiki>
<span class="affiliation vcard"><span class="fn org">National Honor Society</span></span>
</nowiki></pre>

=== Publications ===
<pre><nowiki>
<cite>Breeding Ligers for Fun and Magic</cite>, Idaho Press, 2004.
</nowiki></pre>

== Examples in the wild ==
This section is '''informative'''.

The following sites have published hResumes, and thus are a great place to start for anyone looking for examples "in the wild" to try parsing, indexing, organizing etc. If you have an hResume on your own page, feel free to add it to the '''top''' of this list. Once the list grows too big, we'll make a separate wiki page.

* [http://linkedin.com/ LinkedIn] has ~9 million Public Profiles marked up in hResume, e.g. [http://www.linkedin.com/in/steveganz Steve Ganz's Public Profile].
* [http://steinhardt.nyu.edu/ NYU Steinhardt] has [http://steinhardt.nyu.edu/faculty_bios/list/Faculty 240+ faculty bios marked up], e.g. [http://steinhardt.nyu.edu/faculty_bios/view/Susan_Murray]. ([[User:WizardIsHungry|Jon Williams]])
* [[User:ClintAndrewHall|Clint Hall]] has marked up his [http://www.clintandrewhall.com/resume.html resume] as an hResume.
* [[User:Csarven|Sarven Capadisli]] has marked up his [http://www.csarven.ca/cv Curriculum Vitae] as an hResume.
* [[User:Jax|Xavier Roy]] has marked his [http://xavierroy.com/resume/ resume] with hResume
* [[User:SanchTheFat|Robert O'Rourke]] has marked up his [http://robert.o-rourke.org/ CV] with hResume.
* [[User:Keri Henare|Keri Henare]] has marked up [http://www.kerihenare.com/cv/ his Curriculum Vitae] using hResume.
* [[User:Kwilson|Kenn Wilson]] has marked up [http://www.3color.org/~kwilson/resume/kenneth-wilson.html his resume] using hResume, following [[User:Ralph Brandi|Ralph Brandi]]'s method of using object.include.
* [[User:Ralph Brandi|Ralph Brandi]] has [http://www.brandi.org/ralph/resume/ marked up his resume] with hResume, additionally using the object.include method to associate one description with three hCalendar experiences.
* [[User:Pat Ramsey|Pat Ramsey]] has his [http://www.southwestern.edu/~ramseyp/ramsey_resume2006.html resume] marked up as an hResume.
* [[User:Wim Le Page|Wim Le Page]] has also marked up [http://adrem.ua.ac.be/~wlepage/curriculum-vitae/ his curriculum vitae] as an hResume.
* [[user:Jonathan Arkell|Jonathan Arkell]] has posted an [http://portfolio.jonnay.net/cv/ hResume] on his portfolio website.
* [http://steve.ganz.name/hresume/ Steve Ganz - hResume 0.1]
* [[User:Dave Cardwell|Dave Cardwell]] has marked up [http://davecardwell.co.uk/cv/ his curriculum vitae] as an hResume.
* [[User:EdwardOConnor|Edward O'Connor]]'s [http://edward.oconnor.cx/resume/ resume] is in hResume, and has some experimental JavaScript in it to extract a skill summary from the resume.
* [[User:Lindsey Simon|Lindsey Simon]] has his [http://www.commoner.com/~lsimon/lindsey_simon_resume.html resume] marked up as an hResume - with lots of thanks to Pat Ramsey.
* [[User:Ben Ward|Ben Ward]] has published [http://ben-ward.co.uk/cv his CV] with hResume.
* [http://www.kelleychambers.com Kelley Chambers] has published her [http://www.kelleychambers.com/resume resume] via [http://www.ssdesigninteractive.com/ssdesign/?p=96 Sajid Saiyed's Microformat hResume Plugin for Wordpress].
* [[User:Fishy5|Brennan Falkner]] used hResume to markup his [http://my.usf.edu/bbcswebdav/users/bfalker/resume.html resume].
* [http://www.zachary.com/creemer/resume.html David Creemer's resume] uses hResume, with thanks to Pat Ramsey for the CSS.

=== Examples with problems ===
* [[user:Izo|Mathieu Drouet]] has posted an [http://izo.aucuneid.com/hresume.html hResume].
** ''Incorrect root class name hResume? -- [[DavidJanes]]''

== Implementations ==
This section is '''informative'''.

The following implementations have been developed which either generate or parse hResumes. If you have an hResume implementation, feel free to add it to the top of this list. Once the list grows too big, we'll make a separate wiki page.

* The [http://spurinc.com Spur] team has created an hResume WordPress plugin located at [http://hresume.weblogswork.com/?page_id=3 hResume Plugin]. See an example of the hResume markup [http://hresume.weblogswork.com/?page_id=6 here]. Neat feature of the hResume plugin is that it automatically creates a new page for the resume - no cutting and pasting...

* The [http://www.ssdesigninteractive.com/ssdesign Sajid Saiyed] has created an hResume WordPress plugin located at [http://www.ssdesigninteractive.com/ssdesign/?p=96 Microformat Resume Plugin]. See an example of the hResume markup [http://www.ssdesigninteractive.com/ssdesign/?page_id=95 here].

* Spur also created a standalone hResume Creator located at [http://hresume.weblogswork.com/hresumecreator/ hResume Creator]. The creator will generate hResume markup ready to cut and paste into your webpage.

== Copyright ==
{{MicroFormatCopyrightStatement2006}}

== Patents ==
{{MicroFormatPatentStatement}}

== References ==
=== Normative References ===
* [[hcard|hCard]]
* [[hcalendar|hCalendar]]
* [[include-pattern|include pattern]]
* [http://www.w3.org/TR/REC-html40/ HTML 4]
* [http://www.w3.org/TR/xhtml1/ XHTML]
* [http://gmpg.org/xmdp/ XMDP]
* [[rel-tag| Rel-Tag]]
* @TODO

=== Informative References ===
@TODO

== Acknowledgements ==
=== Concept ===
* [http://theryanking.com/ Ryan King], [http://technorati.com Technorati]
* [http://tantek.com/ Tantek Çelik], [http://technorati.com Technorati]
* James Levine [http://simplyhired.com Simply Hired]
* [http://epeus.blogspot.com/ Kevin Marks], [http://technorati.com Technorati]

== Related Pages ==
* [[resume-examples]]
* [[resume-formats]]
* [[resume-brainstorming]]
* Feedback is encouraged on the [[hresume-feedback]] page.
* If you have any questions about hResume, check the [[hresume-faq|hResume FAQ]], and if you don't find answers, add your questions to the end!
* Please add any issues with the specification to the separate [[hresume-issues|hResume issues]] document.

== Further Reading ==
* See also [http://www.technorati.com/cosmos/referer.html blogs discussing this page].

hresume

2007-01-30T03:05:25Z

Steve Ganz: /* Examples in the wild */ Adding LinkedIn's Public Profiles

<h1> hResume </h1>

hResume is a microformat for publishing resumes and CVs. hResume is one of several open microformat standards suitable for embedding in (X)HTML, Atom, RSS, and arbitrary XML.

Want to get started with writing an hResume? Use the [http://hresume.weblogswork.com/hresumecreator/ hResume Creator] to create your hResume and publish it, or follow the hResume authoring tips to add hResume markup to your web page or blog.

<h2> Microformats Draft Specification </h2>

; Editor/Author: [http://theryanking.com Ryan King]
; Acknowledgments: See [http://microformats.org/wiki/hresume#Acknowledgements acknowledgments].

Microformats [http://microformats.org/wiki/hresume#Copyright copyright] and [http://microformats.org/wiki/hresume#Patents patents] statements apply.

__TOC__

== Status ==
Draft, version 0.1.

== Introduction ==
=== Semantic XHTML Design Principles ===
{{SemanticXHTMLDesignPrinciples}}

== Format ==
=== In General ===
The hResume format is based on a set of fields common to numerous resumes published today on the web. Where possible field names have been chosen and reused from preexisting microformats.

=== Schema ===
The hResume schema consists of the following:

* hResume
** summary. optional. text.
** contact info. required. '''Must''' use [[hcard|hCard]]. '''Should''' use <code class="element"><address></code> + [[hcard|hCard]].
** experience. optional. One or more [[hcalendar]] events with the class name '<code class="class-name">experience</code>', with an embedded [[hcard|hCard]] indicating the job title, name of company, address of company etc.
** education. optional One or more [[hcalendar]] events with the class name '<code class="class-name">education</code>', with an embedded [[hcard|hCard]] indicating the name of school, address of school etc.
** skills. optional. phrases or keywords using the [[rel-tag]] microformat with the class name '<code class="class-name">skill</code>'.
** affiliations. optional. the class name <code class="class-name">affiliation</code> along with an [[hcard]] of the organization
** publications. optional. One or more citations. Use cite tag.

=== Field details ===
The fields of the hResume schema represent the following:

* '''<code class="class-name">hresume</code>''':: root class name
* '''<code class="class-name">summary</code>''':: The class name <code class="class-name">summary</code> is used to mark up an overview of qualifications and objectives.
* '''contact''':: Current contact info in an [[hCard]]. '''Should''' use <code class="element"><address></code> with [[hCard]] when possible.
* '''<code class="class-name">education</code>''':: the class name '<code class="class-name">education</code>' is applied to an [[hcalendar]] event.
* '''<code class="class-name">experience</code>''':: the class name '<code class="class-name">experience</code>' is applied to an [[hcalendar]] event. Job titles/positions should use an [[hCard]].
* '''<code class="class-name">skill</code>''':: An hResume may be tagged using the [[rel-tag]] microformat and the '<code class="class-name">skill</code>' class name.
* '''<code class="class-name">affiliation</code>''':: The class name <code="class-name">affiliation</code> is used along with an [[hcard]] of the organization
* '''<code class="class-name">publications</code>''':: just use <code class="element"><cite></code>. When there is a [[citation]] microformat, then that can be used in combination with the cite element to further markup the components of the citation.

=== XMDP Profile ===
* [[hresume-profile]] (@TODO)

=== Notes ===
This section is informative.

*...

== Examples ==
=== Summary ===
An example summary:

<pre><nowiki>
<p class="summary">
I have 10 years experience with all Web 2.0 technologies– I've been working with Ajax since 1996,
designing with pastels while others will still using tiled background images and frames...
</p>
</nowiki></pre>

=== Contact ===
<pre><nowiki>
<address class="vcard">
<span class="fn">Pedro Sanchez</span>
<span class="adr">
<span class="street-address">123 Fake St.</span>
<span class="locality">Preston</span>, <span class="region">Idaho</span> <span class="postal-code">83263</span>
</span>
<span>Email: <a class="email" href="mailto:joe@example.com">pedro@vote-for-pedro.com</a></span>
<span>Homepage: <a class="url" href="http://vote-for-pedro.com/">vote-for-pedro.com</a></span>
<span>Phone: <span class="tel">+01.208.555.4567</span></span>
</address>
</nowiki></pre>

=== Education ===
<pre><nowiki>
<ol class="vcalendar">
<li class="education vevent">
<a class="url summary" href="http://example.edu/">Preston High School</a>
(<abbr class="dtstart" title="2001-01-24">2001</abbr> - <abbr class="dtend" title="2005-05-25">2005</abbr>)
</li>
...
</nowiki></pre>

=== Experience ===
==== Basic ====
A basic experience event:

<pre><nowiki>
<ol class="vcalendar">
<li class="experience vevent">
<span class="summary">President</span>,
<span class="location">Preston High School</span>,
<abbr class="dtstart" title="2004-09-01">May 2004</abbr> - <abbr title="2005-05-25">present</abbr>
</li>
...
</nowiki></pre>

==== Job Titles ====
To express one or more job titles/positions in the same experience event you should use [[hCard]]s. [[hcard]] requires the <code class="class-name">fn</code> ("formatted name") field, but it isn't reasonable to repeat your name for every job title you mark up in [[hResume|hresume]]. So, you may use an <code class="element"><object></code> and the class name '<code class="class-name">include</code>' with a reference to the <code class="class-name">fn</code> somewhere else on the page.

For example, this [[hCard]] refers to another [[hCard]]

<pre>
<span class="vcard">
<object data="#j" class="include"></object>
<span class="org">Preston High School</span>
<span class="title">Class President</span>
</span>
</pre>

Where "<code class="attr-value">j</code>" is the id attribute value of the "<code class="mf-prop">fn n</code>" element of the contact [[hCard]] at the top of the page, e.g. (shown here as a verbose [[hCard]] for purposes of illustration that the reference may be to a subtree, not just a text node):

<pre><nowiki>
<address class="vcard">
<span class="fn n" id="j">
<span class="given-name">Pedro</span>
<span class="family-name">Sanchez</span>
</span>
</address>
</nowiki></pre>

This method of hCard property indirection via an object element [[include-pattern|has been generalized]] to apply to any/all string/text properties in hCard.
Note: the object data attribute MUST be a local ID reference. External references (which would require a consuming application to load an external resource) are currently not supported by this method.

=== Skills ===
Some sample skills tags:
<pre><nowiki>
I have skills in <a class="skill" rel="tag" href="http://en.wikipedia.org/wiki/Bow_%28weapon%29">bow hunting</a>
and <a class="skill" rel="tag" href="http://en.wikipedia.org/wiki/Nunchucks">nunchucks</a>.
</nowiki></pre>

=== Affiliations ===
<pre><nowiki>
<span class="affiliation vcard"><span class="fn org">National Honor Society</span></span>
</nowiki></pre>

=== Publications ===
<pre><nowiki>
<cite>Breeding Ligers for Fun and Magic</cite>, Idaho Press, 2004.
</nowiki></pre>

== Examples in the wild ==
This section is '''informative'''.

The following sites have published hResumes, and thus are a great place to start for anyone looking for examples "in the wild" to try parsing, indexing, organizing etc. If you have an hResume on your own page, feel free to add it to the '''top''' of this list. Once the list grows too big, we'll make a separate wiki page.

* [http://linkedin.com/ LinkedIn] has ~9 million Public Profiles marked up in hResume, e.g. [http://www.linkedin.com/in/steveganz Steve Ganz's Public Profile]. ([[User:Steve Ganz|Steve Ganz]])
* [http://steinhardt.nyu.edu/ NYU Steinhardt] has [http://steinhardt.nyu.edu/faculty_bios/list/Faculty 240+ faculty bios marked up], e.g. [http://steinhardt.nyu.edu/faculty_bios/view/Susan_Murray]. ([[User:WizardIsHungry|Jon Williams]])
* [[User:ClintAndrewHall|Clint Hall]] has marked up his [http://www.clintandrewhall.com/resume.html resume] as an hResume.
* [[User:Csarven|Sarven Capadisli]] has marked up his [http://www.csarven.ca/cv Curriculum Vitae] as an hResume.
* [[User:Jax|Xavier Roy]] has marked his [http://xavierroy.com/resume/ resume] with hResume
* [[User:SanchTheFat|Robert O'Rourke]] has marked up his [http://robert.o-rourke.org/ CV] with hResume.
* [[User:Keri Henare|Keri Henare]] has marked up [http://www.kerihenare.com/cv/ his Curriculum Vitae] using hResume.
* [[User:Kwilson|Kenn Wilson]] has marked up [http://www.3color.org/~kwilson/resume/kenneth-wilson.html his resume] using hResume, following [[User:Ralph Brandi|Ralph Brandi]]'s method of using object.include.
* [[User:Ralph Brandi|Ralph Brandi]] has [http://www.brandi.org/ralph/resume/ marked up his resume] with hResume, additionally using the object.include method to associate one description with three hCalendar experiences.
* [[User:Pat Ramsey|Pat Ramsey]] has his [http://www.southwestern.edu/~ramseyp/ramsey_resume2006.html resume] marked up as an hResume.
* [[User:Wim Le Page|Wim Le Page]] has also marked up [http://adrem.ua.ac.be/~wlepage/curriculum-vitae/ his curriculum vitae] as an hResume.
* [[user:Jonathan Arkell|Jonathan Arkell]] has posted an [http://portfolio.jonnay.net/cv/ hResume] on his portfolio website.
* [http://steve.ganz.name/hresume/ Steve Ganz - hResume 0.1]
* [[User:Dave Cardwell|Dave Cardwell]] has marked up [http://davecardwell.co.uk/cv/ his curriculum vitae] as an hResume.
* [[User:EdwardOConnor|Edward O'Connor]]'s [http://edward.oconnor.cx/resume/ resume] is in hResume, and has some experimental JavaScript in it to extract a skill summary from the resume.
* [[User:Lindsey Simon|Lindsey Simon]] has his [http://www.commoner.com/~lsimon/lindsey_simon_resume.html resume] marked up as an hResume - with lots of thanks to Pat Ramsey.
* [[User:Ben Ward|Ben Ward]] has published [http://ben-ward.co.uk/cv his CV] with hResume.
* [http://www.kelleychambers.com Kelley Chambers] has published her [http://www.kelleychambers.com/resume resume] via [http://www.ssdesigninteractive.com/ssdesign/?p=96 Sajid Saiyed's Microformat hResume Plugin for Wordpress].
* [[User:Fishy5|Brennan Falkner]] used hResume to markup his [http://my.usf.edu/bbcswebdav/users/bfalker/resume.html resume].
* [http://www.zachary.com/creemer/resume.html David Creemer's resume] uses hResume, with thanks to Pat Ramsey for the CSS.

=== Examples with problems ===
* [[user:Izo|Mathieu Drouet]] has posted an [http://izo.aucuneid.com/hresume.html hResume].
** ''Incorrect root class name hResume? -- [[DavidJanes]]''

== Implementations ==
This section is '''informative'''.

The following implementations have been developed which either generate or parse hResumes. If you have an hResume implementation, feel free to add it to the top of this list. Once the list grows too big, we'll make a separate wiki page.

* The [http://spurinc.com Spur] team has created an hResume WordPress plugin located at [http://hresume.weblogswork.com/?page_id=3 hResume Plugin]. See an example of the hResume markup [http://hresume.weblogswork.com/?page_id=6 here]. Neat feature of the hResume plugin is that it automatically creates a new page for the resume - no cutting and pasting...

* The [http://www.ssdesigninteractive.com/ssdesign Sajid Saiyed] has created an hResume WordPress plugin located at [http://www.ssdesigninteractive.com/ssdesign/?p=96 Microformat Resume Plugin]. See an example of the hResume markup [http://www.ssdesigninteractive.com/ssdesign/?page_id=95 here].

* Spur also created a standalone hResume Creator located at [http://hresume.weblogswork.com/hresumecreator/ hResume Creator]. The creator will generate hResume markup ready to cut and paste into your webpage.

== Copyright ==
{{MicroFormatCopyrightStatement2006}}

== Patents ==
{{MicroFormatPatentStatement}}

== References ==
=== Normative References ===
* [[hcard|hCard]]
* [[hcalendar|hCalendar]]
* [[include-pattern|include pattern]]
* [http://www.w3.org/TR/REC-html40/ HTML 4]
* [http://www.w3.org/TR/xhtml1/ XHTML]
* [http://gmpg.org/xmdp/ XMDP]
* [[rel-tag| Rel-Tag]]
* @TODO

=== Informative References ===
@TODO

== Acknowledgements ==
=== Concept ===
* [http://theryanking.com/ Ryan King], [http://technorati.com Technorati]
* [http://tantek.com/ Tantek Çelik], [http://technorati.com Technorati]
* James Levine [http://simplyhired.com Simply Hired]
* [http://epeus.blogspot.com/ Kevin Marks], [http://technorati.com Technorati]

== Related Pages ==
* [[resume-examples]]
* [[resume-formats]]
* [[resume-brainstorming]]
* Feedback is encouraged on the [[hresume-feedback]] page.
* If you have any questions about hResume, check the [[hresume-faq|hResume FAQ]], and if you don't find answers, add your questions to the end!
* Please add any issues with the specification to the separate [[hresume-issues|hResume issues]] document.

== Further Reading ==
* See also [http://www.technorati.com/cosmos/referer.html blogs discussing this page].

xpn-examples

2007-01-30T01:06:43Z

Steve Ganz: /* business community sites (LinkedIn) */

== XPN-examples ==

This is an exploratory page to document examples of business/professional relationships currently published around the web. The Purpose of the studies on this page is to be used as a basis for the creation of an XPN or the extension of XFN. (Which will need to be discussed, there are legitimate arguments for both sides)

== Authors ==

* Kilian Valkhof

== Types of sites ==

* business community sites (LinkedIn)
* portfolio's
* client lists
* digital resumes

== Examples ==

== business community sites (LinkedIn) ==

*LinkedIn
** Colleague: You've worked with Joe at the same company
*** You managed Joe directly
*** You reported directly to Joe
*** You were senior to Joe, but did not manage directly
*** Joe was senior to you, but you did not report directly
*** You worked with Joe in the same group
*** You worked with Joe in different groups
** Service Provider: You've hired Joe to provide a service for you or your company
** Business Partner: You've worked with Joe, but not as a client or colleague
*** You worked with Joe but were at different companies
*** Joe was a client of yours

== portfolio's ==

Portfolio's always have large lists of links to clients. I (Kilian Valkhof) currently define those using rel="client".

== client list's ==

Large lists of clients, mostly the only semantical description is a header that states "client list"

== Resume's ==

Getting in hResume's water here, but digital resumes often link to client and/or former employers

implementations

2007-01-27T04:27:03Z

Steve Ganz: /* LinkedIn */

<h1>Microformats Implementations and Implementers</h1>

This page lists the applications, plugins, sample code, services, tools that produce or consume microformats as well as companies, developers, and organizations who implement the aforementioned. This is only a partial list. If you know other companies implementing tools for microformats, please add them and list their services/tools and what specific microformats they support.
__TOC__

== Implementations vs. Examples in the Wild ==

This page is ''only'' for implementations of tools that publish or consume microformats. Companies simply ''using'' microformats on their pages/sites belong in the "Examples in the wild" sections of those respective microformats, e.g.:
* [[hcard-examples-in-wild|hCard Examples in the wild]]
* [[hcalendar-examples-in-wild|hCalendar Examples in the wild]]
* etc.

== Editing This Page ==

This page is primarily composed of two big lists:
* [[implementations#Applications_.2F_Plugins_.2F_Services_.2F_Tools|Applications / Plugins / Services / Tools]]
* [[implementations#Companies_.2F_Developers_.2F_Organizations|Companies / Developers / Organizations]]

When you find an implementation, first make sure that it is ''actually'' an implementation as opposed to ''just'' an [[hcard-examples-in-wild|example in the wild]] of publishing microformats (see above).

Second, note the name of the ''tool or service'' separately from the name of the ''developer(s)'' who wrote the tool/service.

Add a third level heading with the name of the tool/service ( <code>=== Name of Tool ===</code> ) to the Applications / Plugins / Services / Tools section, sorted alphabetically by name of tool/service. Add a top level list item (*) just below the heading with an external link to the tool/service, along with a link to evidence of their support for microformats, and mention (and locally link) each microformat that is supported.

Add a nested list item <code>* by Name of Developer</code> and local hyperlink the Name of Developer to a fragment identifier in this page, e.g. Apple Computer would be linked like this: <code><nowiki>[[implementations#Apple_Computer|Apple Computer]]</nowiki></code>

Check to see if there is an entry for the developer in the list of Companies / Developers / Organizations, if not add a third level heading with the name of the developer ( <code>=== Name of Developer ===</code> ), alphabetically sorted by name of developer. Add a link to the developer's home page followed by "has implemented microformats in:".

In the entry for the developer, add a list item <code>* Name of Tool</code> and local hyperlink the Name of Tool to a fragment identifier in this page, e.g. X2V would be linked like this: <code><nowiki>[[implementations#X2V|X2V]]</nowiki></code>

Save the page and make sure that each fragment ID local hyperlink when clicked scrolls you to the right spot (for the developer, and for the tool). Make any fix-up edits as necessary. That's it!

== Formats ==

Most microformat specifications have an "implementations" section, e.g.:
*[[rel-tag#Implementations|rel-tag implementations]]
*[[vote-links#Implementations|vote-link implementations]]
*[[xoxo#Implementations|XOXO implementations]]

In addition, some microformat specifications have separate implementation pages:
*[[hcalendar-implementations|hCalendar implementations]]
*[[hcard-implementations|hCard Implementations]]
*[[xfn-implementations|XFN implementations]]

== Applications / Plugins / Services / Tools ==

This is an alphabetical listing of all applications, plugins (grouped with their app/tool), services and tools that implement microformats, along with the list of microformats that are supported, and the company and/or developers responsible for it.

As a user, the implementations listed below will automatically help you use microformats and help your data portability and interoperability with other apps and services.

Please help complete this list! If you know of additional apps/plugins/services/tools that support microformats, please add them!

Note: this section is only for listing specific ''implementations''. The list of ''implementors'' is in the [[implementations#Companies / Developers / Organizations|Companies / Developers / Organizations]] section below.

=== .Mac Webmail ===

* The [http://www.mac.com/webmail .Mac Webmail] ''service'' now [http://factoryjoe.com/blog/2006/10/28/apple-embraces-microformats-in-new-mac-webmail/ supports hcard].
** by [[implementations#Apple_Computer|Apple Computer]]

=== Blinksale ===
* [http://blinksale.com Blinksale] uses [[hcard|hCard]] standard throughout for people and companies.

=== BlogMatrix ===
* [http://www.blogmatrix.com BlogMatrix] - user information marked as [[hcard|hCard]], tag directories in [[xfolk]]/[[rel-tag]], enclosures are marked as [[rel-enclosure]].
** by [[implementations#David_Janes|David Janes]]

=== Blogmarks.net ===
* [http://www.blogmarks.net Blogmarks.net] publish user bookmarks in [[xfolk]]/[[rel-tag]].

=== Community Server ===
* [http://communityserver.org Community Server] supports tagging posts with [[rel-tag]], implements [[rel-nofollow]] on links in comments, and allows users to create link lists using [http://gmpg.org/xfn/ XFN].

=== Citycita===
* [http://www.citycita.org Citycita] supports [[hCal|hCal]] in all event pages for local social groups.
** by [[implementations#Rubio_Jamin|Rubio Jamin]]

=== Cork'd ===
* [http://corkd.com Cork'd] supports [[hcard|hCard]] for user profiles, [[hreview|hReview]] for wine reviews, along with [[rel-tag]] for tagging wines as announced in [http://www.simplebits.com/notebook/2006/06/10/wineformats.html Pairing Wine and Microformats]
** by [[implementations#Dan_Cederhold|Dan Cederholm]]

=== Dreamweaver ===
==== Microformats Extensions ====
* [http://www.webstandards.org/action/dwtf/microformats Dreamweaver Microformats Extensions] ([http://allinthehead.com/beta/microformats.mxp.zip download]) support authoring [[hcard|hCard]], [[hcalendar|hCalendar]], [http://gmpg.org/xfn XFN], [[rel-tag]], [[rel-license]] as [http://allinthehead.com/retro/282/microformats-in-dreamweaver announced by Drew]
** by [[implementations#Drew_Mclellan|Drew McLellan]]

=== Drupal ===
==== Upcoming module for Drupal ====
* [http://hybernaut.com/upcoming-module Drupal Upcoming.org syndication module] emits [[hcalendar|hCalendar]]
** by [[implementations#Brian_Del_Vecchio|Brian Del Vecchio]]

=== Etnies ===

* [http://etnies.com/extra/calendar/ Etnies Calendar] supports hcalendar. Maybe the [http://thecolab.com/blog/2007/01/22/etniescom-relaunch/ first skate-shop to support microformats].

=== EVDB ===
* [http://evdb.com EVDB] / [http://eventful.com Eventful] supports [[hcalendar|hCalendar]] for over 1,000,000 event listings and [[hcard|hCard]] for venues.

=== Finetoothcog ===
* [http://finetoothcog.com/site/stolen_bikes Stolen Bikes] now supports [[hcalendar|hCalendar]] for reported stolen bikes. Also provides iCal subscription.

=== Firefox ===
* See [[firefox-extensions]]

=== FunAdvice ===
* [http://funadvice.com FunAdvice] supports using the rel-nofollow tag to prevent users posting content simply for the search engine benefit, to improve teh quality of the advice giving community.

=== Gravatar Commenters as hCards ===
* [http://thedredge.org Andy Hume] added code to his blogging software to automatically mark-up the names and URLs of commenters on his blog with [[hcard|hCard]].
** by [[implementations#Andy_Hume|Andy Hume]]
** Andy - any chance of open sourcing your code to turn Gravatars into hCards?

=== Flickr People ===
* [http://flickr.com/ Flickr]'s profiles on its people pages supports both [[hcard|hCard]] and [http://gmpg.org/xfn XFN].
** by [[implementations#Cal_Henderson|Cal Henderson]]
**[http://flickr.com/people/tantek example]

=== Flickr Photos ===
* [http://flickr.com/map/ Flickr's geo tagged photos] are marked up with the [[geo]] microformat.

=== Flock Web Browser ===
* The [http://flock.com Flock web browser] supports the [[rel-tag]] microformat.
** by [[implementations#Flock|Flock]]

=== Google Search ===
* [http://google.com/ Google Search] - supports [[rel-nofollow]]
=== Google Creative Commons Search ===
* [http://www.google.com/webhp?as_rights=(cc_publicdomain%7Ccc_attribute%7Ccc_sharealike%7Ccc_noncommercial%7Ccc_nonderived) Google Creative Commons Search] - supports [[rel-license]]

=== Greasemonkey ===
* [http://greasemonkey.makedatamakesense.com/google_hcalendar/ Google hCalendar] - Adds hCalendar data to Google Calendar.
* [http://www.nickpeters.net/?p=35 Social xFolk] - Adds xFolk links to social bookmarking sites del.icio.us and ma.gnolia.

=== hCalendar creator ===
* [http://microformats.org/code/hcalendar/creator hCalendar creator] (originally [http://theryanking.com/microformats/hcalendar-creator.html published by Ryan King]) is a javascript form for creating [[hcalendar|hCalendar]] events.
** by [[implementations#Ryan_King|Ryan King]]

=== hCard creator ===
* The open source [http://microformats.org/code/hcard/creator hCard creator] (originally [http://tantek.com/microformats/hcard-creator.html published by Tantek]) is a very simple, yet illustrative, open source user interface / form / script which creates an [[hcard|hCard]] in real-time as you type in a set of contact information.
** by [[implementations#Tantek_Çelik|Tantek Çelik]]

=== hKit Microformats Toolkit for PHP5 ===
* [http://allinthehead.com/hkit hKit Microformats Toolkit for PHP5] as [http://allinthehead.com/retro/291/hkit-microformats-toolkit-for-php announced by Drew McLellan]

=== hReview creator ===
* [http://microformats.org/code/hcalendar/creator hReview creator] (originally [http://theryanking.com/microformats/hreview-creator.html published by Ryan King]) is a javascript form for creating [[hreview|hReviews]].
** by [[implementations#Ryan_King|Ryan King]]

=== Ice Rocket ===
* [http://icerocket.com] - [http://blogs.icerocket.com/tag/ supports] [[rel-tag]]

=== iChat buddy list to hCards ===
* [http://tantek.com/microformats/buddylist2hcards.html iChat buddy list to hCards] - open source AppleScript to automatically convert one's buddy list in the MacOSX iChat AIM client into a valid XHTML 1.0 Strict list of hCards.
** by [[implementations#Tantek_Çelik|Tantek Çelik]]

=== JSCalendar ===
* [http://web.mit.edu/glasser/www/JSCalendar/ JSCalendar] parses [[hcalendar|hCalendar]] and produces a displayable HTML table/CSS-based calendar.

=== Konqueror ===
* [http://www.konqueror.org/ Konqueror] - [http://flickr.com/photos/factoryjoe/68755089/ supports] [[hcard|hCard]]

=== Last.fm ===
* [http://last.fm Last.fm] - [http://factoryjoe.com/blog/2006/10/31/lastfm-adds-support-for-hcalendar/ Last.fm supports] [[hcalendar|hCalendar]]

=== Laughing Squid Calendar ===
* The [http://laughingsquid.com/squidlist/calendar/ Laughing Squid Calendar] events listings support [[hcalendar|hCalendar]].
** by [http://laughingsquid.com/ Laughing Squid]

===LinkedIn ===
* [http://www.linkedin.com LinkedIn] - LinkedIn includes [[hcard|hCard]] and [[xfn|XFN]] on contacts, [[hresume|hResume]] for public profiles and [[hreview|hReview]] on service provider recommendations

=== LiveJournal ===
* [http://www.livejournal.com LiveJournal] - LiveJournal supports tagging posts with [[rel-tag]].

=== LJFind ===
* [http://www.ljfind.com LJ-Find] - LJFind supports tagging posts with [[rel-tag]].

=== Ma.gnolia ===

* [http://ma.gnolia.com Ma.gnolia] has wide [http://wiki.ma.gnolia.com/Ma.gnolia_Feeds_Guide#Microformats support for a variety of microformats] including [[rel-tag]], [[xfolk]], [[hreview]], [[xfn]] and [[hcard]].

=== Microformat Base ===
* [http://randomchaos.com/microformats/base/ Microformat Base]
** by [[implementations#Scott Reynen|Scott Reynen]]

=== Microformat Bookmarklet Overlay ===
* [http://leftlogic.com/info/articles/microformats_bookmarklet Microformats Bookmarklet] for Safari, Firefox and Camino, supports [[hcard|hCard]] and [[hcalendar|hCalendar]] and allows the user to import individual microformats on the fly.
** by [[implementations#Remy_Sharp|Remy Sharp]]

=== Microformat Parser for Ruby ===
* [http://blog.labnotes.org/2005/11/20/microformat-parser-for-ruby/ Microformat Parser for Ruby]
** by [[implementations#Assaf Arkin|Assaf Arkin]]

=== Nature Network Boston ===
* [http://network.nature.com/boston/ Nature Network Boston], a social networking community for scientists, supports [[reltag|rel-tag]], [[hcard|hCard]] for user profiles and [[hcalendar|hCalendar]] for marking up events across the site.
** by [[implementations#Nature Publishing Group|Nature Publishing Group]]

=== Nature Protocols ===
* [http://www.nature.com/nprot/ Nature Protocols], a forum for scientists to upload and comment on protocols, supports [[hcard|hCard]] and [[XOXO]].
** by [[implementations#Nature Publishing Group|Nature Publishing Group]]

=== Nutch ===
* [http://www.mail-archive.com/nutch-dev@lucene.apache.org/msg01295.html rel-nofollow support added]
* [http://www.mail-archive.com/nutch-commits@lucene.apache.org/msg01014.html rel-tag support checked in]

=== ODEO ===
* [http://odeo.com/ ODEO] [http://odeo.com/blog/2005/07/adding-microformats-to-odeo.html noted] that they support microformats: [[rel-tag]], [[rel-enclosure]], [http://gmpg.org/xfn XFN].

=== phpMicroformats ===
* [http://enarion.net/phpmicroformats/ phpMicroformats] is a PHP class library that generates microformat entries for [[hcalendar|hCalendar]] and [[hcard|hCard]]. It is released under GPL.

=== PostNuke ===
''[http://www.postnuke.com PostNuke] is an Application Framework/Content Management Systeme''
* [http://www.pagesetter.net/index.php?module=pagesetter&func=viewpub&tid=4&pid=96 hCards4Pagesetter] - hCards Publication Type for the PostNuke module "Pagesetter"
* [http://www.pagesetter.net/index.php?module=pagesetter&func=viewpub&tid=4&pid=97 hCalendar4Pagesetter] - hCalendar Publication Type for the PostNuke module "Pagesetter"
* [http://www.pagesetter.net/index.php?module=pagesetter&func=viewpub&tid=4&pid=98 hReview4Pagesetter] - hReview Publication Type for the PostNuke module "Pagesetter"

=== Profiler ===
* [http://microformat.makedatamakesense.com/profiler/ Profiler] works as a proxy service adding microformat profiles to documents that appear to contain microformats.

=== RFC2629.xslt ===
* [http://greenbytes.de/tech/webdav/rfc2629.xslt rfc2629.xslt] now attempts to generate [[hcard|hCard]] information ([http://ietf.org/rfc/rfc2629 RFC2629] in an XML format for authoring RFCs and Internet Drafts, see [http://greenbytes.de/tech/webdav/rfc2629xslt/rfc2629xslt.html example document])

=== Salesforce ===
* [http://salesforce.com Salesforce] [http://flickr.com/photos/kingsleyj/175689109/ supports] [[hcard|hCard]]
** by [http://flickr.com/people/kingsleyj/ Kingsley Joseph]
==== Spanning Salesforce ====
* [http://spanningsalesforce.com/ Spanning Salesforce] supports [[hcalendar|hCalendar]].

=== Sivitools ===
<blockquote>
Sivitols is a Java library for microformats. Currently only the xFolk RC1 standard is implemented, but additional microformat support is planned. This library is being written and maintained for a tag sharing project undertaken by Video Vertigo.
</blockquote>
[http://blog.blip.tv/blog/microformats/ Annoucement], [http://pokkari.com/microformat/javadoc/ Docs]

=== SPRACI ===
* [http://www.spraci.com SPRACI] - nightlife/events - [[hcalendar|hCalendar]] published in events listings, aggregator can read hCalendar

=== Sunnyvale House Concerts ===
* [http://concerts.shrub.ca/shows Sunnyvale House Concerts] supports [[hcard|hCard]] and [[hcalendar|hCalendar]].

=== Technorati Contacts Feed Service ===
* [http://feeds.technorati.com/contacts/ Technorati Contacts Feed Service] is a deployment of [[implementations#X2V|X2V]] to convert [[hcard|hCards]] to vCard (.vcf) format.

=== Technorati Events Feed Service ===
* [http://feeds.technorati.com/events/ Technorati Events Feed Service] is a deployment of [[implementations#X2V|X2V]] to convert [[hcalendar|hCalendar]] events to iCalendar (.ics) format.

=== Technorati Microformats Search ===
* Technorati [http://kitchen.technorati.com/search/ Microformats Search]. Search for contacts ([[hcard|hCard]]), events ([[hcalendar|hCalendar]]), or reviews ([[hreview|hReview]]) published on blogs and other web sites.
** by [#implementations#Tantek_Çelik|Tantek Çelik]], [[implementations#Ryan_King|Ryan King]], [[implementations|Kevin_Marks|Kevin Marks]], [[implementations#Josh_Smith|Josh Smith]]

=== Technorati Search ===
* [http://technorati.com/ Technorati] [http://technorati.com/search Search] supports and handles both [[vote-links]] and [[rel-nofollow]] for indicating whether a link should have any/positive/negative weighting towards the destination.
** by [http://technorati.com/about/staff.html Technorati Staff]
=== Technorati Tags ===
* [http://technorati.com/tags/ Technorati Tags] pages aggregate blog posts tagged with the [[rel-tag]] open tagging standard, in addition to recent tagged photos and links.

=== Textpattern ===
==== Microformats Plugin ====
* [http://placenamehere.com/TXP/pnh_mf/ Textpattern Microformats Plugin] supports authoring [[hcard|hCard]], [[hcalendar|hCalendar]], [[hreview|hReview]], [http://gmpg.org/xfn XFN], [[rel-tag]], [[rel-license]] in the [http://www.textpattern.com/ Textpattern] CMS/blogging tool
** by [http://placenamehere.com/ Chris Casciano]

=== TYPO3 ===
* [http://www.typo3.com TYPO3], [http://typo3.org TYPO3 Developer Ressource]
==== tt_address extension====
* [http://typo3.org/extensions/repository/view/tt_address/1.0.4/ tt_address] - hCard support with the tt_address extension version 2.0. As of 01/05/07 version 2.0 is beta and latest builds can be obtained from [http://typo3xdev.sourceforge.net/ TYPO3xdev]
** by [[implementations#Ingo_Renner|Ingo Renner]]
==== TIMTAB extension====
* [http://typo3.org/extensions/repository/view/timtab/0.5.11/ TIMTAB] - XFN support for blogrolls with the TIMTAB weblog extension for TYPO3
** by [[implementations#Ingo_Renner|Ingo Renner]]

=== Upcoming.org ===
* [http://upcoming.org Upcoming.org] - hCalendar support in events listings and individual events.
** by [[implementations#Andy_Baio|Andy Baio]], [[implementations#Leonard_Lin|Leonard Lin]], [[implementations#Gordon_Luk|Gordon Luk]]

=== vCardExplorer ===
* [http://vcardexplorer.corefault.de/ vCardExplorer for MacOSX] - browses local vcards and converts hcards from URLs.

=== WordPress ===
* [http://wordpress.org WordPress] supports [http://gmpg.org/xfn/ XFN] blogrolls through a very nice built-in user interface. (cf. [[xfn-implementations]])
** by [[implementations#Matt_Mullenweg|Matt Mullenweg]] and friends

==== WP Microformatted Blogroll ====
* The [http://factorycity.net/projects/wp-microformatted-blogroll/ WP Microformatted Blogroll 0.2] Wordpress plugin by [[implementations#Chris_Messina|Chris Messina]] supports [[hcard|hCard]] and [http://gmpg.org/xfn/ XFN].

==== VoteBack Plugin ====
* [http://redmonk.net/archives/2006/12/21/voteback/ VoteBack plugin for Wordpress] - checks incoming pingbacks and trackbacks for [[votelinks]].

==== WP Themes ====
* [http://www.plaintxt.org/themes/sandbox/ Sandbox] is a theme for Wordpress that uses [[hatom|hAtom]].
** The theme is also available to accounts on the <username>.wordpress.com hosting service.
* [http://www.jesuscarrera.info/proyectos/startpoint/ StartPoint] A theme for theme developers. A good start point to make your own templates. It supports multiple languages, widgets, contains semantic hAtom microformats, and more.
* [http://www.whump.com/dropbox/Strangelove.zip Strangelove] is a modification of the default Wordpress theme (Kubrick) with [[hatom|hAtom]] support.
** It points to the hAtom2Atom proxy service as the link for syndication feeds.

=== X2V ===
* Brian Suda has created several XSLT files to extract microformats from HTML. From that the [http://suda.co.uk/projects/X2V/ X2V] webservice/favelet emerged. The XSLT and favelet extracts [[hcard|hCard]] and to produces .vcf (vCard) files and [[hcalendar|hCalendar]] to produce .ics (iCal) files. Also in the labs is a universal XMDP validator and a site-wide search spider that recognizes 'no-follow', 'license' and other microformats so they can be used in a more semantic way when displaying search results.
** by [[implementations#Brian_Suda|Brian Suda]]

=== Yahoo Creative Commons Search ===
* [http://search.yahoo.com/cc/ Yahoo Creative Commons Search] - supports [[rel-license]] specifically to search for Creative Commons licensed content.

=== Yahoo Local ===
* [http://local.yahoo.com Yahoo local] supports [[hcard|hCard]], [[hcalendar|hCalendar]], and [[hreview|hReview]].

=== Yahoo Tech ===
* [http://tech.yahoo.com Yahoo! Tech] supports [[hreview|hReview]].

=== Yahoo UK Movies ===
* [http://movies.yahoo.co.uk Yahoo! UK Movies] supports [[hreview|hReview]].
** by Mark Norman Francis

=== Yedda ===
* [http://yedda.com Yedda] supports [[hcard|hCard]] for exposing users information, [[hatom|hAtom]] for exposing data that is already exposed via feeds (like list of questions and answers) and [[rel-tag|rel-tag]] for every tag used to tag questions and users.

== Validators ==
This is an alphabetical listing of tools that have been created to validate implementations, and which formats they support.

Please add to this section if you have a validator/checker, no matter which or how many microformats you test for.

=== rel-lint ===
* [http://tools.microformatic.com/help/xhtml/rel-lint/ rel-lint] supports validation of [[rel-tag|rel-tag]] and [[xfn|XFN]]
* by [[implementations#Drew_McLellan|Drew McLellan]]

== Companies / Developers / Organizations ==

(Considering moving all of these to an [[implementors]] page of its own).

Thanks to all of the hardworking developers and innovative companies and organizations for supporting microformats.

This is an alphabetical listing of all companies, developers (by last name) and organizations who have built and shipped at least one implementation (see above for details of each implementation) that users can use.

Please help complete this list! If you have coded support for microformats and don't see your name, add it! If your company supports microformats in its applications, add it!

Note: please add direct links to specific applications, plugins, services, or tools to the list of [[implementations#Applications / Plugins / Services / Tools|Applications / Plugins / Services / Tools]] and then link to those from their implementor with a fragment identifier link, e.g. to link to the "Cork'd" wine review community:
* <nowiki>[[implementations#Cork'd|Cork'd]]</nowiki>
Similarly, for additional sites, put direct links to them in the [[implementations#Additional Sites|Additional Sites]] section and then link to them from their implementor with a fragment identifier link.

=== Apple Computer ===
[http://apple.com/ Apple Computer] has implemented microformats in:
* [[implementations#.Mac_Webmail|.Mac Webmail]]

=== Andy Hume ===
* [[implementations#Andy_Hume_Blog|Andy Hume Blog]]

=== Andy Baio ===
* [[implementations#upcoming.org|Upcoming.org]]

=== Assaf Arkin ===
* [[implementations#Microformat_Parser_for_Ruby|Microformat Parser for Ruby]]

=== Brian Del Vecchio ===
* [[implementations#upcoming_module_for_drupal| Upcoming module for Drupal]]

=== Brian Suda ===
* [[implementations#X2V|X2V]]

=== Chris Casciano ===
* [[implementations#Microformats_Plugin|Textpattern Microformats Plugin]]

=== Chris Messina ===
[[implementations#WP_Microformatted_Blogroll|WP Microformatted Blogroll]]

=== Chris Saccheri ===
* [[implementations#LinkedIn|LinkedIn]]

=== Calvin Yu ===
* [http://blog.codeeg.com/ Calvin Yu blog: Don't Forget to Plant It!]
* [[implementations#Tails_Firefox_Extension|Tails Firefox Extension]]

=== Dan Cederholm ===
* [[implementations#Cork'd|Cork'd]]

=== David Janes ===
* [[implementations#BlogMatrix|BlogMatrix]]

=== David Long and James Myers ===
* [[implementations##ZDNet_UK|ZDNet]]

=== Drew McLellan ===
* [[implementations#Microformats_Extensions|Microformats Extensions]]
* [[implementations#hKit_Microformats_Toolkit_for_PHP5|hKit Microformats Toolkit for PHP5]]
* [[implementations#rel-lint|rel-lint Validator Tool]]

=== enarion.net ===
* [[implementations#phpMicroformats|phpMicroformats]]

=== Flock ===
* [[implementations#Flock Web Browser|Flock Web Browser]]

=== FunAdvice ===
* [[implementations#FunAdvice|FunAdvice]]

=== Google ===
* [[implementations#Google_Search|Google Search]]
* [[implementations#Google_Creative_Commons_Search|Google Creative Commons Search]]

=== Gordon Luk ===
[[implementations#upcoming.org|Upcoming.org]]

=== Ingo Renner ===
[http://www.ingo-renner.com Ingo Renner] has implemented hCard and XFN in:
* [[implementations#TYPO3|TYPO3]]

=== Josh Smith ===
* [[implementations#Technorati_Microformats_Search|Technorati Microformats Search]]

=== Kent Brewster ===
* [http://www.mindsack.com/?page_id=39 Extensible friends] -- JSON + XFN and bookmarklet

=== Kevin Marks ===
* [[implementations#Technorati_Microformats_Search|Technorati Microformats Search]]

=== Kingsley Joseph ===
[http://flickr.com/people/kingsleyj/ Kingsley Joseph]:
* [[implementations#Salesforce|Salesforce]]

=== Laughing Squid ===
* [[implementations#Laughing_Squid_Calendar|Laughing Squid Calendar]]

=== Leonard Lin ===
* [[implementations#upcoming.org|Upcoming.org]]

=== Nature Publishing Group ===
* Nature Publishing Group are steadily rolling out microformats across their sites and titles. Current implementations include the following online services:
** [[implementations#Nature Network Boston|Nature Network Boston]]
** [[implementations#Nature Protocols|Nature Protocols]]
* as well the following additional site(s):
** [[implementations#Nature Home Page|Nature Home Page]]

=== Remy Sharp ===

* [[implementations#Microformats_Bookmarklet|Microformats Bookmarklet]]

=== Robert de Bruin ===
* [http://bordewolf.blogspot.com/ Robert de Bruin' s blog: Bor de Wolf]
* [[implementations#Tails_Export_Firefox_Extension|Tails Export Firefox Extension]]

=== Ryan King ===
* [[implementations#hCalendar_creator|hCalendar Creator]]
* [[implementations#hReview_creator|hReview Creator]]
* [[implementations#Technorati_Microformats_Search|Technorati Microformats Search]]

=== Scott Allan Wallick ===
* [[implementations#WP_Themes|Sandbox Wordpress Theme w/hAtom Support]]

=== Scott Reynen ===
* [[implementations#Microformat_Base|Microformat Base]]

=== SixApart ===
* [[implementations#LiveJournal|LiveJournal]]

=== Steffen Voß ===

* [[implementations#PostNuke|PostNuke hCards]]
* [[implementations#PostNuke|PostNuke hCalendar]]
* [[implementations#PostNuke|PostNuke hReview]]

=== Steve Ivy ===
* [[implementations#VoteBack_Plugin|Wordpress VoteBack Plugin]]

=== Tantek Çelik ===
* [[implementations#hCard_creator|hCard Creator]]
* [[implementations#iChat_buddy_list_to_hCards|iChat Buddy List to hCard]]
* [[implementations#Technorati_Microformats_Search|Technorati Microformats Search]]

=== Technorati ===
* [[implementations#Technorati_Contacts_Feed_Service|Technorati Contacts Feed Service]]
* [[implementations#Technorati_Events_Feed_Service|Technorati Events Feed Service]]
* [[implementations#Technorati_Microformats_Search|Technorati Microformats Search]]
* [[implementations#Technorati_Search|Technorati Search]]
* [[implementations#Technorati_Tags|Technorati Tags]]

=== Yahoo ===
* [[implementations#Flickr_People|Flickr People]]
* [[implementations#Upcoming.org|Upcoming]]
* [[implementations#Yahoo_Creative_Commons_Search|Yahoo Creative Commons Search]]
* [[implementations#Yahoo_Local|Yahoo Local]]
* [[implementations#Yahoo_Tech|Yahoo Tech]]
* [[implementations#Yahoo_UK_Movies|Yahoo UK Movies]]

=== Yedda ===
* [[implementations#Yedda|Yedda]]

== Needs Fixing ==

* Re-format author names and links to display Surname Firstname - for better indexing, and complete cross-linking [[User:Phae|Frances Berriman]]

The following have been moved from the sections above due to problems, stated below:

=== Web Essentials ===
* [http://we05.com/ Web Essentials] - supports [[hcard|hCard]] and [[hcalendar|hCalendar]], e.g. in their [http://we05.com/presenters.cfm list of presenters] and [http://we05.com/program.cfm program schedule].
** John McKerrell tried to look at the site on 24th October 2006 but could not access the site, server didn't seem to be up.

== Other ==
Some notes on initial thoughts around [[implementation-guidelines|Guidelines and Strategies for Implementing Microformats]]

hresume-issues

2006-10-21T04:48:04Z

Steve Ganz: /* Issues */ Defined additional need for hCard types in hResume.

hresume-issues

2006-10-21T04:20:16Z

Steve Ganz: /* Issues */

2005-12-04T18:01:39Z

Steve Ganz:

http://steve.ganz.name/

adr

2005-11-29T16:20:35Z

Steve Ganz: /* adr */

= adr =

'''adr''' (working name, pronounced "adder") is a simple format for marking up address information, suitable for embedding in (X)HTML, Atom, RSS, and arbitrary XML. '''adr''' is a 1:1 representation of the ''adr'' property in the vCard standard ([http://www.ietf.org/rfc/rfc2426.txt RFC2426]) in XHTML, one of several open [[microformats|microformat]] standards.
__TOC__

== Draft Specification ==
=== Editor/Author ===
[http://tantek.com/ Tantek Çelik], [http://technorati.com Technorati, Inc.]

=== Copyright ===
{{MicroFormatCopyrightStatement2005}}

=== Patents ===
{{MicroFormatPatentStatement}}

=== Inspiration and Acknowledgments ===
Thanks to everyone who participated in the [[geo-bof-2005-06-30|Geo Microformat BOF at O'Reilly's Where 2.0 conference]], and in particular to [http://radar.oreilly.com/nat/ Nat Torkington] and Vee McMillen of [http://oreilly.com O'Reilly] for [http://conferences.oreillynet.com/cs/where2005/view/e_sess/7476 arranging and hosting the BOF].

== Introduction and Background ==
The vCard standard ([http://www.ietf.org/rfc/rfc2426.txt RFC2426]), has been broadly and interoperably implemented (e.g. Apple's Address Book application). The [[hcard|hCard]] microformat has similarly received significant adoption, from numerous sites publishing the format, to hCard to vCard proxies, to clientside javascript parsers.

At the [http://conferences.oreillynet.com/where/ Where 2.0 conference] in June 2005, there was widespread recognition that the community needed a way to simply and easily publish visible, extractable, address information on the Web, given how often bloggers, and numerous other sites publish address information. The [[geo-bof-2005-06-30|geo microformat BOF]] discussed this very topic, and concluded with a consensus decision to just try using ''adr'' from vCard/hCard.

This specification introduces the '''adr''' microformat, which is a 1:1 representation of the aforementioned ''adr'' property from the vCard standard, by simply reusing the ''adr'' property and sub-properties as-is from the [[hcard|hCard]] microformat.

Publishers can both embed '''adr''' addresses directly in their web pages and feeds, as well as markup existing addresses in the context of the rest of the information in their web pages and feeds.

If the publisher knows and is publishing the ''name'' of the location in addition to its address, then the publisher MUST use [[hcard|hCard]] instead of just '''adr''' to publish the name and address of the location.

== Semantic XHTML Design Principles ==
{{semantic-xhtml-design-principles}}

== Format ==
=== Singular Properties ===

Note that all the properties in '''adr''' are singular properties, and thus the first descendant element with that class should take effect, any others being ignored.

=== Human vs. Machine readable ===

If an <code><abbr></code> element is used for a property, then the <code>title</code> attribute of the <code><abbr></code> element is the value of the property, instead of the contents of the element, which instead provide a human presentable version of the value.

Similarly, if an <code><img></code> element is used for one or more properties, it must be treated as follows:
# For the <code>PHOTO</code> property and any other property that takes a <abbr title="Uniform Resource Locator">URL</abbr> as its value, the <code>src</code> attribute provides the property value.
# For other properties, the <code><img></code> element's <code>alt</code> attribute is the value of the property.

=== Value excerpting ===

Sometimes only part of an element which is the equivalent for a property should be used for the value of the property. For this purpose, the special class name <code>value</code> is used to excerpt out the subset of the element that is the value of the property. See [[hcard|hCard]] for details on this.

=== Root Class Name ===

The root class name for an '''adr''' address is <code>adr</code>.

=== Property List ===

This is the list of properties in '''adr''', taken from [[hcard|hCard]]:

* <code>post-office-box</code>
* <code>extended-address</code>
* <code>street-address</code>
* <code>locality</code>
* <code>region</code>
* <code>postal-code</code>
* <code>country-name</code>

The <code>type</code> sub-property is omitted because without the context of a type of address for ''whom'', it doesn't make much sense.

=== XMDP Profile ===

See [[hcard-profile]] for the [http://gmpg.org/xmdp XMDP] profile of hCard which contains the above complete list of properties, with references to their RFC 2426 definitions.

=== Parsing Details ===
See [[hcard-parsing|hCard parsing]], with the only difference being that "adr" is the root class name, rather than "vcard".

== Examples ==
This section is informative.

=== Sample adr ===

Here is a sample adr:

<pre><nowiki>
<div class="adr">
<div class="street-address">665 3rd St.</div>
<div class="extended-address">Suite 207</div>
<span class="locality">San Francisco</span>,
<span class="region">CA</span>
<span class="postal-code">94107</span>
<div class="country-name">U.S.A.</div>
</div>
</nowiki></pre>

This adr might be displayed as:

<pre>665 3rd St.
Suite 207
San Francisco, CA 94107
U.S.A.</pre>

=== More Examples ===

See [http://microformats.org/wiki/hcard-examples#3.2.1_ADR_Type_Definition hCard example ADR] for more examples.

== Examples in the wild ==
This section is '''informative'''.

The following sites have published adrs, outside their normal context of hCards, and thus are a great place to start for anyone looking for examples "in the wild" to try parsing, indexing, organizing etc., in addition to [[hcard|hCard]] examples in the wild. If you find adrs outside of hCards anywhere else, feel free to add them to the top of this list. Once the list grows too big, we'll make a separate wiki page.

* ...
* ...

== Implementations ==
This section is '''informative'''.

The following implementations have been developed which either generate or parse adrs outside the context of hCards. If you have an adr implementation, feel free to add it to the top of this list. Once the list grows too big, we'll make a separate wiki page.

* The [http://tantek.com/microformats/hcard-creator.html hCard creator], though it creates complete hCards, can also be used simply to create adrs by filling out the address portion and simply copy and pasting the <div class="adr"> element and its contents.

== References ==
=== Normative References ===
* [[hcard|hCard]]

=== Informative References ===
* [http://www.ietf.org/rfc/rfc2426.txt vCard RFC2426] ([http://www.w3.org/2002/12/cal/rfc2426 HTML reformatted version of RFC2426])
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]

=== Similar Work ===
* [[geo]]
* [[hcalendar|hCalendar]]
* [[XOXO]]

== Work in progress ==
This specification is a work in progress. As additional aspects are discussed, understood, and written, they will be added.

== Discussions ==

* See [http://www.technorati.com/cosmos/referer.html blogs discussing this page].

=== Q&A ===
* If you have any questions about hCard, check the [[hcard-faq|hCard FAQ]] first, and if you don't find answers, add your questions! (Odds are that any '''adr''' question will apply to [[hCard]] as well).
* See also [http://microformats.org/discuss/ for other methods of feeback].

=== Issues ===
* Please add any issues with the specification to the separate [[hcard-issues|hCard issues]] document. Ditto.