microformats2-brainstorming

Brainstorming experimental / undeveloped / rejected ideas for microformats-2.

For the original brainstorming of microformats2 itself, see:

• microformats2-origins

brainstorms to consider

document url

Since microformats2-parsing produces JSON with "rels" and "rel-urls", it may be useful to have a root context object which provides the URL of the document itself.

adopt itemref

There many existing real-world use-cases where either:

• several microformats in a page want to share some common data without repeating it.
  • e.g. a page about a product with multiple reviews of that product (very common, products sites, Amazon/CNET et al, review aggregators, Yelp et al)
  • e.g. representing the author of multiple hAtom entries on a page. Currently this is possible with the <address class="hcard"> optimisation, which would be rendered obsolete by the proposed new generic parsing rules.
• a microformat in a page needs to incorporate information spread across different parts of a page, without assigning the entire page to that microformat

The include-pattern provides the necessary functionality for existing microformats (1.0).

For 2.0 it may be reasonable to simply re-use the nice itemref attribute from microdata, with identical/analogous functionality.

That is, when present on the root element of a microformat, the itemref attribute provides a space separated list of ids of elements in the document which are then incorporated as children of the microformat, before its actual children in the document. This is a simple coarse summary of course, and the actual itemref inclusion algorithm should be followed.

Questions and possible issues:

hReview item backward compatibility

It maybe necessary (pending research/evidence) to add backward compatible parsing for the class name "item" inside the backward compatible parsing for the root class name "hreview". If so, here are some notes on how to add that to the microformats2 spec on v2 vocabularies.

h-item

...

For backward compatibility, microformats 2 parsers SHOULD, when parsing an "hreview" for backwards compatibility, detect the following root class name and property names. A microformats 2 parser may use existing microformats parsers to extract these properties. If an "h-item" is found, don't look for an "item" on the same element.

compat root class name: item
properties: (parsed as p- plain text unless otherwise specified)

• fn - parse as p-name
• photo - parse as u-photo
• url - parse as u-url

Note: we should analyze hreview-examples-in-wild to see if there are any that actually depend on parsing for "item", or if simply looking for "fn", "photo", and "url" directly inside a root class name of "hreview" is sufficient. If so, we should DROP this backward-compat parsing for the class name "item" as it may otherwise produce too many false positives ("item" is a fairly common term).

h-review

...

• item - including compat root vcard|vevent in the absence of h-card|h-event

...

Note: we should analyze hreview-examples-in-wild to see if there are any that actually depend on parsing for "item", or if simply looking for "fn", "photo", and "url" directly inside a root class name of "hreview" is sufficient. If so, we should DROP the backward-compat parsing for the class name "item" as it may otherwise produce too many false positives ("item" is a fairly common term).

register a mime type?

See microformats2-mime-type.

accepted ideas

more on allow root class name only

This has been stable for a while, see:

• microformats-2-implied-properties

rejected ideas

n prefix for multiple numbers

Idea:

• "n-*" for (one or more) numbers, e.g. "n-rating", "n-geo", leaving the semantics of more than one number up to specific format. e.g. for an "n-rating" inside an "h-review", the first number would presumably be the rating value, when only two numbers the second would be the "best" value (e.g. rated <span class="n-rating">3 out of 4</span>), when three numbers the second would be the "worst" and the third would be the "best" (e.g. <span class="n-rating">7.5 out of 1 to 10</span>). similarly "n-geo" would specify the first number to be the latitude and the second to be the longitude.

Rejected because while this *might* work for some properties in *English* it will NOT localize/internationalize well (orders of numbers in phrases change in different languages), and it will also limit the human expressivity of the plain text. Thanks to Ben Ward for this feedback at the 2011-06-02 microformats dinner. Tantek 14:25, 9 June 2011 (UTC)

incorporate rel

Update: requiring rel with class tends to confuse web authors (lots of anecdotal experience here), thus microformats2 itself does not require any use of rel by publishers, and keeps it only as part of backcompat handling of a small handful of classic microformats (e.g. rel-tag in hAtom, hCard).

The rest of this proposal (of formally adding rel-* handling inside of microformats root class names) was rejected long ago.

profile h-card rel-me

Many sites have profile pages (personal home pages, and social networks), marked up with hCard, and permitting one or more rel-me values to other profiles, e.g. if this content were on http://tantek.com/ :

Tantek Çelik (@t, github.com/tantek)

with source:

<span class="h-card">
  <span class="p-name">Tantek Çelik</span>
 (<a class="u-url" rel="me"
     href="https://twitter.com/t"
     >@t</a>, 
  <a class="u-url" rel="me"
     href="http://github.com/tantek"
     >github.com/tantek</a>)
</span>

Parsed JSON per microformats2 properties:

{
  "items": [{ 
    "type": ["h-card"],
    "properties": {
      "name": ["Tantek Çelik"],
      "url": ["https://twitter.com/t", 
              "http://github.com/tantek"]
    }
  }]
}

We could incorporate rel property parsing either as just another property (like a 'u-' property) scoped to the microformat:

{
  "items": [{ 
    "type": ["h-card"],
    "properties": {
      "name": ["Tantek Çelik"],
      "url": ["https://twitter.com/t", 
              "http://github.com/tantek"],
      "rel-me": ["https://twitter.com/t", 
              "http://github.com/tantek"]
    }
  }]
}

Or as always within global scope (closer to HTML5's currently defined scoping for 'rel' attributed links in a document):

{
  "items": [{
    "url": "http://tantek.com/",
    "rel-stylesheet": ["...", "..."],
    "rel-me": ["https://twitter.com/t", 
               "http://github.com/tantek"]
    },
    { 
    "type": ["h-card"],
    "properties": {
      "name": ["Tantek Çelik"],
      "url": ["https://twitter.com/t", 
              "http://github.com/tantek"],
    }
  }]
}

Note: "url" in that root level object is the URL of the document itself, which is necessary for:

• 'rel' semantics: which URL from to which other URL the rels apply to.
• vCard .vcf export "SOURCE:" property (URL that the vCards were derived from).

see also

• microformats2
• microformats2-parsing
• microformats2-brainstorming
• microformats2-experimental-properties
• microformats2-prefixes
• microformats2-implied-properties
• microformats2-faq
• html-stripping-examples
• microformats2-origins