microformat Wiki & Documentation Rss Feed

UPDATED WIKI: Home

Kinlan — Sun, 16 Sep 2007 14:34:40 GMT

Project Description
The Microformat.net project is a framework to help developers take advantage of the information that is stored as microformats on web pages and XML feeds.

The framework is completly flexible. Each microformat that you want to parse on a web page *you* configure, this means that as and when new microformats are introduced or existing formats are changed you only need to update the configuration file to take advantage of the new information.

This project is at a fairly mature stage at the moment. The framework parses microformats and nested structures. It can be used to parse custom structures in HTML that are not nessicarily a microformat.

Microformats will be parsed using stream readers so to minimise the memory footprint taken to parse microformats.

A MicroformatReader will be provided that allows developers of the framework to use Stream Reader semantics to obtain valid Microformats from an input stream. This offers a excellent level of flexibilty because it allows the input to be from any Stream based datasource. There is no intention to provide a DOM based microformat parser.

Only Microformats specified in the application configuration will be considered when parsing the input stream. Microformat Configuration Documentation.

Release 4

Release 4 is NOW AVAILABLE. There are many more fixes and enhancements to this project... This is a lot more stable than release 3. And it includes an installer so that you don't have to compile the DLL yourself for you to use it in your applications.

UPDATED WIKI: Home

Kinlan — Fri, 14 Sep 2007 20:32:13 GMT

Project Description
The Microformat.net project is a framework to help developers take advantage of the information that is stored as microformats on web pages and XML feeds.

The framework is completly flexible. Each microformat that you want to parse on a web page *you* configure, this means that as and when new microformats are introduced or existing formats are changed you only need to update the configuration file to take advantage of the new information.

This project is at a very early stage at the moment and the code that is released only parses the presence of a microformat and not the internal content.

Microformats will be parsed using stream readers so to minimise the memory footprint taken to parse microformats.

A MicroformatReader will be provided that allows developers of the framework to use Stream Reader semantics to obtain valid Microformats from an input stream. This offers a excellent level of flexibilty because it allows the input to be from any Stream based datasource. There is no intention to provide a DOM based microformat parser.

Only Microformats specified in the application configuration will be considered when parsing the input stream. Microformat Configuration Documentation.

Release 4

UPDATED WIKI: Home

Kinlan — Fri, 14 Sep 2007 20:31:18 GMT

Project Description
The Microformat.net project is a framework to help developers take advantage of the information that is stored as microformats on web pages and XML feeds.

The framework is completly flexible. Each microformat that you want to parse on a web page *you* configure, this means that as and when new microformats are introduced or existing formats are changed you only need to update the configuration file to take advantage of the new information.

This project is at a very early stage at the moment and the code that is released only parses the presence of a microformat and not the internal content.

Microformats will be parsed using stream readers so to minimise the memory footprint taken to parse microformats.

A MicroformatReader will be provided that allows developers of the framework to use Stream Reader semantics to obtain valid Microformats from an input stream. This offers a excellent level of flexibilty because it allows the input to be from any Stream based datasource. There is no intention to provide a DOM based microformat parser.

Only Microformats specified in the application configuration will be considered when parsing the input stream. Microformat Configuration Documentation.

Release 4

Latest Release News

UPDATED WIKI: Home

Kinlan — Fri, 14 Sep 2007 14:56:56 GMT

Project Description
The Microformat.net project is a framework to help developers take advantage of the information that is stored as microformats on web pages and XML feeds.

The framework is completly flexible. Each microformat that you want to parse on a web page *you* configure, this means that as and when new microformats are introduced or existing formats are changed you only need to update the configuration file to take advantage of the new information.

This project is at a very early stage at the moment and the code that is released only parses the presence of a microformat and not the internal content.

Microformats will be parsed using stream readers so to minimise the memory footprint taken to parse microformats.

A MicroformatReader will be provided that allows developers of the framework to use Stream Reader semantics to obtain valid Microformats from an input stream. This offers a excellent level of flexibilty because it allows the input to be from any Stream based datasource. There is no intention to provide a DOM based microformat parser.

Only Microformats specified in the application configuration will be considered when parsing the input stream. Microformat Configuration Documentation.

Release 4

Latest Release News

{rss:url="http://www.codeplex.com/microformat/Project/ProjectRss.aspx?ProjectRSSFeed=codeplex%3a%2f%2frelease%2fmicroformat", max="3"}

UPDATED WIKI: Home

Kinlan — Fri, 14 Sep 2007 14:55:55 GMT

Project Description
The Microformat.net project is a framework to help developers take advantage of the information that is stored as microformats on web pages and XML feeds.

The framework is completly flexible. Each microformat that you want to parse on a web page *you* configure, this means that as and when new microformats are introduced or existing formats are changed you only need to update the configuration file to take advantage of the new information.

This project is at a very early stage at the moment and the code that is released only parses the presence of a microformat and not the internal content.

Microformats will be parsed using stream readers so to minimise the memory footprint taken to parse microformats.

A MicroformatReader will be provided that allows developers of the framework to use Stream Reader semantics to obtain valid Microformats from an input stream. This offers a excellent level of flexibilty because it allows the input to be from any Stream based datasource. There is no intention to provide a DOM based microformat parser.

Only Microformats specified in the application configuration will be considered when parsing the input stream. Microformat Configuration Documentation.

Release 4

Latest Release News

NEWS FEED

CREATED RELEASE: Iteration 4

Sunday, September 09, 2007 | From microformat Release Rss Feed

This is the 4th Iteration of the Microformat.net project.

This release will contain fixes to the current implementation. It will not introduce any more new functionality.

UPDATED RELEASE: Iteration 3 (Sep 07, 2007)

Friday, September 07, 2007 | From microformat Release Rss Feed

! First useable Release
This iteration will be the first proper release of the project. It will let developers using the framework to be able to configure microformats that they want to consume and be able to interact with the entity model once the data is parsed.

This version has only some basic microformats defined in the configuration. A more comprehensive suite will be documented and released shortly.

UPDATED RELEASE: Iteration 3

