metaformats - Revision history

Tantek: split backcompat metaformats from explicit mf2 metaformats, per https://github.com/microformats/microformats2-parsing/issues/75 request from implementor, and in consideration of reducing chance of an unexpected (possibly worse) new first root microformat in parsed documents

2023-12-02T00:36:50Z

split backcompat metaformats from explicit mf2 metaformats, per https://github.com/microformats/microformats2-parsing/issues/75 request from implementor, and in consideration of reducing chance of an unexpected (possibly worse) new first root microformat in parsed documents

← Older revision		Revision as of 00:36, 2 December 2023
Line 18:		Line 18:
	For each of the following subsections, apply the changes therein to the steps in the same subsection in the [[microformats2-parsing]] specification.		For each of the following subsections, apply the changes therein to the steps in the same subsection in the [[microformats2-parsing]] specification.

	=== parse ~~an element~~ for ~~class~~ microformats ===		=== parse a document for microformats ===
	~~Before~~ the ~~step~~: "~~if none found~~, ~~parse child elements …~~", ~~insert these steps at the same level~~:		Change the line "start with an empty JSON…" to:
			* start with an empty JSON "items" array and hashes "meta-item", "rels", "rel-urls":

	* if none found and the ~~element is a <code>head</code> element and there were no root class names found on the <code>html</code> element~~		Update the JSON sample data structure to:
	** parse <~~code>meta</code> elements for backcompat properties (defined in [[#meta_backward_compatible_parsing\|meta backward compatible parsing]])~~		<syntaxhighlight lang=json>
	** if there is a <code>meta[property=~~og:type]</code~~> ~~then~~		{
	*** get that meta element’s <code>content</code> attribute value		"items": [],
	*** if it’s "~~article~~" ~~then imply a <code>head</code> element root class name of <code>~~[~~[h-entry~~]~~]</code>~~		"meta-item": {},
	*** if it’s "~~profile~~" ~~then imply a <code>head</code> element root class name of <code>[[h-card]]</code>~~		"rels": {},
	*** if it's "music" or "~~video~~" ~~then imply a <code>head</code> element root class name of <code>[[h-cite]]</code>~~		"rel-urls": {}
	** end if		}
	** if there is no implied <code>head</code> element root class name and there is a <code>meta[name=twitter:~~card]</code> then~~		</syntaxhighlight>
	*** get that meta element’s <code>content</code> attribute value
	*** if it's "~~summary~~" ~~or "summary_large_image" then imply a <code>head</code> element root class name of <code>[[h-entry]]</code>~~		Before the line "* return the resulting JSON", insert:
	** end if		* parse the <code>head</code> element for backcompat metaformats
	** if there is no implied <code>head</~~code~~> ~~element root class name and~~
	*** there is a <code>meta[property^=og:]</code> or <code>meta[name^=twitter:]</code>
	** then imply a <code>head</code> element root class name of <code>[[h-entry]]</code>
	** if there is an implied <code>head</code> element root class name
	*** set aside the ~~parsed 'item' from that root and its properties~~
	*** after parsing the rest of the document, append that parsed 'item' from the <code>head</code> element ~~to the end of the top level 'items' array~~
	** end if

	=== parsing an element for properties ===		=== parsing an element for properties ===
Line 54:		Line 48:
	* else if <code>meta.dt-x[content]</code>, then return the <code>content</code> attribute		* else if <code>meta.dt-x[content]</code>, then return the <code>content</code> attribute

	== ~~meta backward compatible parsing~~ ==		=== parse the head element for backcompat metaformats ===
	~~The~~ following ~~list of~~ meta ~~elements are~~ to ~~be parsed as~~ the ~~listed~~ [[~~microformats2~~]] ~~equivalent~~ properties.		After the section "parse an img element for src and alt", insert a new sibling section:
	* if <code>meta[property="og:title"]</code>, parse <code>content</code> attribute as <code>p-name</code>		<pre>=== parse the head element for backcompat metaformats ===</pre>
	* else <code>meta[name="twitter:title"]</code>, parse <code>content</code> as <code>p-name</code>
	* if <code>meta[property="og:description"]</code>, parse <code>content</code> as <code>p-summary</code>		With the following instructions:
	* else if <code>meta[name="twitter:description"]</code>, parse <code>content</code> as <code>p-summary</code>
	* if <code>meta[property="og:image"]</code>, parse <code>content</code> as <code>u-photo</code>		* if there were no root class names found on the <code>html</code> and <code>head</code> elements
	* else if <code>meta[name="twitter:image"]</code>, parse <code>content</code> as <code>u-photo</code>		** if there is a <code>meta[property=og:type]</code> then
	* if <code>meta[property="og:video"]</code>, parse <code>content</code> as <code>u-video</code>		*** get that meta element’s <code>content</code> attribute value
	* if <code>meta[property="og:audio"]</code>, parse <code>content</code> as <code>u-audio</code>		*** if it’s "article" then set the meta-item "type" property to "entry"
	* if <code>meta[property="article:published_time"]</code>, parse <code>content</code> as <code>dt-published</code>		*** if it’s "profile" then set the meta-item "type" property to "card"
	* if <code>meta[property="article:modified_time"]</code>, parse <code>content</code> as <code>dt-updated</code>		*** if it's "music" or "video" then set the meta-item "type" property to "cite"
	* if <code>meta[property="article:author"]</code>, parse <code>content</code> as <code>p-author</code>		** end if
			** if there is no meta-item "type" property value and there is a <code>meta[name=twitter:card]</code> then
			*** get that meta element’s <code>content</code> attribute value
			*** if it's "summary" or "summary_large_image" then set the meta-item "type" property to "entry"
			** end if
			** if there is no meta-item "type" property value and
			*** there is a <code>meta[property^=og:]</code> or <code>meta[name^=twitter:]</code>
			** then set the meta-item "type" property to "entry"
			** parse <code>meta</code> elements for backcompat properties as follows and add them to a "properties" hash inside the "meta-item" hash:
			*** if <code>meta[property="og:title"]</code>, parse <code>content</code> attribute as <code>p-name</code>
			*** else <code>meta[name="twitter:title"]</code>, parse <code>content</code> as <code>p-name</code>
			*** if <code>meta[property="og:description"]</code>, parse <code>content</code> as <code>p-summary</code>
			*** else if <code>meta[name="twitter:description"]</code>, parse <code>content</code> as <code>p-summary</code>
			*** if <code>meta[property="og:image"]</code>, parse <code>content</code> as <code>u-photo</code>
			*** else if <code>meta[name="twitter:image"]</code>, parse <code>content</code> as <code>u-photo</code>
			*** if <code>meta[property="og:video"]</code>, parse <code>content</code> as <code>u-video</code>
			*** if <code>meta[property="og:audio"]</code>, parse <code>content</code> as <code>u-audio</code>
			*** if <code>meta[property="article:published_time"]</code>, parse <code>content</code> as <code>dt-published</code>
			*** if <code>meta[property="article:modified_time"]</code>, parse <code>content</code> as <code>dt-updated</code>
			*** if <code>meta[property="article:author"]</code>, parse <code>content</code> as <code>p-author</code>
			** end if /* parse meta elements for backcompat properties */
			* end if /* no root class names found on html and head */

	== Background ==		== Background ==
Line 77:		Line 92:
	== See Also ==		== See Also ==
	* [[microformats2-parsing]]		* [[microformats2-parsing]]
			* [[meta]]

Tantek: editorial: no use discouraging additional implementations when clearly folks are finding it useful to build them, seems like stable feature are now possible as well

2023-11-28T20:40:14Z

editorial: no use discouraging additional implementations when clearly folks are finding it useful to build them, seems like stable feature are now possible as well

← Older revision		Revision as of 20:40, 28 November 2023
Line 2:		Line 2:
	<dfn style="font-style:normal;font-weight:bold">[[metaformats]]</dfn> is an extension to the [[microformats2-parsing]] for parsing [[invisible data]] published in HTML <code>meta</code> tags, both with an explicit methodology, and for backward compatibility with existing vocabularies that have multiple testable interoperable implementations.		<dfn style="font-style:normal;font-weight:bold">[[metaformats]]</dfn> is an extension to the [[microformats2-parsing]] for parsing [[invisible data]] published in HTML <code>meta</code> tags, both with an explicit methodology, and for backward compatibility with existing vocabularies that have multiple testable interoperable implementations.

	:This is a '''Living Specification''' that is subject to change as research discovers meta tag vocabularies in wide use and consumed by multiple implementations~~. Additional implementations are not encouraged at this time~~. This specification has no stable portions. Features are untested, unless explicitly labeled stable, draft, or proposed, or in stable, draft, or proposed sections. All features are likely to change ~~substantively~~. ~~While stable~~ features are ~~unexpected~~, ~~it is a~~ living specification ~~and~~ may eventually document some. When stable features are documented, substantive changes may be proposed by issues and errata filed in response to implementation experience, requiring consensus among participating implementers as part of an explicit to be defined change control <!--[[#change_control\|change control]]--> process.		:This is a '''Living Specification''' that is subject to change as research discovers meta tag vocabularies in wide use and consumed by multiple implementations. This specification has no stable portions. Features are untested, unless explicitly labeled stable, draft, or proposed, or in stable, draft, or proposed sections. All features are likely to change. Stable features are possible, and thus this living specification may eventually document some. When stable features are documented, substantive changes may be proposed by issues and errata filed in response to implementation experience, requiring consensus among participating implementers as part of an explicit to be defined change control <!--[[#change_control\|change control]]--> process.
	;<span id="participate">Participate</span>		;<span id="participate">Participate</span>
	:[https://github.com/microformats/metaformats/issues Open Issues]		:[https://github.com/microformats/metaformats/issues Open Issues]

Tantek: /* meta backward compatible parsing */ else if

2022-04-04T22:16:57Z

meta backward compatible parsing: else if

← Older revision		Revision as of 22:16, 4 April 2022
Line 59:		Line 59:
	* else <code>meta[name="twitter:title"]</code>, parse <code>content</code> as <code>p-name</code>		* else <code>meta[name="twitter:title"]</code>, parse <code>content</code> as <code>p-name</code>
	* if <code>meta[property="og:description"]</code>, parse <code>content</code> as <code>p-summary</code>		* if <code>meta[property="og:description"]</code>, parse <code>content</code> as <code>p-summary</code>
	* else <code>meta[name="twitter:description"]</code>, parse <code>content</code> as <code>p-summary</code>		* else if <code>meta[name="twitter:description"]</code>, parse <code>content</code> as <code>p-summary</code>
	* if <code>meta[property="og:image"]</code>, parse <code>content</code> as <code>u-photo</code>		* if <code>meta[property="og:image"]</code>, parse <code>content</code> as <code>u-photo</code>
	* else <code>meta[name="twitter:image"]</code>, parse <code>content</code> as <code>u-photo</code>		* else if <code>meta[name="twitter:image"]</code>, parse <code>content</code> as <code>u-photo</code>
	* if <code>meta[property="og:video"]</code>, parse <code>content</code> as <code>u-video</code>		* if <code>meta[property="og:video"]</code>, parse <code>content</code> as <code>u-video</code>
	* if <code>meta[property="og:audio"]</code>, parse <code>content</code> as <code>u-audio</code>		* if <code>meta[property="og:audio"]</code>, parse <code>content</code> as <code>u-audio</code>

Tantek: /* Background */ prior

2022-04-04T22:14:47Z

Background: prior

← Older revision		Revision as of 22:14, 4 April 2022
Line 69:		Line 69:

	== Background ==		== Background ==
	The following ~~past~~ work was used to develop this specification:		The following prior work was used to develop this specification:
	* [https://indieweb.org/metaformats IndieWeb: metaformats page]		* [https://indieweb.org/metaformats IndieWeb: metaformats page]
	* [[metaformats-brainstorming]]		* [[metaformats-brainstorming]]

	[[Category:Draft Specifications]]		[[Category:Draft Specifications]]

	== See Also ==		== See Also ==
	* [[microformats2-parsing]]		* [[microformats2-parsing]]

Tantek: /* parse an element for class microformats / link h-, set aside parsed head item and append it to end of items array after finishing parsing (prioritize visible data in body)

2022-04-02T21:41:01Z

parse an element for class microformats: link h-*, set aside parsed head item and append it to end of items array after finishing parsing (prioritize visible data in body)

Tantek: link meta backcompat parsing

2022-04-02T08:31:36Z

link meta backcompat parsing

← Older revision		Revision as of 08:31, 2 April 2022
Line 22:		Line 22:

	* if none found and the element is a <code>head</code> element and there were no root class names found on the <code>html</code> element		* if none found and the element is a <code>head</code> element and there were no root class names found on the <code>html</code> element
	** parse <code>meta</code> elements for backcompat properties (~~to be~~ defined in "meta backward compatible parsing")		** parse <code>meta</code> elements for backcompat properties (defined in [[#meta_backward_compatible_parsing\|meta backward compatible parsing]])
	** if there is a <code>meta[property=og:type]</code> then		** if there is a <code>meta[property=og:type]</code> then
	*** get that meta element’s <code>content</code> attribute value		*** get that meta element’s <code>content</code> attribute value

Tantek: copy edit dfn

2022-04-02T08:26:03Z

copy edit dfn

← Older revision		Revision as of 08:26, 2 April 2022
Line 1:		Line 1:
	{{DISPLAYTITLE:metaformats specification}}		{{DISPLAYTITLE:metaformats specification}}
	<dfn style="font-style:normal;font-weight:bold">[[metaformats]]</dfn> is an extension to the [[microformats2-parsing]] ~~specification~~ for parsing [[invisible data]] published in HTML <code>meta</code> tags, both with an explicit methodology, and for backward compatibility with existing vocabularies that have multiple testable interoperable implementations.		<dfn style="font-style:normal;font-weight:bold">[[metaformats]]</dfn> is an extension to the [[microformats2-parsing]] for parsing [[invisible data]] published in HTML <code>meta</code> tags, both with an explicit methodology, and for backward compatibility with existing vocabularies that have multiple testable interoperable implementations.

	:This is a '''Living Specification''' that is subject to change as research discovers meta tag vocabularies in wide use and consumed by multiple implementations. Additional implementations are not encouraged at this time. This specification has no stable portions. Features are untested, unless explicitly labeled stable, draft, or proposed, or in stable, draft, or proposed sections. All features are likely to change substantively. While stable features are unexpected, it is a living specification and may eventually document some. When stable features are documented, substantive changes may be proposed by issues and errata filed in response to implementation experience, requiring consensus among participating implementers as part of an explicit to be defined change control <!--[[#change_control\|change control]]--> process.		:This is a '''Living Specification''' that is subject to change as research discovers meta tag vocabularies in wide use and consumed by multiple implementations. Additional implementations are not encouraged at this time. This specification has no stable portions. Features are untested, unless explicitly labeled stable, draft, or proposed, or in stable, draft, or proposed sections. All features are likely to change substantively. While stable features are unexpected, it is a living specification and may eventually document some. When stable features are documented, substantive changes may be proposed by issues and errata filed in response to implementation experience, requiring consensus among participating implementers as part of an explicit to be defined change control <!--[[#change_control\|change control]]--> process.

Tantek: /* meta backward compatible parsing */ attribute

2022-04-02T08:17:28Z

meta backward compatible parsing: attribute

← Older revision		Revision as of 08:17, 2 April 2022
Line 52:		Line 52:
	== meta backward compatible parsing ==		== meta backward compatible parsing ==
	The following list of meta elements are to be parsed as the listed [[microformats2]] equivalent properties.		The following list of meta elements are to be parsed as the listed [[microformats2]] equivalent properties.
	* if <code>meta[property="og:title"]</code>, parse <code>content</code> as <code>p-name</code>		* if <code>meta[property="og:title"]</code>, parse <code>content</code> attribute as <code>p-name</code>
	* else <code>meta[name="twitter:title"]</code>, parse <code>content</code> as <code>p-name</code>		* else <code>meta[name="twitter:title"]</code>, parse <code>content</code> as <code>p-name</code>
	* if <code>meta[property="og:description"]</code>, parse <code>content</code> as <code>p-summary</code>		* if <code>meta[property="og:description"]</code>, parse <code>content</code> as <code>p-summary</code>

Tantek: algorithm changes / parse an element for class microformats, meta backward compatible parsing

2022-04-02T08:11:46Z

algorithm changes / parse an element for class microformats, meta backward compatible parsing

@@ Line 2: / Line 2: @@
 <dfn style="font-style:normal;font-weight:bold">[[metaformats]]</dfn> is an extension to the [[microformats2-parsing]] specification for parsing [[invisible data]] published in HTML <code>meta</code> tags, both with an explicit methodology, and for backward compatibility with existing vocabularies that have multiple testable interoperable implementations.
-:This is a '''Living Specification''' that is subject to change as research discovers meta tag vocabularies in wide use and consumed by multiple implementations. Additional implementations are not encouraged at this time. This specification has no stable portions. Features are untested, unless explicitly labeled stable, draft, or proposed, or in stable, draft, or proposed sections. All features are likely to change substantively. While stable features are unexpected, it is a living specification and may eventually document some. When stable features are documented, substantive changes may be proposed by issues and errata filed in response to implementation experience, requiring consensus among participating implementers as part of an explicit to be defined [[#change_control|change control]] process.
+:This is a '''Living Specification''' that is subject to change as research discovers meta tag vocabularies in wide use and consumed by multiple implementations. Additional implementations are not encouraged at this time. This specification has no stable portions. Features are untested, unless explicitly labeled stable, draft, or proposed, or in stable, draft, or proposed sections. All features are likely to change substantively. While stable features are unexpected, it is a living specification and may eventually document some. When stable features are documented, substantive changes may be proposed by issues and errata filed in response to implementation experience, requiring consensus among participating implementers as part of an explicit to be defined change control <!--[[#change_control|change control]]--> process.
 ;<span id="participate">Participate</span>
 :[https://github.com/microformats/metaformats/issues Open Issues]
@@ Line 12: / Line 12: @@
 ;License
 : {{cc0-owfa-license}}
 == See Also ==
-* [[metaformats-brainstorming]]
+* [[microformats2-parsing]]

Tantek: see also

2022-04-01T21:06:35Z

← Older revision		Revision as of 21:41, 2 April 2022
Line 25:		Line 25:
	** if there is a <code>meta[property=og:type]</code> then		** if there is a <code>meta[property=og:type]</code> then
	*** get that meta element’s <code>content</code> attribute value		*** get that meta element’s <code>content</code> attribute value
	*** if it’s "article" then imply a <code>head</code> element root class name of <code>h-entry</code>		*** if it’s "article" then imply a <code>head</code> element root class name of <code>[[h-entry]]</code>
	*** if it’s "profile" then imply a <code>head</code> element root class name of <code>h-card</code>		*** if it’s "profile" then imply a <code>head</code> element root class name of <code>[[h-card]]</code>
	*** if it's "music" or "video" then imply a <code>head</code> element root class name of <code>h-cite</code>		*** if it's "music" or "video" then imply a <code>head</code> element root class name of <code>[[h-cite]]</code>
	** end if		** end if
	** if there is no implied <code>head</code> element root class name and there is a <code>meta[name=twitter:card]</code> then		** if there is no implied <code>head</code> element root class name and there is a <code>meta[name=twitter:card]</code> then
	*** get that meta element’s <code>content</code> attribute value		*** get that meta element’s <code>content</code> attribute value
	*** if it's "summary" or "summary_large_image" then imply a <code>head</code> element root class name of <code>h-entry</code>		*** if it's "summary" or "summary_large_image" then imply a <code>head</code> element root class name of <code>[[h-entry]]</code>
	** end if		** end if
	** if there is no implied <code>head</code> element root class name and		** if there is no implied <code>head</code> element root class name and
	*** there is a <code>meta[property^=og:]</code> or <code>meta[name^=twitter:]</code>		*** there is a <code>meta[property^=og:]</code> or <code>meta[name^=twitter:]</code>
	** then imply a <code>head</code> element root class name of <code>h-entry</code>		** then imply a <code>head</code> element root class name of <code>[[h-entry]]</code>
			** if there is an implied <code>head</code> element root class name
			*** set aside the parsed 'item' from that root and its properties
			*** after parsing the rest of the document, append that parsed 'item' from the <code>head</code> element to the end of the top level 'items' array
			** end if

	=== parsing an element for properties ===		=== parsing an element for properties ===

← Older revision		Revision as of 21:06, 1 April 2022
Line 12:		Line 12:
	;License		;License
	: {{cc0-owfa-license}}		: {{cc0-owfa-license}}

			== See Also ==
			* [[metaformats-brainstorming]]