hcomment - Revision history

Tantek: name update, see instead

2018-06-08T22:58:35Z

name update, see instead

← Older revision		Revision as of 22:58, 8 June 2018
Line 1:		Line 1:
			{{instead\|https://indieweb.org/reply}}

	{{DeprecatedHistoricalPage}}		{{DeprecatedHistoricalPage}}

Line 27:		Line 29:
	* [http://sippey.typepad.com/ Michael Sippey], [http://sixapart.com Six Apart, Ltd.]		* [http://sippey.typepad.com/ Michael Sippey], [http://sixapart.com Six Apart, Ltd.]
	* [http://mokolabs.com/ Patrick Crowley], [http://evdb.com EVDB, Inc.]		* [http://mokolabs.com/ Patrick Crowley], [http://evdb.com EVDB, Inc.]
	* [http://~~edward~~.oconnor.cx/ ~~Edward~~ O'Connor], [http://evdb.com EVDB, Inc.]		* [http://tess.oconnor.cx/ Theresa O'Connor], [http://evdb.com EVDB, Inc.]

	== Introduction ==		== Introduction ==

MarkNg: /* Human vs. Machine Readable */

2008-03-05T09:22:37Z

Human vs. Machine Readable

← Older revision		Revision as of 09:22, 5 March 2008
Line 132:		Line 132:

	=== Human vs. Machine Readable ===		=== Human vs. Machine Readable ===
	If an <code><abbr></code> element is used for a property, then its '<code>title</code>' attribute is used for the value of the property, instead of the contents of the element, which can then be used to provide a user-friendly alternate presentation of the value.		If an <code><abbr></code> element is used for a property, then its '<code>title</code>' attribute is used for the value of the property, instead of the contents of the element, which can then be used to provide a user-friendly alternate presentation of the value.

	Similarly, if an <code><img /></code> element is used for one or more properties, it MUST be treated as follows:		Similarly, if an <code><img /></code> element is used for one or more properties, it MUST be treated as follows:

Tantek at 23:18, 29 January 2008

2008-01-29T23:18:24Z

← Older revision		Revision as of 23:18, 29 January 2008
Line 1:		Line 1:
	{{DeprecatedHistoricalPage}}		{{DeprecatedHistoricalPage}}

			'''This page needs a major rewrite/edit. It appears to mostly be content copied from [[hReview]] without removing the hReview-specific content such as the draft spec note, date, authors, etc. This can be fixed by:'''
			* Analyze what aspects are "comment" specific (rather than just copied from hReview)
			* Extract comment-specific ideas/thoughts etc., and place them by themselves into a [[comment-brainstorming]] page.
			* Reference [[hAtom]] for possible additional comment brainstorming (i.e. how to markup blog comments (in addition to posts) with hAtom).
			* Leave a redirect from this page to [[comment-brainstorming]]
			[[User:Tantek\|Tantek]] 15:18, 29 Jan 2008 (PST)

	= hComment 0.1 =		= hComment 0.1 =

AndyMabbett: fmt

2008-01-17T22:40:20Z

fmt

← Older revision		Revision as of 22:40, 17 January 2008
Line 5:		Line 5:
	hComment is a simple, open, distributed comment format suitable for embedding in (X)HTML, Atom, RSS, and arbitrary XML. hComment is one of several [[microformats]] open standards.		hComment is a simple, open, distributed comment format suitable for embedding in (X)HTML, Atom, RSS, and arbitrary XML. hComment is one of several [[microformats]] open standards.

	~~__TOC__~~		{{TOC-right}}

	== Draft Specification 2005-06-22 ==		== Draft Specification 2005-06-22 ==

RobertBachmann: Used Template:DeprecatedHistoricalPage

2005-10-25T19:13:03Z

Used Template:DeprecatedHistoricalPage

← Older revision		Revision as of 19:13, 25 October 2005
Line 1:		Line 1:
	~~''This page is deprecated because it doesn't follow the [[process]] but it is left online for historical purposes.''~~		{{DeprecatedHistoricalPage}}

	= hComment 0.1 =		= hComment 0.1 =

RobertBachmann: /* hComment 0.1 */ Added deprecation note

2005-10-24T19:27:38Z

hComment 0.1: Added deprecation note

← Older revision		Revision as of 19:27, 24 October 2005
Line 1:		Line 1:
			''This page is deprecated because it doesn't follow the [[process]] but it is left online for historical purposes.''

	= hComment 0.1 =		= hComment 0.1 =

64.239.183.15: /* Authors */

2005-06-23T23:36:26Z

Authors

← Older revision		Revision as of 23:36, 23 June 2005
Line 11:		Line 11:

	=== Authors ===		=== Authors ===
	* [http://tantek.com/ Tantek ~~«elik~~], [http://technorati.com Technorati, Inc.]		* [http://tantek.com/ Tantek Çelik], [http://technorati.com Technorati, Inc.]
	* [http://360.yahoo.com/alidiabali Ali Diab],[http://yahoo.com Yahoo! Inc.]		* [http://360.yahoo.com/alidiabali Ali Diab],[http://yahoo.com Yahoo! Inc.]
	* [http://spaces.msn.com/members/ianmcallister/ Ian McAllister], [http://microsoft.com/ Microsoft Corporation]		* [http://spaces.msn.com/members/ianmcallister/ Ian McAllister], [http://microsoft.com/ Microsoft Corporation]

64.239.183.15: /* Editor */

2005-06-23T23:36:15Z

Editor

← Older revision		Revision as of 23:36, 23 June 2005
Line 8:		Line 8:

	=== Editor ===		=== Editor ===
	* [http://tantek.com/ Tantek ~~«elik~~], [http://technorati.com Technorati, Inc.]		* [http://tantek.com/ Tantek Çelik], [http://technorati.com Technorati, Inc.]

	=== Authors ===		=== Authors ===

EdwardOConnor: initial version

2005-06-22T22:17:31Z

initial version

New page

= hComment 0.1 =

hComment is a simple, open, distributed comment format suitable for embedding in (X)HTML, Atom, RSS, and arbitrary XML. hComment is one of several [[microformats]] open standards.

__TOC__

== Draft Specification 2005-06-22 ==

=== Editor ===
* [http://tantek.com/ Tantek «elik], [http://technorati.com Technorati, Inc.]

=== Authors ===
* [http://tantek.com/ Tantek «elik], [http://technorati.com Technorati, Inc.]
* [http://360.yahoo.com/alidiabali Ali Diab],[http://yahoo.com Yahoo! Inc.]
* [http://spaces.msn.com/members/ianmcallister/ Ian McAllister], [http://microsoft.com/ Microsoft Corporation]
* [http://journals.aol.com/panzerjohn/abstractioneer John Panzer], [http://www.aol.com America Online, Inc.]
* [http://ifindkarma.com/blog Adam Rifkin], [http://labs.commerce.net/ CommerceNet Labs]
* [http://sippey.typepad.com/ Michael Sippey], [http://sixapart.com Six Apart, Ltd.]
* [http://mokolabs.com/ Patrick Crowley], [http://evdb.com EVDB, Inc.]
* [http://edward.oconnor.cx/ Edward O'Connor], [http://evdb.com EVDB, Inc.]

== Introduction ==

In order to enable and encourage the sharing, distribution, syndication, and aggregation, of comments, the authors propose the hComment MicroFormat, an open standard for distributed comments.

A "comment" is a block of text which allows a user to express an opinion, thought, or other feedback about a particular content object (an article, blog entry, event, venue, product, etc.).

At present, every website has its own way of rendering comments into XHTML, making intra-site comment sharing, searching, and aggregation difficult. Trackbacks have shown the potential of intra-site discussion. Why not allow all comments to jump the chasm too?

Note: this standard is a reformulation of the hReview Microformat.

=== Relationship between hComment and hReview ===

A "review" is simply a comment with additional properties such as a rating or a specific object reference. Numerous web sites publish reviews using a broad variety of schema for all sorts of things from products (movies, music, books), to businesses (restaurants, hotels, stores), to events (concerts, theatre), to people (artists, leaders, celebrities), to places (landmarks, parks), to online resources (web pages, files), to reviews of reviews themselves.

Since reviews and comments overlap so substantially, they should share a common microformat standard. So, instead of two mutually exclusive standards which contain 98% of the same functionality, hReview will be expressed in terms of hComment.

==== Expressing hReview in terms of hComment ====

If hReview v0.3 is to be expressed in terms of hComment, here's what would need to be done:

* Remove tags, permalink, description, summary, item type, item info, as they're now in hComment
* Retain rating, as it's not in hComment
* Remove reviewer and dtreviewed in favor of hcomment's poster and dtposted
** transition can have dual-classing: <code>class="dtposted dtreviewed"</code> is fine
* Deal with version being present in both somehow

=== Working Name ===
The name "hComment" is a working name for this microformat. The name was suggested as it shares much with the hCard and hCalendar microformats, despite not having an IETF RFC to reference for a normative schema.

=== Copyright ===
{{MicroformatCopyrightStatement2005}}

=== Patents ===
{{MicroFormatPatentStatement}}

=== Inspiration and Acknowledgments ===
Thanks to everyone who responded to the open call for implementor participation for hReview. The authors in particular wish to thank the following individuals for their constructive input and feedback: [http://www.richardault.com/ Richard Ault], [http://dannyayers.com Danny Ayers], [http://www.vertexdev.com/~jeff/ Jeffrey Barr],[http://adriancuthbert.blogspot.com/ Adrian Cuthbert],[http://jason.defillippo.com/ Jason DeFillippo], [http://www.hybernaut.com/bdv Brian Del Vecchio], Scott Derringer, [http://budgibson.com/home/ Bud Gibson], [http://joi.ito.com/ Joi Ito], [http://www.kanai.net/weblog/ Gen Kanai],[http://niallkennedy.com/ Niall Kennedy], [http://labs.commerce.net/wiki/index.php/Rohit_Khare Rohit Khare], [http://theryanking.com/ Ryan King], [http://www.jluster.org/ Jonas Luster], [http://epeus.blogspot.com/ Kevin Marks], [http://www.powazek.com/ Derek Powazek], [http://www.judysbook.com/ Jeff Rodenburg], [http://sifry.com/alerts/ David Sifry], [http://jystewart.net/ James Stewart], [http://kung-foo.tv/ Adriaan Tijsseling], [http://www.flashenabled.com/ Phillip Torrone], Thai Tran, [http://w6daily.winn.com/ Phillip Winn], [http://yohei-y.blogspot.com YAMAMOTO Yohei].

=== Scope ===
Comments consistently share several common fields. Where possible hComment has been based on this minimal common subset.

==== Out of scope ====
Fields that are type-specific have been omitted from hComment. It is important that hComment be kept simple and minimal from the start. Additional features can be added as deemed necessary by practical implementation experience.

The concept of a "universal object identifier", that is, how to identify the same object/item/product across different shopping sites, though something very useful to have, is outside the scope of this format.

== Semantic XHTML Design Principles ==
{{SemanticXHTMLDesignPrinciples}}

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

=== Schema ===
The hComment schema consists of the following:

* hComment
** version. optional. text.
** summary. optional. text.
** item type. optional. product | business | event | person | place | website | url.
** item info. required. (fn || url || photo ) | [[hcard|hCard]] (for person or business).
** poster. required. [[hcard|hCard]] | fn | email | url.
** dtposted. required. ISO8601 absolute date time.
** description. optional. text with optional valid XHTML markup.
** tags. optional. keywords or phrases, using RelTag, each with optional rating.
** permalink. optional.

=== Field details ===
The fields of the hComment schema represent the following:

'''version''':: This optional field permits hComment publishers to specify a particular version of hComment that their content uses. By omitting this field, the publisher is stating that implementations may interpret the hComments according to any version of the hComment specification v0.1 or later. In practice the authors of this specification are comitted to maintaining backward compatibility with content produced using earlier versions of the specification. This field is syntax compatible with, and thus reuses the semantics of "VERSION" as defined in vCard RFC2426 section "3.6.9 VERSION Type Definition". The value of this field for this specification is "0.1".

'''summary''':: This optional field serves as a title for the comment itself.

'''item type''':: This optional field "type" provides the type of the item being commented upon, one of the following: product, business, event, person, place, website, url.

'''item info''':: This optional field, when present, MUST have at a minimum the name ("fn" - the formatted text corresponding to the name) of the item, SHOULD provide at least one URI ("url") for the item, and MAY provide at least one URL to a photo or depiction ("photo") of the item. For items of type person or business, the item info (fn, url, photo) SHOULD be encapsulated in an [[hcard|hCard]]. Unique item IDs (e.g. ISBNs, UPCs) MAY be represented as a URN ("url") for the item. When an hComment lacks this field, the hComment is implicitly assumed to be a comment on the page on which it appears.

'''poster''':: The person who authored the comment. An hCard representing the poster SHOULD be provided with full name and URL. Alternatively, just a name, email address, or URL to the person MAY be provided. To specify more than one of those, encapsulate them in an hCard. For anonymous comments, use "anonymous" (without quotes) for the full name of the poster.

'''dtposted''':: This required field MUST provide an ISO8601 absolute date time of when the comment was written or otherwise authored. This field SHOULD use UTC, but MAY use the time zone offset syntax.

'''description''':: This optional field contains the full text representing the written opinion of the poster. The field MAY include valid XHTML markup (e.g. paragraphs). User agents SHOULD preserve any markup. Multiple descriptions or section descriptions (e.g. pros and cons, plusses and minusses) SHOULD be included in the description field.

'''tags''':: Tags are represented using a list of keywords or phrases (using the [[reltag|RelTag]] microformat for each individual keyword or phrase tag) that the poster associates with the item. Authors MAY enclose all tags for a comment inside an element with a specific classname, e.g. "categories" (from vCard RFC2426 and iCalendar RFC2445), but are not required to do so.

'''permalink''':: This optional field is a URL for the hComment. In addition to using the <code><a href></code> tag for this field, the attribute <code>rel="self bookmark"</code> MUST be used to indicate that the hyperlink is a permalink for the comment itself. If the hyperlink already contains a <code>rel</code> attribute, then the values <code>self</code> and <code>bookmark</code> MUST be included among the space-separated set of values in the attribute. Indexers MAY treat the permalink of a comment as a unique ID in order to identify and collate the same comment from multiple sources (such as indexing a page multiple times). The permalink MAY also be used to indicate or imply the origin of the comment. Authors MAY use the classname of "permalink" on the element representing the permalink, but are not required to do so.

The following field names have been reused from the [[hcard|hCard]] and [[hcalendar|hCalendar]] microformats: <code>version, summary, fn, url, email, photo, description, categories</code>. In addition, items and posters described by hCards MAY contain any hCard field.

=== More Semantic Equivalents ===

For some properties there is a more semantic equivalent, and therefore they get special treatment, e.g.:

* For any "url", use <code><a class="url" href="...">...</a></code> inside the element with class="hreview" in hComment.
* Similarly, any "email", use <code><nowiki><a class="email" href="mailto:...">...</a></nowiki></code>
* And for "photo", use <code><img class="photo" src="..." alt="Photo of ..." /></code>

==== Language ====
* To explicitly convey the natural language that an hComment is written in, use the standard (X)HTML 'lang' attribute on the element with class="hcomment", e.g. <code><div class="hcomment" lang="en"> ... </div></code> If portions of an hComment (e.g. the item name) are in a different language, use the 'lang' attribute on those portions.
* hComment processors which need to handle the language of comments MUST process the standard (X)HTML 'lang' attribute as specified.

=== Human vs. Machine Readable ===
If an <code><abbr></code> element is used for a property, then its '<code>title</code>' attribute is used for the value of the property, instead of the contents of the element, which can then be used to provide a user-friendly alternate presentation of the value.

Similarly, if an <code><img /></code> element is used for one or more properties, it MUST be treated as follows:

# For the "photo" property and any other property that takes a URL as its value, the <code>src="..."</code> attribute provides the property value.
# For other properties, the <code><img /></code> element's '<code>alt</code>' attribute is the value of the property.

=== Notes ===
This section is informative.

* By marking up a comment with the hComment microformat, the expectation is communicated that the comment MAY be indexed. This has no impact on the copyright of the comment itself.
* The enumerated list of item types is under development and may be extended.
* Each type may have custom hComment fields that follow the common set.
* Additional details about a particular item should be specified with the rest of the item's info at the URL provided for the item.

== Examples ==
Here are a few examples of comments from current web sites, and how they could be easily enhanced to support the hComment structured comment microformat.

=== Blog comments ===

Here is an example of a simple blog comment (based on a real blog comment from [http://www.microformats.org/blog/2005/06/20/microformats-workshop-at-supernova2005/#comments here]):

<code><pre><nowiki>
<div id="comment-9">
<cite><a href='http://http//9rules.com' rel='external nofollow'>Mike</a></cite>:
<br />
<p>Microformats sound cool, thanks for the great site guys!
</p>
<p class="com-meta"><a href="#comment-9" title="">June 22nd, 2005 at 9:28 am</a> </p>
</div>
</nowiki></pre></code>

Adding hComment to this comment is quite simple:

<code><pre><nowiki>
<div class="hcomment" id="comment-9">
<cite class="poster vcard"><a class="url fn" href='http://http//9rules.com' rel='external nofollow'>Mike</a></cite>:
<p class="description">
Microformats sound cool, thanks for the great site guys!
</p>
<p class="com-meta"><a class="dtposted url" href="#comment-9" title="20050622T0928Z">June 22nd, 2005 at 9:28 am</a></p>
</div>
</nowiki></pre></code>

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

The following sites have published hComments, and thus are a great place to start for anyone looking for examples "in the wild" to try parsing, indexing, organizing etc. If you publish hComments on your own page, feel free to add it to the top of this list. Once the list grows too big, we'll make a separate wiki page.

[Coming soon!]

== Implementations ==
This section is '''informative'''.

The following implementations have been developed which either generate or parse hComments. If you have an hComment implementation, feel free to add it to the top of this list. Once the list grows too big, we'll make a separate wiki page.

== References ==
=== Normative References ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [http://gmpg.org/xmdp/ XMDP]
* [[hcard|hCard]]
* [[hcalendar|hCalendar]]
* [[reltag|RelTag]]
* [http://www.ietf.org/rfc/rfc2119.txt RFC2119]
* [http://www.ietf.org/rfc/rfc3986.txt RFC3986]

=== Informative References ===
* [http://www.w3.org/TR/REC-CSS1 CSS1]
* ISO.8601.1988
** International Organization for Standardization, "Data elements and interchange formats - Information interchange - Representation of dates and times", ISO Standard 8601, June 1988.
* [http://www.w3.org/TR/1998/NOTE-datetime-19980827 W3C NOTE-datetime-19980827]
* [http://www.ietf.org/rfc/rfc3667.txt RFC3667]
* [http://www.ietf.org/rfc/rfc3668.txt RFC3668]
* [http://www.w3.org/Consortium/Patent-Policy-20040205/ W3C Patent Policy]

==== Similar Work ====
* [[xoxo]]

== Work in progress ==
This specification is a work in progress. As additional aspects are discussed, understood, and written, they will be added.

=== Changes from hReview v0.2 ===
The following changes have been made in hComment v0.1:
# removed '''rating''' field
# changed '''reviewer''' to '''poster'''
# changed '''dtreviewed''' to '''dtposted'''
# removed many examples :(

== Feedback ==
* Feedback is encouraged on the [[Talk:hcomment]] page.
* See also [http://www.technorati.com/cosmos/referer.html blogs discussing this page].