Friday, September 07, 2007 | From microformat Release Rss Feed

UPDATED RELEASE: Iteration 3

Friday, September 07, 2007 | From microformat Release Rss Feed

This iteration will be the first proper release of the project. It will let developers using the framework to be able to configure microformats that they want to consume and be able to interact with the entity model once the data is parsed.

This version has only some basic microformats defined in the configuration. A more comprehensive suite will be documented and released shortly.

UPDATED RELEASE: Iteration 3

Friday, September 07, 2007 | From microformat Release Rss Feed

UPDATED RELEASE: Iteration 3

Friday, September 07, 2007 | From microformat Release Rss Feed

UPDATED RELEASE: Iteration 2 (Sep 06, 2007)

Thursday, September 06, 2007 | From microformat Release Rss Feed

Iteration 2 will deliver a codebase that has support for the detection of microformats with a basic API in place that will allow developers of the framework to start building applications that will consume microformats.

This iteration will not support data held inside the microformats, yet the framwork should remain static with no breaking changes.

UPDATED RELEASE: Iteration 2 (Sep 06, 2007)

Thursday, September 06, 2007 | From microformat Release Rss Feed

UPDATED RELEASE: Iteration 2

Thursday, September 06, 2007 | From microformat Release Rss Feed

CREATED RELEASE: Iteration 2

Thursday, September 06, 2007 | From microformat Release Rss Feed

RELEASED: Iteration 1 (Aug 30, 2007)

Thursday, August 30, 2007 | From microformat Release Rss Feed

# A basic project structure will be decided, basic guidelines for development will be implemented.
# User stories will be developed.

This Release will contain no code.

UPDATED RELEASE: Iteration 1 (Aug 30, 2007)

Thursday, August 30, 2007 | From microformat Release Rss Feed

# A basic project structure will be decided, basic guidelines for development will be implemented.
# User stories will be developed.

This Release will contain no code.

UPDATED RELEASE: Iteration 1 (Aug 30, 2007)

Thursday, August 30, 2007 | From microformat Release Rss Feed

# A basic project structure will be decided, basic guidelines for development will be implemented.
# User stories will be developed.

This Release will contain no code.

NEWS FEED

UPDATED WIKI: Microformat Configuration

Kinlan — Fri, 14 Sep 2007 09:44:42 GMT

Sample Configuration

  <?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <configSections>
    <section name="MicroformatsSection" type="Microformats.ConfigurationSections.MicroformatConfigSection, Microformat.net, Version=1.0.0.0, Culture=neutral, PublicKeyToken=56e50f59d03f15a7"/>
  </configSections>
  <MicroformatsSection>
    <Microformats>
      <Microformat name="tag" type="rel-tag" rootType="rel" root="tag" dataType="System.Uri" />
      <Microformat name="hCard" type="hCard" rootType="class" root="vcard" dataType="System.String">
        <Fields>
          <Field name="fn" rootType="class" dataType="System.String" plurality="Singular" />
          <Field name="n" rootType="class" dataType="System.String" plurality="Singular" >
            <Fields>
              <Field name="honorific-suffix" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="honorific-prefix" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="given-name" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="family-name" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="additional-name" rootType="class" dataType="System.String" plurality="Singular" />
            </Fields>
          </Field>
          <Field name="tel" rootType="class" dataType="System.String" plurality="Singular" >
            <Fields>
              <Field name="type" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="value" rootType="class" dataType="System.String" plurality="Singular" />              
            </Fields>
          </Field>
          <Field name="bday" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="nickname" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="title" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="role" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="geo" rootType="class" dataType="Microformat" plurality="Singular"/>
          <Field name="org" rootType="class" dataType="System.String" plurality="Singular">
            <Fields>
              <Field name="organization-name" rootType="class" dataType="System.String" plurality="Singular"/>
              <Field name="organization-unit" rootType="class" dataType="System.String" plurality="Singular"/>                        
            </Fields>
          </Field>
          <Field name="url" rootType="class" dataType="System.Uri" plurality="Singular"/>
          <Field name="note" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="uid" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="email" rootType="class" dataType="System.Uri" plurality="Singular"/>
          <Field name="photo" rootType="class" dataType="System.Uri" plurality="Singular"/>
          <Field name="logo" rootType="class" dataType="System.Uri" plurality="Singular"/>
          <Field name="adr" rootType="class" dataType="Microformat" plurality="Plural"/>
        </Fields>
      </Microformat>
      <Microformat name="name" type="adr" rootType="class" root="adr" dataType="System.String">
        <Fields>
          <Field name="type" rootType="class" dataType="System.String" plurality="Plural"/>
          <Field name="post-office-box" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="extended-address" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="street-address" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="locality" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="region" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="postal-code" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="country-name" rootType="class" dataType="System.String" plurality="Singular"/>
        </Fields>
      </Microformat>
      <Microformat name="geo" type="geo" rootType="class" root="geo" dataType="System.String">
        <Fields>
          <Field name="longitude" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="latitude" rootType="class" dataType="System.String" plurality="Singular"/>          
        </Fields>
      </Microformat>
    </Microformats>
  </MicroformatsSection>
</configuration>

Section Configuration

TODO

Microformats Collection Element

The MicroformatCollectionElement is a container of MicroformatElements. Each MicroformatElement contains the definition of the Microformat the you wish to parse.

Microformat Element

The MicroformatElement defines the structure of a Microformat. This configuration is used by the parser so that it can determine the data that it should take from an input stream or Ignore.

The MicroformatElement contains a collection of fields contained by a FieldCollectionElement.

Fields Collection Element

The FieldCollectionElement is a container of FieldElements. Each FieldElement contains the definition of the value data that the framework should parse.

Field Element

The FieldElement defines what data the parser should look for in the input stream. Take the following field declaration as an example <Field name="bday" rootType="class" dataType="System.String" plurality="Singular"/>.

The name attribute is the exact representation of the attibute value that the parser looks for in the input stream (i.e. If an html element is as follows: <li class="bday">03-06-1960</li> the parser will include the data in the associated Microformat).

