View source for xfn-to-foaf

<h1>XFN &rarr; FOAF</h1>
{{TOC-right}}
by [[User:TobyInk|Toby Inkster]]

<p>&nbsp;</p>

A number of people have expressed an interest in extracting RDF-like data from [[xfn|XFN]] and [[hcard|hCard]]. The problem is that while XFN is interpreted as representing a relationship between two people, it actually encodes a relationship between two URIs. 

This page describes a technique for figuring out which people these URIs represent. It is not an attempt to describe a new specification or standard, but  rather, a set of best practices. Two algorithms are described: a "high-bandwidth" version which requires web crawling, and a "low-bandwidth" version which uses only the information found on the initial page.

For most of the examples on this page, the following XFN link will be used:

<pre><nowiki><a rel="friend met" href="http://bob.example.net">Bob Smith</a></nowiki></pre>

which has been found on Alice Jones' web page at <nowiki>http://alice.example.net</nowiki>.

== Determining the subject ==

# Find the [[representative-hcard|representative hCard]] for the current page.
# In the high-bandwidth situation, parsers {{may}} crawl <code>rel=me</code> links in order to find a "better" representative hCard, where the meaning of "better" is to be defined by the parser itself.
#* (Parsers {{should}} impose a depth limit for crawling.)
# If no hCard for the subject has been found, the subject is a person represented by the following RDF triples:
<pre><nowiki>:bnode01 a foaf:Person;
         foaf:page &lt;http://alice.example.net&gt;.</nowiki></pre>

A parser which understands RDFa or other semantics may use additional techniques to determine the subject of the link, but those are beyond the scope of the Microformats wiki.

== Determining the predicate ==

This is the easiest step.

For <code>rel="me"</code> the predicate is <code>foaf:page</code>.

For other relationships, the local name of the predicate is the same as the rel value, and the namespace URI is defined as <code><nowiki>http://gmpg.org/xfn/11#</nowiki></code>. Many non-me XFN values can be considered to be refinements of foaf:knows. As an example, the fully qualified URIs for the predicates associated with <code><nowiki>rel="met friend"</nowiki></code> are:

* <code><nowiki>http://gmpg.org/xfn/11#met</nowiki></code>
* <code><nowiki>http://gmpg.org/xfn/11#friend</nowiki></code>
* <code><nowiki>http://xmlns.com/foaf/0.1/knows</nowiki></code>

'''Which XFN values are refinements of <code>foaf:knows</code>?''' This is a matter of debate. Although normally, say, a parent and child will have a close relationship, there are instances where they may have never met, and not know each other at all. The current list of XFN values which I treat as refinements of <code>foaf:knows</code> are: acquaintance, friend, met, co-resident, spouse, crush, date and sweetheart. Depending upon your application, you may wish to narrow or broaden your scope.

== Determining the object ==

# If the link element is a descendant of an element with <code>class="vcard"</code> which is not the representative hCard for the page, then this hCard is taken to represent the person who is the object of the relationship.
<!-- # If a non-representative hCard exists on the page with a UID property which is identical to the target of the link element, then this hCard is taken to represent the object of the relationship. -->
# In the high-bandwidth situation, parsers {{may}} follow the link target to look for a representative hCard for the object.
#* (Parsers {{may}} then further follow rel="me" links from <nowiki>http://bob.example.net</nowiki> in order to find a "better" representative hCard for Bob.)
# If no hCard representing the object of the relationship has been found, then the object is taken to be a <code>foaf:Person</code> with a <code>foaf:name</code> corresponding to the link text and, depending on the kind of link provided in the <code>href</code> attribute, a <code>foaf:mbox</code> (for "mailto:" links), <code>foaf:mbox_sha1sum</code> (for "urn:sha1:" URLs), <code>foaf:img</code> (image links, determined by <code>type</code> attribute or HTTP headers, not by file name) or <code>foaf:page</code> (all other links). Our example would generate the following triples: <pre><nowiki>:bnode02 a foaf:Person;
         foaf:page &lt;http://bob.example.net&gt;;
         foaf:name "Bob Smith".</nowiki></pre>

