menu-formats: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
(stub)
 
(Adds schema.org Menu type.)
Line 4: Line 4:


See [[recipe-formats]] for an example of how to grow this page.
See [[recipe-formats]] for an example of how to grow this page.
=== schema.org ===
schema.org has a [https://schema.org/Menu menu type] with a high degree of complexity. There are over 100 properties associated with it, many of which have little or nothing to do with restaurant menus:
; learningResourceType
: a menu is not a learning resource, except I suppose as a way to learn what food they offer, which is sort of tautological
; publisherImprint
: This is described as "The publishing division which published the comic." Why this property is part of the Menu type is beyond my comprehension.
; timeRequired
: this is intended to mark up the time it takes to read the work; the time it takes to read a menu is hardly relevant for a web author or user
The Menu type has other properties that are better handled with existing HTML constructs:
;  inLanguage
: instead use lang attribute on root element or other container
; educationalAlignment
: restaurants aren't generally aligned with a school, and they were, that would be better handled with a nested Restaurant type; for microformats, a nested [[h-card]] would be easy and intuitive
; translationOfWork
: better handled with <code>rel</code> attributes, perhaps on a <code>link</code> element in a document <code>head</code>
The complexity is part of the schema.org philosophy of adding properties for every possible variation and contingency of web publishing, at the expense of making it difficult and intimidating for web authors to adopt. It appears that [https://schema.org/ schema.org] no longer publishes adoption rates, so it's hard to gauge whether their Menu schema is actually being used in the wild.




== See Also ==
== See Also ==
* [[menu]]
* [[menu]]

Revision as of 21:08, 4 December 2020

This article is a stub. You can help the microformats.org wiki by expanding it.

Per process, for documenting existing restaurant menu publishing formats.

See recipe-formats for an example of how to grow this page.

schema.org

schema.org has a menu type with a high degree of complexity. There are over 100 properties associated with it, many of which have little or nothing to do with restaurant menus:

learningResourceType
a menu is not a learning resource, except I suppose as a way to learn what food they offer, which is sort of tautological
publisherImprint
This is described as "The publishing division which published the comic." Why this property is part of the Menu type is beyond my comprehension.
timeRequired
this is intended to mark up the time it takes to read the work; the time it takes to read a menu is hardly relevant for a web author or user

The Menu type has other properties that are better handled with existing HTML constructs:

inLanguage
instead use lang attribute on root element or other container
educationalAlignment
restaurants aren't generally aligned with a school, and they were, that would be better handled with a nested Restaurant type; for microformats, a nested h-card would be easy and intuitive
translationOfWork
better handled with rel attributes, perhaps on a link element in a document head

The complexity is part of the schema.org philosophy of adding properties for every possible variation and contingency of web publishing, at the expense of making it difficult and intimidating for web authors to adopt. It appears that schema.org no longer publishes adoption rates, so it's hard to gauge whether their Menu schema is actually being used in the wild.



See Also