mfo-examples: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
(Describe current hAtom experience)
m (→‎The Problem: Fixed wiki syntax)
Line 11: Line 11:
Both recent discussions around hAtom, and earlier discussions from June of 2005 have indicated that there may be a need for a generic microformat to indicate that a specific element is a wrapper, container, or layer of abstraction, that should be opaque to something parsing the microformats that may be further up the hierarchy.
Both recent discussions around hAtom, and earlier discussions from June of 2005 have indicated that there may be a need for a generic microformat to indicate that a specific element is a wrapper, container, or layer of abstraction, that should be opaque to something parsing the microformats that may be further up the hierarchy.


E.g. you might put a <code>&lt;span class="vcard mfo"&gt; deep inside a &lt;span class="vevent"&gt;, and not want the categories/tags of the [[hcard|hCard]] accidentally parsed into the hCalendar event.
E.g. you might put a <code>&lt;span class="vcard mfo"&gt;</code> deep inside a <code>&lt;span class="vevent"&gt;</code>, and not want the categories/tags of the [[hcard|hCard]] accidentally parsed into the hCalendar event.


Note: the use of "mfo" is only for the purpose of illustration is by no means a proposed name for this microformat.  We expect research/discussion to reveal a much better name.  We use "mfo" only as a temporary name for the sake of discussion and example illustration.  We may even want to commit to deliberately using a class name different from "mfo" just to make this clear in the end.
Note: the use of "mfo" is only for the purpose of illustration is by no means a proposed name for this microformat.  We expect research/discussion to reveal a much better name.  We use "mfo" only as a temporary name for the sake of discussion and example illustration.  We may even want to commit to deliberately using a class name different from "mfo" just to make this clear in the end.

Revision as of 12:03, 29 December 2005

MFO examples

Microformat Object or Microformat Opacity or Microformat Opaque

Contributors

  • Tantek Çelik

The Problem

Both recent discussions around hAtom, and earlier discussions from June of 2005 have indicated that there may be a need for a generic microformat to indicate that a specific element is a wrapper, container, or layer of abstraction, that should be opaque to something parsing the microformats that may be further up the hierarchy.

E.g. you might put a <span class="vcard mfo"> deep inside a <span class="vevent">, and not want the categories/tags of the hCard accidentally parsed into the hCalendar event.

Note: the use of "mfo" is only for the purpose of illustration is by no means a proposed name for this microformat. We expect research/discussion to reveal a much better name. We use "mfo" only as a temporary name for the sake of discussion and example illustration. We may even want to commit to deliberately using a class name different from "mfo" just to make this clear in the end.

Forward Compatibility for Parsers

Part of the point of this is to help with forward compatibility for parsers.

Thus an hCalendar parser might need not know about hCard (even though in practice they probably will). As the number of microformats grows, the chances that a new microformat may confuse an old parser due to the scenario outlined above increases. Thus we are considering making it explicit when a new "root" microformat is established.

To Do

In order:

  1. fill out the real world examples below
  2. create mfo-formats page for researching/describing how other data formats indicate this kind of "abstraction", including the various terms they use like "object", "container", etc.
  3. create mfo-brainstorming page where we discuss how this should work, and candidate names. Some candidate names that have been offered to date: u, uf, object, container, root, mfo...

Examples

Here are some real world examples where folks have encountered the need to explicitly indicate that an embedded microformat does not introduce properties to its container.

hAtom

Container microformats use context in a similar way to that of conventional XML. When an atom document includes the element <author> it is context that determines whether the author of a feed or the author of an entry is being specified. However, contrary to convetional XML microformats support forwards compatibility with must-ignore semantics for intervening elements between the context and data. This introduces a problem of identifying contexts that may have been ignored in parsing. If hAtom finds an author element belonging a new microformat that it does not recognise, it may incorrectly summise that the author element belongs to it and refers to it. In fact, it refers to the unknown microformat. Any other inference is invalid.

Elements that have different meanings in different microformats also pose a problem. hCard includes a title element meaning approximately "a person's job title". Atom and various other specifications use title to mean "the title of this document or sub-document". hReview avoided the use of title by introducing a summary element, however this also clashes with the atom namespace. hReview uses summary to mean "review title", while atom uses summary to mean "abbreviated content, both longer than title and shorter than content".

hAtom currently attempts to resolve both the context problem and the nomenclature problem by explicitly naming child elements as opaque. Currently "content" and "summary" are considered completely opaque, while "author" and "contributor" are only scanned for vcard content. This may be an incomplete solution if vcards or other context microformats are included outside of these nodes.