A parser which understands RDFa or other semantics may use additional techniques to determine the object of the link, but those are beyond the scope of the Microformats wiki.

(TODO: Add Gabriele Renzi's suggestion here.)

== Example ==

The following example is assumed to have been found at <nowiki>http://alice.example.net</nowiki>. For simplicity's sake, we assume the low-bandwidth situation.

<pre><nowiki>
<html lang="en">
  <title>Alice Jones</title>
  
  <div class="vcard">
    <h1 class="fn">Alice Jones</h1>
    <p class="adr">
      <span class="locality">Sydney</span>, 
      <span class="country-name">Australia</span>.
    </p>
    <p>
      <a href="http://alice.example.com/blog/" rel="me" class="url">
        Alice's Blog
      </a>
    </p>
  </div>
  
  <h2>Friends &amp;amp; Contacts</h2>
  
  <ul>
  
    <li class="vcard">
      <a class="fn url" href="http://bob.example.net" rel="friend met">
        Bob Smith
      </a>
    </li>
  	 
    <li>
      <a href="http://carol.example.net" rel="co-worker met">
        Carol Brown
      </a>
    </li>

    <li>
      <a href="http://dave.example.net" rel="friend neighbor met">
        Dave Wong
      </a>
    </li>

    <li>
      <a href="http://eve.example.net" rel="adversary met">
        Eve Ville
      </a>
    </li>
  	 
  </ul>
  
  <address class="vcard">
    Page maintained by <a href="http://eve.example.net" class="url uid"
    >Eve Ville</a>. Contact <a class="email" href="mailto:eve@example.net"
    >eve@example.net</a> for corrections. (I know I'm not the most trustworthy
    of sources.)
  </address>
  
</html>
</nowiki></pre>

The subject of all the XFN links on the page is the hCard for Alice Jones at the top of the page. This is determined in [[representative-hcard-parsing|step two of the representative hCard parsing procedure]] because it contains <code>rel="me"</code>.

The next XFN link is the one labelled "Bob Smith". Because the link is part of an hCard, the person described by the hCard is the object of the link.

For the next two XFN links, there exist no hCards that represent the objects. We can gather some information about them from the link element itself: their <code>foaf:name</code> and <code>foaf:page</code>. (Note that FOAF defines foaf:name very loosely, so it's OK if the link text is a nickname.)

Although at first glance the XFN link for Eve Ville looks similar, there is in fact an hCard later on in the page with a UID matching the XFN link target, so using rule #2 for determining the object, we use this hCard as the object of the XFN relationship. Note that "adversary" is not an XFN rel value, so is beyond the scope of this document.

=== Possible RDF Output ===

The following is a possible RDF/XML representation of the information in the example above.

<pre><nowiki>
<?xml version="1.0"?>
<rdf:RDF xmlns="http://xmlns.com/foaf/0.1/"
         xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
         xmlns:xfn="http://gmpg.org/xfn/11#"
         xmlns:hcard="urn:ietf:rfc:2426#">

  <!-- Alice -->
  <Person rdf:nodeID="bnode01">
  
    <!-- data from Alice's hCard -->
    <hcard:fn>Alice Jones</hcard:fn>
    <hcard:adr>
      <hcard:locality>Sydney</hcard:locality>
      <hcard:country-name>Australia</hcard:country-name>
    </hcard:adr>
    <hcard:url rdf:resource="http://alice.example.com/blog/" />
    
    <!-- data from Alice's XFN links -->
    <page rdf:resource="http://alice.example.com/blog/" />
    <knows rdf:nodeID="bnode02" />
    <xfn:met rdf:nodeID="bnode02" />
    <xfn:friend rdf:nodeID="bnode02" />
    <knows rdf:nodeID="bnode03" />
    <xfn:met rdf:nodeID="bnode03" />
    <xfn:co-worker rdf:nodeID="bnode03" />
    <knows rdf:nodeID="bnode04" />
    <xfn:met rdf:nodeID="bnode04" />
    <xfn:friend rdf:nodeID="bnode04" />
    <xfn:neighbor rdf:nodeID="bnode04" />
    <knows rdf:nodeID="bnode05" />
    <xfn:met rdf:nodeID="bnode05" />
    
  </Person>
  
  <!-- Bob, data from hCard -->
  <Person rdf:nodeID="bnode02">
    <hcard:fn>Bob Smith</hcard:fn>
    <hcard:url rdf:resource="http://bob.example.net" />
  </Person>
  
  <!-- Carol, implied data -->
  <Person rdf:nodeID="bnode03">
    <name>Carol Brown</name>
    <page rdf:resource="http://carol.example.net" />
  </Person>

  <!-- Dave, implied data -->
  <Person rdf:nodeID="bnode04">
    <name>Dave Wong</name>
    <page rdf:resource="http://dave.example.net" />
  </Person>

  <!-- Eve, data from hCard -->
  <Person rdf:nodeID="bnode05">
    <hcard:fn>Eve Ville</hcard:fn>
    <hcard:url rdf:resource="http://eve.example.net" />
    <hcard:uid rdf:resource="http://eve.example.net" />
    <hcard:email rdf:resource="mailto:eve@example.net" />
  </Person>

</rdf:RDF>
</nowiki></pre>

Note that some personal data for contacts is expressed in the FOAF vocabulary, and some information is expressed in vCard/hCard vocabulary. User agents may use OWL or another technique to draw equivalencies between vocabularies, such as taking <code>hcard:fn</code> to be equivalent to <code>foaf:name</code>.

== Organisation hCards and XFN ==

If either the subject or object hCard represents an organisation (rather than a person), the following relationships are meaningless:

* acquaintance
* friend
* child
* parent
* sibling
* spouse
* kin
* crush
* date
* sweetheart

== Reverse Relationships ==

Explicit reverse relationships may be provided by authors using the <code>rev</code> attribute. These should be interpreted by parsers in exactly the same manner as described above, however subject and object must be swapped.

The [http://gmpg.org/xfn/11 XFN 1.1 profile] explicitly mentions inverses for some XFN relationships, and lists which relationships are symmetric (i.e. their own inverse). For example, as Alice met Bob, it is implied that Bob met Alice. Parsers may use the information in the profile to make explicit the implicit reverse relationships.

== Inspiration, References ==

* [http://microformats.org/discuss/mail/microformats-discuss/2008-March/011760.html Re: XFN is getting smoked by FOAF] - Toby Inkster, 2008-03-11
* [http://microformats.org/discuss/mail/microformats-discuss/2008-March/011772.html Re: XFN + hCard] - Toby Inkster, 2008-03-12
* [http://microformats.org/discuss/mail/microformats-discuss/2008-March/011799.html Re: A (big) problem with XFN: identity of source and target not findable] - Toby Inkster, 2008-03-18
* [http://microformats.org/discuss/mail/microformats-discuss/2008-March/011800.html Re: A (big) problem with XFN: identity of source and target not findable] - David Janes, 2008-03-18
* [http://microformats.org/discuss/mail/microformats-discuss/2008-March/011806.html Re: A (big) problem with XFN: identity of source andtarget not findable] - Toby Inkster, 2008-03-18
* [http://microformats.org/discuss/mail/microformats-discuss/2008-March/011851.html Re: A (big) problem with XFN: identity of source andtarget not findable] - Roger L Costello, 2008-03-20
* [http://microformats.org/discuss/mail/microformats-discuss/2008-April/012010.html Re: Coding mbox_sha1sum in XFN] - Toby Inkster, 2008-04-26

== Related Pages ==

=== XFN ===

{{xfn-related-pages}}

=== Microformats to RDF ===

{{uf-rdf-related-pages}}

=== Other ===

* [http://xen.adactio.com/ XHTML Enemies Network] - spoof of XFN. Can be easily implemented using the same algorithm. Use namespace <code>http://xen.adactio.com/#</code>.
* [[xpn|XHTML Professionals Network]] - proposed extension to XFN to deal with corporate relationships. When/if completed, will probably be implementable using the algorithm on this page.