The rootType attribute defines the attribute that the parser will look for the specified name value on an sgml element ((i.e. If an html element is as follows: <li class="bday">03-06-1960</li> the parser will search the class attibute for the field defined by the name).

The dataType attribute tells the parser how to read the values out of the input stream.
Current dataType values are:

Microformat - defines a nested microformat
System.String - the parser will treat data as a string
System.Uri - the parser will treat data as a Uri

The plurality attribute informs the parser how to treat data.
Warning: specifiying a pluraity of Singular does not yet ignore multiple instances of the field

Nested Elements

Each FieldElement can contain a nested collection of field elements via a FieldCollectionElement. This is exemplified by the "n" element in the hCard definintion:

 <Field name="n" rootType="class" dataType="System.String" plurality="Singular" >
            <Fields>
              <Field name="honorific-suffix" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="honorific-prefix" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="given-name" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="family-name" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="additional-name" rootType="class" dataType="System.String" plurality="Singular" />
            </Fields>
          </Field>

The "n" element says to the parser that all the fields beneath can only be parsed if they are nested underneath the n element in the input stream:
This would parse:

<html>
<body>
<span class="vcard"><span class="fn n"><span class="given-name">Paul</span><span class="family-name">Kinlan</span></span></span>
</body>
<html>

This wont parse:

<html>
<body>
<span class="vcard"><span class="fn n">Paul Kinlan</span><span class="given-name">Paul</span><span class="family-name">Kinlan</span></span>
</body>
<html>

Notice the differences above, in the second example the given-name and family name are outside the "n" elements tree.

Nested Microformats

Each Microformat configuration can point to another configured microformat. A nested microformat must be configured, before it is refernced inside another microformat. For example, take the hCard Microformat, it contains two nested microformats, GEO (Geographic Reference points) and ADR (Address information). They are configured referenced in the hCard as a field with a dataType of "Microformat" (<Field name="adr" rootType="class" dataType="Microformat" plurality="Plural"/>). The framework will reconise that it needs to then find the Microformat called ADR and then resolve all the ADR fields into the hCard format.
Warning: It is possible to create an infinite loop of nested formats, with both Microformats refering to each other.

UPDATED WIKI: Microformat Configuration

Kinlan — Fri, 14 Sep 2007 09:43:53 GMT

Sample Configuration

  <?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <configSections>
    <section name="MicroformatsSection" type="Microformats.ConfigurationSections.MicroformatConfigSection, Microformat.net, Version=1.0.0.0, Culture=neutral, PublicKeyToken=56e50f59d03f15a7"/>
  </configSections>
  <MicroformatsSection>
    <Microformats>
      <Microformat name="tag" type="rel-tag" rootType="rel" root="tag" dataType="System.Uri" />
      <Microformat name="hCard" type="hCard" rootType="class" root="vcard" dataType="System.String">
        <Fields>
          <Field name="fn" rootType="class" dataType="System.String" plurality="Singular" />
          <Field name="n" rootType="class" dataType="System.String" plurality="Singular" >
            <Fields>
              <Field name="honorific-suffix" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="honorific-prefix" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="given-name" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="family-name" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="additional-name" rootType="class" dataType="System.String" plurality="Singular" />
            </Fields>
          </Field>
          <Field name="tel" rootType="class" dataType="System.String" plurality="Singular" >
            <Fields>
              <Field name="type" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="value" rootType="class" dataType="System.String" plurality="Singular" />              
            </Fields>
          </Field>
          <Field name="bday" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="nickname" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="title" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="role" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="geo" rootType="class" dataType="Microformat" plurality="Singular"/>
          <Field name="org" rootType="class" dataType="System.String" plurality="Singular">
            <Fields>
              <Field name="organization-name" rootType="class" dataType="System.String" plurality="Singular"/>
              <Field name="organization-unit" rootType="class" dataType="System.String" plurality="Singular"/>                        
            </Fields>
          </Field>
          <Field name="url" rootType="class" dataType="System.Uri" plurality="Singular"/>
          <Field name="note" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="uid" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="email" rootType="class" dataType="System.Uri" plurality="Singular"/>
          <Field name="photo" rootType="class" dataType="System.Uri" plurality="Singular"/>
          <Field name="logo" rootType="class" dataType="System.Uri" plurality="Singular"/>
          <Field name="adr" rootType="class" dataType="Microformat" plurality="Plural"/>
        </Fields>
      </Microformat>
      <Microformat name="name" type="adr" rootType="class" root="adr" dataType="System.String">
        <Fields>
          <Field name="type" rootType="class" dataType="System.String" plurality="Plural"/>
          <Field name="post-office-box" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="extended-address" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="street-address" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="locality" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="region" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="postal-code" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="country-name" rootType="class" dataType="System.String" plurality="Singular"/>
        </Fields>
      </Microformat>
      <Microformat name="geo" type="geo" rootType="class" root="geo" dataType="System.String">
        <Fields>
          <Field name="longitude" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="latitude" rootType="class" dataType="System.String" plurality="Singular"/>          
        </Fields>
      </Microformat>
    </Microformats>
  </MicroformatsSection>
</configuration>

Section Configuration

TODO

Microformats Collection Element

The MicroformatCollectionElement is a container of MicroformatElements. Each MicroformatElement contains the definition of the Microformat the you wish to parse.

Microformat Element

Fields Collection Element

The FieldCollectionElement is a container of FieldElements. Each FieldElement contains the definition of the value data that the framework should parse.

Field Element

Microformat - defines a nested microformat
System.String - the parser will treat data as a string
System.Uri - the parser will treat data as a Uri

The plurality attribute informs the parser how to treat data.
Warning: specifiying a pluraity of Singular does not yet ignore multiple instances of the field

Nested Elements

Each FieldElement can contain a nested collection of field elements via a FieldCollectionElement. This is exemplified by the "n" element in the hCard definintion {{<Field name="n" rootType="class" dataType="System.String" plurality="Singular" >
<Fields>
<Field name="honorific-suffix" rootType="class" dataType="System.String" plurality="Singular" />
<Field name="honorific-prefix" rootType="class" dataType="System.String" plurality="Singular" />
<Field name="given-name" rootType="class" dataType="System.String" plurality="Singular" />
<Field name="family-name" rootType="class" dataType="System.String" plurality="Singular" />
<Field name="additional-name" rootType="class" dataType="System.String" plurality="Singular" />
</Fields>
</Field>
}}
The "n" element says to the parser that all the fields beneath can only be parsed if they are nested underneath the n element in the input stream:
This would parse:

<html>
<body>
<span class="vcard"><span class="fn n"><span class="given-name">Paul</span><span class="family-name">Kinlan</span></span></span>
</body>
<html>

This wont parse:

<html>
<body>
<span class="vcard"><span class="fn n">Paul Kinlan</span><span class="given-name">Paul</span><span class="family-name">Kinlan</span></span>
</body>
<html>

Notice the differences above, in the second example the given-name and family name are outside the "n" elements tree.

Nested Microformats

UPDATED WIKI: Microformat Configuration

Kinlan — Fri, 14 Sep 2007 09:41:15 GMT

Sample Configuration

  <?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <configSections>
    <section name="MicroformatsSection" type="Microformats.ConfigurationSections.MicroformatConfigSection, Microformat.net, Version=1.0.0.0, Culture=neutral, PublicKeyToken=56e50f59d03f15a7"/>
  </configSections>
  <MicroformatsSection>
    <Microformats>
      <Microformat name="tag" type="rel-tag" rootType="rel" root="tag" dataType="System.Uri" />
      <Microformat name="hCard" type="hCard" rootType="class" root="vcard" dataType="System.String">
        <Fields>
          <Field name="fn" rootType="class" dataType="System.String" plurality="Singular" />
          <Field name="n" rootType="class" dataType="System.String" plurality="Singular" >
            <Fields>
              <Field name="honorific-suffix" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="honorific-prefix" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="given-name" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="family-name" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="additional-name" rootType="class" dataType="System.String" plurality="Singular" />
            </Fields>
          </Field>
          <Field name="tel" rootType="class" dataType="System.String" plurality="Singular" >
            <Fields>
              <Field name="type" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="value" rootType="class" dataType="System.String" plurality="Singular" />              
            </Fields>
          </Field>
          <Field name="bday" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="nickname" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="title" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="role" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="geo" rootType="class" dataType="Microformat" plurality="Singular"/>
          <Field name="org" rootType="class" dataType="System.String" plurality="Singular">
            <Fields>
              <Field name="organization-name" rootType="class" dataType="System.String" plurality="Singular"/>
              <Field name="organization-unit" rootType="class" dataType="System.String" plurality="Singular"/>                        
            </Fields>
          </Field>
          <Field name="url" rootType="class" dataType="System.Uri" plurality="Singular"/>
          <Field name="note" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="uid" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="email" rootType="class" dataType="System.Uri" plurality="Singular"/>
          <Field name="photo" rootType="class" dataType="System.Uri" plurality="Singular"/>
          <Field name="logo" rootType="class" dataType="System.Uri" plurality="Singular"/>
          <Field name="adr" rootType="class" dataType="Microformat" plurality="Plural"/>
        </Fields>
      </Microformat>
      <Microformat name="name" type="adr" rootType="class" root="adr" dataType="System.String">
        <Fields>
          <Field name="type" rootType="class" dataType="System.String" plurality="Plural"/>
          <Field name="post-office-box" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="extended-address" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="street-address" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="locality" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="region" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="postal-code" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="country-name" rootType="class" dataType="System.String" plurality="Singular"/>
        </Fields>
      </Microformat>
      <Microformat name="geo" type="geo" rootType="class" root="geo" dataType="System.String">
        <Fields>
          <Field name="longitude" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="latitude" rootType="class" dataType="System.String" plurality="Singular"/>          
        </Fields>
      </Microformat>
    </Microformats>
  </MicroformatsSection>
</configuration>

Section Configuration

TODO

Microformats Collection Element

The MicroformatCollectionElement is a container of MicroformatElements. Each MicroformatElement contains the definition of the Microformat the you wish to parse.

Microformat Element

Fields Collection Element

The FieldCollectionElement is a container of FieldElements. Each FieldElement contains the definition of the value data that the framework should parse.

Field Element

Microformat - defines a nested microformat
System.String - the parser will treat data as a string
System.Uri - the parser will treat data as a Uri

The plurality attribute informs the parser how to treat data.
Warning: specifiying a pluraity of Singular does not yet ignore multiple instances of the field

Each FieldElement can contain a nested collection of field elements via a FieldCollectionElement. This is exemplified by the "n" element in the hCard definintion {{<Field name="n" rootType="class" dataType="System.String" plurality="Singular" >
<Fields>
<Field name="honorific-suffix" rootType="class" dataType="System.String" plurality="Singular" />
<Field name="honorific-prefix" rootType="class" dataType="System.String" plurality="Singular" />
<Field name="given-name" rootType="class" dataType="System.String" plurality="Singular" />
<Field name="family-name" rootType="class" dataType="System.String" plurality="Singular" />
<Field name="additional-name" rootType="class" dataType="System.String" plurality="Singular" />
</Fields>
</Field>
}}
The "n" element says to the parser that all the fields beneath can only be parsed if they are nested underneath the n element in the input stream:
This would parse:

<html>
<body>
<span class="vcard"><span class="fn n"><span class="given-name">Paul</span><span class="family-name">Kinlan</span></span></span>
</body>
<html>

This wont parse:

<html>
<body>
<span class="vcard"><span class="fn n">Paul Kinlan</span><span class="given-name">Paul</span><span class="family-name">Kinlan</span></span>
</body>
<html>

Notice the differences above, in the second example the given-name and family name are outside the "n" elements tree,

Nested Microformats

UPDATED WIKI: Microformat Configuration

Kinlan — Fri, 14 Sep 2007 09:21:23 GMT

Sample Configuration

  <?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <configSections>
    <section name="MicroformatsSection" type="Microformats.ConfigurationSections.MicroformatConfigSection, Microformat.net, Version=1.0.0.0, Culture=neutral, PublicKeyToken=56e50f59d03f15a7"/>
  </configSections>
  <MicroformatsSection>
    <Microformats>
      <Microformat name="tag" type="rel-tag" rootType="rel" root="tag" dataType="System.Uri" />
      <Microformat name="hCard" type="hCard" rootType="class" root="vcard" dataType="System.String">
        <Fields>
          <Field name="fn" rootType="class" dataType="System.String" plurality="Singular" />
          <Field name="n" rootType="class" dataType="System.String" plurality="Singular" >
            <Fields>
              <Field name="honorific-suffix" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="honorific-prefix" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="given-name" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="family-name" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="additional-name" rootType="class" dataType="System.String" plurality="Singular" />
            </Fields>
          </Field>
          <Field name="tel" rootType="class" dataType="System.String" plurality="Singular" >
            <Fields>
              <Field name="type" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="value" rootType="class" dataType="System.String" plurality="Singular" />              
            </Fields>
          </Field>
          <Field name="bday" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="nickname" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="title" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="role" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="geo" rootType="class" dataType="Microformat" plurality="Singular"/>
          <Field name="org" rootType="class" dataType="System.String" plurality="Singular">
            <Fields>
              <Field name="organization-name" rootType="class" dataType="System.String" plurality="Singular"/>
              <Field name="organization-unit" rootType="class" dataType="System.String" plurality="Singular"/>                        
            </Fields>
          </Field>
          <Field name="url" rootType="class" dataType="System.Uri" plurality="Singular"/>
          <Field name="note" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="uid" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="email" rootType="class" dataType="System.Uri" plurality="Singular"/>
          <Field name="photo" rootType="class" dataType="System.Uri" plurality="Singular"/>
          <Field name="logo" rootType="class" dataType="System.Uri" plurality="Singular"/>
          <Field name="adr" rootType="class" dataType="Microformat" plurality="Plural"/>
        </Fields>
      </Microformat>
      <Microformat name="name" type="adr" rootType="class" root="adr" dataType="System.String">
        <Fields>
          <Field name="type" rootType="class" dataType="System.String" plurality="Plural"/>
          <Field name="post-office-box" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="extended-address" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="street-address" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="locality" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="region" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="postal-code" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="country-name" rootType="class" dataType="System.String" plurality="Singular"/>
        </Fields>
      </Microformat>
      <Microformat name="geo" type="geo" rootType="class" root="geo" dataType="System.String">
        <Fields>
          <Field name="longitude" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="latitude" rootType="class" dataType="System.String" plurality="Singular"/>          
        </Fields>
      </Microformat>
    </Microformats>
  </MicroformatsSection>
</configuration>

Section Configuration

TODO

Microformats Collection Element

The MicroformatCollectionElement is a container of MicroformatElements. Each MicroformatElement contains the definition of the Microformat the you wish to parse.

Microformat Element

TODO

Fields Collection Element

TODO

Field Element

Microformat - defines a nested microformat
System.String - the parser will treat data as a string
System.Uri - the parser will treat data as a Uri

The plurality attribute informs the parser how to treat data.
Warning: specifiying a pluraity of Singular does not yet ignore multiple instances of the field

Nested Microformats

UPDATED WIKI: Microformat Configuration

Kinlan — Fri, 14 Sep 2007 09:15:47 GMT

Sample Configuration

  <?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <configSections>
    <section name="MicroformatsSection" type="Microformats.ConfigurationSections.MicroformatConfigSection, Microformat.net, Version=1.0.0.0, Culture=neutral, PublicKeyToken=56e50f59d03f15a7"/>
  </configSections>
  <MicroformatsSection>
    <Microformats>
      <Microformat name="tag" type="rel-tag" rootType="rel" root="tag" dataType="System.Uri" />
      <Microformat name="hCard" type="hCard" rootType="class" root="vcard" dataType="System.String">
        <Fields>
          <Field name="fn" rootType="class" dataType="System.String" plurality="Singular" />
          <Field name="n" rootType="class" dataType="System.String" plurality="Singular" >
            <Fields>
              <Field name="honorific-suffix" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="honorific-prefix" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="given-name" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="family-name" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="additional-name" rootType="class" dataType="System.String" plurality="Singular" />
            </Fields>
          </Field>
          <Field name="tel" rootType="class" dataType="System.String" plurality="Singular" >
            <Fields>
              <Field name="type" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="value" rootType="class" dataType="System.String" plurality="Singular" />              
            </Fields>
          </Field>
          <Field name="bday" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="nickname" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="title" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="role" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="geo" rootType="class" dataType="Microformat" plurality="Singular"/>
          <Field name="org" rootType="class" dataType="System.String" plurality="Singular">
            <Fields>
              <Field name="organization-name" rootType="class" dataType="System.String" plurality="Singular"/>
              <Field name="organization-unit" rootType="class" dataType="System.String" plurality="Singular"/>                        
            </Fields>
          </Field>
          <Field name="url" rootType="class" dataType="System.Uri" plurality="Singular"/>
          <Field name="note" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="uid" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="email" rootType="class" dataType="System.Uri" plurality="Singular"/>
          <Field name="photo" rootType="class" dataType="System.Uri" plurality="Singular"/>
          <Field name="logo" rootType="class" dataType="System.Uri" plurality="Singular"/>
          <Field name="adr" rootType="class" dataType="Microformat" plurality="Plural"/>
        </Fields>
      </Microformat>
      <Microformat name="name" type="adr" rootType="class" root="adr" dataType="System.String">
        <Fields>
          <Field name="type" rootType="class" dataType="System.String" plurality="Plural"/>
          <Field name="post-office-box" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="extended-address" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="street-address" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="locality" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="region" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="postal-code" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="country-name" rootType="class" dataType="System.String" plurality="Singular"/>
        </Fields>
      </Microformat>
      <Microformat name="geo" type="geo" rootType="class" root="geo" dataType="System.String">
        <Fields>
          <Field name="longitude" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="latitude" rootType="class" dataType="System.String" plurality="Singular"/>          
        </Fields>
      </Microformat>
    </Microformats>
  </MicroformatsSection>
</configuration>

Section Configuration

TODO

Microformats Collection Element

The MicroformatCollectionElement is a container of MicroformatElements. Each MicroformatElement contains the definition of the Microformat the you wish to parse.

Microformat Element

TODO

Fields Collection Element

TODO

Field Element

The FieldElement defines what data the parser should look for in the input stream. Take the following field declaration as an example <Field name="bday" rootType="class" dataType="System.String" plurality="Singular"/>. The name attribute is the exact representation of the attibute value that the parser looks for in the input stream (i.e. If an html element is as follows: <li class="bday">03-06-1960</li> the parser will include the data in the associated Microformat). The rootType attribute defines the attribute that the parser will look for the specified name value on an sgml element ((i.e. If an html element is as follows: <li class="bday">03-06-1960</li> the parser will include the data in the associated Microformat).
Warning: specifiying a pluraity of Singular does not yet ignore multiple instances of the field

Nested Microformats

UPDATED WIKI: Microformat Configuration

Kinlan — Fri, 14 Sep 2007 09:09:20 GMT

Sample Configuration

  <?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <configSections>
    <section name="MicroformatsSection" type="Microformats.ConfigurationSections.MicroformatConfigSection, Microformat.net, Version=1.0.0.0, Culture=neutral, PublicKeyToken=56e50f59d03f15a7"/>
  </configSections>
  <MicroformatsSection>
    <Microformats>
      <Microformat name="tag" type="rel-tag" rootType="rel" root="tag" dataType="System.Uri" />
      <Microformat name="hCard" type="hCard" rootType="class" root="vcard" dataType="System.String">
        <Fields>
          <Field name="fn" rootType="class" dataType="System.String" plurality="Singular" />
          <Field name="n" rootType="class" dataType="System.String" plurality="Singular" >
            <Fields>
              <Field name="honorific-suffix" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="honorific-prefix" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="given-name" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="family-name" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="additional-name" rootType="class" dataType="System.String" plurality="Singular" />
            </Fields>
          </Field>
          <Field name="tel" rootType="class" dataType="System.String" plurality="Singular" >
            <Fields>
              <Field name="type" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="value" rootType="class" dataType="System.String" plurality="Singular" />              
            </Fields>
          </Field>
          <Field name="bday" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="nickname" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="title" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="role" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="geo" rootType="class" dataType="Microformat" plurality="Singular"/>
          <Field name="org" rootType="class" dataType="System.String" plurality="Singular">
            <Fields>
              <Field name="organization-name" rootType="class" dataType="System.String" plurality="Singular"/>
              <Field name="organization-unit" rootType="class" dataType="System.String" plurality="Singular"/>                        
            </Fields>
          </Field>
          <Field name="url" rootType="class" dataType="System.Uri" plurality="Singular"/>
          <Field name="note" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="uid" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="email" rootType="class" dataType="System.Uri" plurality="Singular"/>
          <Field name="photo" rootType="class" dataType="System.Uri" plurality="Singular"/>
          <Field name="logo" rootType="class" dataType="System.Uri" plurality="Singular"/>
          <Field name="adr" rootType="class" dataType="Microformat" plurality="Plural"/>
        </Fields>
      </Microformat>
      <Microformat name="name" type="adr" rootType="class" root="adr" dataType="System.String">
        <Fields>
          <Field name="type" rootType="class" dataType="System.String" plurality="Plural"/>
          <Field name="post-office-box" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="extended-address" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="street-address" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="locality" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="region" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="postal-code" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="country-name" rootType="class" dataType="System.String" plurality="Singular"/>
        </Fields>
      </Microformat>
      <Microformat name="geo" type="geo" rootType="class" root="geo" dataType="System.String">
        <Fields>
          <Field name="longitude" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="latitude" rootType="class" dataType="System.String" plurality="Singular"/>          
        </Fields>
      </Microformat>
    </Microformats>
  </MicroformatsSection>
</configuration>

Section Configuration

TODO

Microformats Collection Element

The MicroformatCollectionElement is a container of MicroformatElements. Each MicroformatElement contains the definition of the Microformat the you wish to parse.

Microformat Element

TODO

Fields Collection Element

TODO

Field Element

TODO

Nested Microformats

UPDATED WIKI: Microformat Configuration

Kinlan — Fri, 14 Sep 2007 09:05:24 GMT

Sample Configuration

  <?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <configSections>
    <section name="MicroformatsSection" type="Microformats.ConfigurationSections.MicroformatConfigSection, Microformat.net, Version=1.0.0.0, Culture=neutral, PublicKeyToken=56e50f59d03f15a7"/>
  </configSections>
  <MicroformatsSection>
    <Microformats>
      <Microformat name="tag" type="rel-tag" rootType="rel" root="tag" dataType="System.Uri" />
      <Microformat name="hCard" type="hCard" rootType="class" root="vcard" dataType="System.String">
        <Fields>
          <Field name="fn" rootType="class" dataType="System.String" plurality="Singular" />
          <Field name="n" rootType="class" dataType="System.String" plurality="Singular" >
            <Fields>
              <Field name="honorific-suffix" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="honorific-prefix" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="given-name" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="family-name" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="additional-name" rootType="class" dataType="System.String" plurality="Singular" />
            </Fields>
          </Field>
          <Field name="tel" rootType="class" dataType="System.String" plurality="Singular" >
            <Fields>
              <Field name="type" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="value" rootType="class" dataType="System.String" plurality="Singular" />              
            </Fields>
          </Field>
          <Field name="bday" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="nickname" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="title" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="role" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="geo" rootType="class" dataType="Microformat" plurality="Singular"/>
          <Field name="org" rootType="class" dataType="System.String" plurality="Singular">
            <Fields>
              <Field name="organization-name" rootType="class" dataType="System.String" plurality="Singular"/>
              <Field name="organization-unit" rootType="class" dataType="System.String" plurality="Singular"/>                        
            </Fields>
          </Field>
          <Field name="url" rootType="class" dataType="System.Uri" plurality="Singular"/>
          <Field name="note" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="uid" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="email" rootType="class" dataType="System.Uri" plurality="Singular"/>
          <Field name="photo" rootType="class" dataType="System.Uri" plurality="Singular"/>
          <Field name="logo" rootType="class" dataType="System.Uri" plurality="Singular"/>
          <Field name="adr" rootType="class" dataType="Microformat" plurality="Plural"/>
        </Fields>
      </Microformat>
      <Microformat name="name" type="adr" rootType="class" root="adr" dataType="System.String">
        <Fields>
          <Field name="type" rootType="class" dataType="System.String" plurality="Plural"/>
          <Field name="post-office-box" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="extended-address" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="street-address" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="locality" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="region" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="postal-code" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="country-name" rootType="class" dataType="System.String" plurality="Singular"/>
        </Fields>
      </Microformat>
      <Microformat name="geo" type="geo" rootType="class" root="geo" dataType="System.String">
        <Fields>
          <Field name="longitude" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="latitude" rootType="class" dataType="System.String" plurality="Singular"/>          
        </Fields>
      </Microformat>
    </Microformats>
  </MicroformatsSection>
</configuration>

Section Configuration

TODO

Microformats Collection Element

The MicroformatCollectionElement is a container of MicroformatElements. Each MicroformatElement contains the definition of the Microformat the you wish to parse.

Microformat Element

TODO

Fields Collection Element

TODO

Field Element

TODO

!!Nested Microformats
Each Microformat configuration can point to another configured microformat. A nested microformat must be configured, before it is refernced inside another microformat. For example, take the hCard Microformat, it contains two nested microformats, GEO (Geographic Reference points) and ADR (Address information). They are configured referenced in the hCard as a field with a dataType of "Microformat" (<Field name="adr" rootType="class" dataType="Microformat" plurality="Plural"/>)

UPDATED WIKI: Microformat Configuration

Kinlan — Fri, 14 Sep 2007 09:00:32 GMT

Sample Configuration

  <?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <configSections>
    <section name="MicroformatsSection" type="Microformats.ConfigurationSections.MicroformatConfigSection, Microformat.net, Version=1.0.0.0, Culture=neutral, PublicKeyToken=56e50f59d03f15a7"/>
  </configSections>
  <MicroformatsSection>
    <Microformats>
      <Microformat name="tag" type="rel-tag" rootType="rel" root="tag" dataType="System.Uri" />
      <Microformat name="hCard" type="hCard" rootType="class" root="vcard" dataType="System.String">
        <Fields>
          <Field name="fn" rootType="class" dataType="System.String" plurality="Singular" />
          <Field name="n" rootType="class" dataType="System.String" plurality="Singular" >
            <Fields>
              <Field name="honorific-suffix" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="honorific-prefix" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="given-name" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="family-name" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="additional-name" rootType="class" dataType="System.String" plurality="Singular" />
            </Fields>
          </Field>
          <Field name="tel" rootType="class" dataType="System.String" plurality="Singular" >
            <Fields>
              <Field name="type" rootType="class" dataType="System.String" plurality="Singular" />
              <Field name="value" rootType="class" dataType="System.String" plurality="Singular" />              
            </Fields>
          </Field>
          <Field name="bday" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="nickname" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="title" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="role" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="geo" rootType="class" dataType="Microformat" plurality="Singular"/>
          <Field name="org" rootType="class" dataType="System.String" plurality="Singular">
            <Fields>
              <Field name="organization-name" rootType="class" dataType="System.String" plurality="Singular"/>
              <Field name="organization-unit" rootType="class" dataType="System.String" plurality="Singular"/>                        
            </Fields>
          </Field>
          <Field name="url" rootType="class" dataType="System.Uri" plurality="Singular"/>
          <Field name="note" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="uid" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="email" rootType="class" dataType="System.Uri" plurality="Singular"/>
          <Field name="photo" rootType="class" dataType="System.Uri" plurality="Singular"/>
          <Field name="logo" rootType="class" dataType="System.Uri" plurality="Singular"/>
          <Field name="adr" rootType="class" dataType="Microformat" plurality="Plural"/>
        </Fields>
      </Microformat>
      <Microformat name="name" type="adr" rootType="class" root="adr" dataType="System.String">
        <Fields>
          <Field name="type" rootType="class" dataType="System.String" plurality="Plural"/>
          <Field name="post-office-box" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="extended-address" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="street-address" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="locality" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="region" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="postal-code" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="country-name" rootType="class" dataType="System.String" plurality="Singular"/>
        </Fields>
      </Microformat>
      <Microformat name="geo" type="geo" rootType="class" root="geo" dataType="System.String">
        <Fields>
          <Field name="longitude" rootType="class" dataType="System.String" plurality="Singular"/>
          <Field name="latitude" rootType="class" dataType="System.String" plurality="Singular"/>          
        </Fields>
      </Microformat>
    </Microformats>
  </MicroformatsSection>
</configuration>

Section Configuration

TODO

Microformats Collection Element

The MicroformatCollectionElement is a container of MicroformatElements. Each MicroformatElement contains the definition of the Microformat the you wish to parse.

Microformat Element

TODO

Fields Collection Element

TODO

Field Element

TODO

UPDATED WIKI: Home

Kinlan — Fri, 14 Sep 2007 08:56:47 GMT

Project Description
A project to help developers take advantage of microformat information stored on web pages.

It is intended that this project be able to parse XHTML and return the data as business objects. The formats will be flexibly designed at the config level so as and when new formats or changes to existing formats occur the framework will no changes.

This project is at a very early stage at the moment and the code that is released only parses the presence of a microformat and not the internal content.

Microformats will be parsed using stream readers so to minimise the memory footprint taken to parse microformats.

A MicroformatReader will be provided that allows developers of the framework to use Stream Reader semantics to obtain valid Microformats from an input stream. This offers a excellent level of flexibilty because it allows the input to be from any Stream based datasource. There is no intention to provide a DOM based microformat parser.

Only Microformats specified in the application configuration will be considered when parsing the input stream. Microformat Configuration Documentation.

Release 4

UPDATED WIKI: Home

Kinlan — Fri, 14 Sep 2007 08:54:59 GMT

Release 4

Cannot resolve link: [release:6975 Release 4] is NOW AVAILABLE. There are many more fixes and enhancements to this project... This is a lot more stable than release 3. And it includes an installer so that you don't have to compile the DLL yourself for you to use it in your applications.

UPDATED WIKI: Home

Kinlan — Thu, 13 Sep 2007 15:42:46 GMT

Release 4

Release 4 is due soon. There are many more fixes and enhancements to this project... Hold on tight, this is a lot more stable than release 3. And it includes an installer so that you don't have to compile the DLL yourself.

UPDATED WIKI: Home

Kinlan — Thu, 13 Sep 2007 15:41:40 GMT

Release 4

Release 4 is due soon. There are many more fixes and enhancements to this project... Hold on tight, this is a lot more stable than release 3.

UPDATED WIKI: Microformat Configuration

Kinlan — Fri, 07 Sep 2007 20:35:51 GMT

Sample Configuration

  <configSections>
    <section name="MicroformatsSection" type="Microformats.ConfigurationSections.MicroformatConfigSection, Microformat.net"/>
  </configSections>
  <MicroformatsSection>
    <Microformats>
      <Microformat type="rel-tag" rootType="rel" root="tag" dataType="System.Uri" />
      <Microformat type="hCard" rootType="class" root="vcard" dataType="System.String">
        <Fields>
          <Field name="fn" dataType="System.String" plurality="Singular"/>
          <Field name="url" dataType="System.Uri" plurality="Singular"/>
          <Field name="email" dataType="System.Uri" plurality="Singular"/>
          <Field name="adr" dataType="Microformat" plurality="Singular"/>
        </Fields>
      </Microformat>
      <Microformat type="adr" rootType="class" root="adr" dataType="System.String">
        <Fields>
          <Field name="post-office-box" dataType="System.String" plurality="Singular"/>
          <Field name="extended-address" dataType="System.String" plurality="Singular"/>
          <Field name="street-address" dataType="System.String" plurality="Singular"/>
          <Field name="locality" dataType="System.String" plurality="Singular"/>
          <Field name="region" dataType="System.String" plurality="Singular"/>
          <Field name="postal-code" dataType="System.String" plurality="Singular"/>
          <Field name="country-name" dataType="System.String" plurality="Singular"/>
        </Fields>
      </Microformat>
    </Microformats>
  </MicroformatsSection>

Section Configuration

TODO

Microformats Collection Element

The MicroformatCollectionElement is a container of MicroformatElements. Each MicroformatElement contains the definition of the Microformat the you wish to parse.

Microformat Element

TODO

Fields Collection Element

TODO

Field Element

TODO

UPDATED WIKI: Microformat Configuration

Kinlan — Fri, 07 Sep 2007 20:30:27 GMT

Sample Configuration

  <configSections>
    <section name="MicroformatsSection" type="Microformats.ConfigurationSections.MicroformatConfigSection, Microformat.net"/>
  </configSections>
  <MicroformatsSection>
    <Microformats>
      <Microformat type="rel-tag" rootType="rel" root="tag" dataType="System.Uri" />
      <Microformat type="hCard" rootType="class" root="vcard" dataType="System.String">
        <Fields>
          <Field name="fn" dataType="System.String" plurality="Singular"/>
          <Field name="url" dataType="System.Uri" plurality="Singular"/>
          <Field name="email" dataType="System.Uri" plurality="Singular"/>
          <Field name="adr" dataType="Microformat" plurality="Singular"/>
        </Fields>
      </Microformat>
      <Microformat type="adr" rootType="class" root="adr" dataType="System.String">
        <Fields>
          <Field name="post-office-box" dataType="System.String" plurality="Singular"/>
          <Field name="extended-address" dataType="System.String" plurality="Singular"/>
          <Field name="street-address" dataType="System.String" plurality="Singular"/>
          <Field name="locality" dataType="System.String" plurality="Singular"/>
          <Field name="region" dataType="System.String" plurality="Singular"/>
          <Field name="postal-code" dataType="System.String" plurality="Singular"/>
          <Field name="country-name" dataType="System.String" plurality="Singular"/>
        </Fields>
      </Microformat>
    </Microformats>
  </MicroformatsSection>

Section Configuration

TODO

Microformats Collection Element

TODO

Microformat Element

TODO

Fields Collection Element

TODO

Field Element

TODO

UPDATED WIKI: Microformat Configuration

Kinlan — Fri, 07 Sep 2007 20:29:59 GMT

Sample Configuration

  <configSections>
    <section name="MicroformatsSection" type="Microformats.ConfigurationSections.MicroformatConfigSection, Microformat.net"/>
  </configSections>
  <MicroformatsSection>
    <Microformats>
      <Microformat type="rel-tag" rootType="rel" root="tag" dataType="System.Uri" />
      <Microformat type="hCard" rootType="class" root="vcard" dataType="System.String">
        <Fields>
          <Field name="fn" dataType="System.String" plurality="Singular"/>
          <Field name="url" dataType="System.Uri" plurality="Singular"/>
          <Field name="email" dataType="System.Uri" plurality="Singular"/>
          <Field name="adr" dataType="Microformat" plurality="Singular"/>
        </Fields>
      </Microformat>
      <Microformat type="adr" rootType="class" root="adr" dataType="System.String">
        <Fields>
          <Field name="post-office-box" dataType="System.String" plurality="Singular"/>
          <Field name="extended-address" dataType="System.String" plurality="Singular"/>
          <Field name="street-address" dataType="System.String" plurality="Singular"/>
          <Field name="locality" dataType="System.String" plurality="Singular"/>
          <Field name="region" dataType="System.String" plurality="Singular"/>
          <Field name="postal-code" dataType="System.String" plurality="Singular"/>
          <Field name="country-name" dataType="System.String" plurality="Singular"/>
        </Fields>
      </Microformat>
    </Microformats>
  </MicroformatsSection>

Microformats Collection Element

TODO

Microformat Element

TODO

Fields Collection Element

TODO

Field Element

TODO