h-listing - Revision history

GRegorLove: s///

2022-11-13T21:56:02Z

s/<source>/<syntaxhighlight>/

← Older revision		Revision as of 21:56, 13 November 2022
Line 77:		Line 77:
	For instance, one could use a <kbd>data</kbd> element.		For instance, one could use a <kbd>data</kbd> element.

	<~~source~~ lang="~~html4strict~~">		<syntaxhighlight lang="html">
	<section class="h-listing" lang="fr">		<section class="h-listing" lang="fr">
	<h1><data class="action" value="sale">À vendre</data>! <span class="summary">Belle usine widget pour produire widgets magique et révolutionnaire</span></h1>		<h1><data class="action" value="sale">À vendre</data>! <span class="summary">Belle usine widget pour produire widgets magique et révolutionnaire</span></h1>
	</section>		</section>
	</~~source~~>		</syntaxhighlight>

Aaronpk: Replace with {{DISPLAYTITLE:}}

2020-07-18T16:23:36Z

Replace <entry-title> with {{DISPLAYTITLE:}}

← Older revision		Revision as of 16:23, 18 July 2020
Line 1:		Line 1:
	~~<entry-title>~~h-listing draft~~</entry-title>~~		{{DISPLAYTITLE:h-listing draft}}
	{{DraftSpecification}}		{{DraftSpecification}}

Tantek: editorial: drop explicit HTML5 from dfn, unnecessary

2017-08-03T21:44:20Z

editorial: drop explicit HTML5 from dfn, unnecessary

← Older revision		Revision as of 21:44, 3 August 2017
Line 2:		Line 2:
	{{DraftSpecification}}		{{DraftSpecification}}

	<dfn style="font-style:normal;font-weight:bold">h-listing</dfn> is a simple, open format for publishing product data on the web. h-listing is one of several open [[microformats\|microformat]] draft standards suitable for embedding data in HTML~~/HTML5~~.		<dfn style="font-style:normal;font-weight:bold">h-listing</dfn> is a simple, open format for publishing product data on the web. h-listing is one of several open [[microformats\|microformat]] draft standards suitable for embedding data in HTML.

	h-Listing is the [[microformats2]] update to [[hListing]].		h-Listing is the [[microformats2]] update to [[hListing]].

TomMorris: orthography: h-listing not h-Listing.

2014-12-04T23:45:38Z

orthography: h-listing not h-Listing.

← Older revision		Revision as of 23:45, 4 December 2014
Line 1:		Line 1:
	<entry-title>h-~~Listing~~ draft</entry-title>		<entry-title>h-listing draft</entry-title>
	{{DraftSpecification}}		{{DraftSpecification}}

	<dfn style="font-style:normal;font-weight:bold">h-~~Listing~~</dfn> is a simple, open format for publishing product data on the web. h-~~Listing~~ is one of several open [[microformats\|microformat]] draft standards suitable for embedding data in HTML/HTML5.		<dfn style="font-style:normal;font-weight:bold">h-listing</dfn> is a simple, open format for publishing product data on the web. h-listing is one of several open [[microformats\|microformat]] draft standards suitable for embedding data in HTML/HTML5.

	h-Listing is the [[microformats2]] update to [[hListing]].		h-Listing is the [[microformats2]] update to [[hListing]].
Line 26:		Line 26:
	While descriptions of products and services are common on the Web, particularly on e-commerce sites, we are proposing an hListing microformat for sharing, searching, and syndicating the information that helps match up buyers and sellers. This proposal follows the common practices of trading sites such as Craigslist, eBay and newspaper classifieds.		While descriptions of products and services are common on the Web, particularly on e-commerce sites, we are proposing an hListing microformat for sharing, searching, and syndicating the information that helps match up buyers and sellers. This proposal follows the common practices of trading sites such as Craigslist, eBay and newspaper classifieds.

	If [[hreview\|hReview]] is about an item and what you think of it, h-~~Listing~~ is about an item and what you want to ''do'' with it.		If [[hreview\|hReview]] is about an item and what you think of it, h-listing is about an item and what you want to ''do'' with it.

	=== Inspiration and Acknowledgments ===		=== Inspiration and Acknowledgments ===
Line 38:		Line 38:

	=== In General ===		=== In General ===
	The ~~hListing~~ format is based on a set of fields common to numerous listing sites and formats in use today on the web. Where possible field names have been chosen based on those defined by the related [[hreview\|hReview]], [[hcard\|hCard]], [[hcalendar\|hCalendar]] standards.		The h-listing format is based on a set of fields common to numerous listing sites and formats in use today on the web. Where possible field names have been chosen based on those defined by the related [[hreview\|hReview]], [[hcard\|hCard]], [[hcalendar\|hCalendar]] standards.


	=== Properties ===		=== Properties ===
Line 104:		Line 103:

	== implementations ==		== implementations ==
	Please add links to sites that consume h-~~Listings~~, and tools which generate h-~~Listings~~.		Please add links to sites that consume h-listings, and tools which generate h-listings.
	* ...		* ...

