include-pattern-issues

Include-Pattern Issues

See: A summary of issues with the include pattern.

• closed issue 2007-08-03 raised by Mike Kaply

• 1. It needs to be explicit that the only classname on the object/etc should be include. Having specific microformat property classnames (e.g. "fn") on the object is not necessary since the premise is that the object node is REPLACED by the referenced node. This is clarified on February 12th 2008, line 27 (http://microformats.org/wiki?title=include-pattern&diff=0&oldid=25677)

• open issue! 2008-02-21 raised by TobyInk

It's very easy for inclusions to end up as an infinite loop. For example:

<div class="fn" id="foo"><a class="include" href="#foo">include</a></div>

Assuming that we want to allow multi-level inclusion (e.g. an hcard could include an "adr" from elsewhere on the page, which in turn might include a "locality" from somewhere else), loops are hard to avoid. In my own parser, I assume a maximum number of iterations over the inclusion function. This level is set higher for more complex microformats than the more simple ones -- for example an hCard is allowed up to six iterations, whereas a geo is only allowed up to two.

Template

Consider using this format (copy and paste this to the end of the list to add your issues; replace ~~~ with an external link if preferred) to report issues or feedback, so that issues can show up in hAtom subscriptions of this issues page. If open issues lack this markup, please add it.

Please post one issue per entry, to make them easier to manage. Avoid combining multiple issues into single reports, as this can confuse or muddle feedback, and puts a burden of separating the discrete issues onto someone else who 1. may not have the time, and 2. may not understand the issue in the same way as the original reporter.

<div class="hentry">
{{OpenIssue}} 
<span class="entry-summary author vcard">
 <span class="published">2011-MM-DD</span> 
 raised by <span class="fn">~~~</span>
</span>
<div class="entry-content discussion issues">
* <strong class="entry-title">«Short title of issue»</strong>. «Description of Issue»
** Follow-up comment #1
** Follow-up comment #2
</div>
</div>

Related Pages

• the include pattern
• include-pattern examples in the wild - an on-going list of websites which use the include pattern.
• include-pattern FAQ - if you have any questions about the include pattern, check here, and if you don't find answers, add your questions!
• include-pattern feedback- general feedback (as opposed to specific issues).
• include-pattern issues - specific issues with the include pattern.
• include-pattern strawman - alternative proposals