representative-h-card-parsing - Revision history

Barnabywalters: /* Implementations */ added rockorager/representative-h-card

2021-06-22T12:45:49Z

Implementations: added rockorager/representative-h-card

← Older revision		Revision as of 12:45, 22 June 2021
Line 24:		Line 24:
	** Example usage: <code>$hcard = BarnabyWalters\Mf2\getRepresentativeHCard($mfs, $url);</code>		** Example usage: <code>$hcard = BarnabyWalters\Mf2\getRepresentativeHCard($mfs, $url);</code>
	* '''PHP''' [https://github.com/indieweb/representative-h-card-php indieweb/representative-h-card-php]		* '''PHP''' [https://github.com/indieweb/representative-h-card-php indieweb/representative-h-card-php]
			* '''node.js''' [https://github.com/rockorager/representative-h-card rockorager/representative-h-card]
	* Add yours here!		* Add yours here!
	* …		* …

Aaronpk: /* Implementations */

2015-12-23T18:15:09Z

Implementations

← Older revision		Revision as of 18:15, 23 December 2015
Line 23:		Line 23:
	* '''PHP''' [https://github.com/barnabywalters/php-mf-cleaner barnabywalters/mf-cleaner] package implements representative h-card parsing in [https://github.com/barnabywalters/php-mf-cleaner/blob/master/src/BarnabyWalters/Mf2/Functions.php#L211 getRepresentativeHCard()] function		* '''PHP''' [https://github.com/barnabywalters/php-mf-cleaner barnabywalters/mf-cleaner] package implements representative h-card parsing in [https://github.com/barnabywalters/php-mf-cleaner/blob/master/src/BarnabyWalters/Mf2/Functions.php#L211 getRepresentativeHCard()] function
	** Example usage: <code>$hcard = BarnabyWalters\Mf2\getRepresentativeHCard($mfs, $url);</code>		** Example usage: <code>$hcard = BarnabyWalters\Mf2\getRepresentativeHCard($mfs, $url);</code>
			* '''PHP''' [https://github.com/indieweb/representative-h-card-php indieweb/representative-h-card-php]
	* Add yours here!		* Add yours here!
	* …		* …

Aaronpk: disambiguate the case where the page contains only one h-card

2015-12-23T17:53:03Z

disambiguate the case where the page contains only one h-card

← Older revision		Revision as of 17:53, 23 December 2015
Line 9:		Line 9:
	* If the page contains an h-card with '''uid''' and '''url''' properties both matching the page URL, the first such h-card is the representative h-card		* If the page contains an h-card with '''uid''' and '''url''' properties both matching the page URL, the first such h-card is the representative h-card
	* If no representative h-card was found, if the page contains an h-card with a '''url''' property value which also has a <code>rel=me</code> relation (i.e. matches a URL in parse_results.rels.me), the first such h-card is the representative h-card		* If no representative h-card was found, if the page contains an h-card with a '''url''' property value which also has a <code>rel=me</code> relation (i.e. matches a URL in parse_results.rels.me), the first such h-card is the representative h-card
	* If no representative h-card was found, if the page contains '''one single''' h-card ~~with~~ a '''url''' property matching the page URL, that h-card is the representative h-card		* If no representative h-card was found, if the page contains '''one single''' h-card, and the h-card has a '''url''' property matching the page URL, that h-card is the representative h-card
	* If no representative h-card was found, the page has no representative h-card		* If no representative h-card was found, the page has no representative h-card

Barnabywalters: added mf-cleaner implementation

2014-10-06T23:14:56Z

added mf-cleaner implementation

← Older revision		Revision as of 23:14, 6 October 2014
Line 21:		Line 21:
	Open source implementations of the representative h-card algorithm.		Open source implementations of the representative h-card algorithm.

			* '''PHP''' [https://github.com/barnabywalters/php-mf-cleaner barnabywalters/mf-cleaner] package implements representative h-card parsing in [https://github.com/barnabywalters/php-mf-cleaner/blob/master/src/BarnabyWalters/Mf2/Functions.php#L211 getRepresentativeHCard()] function
			** Example usage: <code>$hcard = BarnabyWalters\Mf2\getRepresentativeHCard($mfs, $url);</code>
	* Add yours here!		* Add yours here!
	* …		* …

Barnabywalters: initial updated microformats2 version of representative h-card algorithm

2014-10-06T22:40:39Z

initial updated microformats2 version of representative h-card algorithm

New page

Assuming you already have access to a [[parsers#microformats2_parsers|microformats2 parser]], the algorithm defined here allows you to determine the representative [[h-card]] for a given page.

This algorithm is the microformats2 update to [[representative-hcard-parsing]].

== Algorithm ==

After [[parsing]] the page:

* If the page contains an h-card with '''uid''' and '''url''' properties both matching the page URL, the first such h-card is the representative h-card
* If no representative h-card was found, if the page contains an h-card with a '''url''' property value which also has a <code>rel=me</code> relation (i.e. matches a URL in parse_results.rels.me), the first such h-card is the representative h-card
* If no representative h-card was found, if the page contains '''one single''' h-card with a '''url''' property matching the page URL, that h-card is the representative h-card
* If no representative h-card was found, the page has no representative h-card

=== Matching URLs ===
URLs are to be matched as per the parsing algorithm defined in https://url.spec.whatwg.org:

* Parse the URLs
* If every component matches, the URLs match

== Implementations ==
Open source implementations of the representative h-card algorithm.

* Add yours here!
* …

== Back compat ==
All backcompat for representative h-card parsing should already be handled by the [[h-card#Backward_Compatibility|h-card backcompat]] rules, implemented by a conforming parser.

== See Also ==
* [[h-card]]
* [[representative-hcard]] — original hCard work, most of which applies equally to the updated algorithm