From Microformats Wiki
Jump to navigation Jump to search

Parsing Microformats

Microformat parsing mechanisms that depend on documents having even minimal xml properties like well-formedness may fail when consuming non-well-formed content. Tidy or even better CyberNeko may be a useful work around. In particular X2V uses XSLT, and tidy to clean any non-well-formed input before processing it.

Parsing class values

When parsing class values care must be taken:

  1. Class attributes may contain multiple class names separated by whitespace, e.g: class="foo vcard bar"
  2. Class attributes may contain class names which contain the class name used by a microformat, e.g: class="foovcardbar" class="foovcard", class="vcardbar" - none of which are hCards.
  3. Multiple class names can be separated by one or more whitespace characters.
  4. Class names are case sensitive. microformats class names are always all lowercase (per Naming Principles and naming-conventions).


JavaScript example

The Ultimate getElementsByClassName JavaScript function may be useful. Then you can do:

var adrs = document.getElementsByClassName(document, "*", "adr");

or even:

var cities = document.getElementsByClassName(document, "*", "locality");

XSLT example

<xsl:if test="contains(
   concat (' ', normalize-space(@class),' '),
   ' vcard '
   )" > ...

JavaScript can also perform XSLT natively in browsers like Firefox. See Firefox extensions for performing XSL transformations in Firefox without JavaScript.

XQuery example

Also using XPath...

<div style="background-color:yellow;">
  for $a in doc()//div[@class='vcard']
  let $b := $a/div[@class='fn org' or @class='org fn']
  let $c := $a/div[@class='adr']
  return ($b, $c, <br />)

For example, this could be used against See Firefox extensions for getting XQuery in Firefox.

Note that the 'class' tests above should really use the more complicated XPath expression used within the XSLT example (in order to allow for other classes to be used on the element, variations in whitespace, etc.), but it is simplified above for demonstration purposes.

Simple XPath expressions can also be used, as these are considered to be valid XQueries.

Parsing rel/rev values

Parsing rel and rev values is similar to parsing class values except for the following differences:

  1. rel and rev values should be separated by one space.
  2. rel and rev values are case insensitive.


See Also