TomMorris: started work on h-listing

2014-12-03T12:37:45Z

started work on h-listing

← Older revision		Revision as of 12:37, 3 December 2014
Line 30:		Line 30:
	=== Inspiration and Acknowledgments ===		=== Inspiration and Acknowledgments ===
	Thanks to everyone who participated in the initial burst of hListing activity in August 2005, particularly Emiliano Martínez Luque and Trevor O'Reilly, for naming the effort and organizing the listing-{brainstorming, formats, examples} pages on the wiki. We would like to thank Tantek for an initial debate about whether to extend hReview or pursue an independent-though-similar hListing and later on, h-Listing for our proposal.		Thanks to everyone who participated in the initial burst of hListing activity in August 2005, particularly Emiliano Martínez Luque and Trevor O'Reilly, for naming the effort and organizing the listing-{brainstorming, formats, examples} pages on the wiki. We would like to thank Tantek for an initial debate about whether to extend hReview or pursue an independent-though-similar hListing and later on, h-Listing for our proposal.


	=== Scope ===		=== Scope ===
Line 43:		Line 42:

	=== Properties ===		=== Properties ===
			(Not yet finished)

	The class '''<code>h-listing</code>''' is a ''root class name'' that indicates the presence of an h-Listing.		The class '''<code>h-listing</code>''' is a ''root class name'' that indicates the presence of an h-Listing.

	* h-~~Listing~~		* <kbd>h-listing</kbd>: root
			** <kbd>p-lister</kbd>: [[h-card]]
			** <kbd>dt-listed</kbd>: datetime, optional
			** <kbd>dt-expired</kbd>: datetime, optional
			** <kbd>p-price</kbd>: text, optional (should include a floating-point number with optional ISO currency codes)
			** <kbd>p-category</kbd>: text, optional, zero or more
			** <kbd>p-action</kbd>: text, optional, one of the following values
			*** sell, rent, trade, meet, announce, offer, wanted, event, service
			** <kbd>u-url</kbd>


	==== Summary of Changes ====		==== Summary of Changes ====
			* Modified to use [[microformats-2]].
			* The <kbd>version</kbd> property from [[hListing]] has been deprecated. No hListing markup (even in example files used by parsers) has ever been presented that actually uses the version property, nor any enumeration of valid values. No other microformat thus far has had a version property, and explicit versioning seems like clumsy design: any future changes to the specification should be made in such a way as to support existing content and degrade gracefully per the [http://www.w3.org/TR/html-design-principles/#compatibility design principles of HTML].
			* The <kbd>dtlisted</kbd> and <kbd>dtexpired</kbd> properties are prefixed with <kbd>dt-</kbd> in microformats2 anyway, so no duplication of the <kbd>dt</kbd> is needed.
			* <kbd>lister</kbd> must contain an embedded <kbd>[[h-card]]</kbd> object for simplicity—the [[microformats-2-parsing]] specification would need to be modified to specify any optimisations there.
			* The use of [[rel-tag]] has been deprecated due to the <kbd>rel</kbd> attribute being defined as document scoped in HTML5. Following on from the example of <kbd>[[h-entry]]</kbd>, <kbd>category</kbd> seems the ideal mapping.
			* <kbd>permalink</kbd> has been replaced with <kbd>url</kbd> following [[h-entry]].

	==Property Details==		==Property Details==

	h-Listing property details:		h-Listing property details:

			==Authoring guidelines==

			=== action type internationalisation ===
			One issue with hard-coded action types is it prevents internationalisation.

			The <kbd>p-</kbd> value [[microformats-2-parsing#parsing_a_p-_property\|parsing algorithm]] can be used to provide an alternative text description in a non-English language, at the cost of introducing [[invisible data]].

			For instance, one could use a <kbd>data</kbd> element.

			<source lang="html4strict">
			<section class="h-listing" lang="fr">
			<h1><data class="action" value="sale">À vendre</data>! <span class="summary">Belle usine widget pour produire widgets magique et révolutionnaire</span></h1>
			</section>
			</source>


Line 59:		Line 88:


	=== ~~Challenge Problems~~ ===		=== Challenges and problems ===

	See [[h-listing-challenges\|h-Listing Challenge Problems]] for some hypothetical examples that illustrate corners of the specification.		See [[h-listing-challenges\|h-Listing Challenge Problems]] for some hypothetical examples that illustrate corners of the specification.

			* If no action is specified, should parsers assume the 'sale' property? A listing with no action seems less than useful.


Line 81:		Line 112:

	== Background ==		== Background ==
			Unlike [[hCard]], [[hCalendar]], [[hReview]] and other microformats, hListing has not been nearly as widely adopted. A number of inconsistencies and unclear properties has led to difficulty by page authors to implement the microformat.

	== Discussions ==		== Discussions ==
	* Feedback is encouraged on the [[h-listing-feedback]] page.		* Feedback is encouraged on the [[h-listing-feedback]] page.


	===Internationalization===		===Internationalization===

ChiefRA: corrected the case of h-Listing

2014-11-18T16:05:35Z

corrected the case of h-Listing

← Older revision		Revision as of 16:05, 18 November 2014
Line 1:		Line 1:
	<entry-title>h-~~listing~~ draft</entry-title>		<entry-title>h-Listing draft</entry-title>
	{{DraftSpecification}}		{{DraftSpecification}}

	<dfn style="font-style:normal;font-weight:bold">h-~~listing~~</dfn> is a simple, open format for publishing product data on the web. h-~~listing~~ is one of several open [[microformats\|microformat]] draft standards suitable for embedding data in HTML/HTML5.		<dfn style="font-style:normal;font-weight:bold">h-Listing</dfn> is a simple, open format for publishing product data on the web. h-Listing is one of several open [[microformats\|microformat]] draft standards suitable for embedding data in HTML/HTML5.

	h-~~listing~~ is the [[microformats2]] update to [[hListing]].		h-Listing is the [[microformats2]] update to [[hListing]].

	{{cc0-owfa-license}}		{{cc0-owfa-license}}

ChiefRA: created the h-listing draft page

2014-11-18T16:04:01Z

created the h-listing draft page

New page

<entry-title>h-listing draft</entry-title>
{{DraftSpecification}}

<dfn style="font-style:normal;font-weight:bold">h-listing</dfn> is a simple, open format for publishing product data on the web. h-listing is one of several open [[microformats|microformat]] draft standards suitable for embedding data in HTML/HTML5.

h-listing is the [[microformats2]] update to [[hListing]].

{{cc0-owfa-license}}

== Draft Proposal ==

===Editors===
* [[User:Tantek|Tantek Çelik]]
* [[User:TomMorris|Tom Morris]]
* [[User:ChiefRA|Arthur Rădulescu]]

===Authors and Contributors===

==Introduction==
Individuals and professionals are increasingly publishing their offerings online: whether as items for sale or rent (cars, homes, apartments), services for hire (music lessons, dog walker, plumber), openings (jobs, volunteers, extra spot in a book club) or personals (people looking for dates, companions, roommates). The goal of publishing (and promoting) these listings online is to seek out interested parties, often within a limited time period.

While descriptions of products and services are common on the Web, particularly on e-commerce sites, we are proposing an hListing microformat for sharing, searching, and syndicating the information that helps match up buyers and sellers. This proposal follows the common practices of trading sites such as Craigslist, eBay and newspaper classifieds.

If [[hreview|hReview]] is about an item and what you think of it, h-Listing is about an item and what you want to ''do'' with it.

=== Inspiration and Acknowledgments ===
Thanks to everyone who participated in the initial burst of hListing activity in August 2005, particularly Emiliano Martínez Luque and Trevor O'Reilly, for naming the effort and organizing the listing-{brainstorming, formats, examples} pages on the wiki. We would like to thank Tantek for an initial debate about whether to extend hReview or pursue an independent-though-similar hListing and later on, h-Listing for our proposal.

=== Scope ===

== Format ==

=== In General ===
The hListing format is based on a set of fields common to numerous listing sites and formats in use today on the web. Where possible field names have been chosen based on those defined by the related [[hreview|hReview]], [[hcard|hCard]], [[hcalendar|hCalendar]] standards.

=== Properties ===
The class '''<code>h-listing</code>''' is a ''root class name'' that indicates the presence of an h-Listing.

* h-Listing

==== Summary of Changes ====

==Property Details==

h-Listing property details:

==Examples==

=== Challenge Problems ===

See [[h-listing-challenges|h-Listing Challenge Problems]] for some hypothetical examples that illustrate corners of the specification.

== Examples in the Wild ==
This section is '''informative'''.

The following sites have implemented [[h-listing]], and thus are a great place to start for anyone looking for examples "in the wild" to try parsing, indexing, organizing etc. If your site is marked up with hListing, feel free to add it to the '''top''' of this list. Include both a URL to the top level site, and at least one URL to a specific hListing item on that site so that the hListing markup can be verified.

Once the list grows too big, we'll make a separate wiki page like [[h-listing-examples-in-wild]].

== implementations ==
Please add links to sites that consume h-Listings, and tools which generate h-Listings.
* ...

==Changes==

== Background ==

== Discussions ==
* Feedback is encouraged on the [[h-listing-feedback]] page.

===Internationalization===
''Internationalization:'' Though there are many English-language tokens, they are only used as class-names; user-visible listing information can be completely localized. N.b. that (X)HTML lang attribute rules still apply as usual, for multilingual aggregators of h-Listings.

== See also==
* [[h-listing]], a draft reboot of hListing based on [[microformats-2]]
* [[h-listing-issues]]
* [[h-listing-feedback]]
* [[h-listing-brainstorming]]
* [[commerce-examples]]
* [[currency]] proposal

[[Category:Draft Specifications]]