vote-links: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
(Brian Ellin implemented votelinks on jyte within less than 30 minutes)
m (s/<source>/<syntaxhighlight>/)
 
(32 intermediate revisions by 20 users not shown)
Line 1: Line 1:
= Vote Links =
{{DISPLAYTITLE:Vote Links}}
__TOC__
__TOC__
== Specification 2005 ==
== Specification 2005 ==
=== Editor ===
=== Editor ===
* [http://tantek.com/ Tantek Çelik], [http://technorati.com Technorati, Inc.] (formerly of [http://microsoft.com/ Microsoft Corporation])
* [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.], formerly of [http://microsoft.com/ Microsoft Corporation])


=== Concept ===
=== Concept ===
* [http://epeus.blogspot.com/ Kevin Marks], [http://technorati.com Technorati, Inc.]
* [http://epeus.blogspot.com/ Kevin Marks] ([http://technorati.com Technorati, Inc.])


=== Authors ===
=== Authors ===
* [http://epeus.blogspot.com/ Kevin Marks], [http://technorati.com Technorati, Inc]
* [http://epeus.blogspot.com/ Kevin Marks] ([http://technorati.com Technorati, Inc])
* [http://tantek.com/ Tantek Çelik], [http://technorati.com Technorati, Inc]
* [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc])


=== Copyright ===
=== Copyright ===
{{MicroFormatCopyrightStatement2004}}
{{MicroFormatPublicDomainContributionStatement}}
* [[User:Tantek|Tantek]]: I release all my contributions to this specification into the public domain and I encourage the other authors to do so as well.
* [[User:Kevin_Marks|Kevin Marks]]: I release all my contributions to this specification into the public domain and I encourage the other authors to do so as well.


=== Patents ===
=== Patents ===
Line 35: Line 37:


Examples:
Examples:
<pre><nowiki>
<syntaxhighlight lang="html">
<a rev=&quot;vote-for&quot; href=&quot;http://ragingcow.blogspot.com&quot;  
<a rev="vote-for" href="http://example.com/cheesevote"  
   title=&quot;neat spoof&quot;>Raging Cow</a>
   title="Melt the cheese!">Do it!</a>
<a rev=&quot;vote-against&quot; href=&quot;http://ragingcow.com&quot;  
<a rev="vote-against" href="http://example.com/cheesevote"  
   title=&quot;nasty corn syrup drink&quot;>Raging Cow</a>
   title="Don't melt the cheese!">Don't do it!</a>
</nowiki></pre>
</syntaxhighlight>


=== Deprecated: Using 'rel' for VoteLinks ===
=== Deprecated: Using 'rel' for VoteLinks ===
A previous draft of the specification used the 'rel' value instead of the 'rev' attribute.  Analysis and feedback has demonstrated this to have been inappropriate use of the 'rel' attribute, when the 'rev' attribute was much more important.  See the [[RelFAQ]] for more details.
A previous draft of the specification used the 'rel' attribute instead of the 'rev' attribute.  Analysis and feedback has demonstrated this to have been inappropriate use of the 'rel' attribute, when the 'rev' attribute was much more important.  See the [[RelFAQ]] for more details.


Implementations MAY support links with the VoteLinks values in the 'rel' attribute for backward compatibility with any existing VoteLinks content.
Implementations MAY support links with the VoteLinks values in the 'rel' attribute for backward compatibility with any existing VoteLinks content.
Line 50: Line 52:


== XMDP profile ==
== XMDP profile ==
<pre><nowiki>
The following is an [http://gmpg.org/xmdp/ XMDP] profile for the [[vote-links]] specification.
<dl class=&quot;profile&quot;>
 
  <dt id=&quot;rev&quot;>rev</dt>
=== URLs ===
  <dd><p><a rel=&quot;help&quot; href=&quot;http://www.w3.org/TR/html401/struct/links.html#adef-rev&quot;>
This profile is hosted as a separate XMDP file on microformats.org:
        HTML4 definition of the 'rev' attribute.</a>   
* http://microformats.org/profile/vote-links
  Here are some additional values.</p>
* shortURL: http://ufs.cc/x/vote-links
 
=== Usage ===
Profiles are referenced in (X)HTML files in the &lt;HEAD&gt; tag, e.g.:
<syntaxhighlight lang="html">
<head profile='http://microformats.org/profile/vote-links'>
</syntaxhighlight>
 
=== Profile ===
<syntaxhighlight lang="html">
<dl class="profile">
  <dt id="rev">rev</dt>
  <dd><p>
  <a rel="help" href="http://www.w3.org/TR/html401/struct/links.html#adef-rev">
    HTML4 definition of the 'rev' attribute.</a>   
  Here are additional values as defined in the
  <a rel="help start" href="http://microformats.org/wiki/vote-links">
  vote-links specification</a>
  .</p>
   <dl>
   <dl>
   <dt id=&quot;vote-for&quot;>vote-for</dt>
   <dt id="vote-for">vote-for</dt>
   <dd>Indicates agreement with or recommendation for the referred resource.</dd>
   <dd>Indicates agreement with or recommendation for the referred resource.</dd>
   <dt id=&quot;vote-abstain&quot;>vote-abstain</dt>
   <dt id="vote-abstain">vote-abstain</dt>
   <dd>Indicates abstention or indifference for the referred resource.</dd>
   <dd>Indicates abstention or indifference for the referred resource.</dd>
   <dt id=&quot;vote-against&quot;>vote-against</dt>
   <dt id="vote-against">vote-against</dt>
   <dd>Indicates disagreement with or recommendation against the referred resource.</dd>
   <dd>Indicates disagreement with or recommendation against the referred resource.</dd>
   </dl>
   </dl>
  </dd>
  </dd>
</dl>
</dl>
</nowiki></pre>
</syntaxhighlight>


== Implementations ==
== Implementations ==
This section is '''informative'''.
This section is '''informative'''.
* Following a [http://jyte.com/cl/jyte-should-integrate-microformats-votelinks vote-links claim] [http://jyte.com/profile/brianellin.com Brian Ellin] implemented vote-links on [http://jyte.com Jyte] within less than 30 minutes.
* [http://moloko.itc.it/paoloblog/ Paolo Massa] created [http://moloko.itc.it/paoloblog/semantic_links/ SemanticLinks], a small Firefox extension that shows vote-for, vote-against links information. (Note the download links for SemanticLinks have been removed by the author.)
* Wordpress VoteBack (vote-link aware pingback and trackback) plugin is in testing at [http://redmonk.net/archives/2006/12/21/voteback/ VoteBack] ([[User:SteveIvy|Steve Ivy]]) - looking for testers!


== Normative References ==
* Wordpress VoteBack (vote-link aware pingback and trackback) plugin is in testing at [http://monkinetic.com/2006/12/22/voteback.html VoteBack] ([[User:SteveIvy|Steve Ivy]]) - looking for testers!
** Any examples of WordPress sites running this? - [[User:Tantek|Tantek]] 23:42, 30 July 2012 (UTC)
 
=== past implementations ===
The following implementations went away or stopped working at some point:
 
* [http://folksr.de/ Folksr.de] - Apache test page (2012-07-30). Was: using VoteLinks to vote on the World Cup 2006
* '''jyte.com''' - "jyte is sleeping" (2012-07-30). Was: Following a [http://jyte.com/cl/jyte-should-integrate-microformats-votelinks vote-links claim] [http://jyte.com/profile/brianellin.com Brian Ellin] implemented vote-links on [http://jyte.com Jyte] within less than 30 minutes.
* '''moloko.itc.it''' site is unresponsive. was: [http://moloko.itc.it/paoloblog/ Paolo Massa] created [http://moloko.itc.it/paoloblog/semantic_links/ SemanticLinks], a small Firefox extension that shows vote-for, vote-against links information. (Note the download links for SemanticLinks have been removed by the author.)
 
== Examples in the wild ==
This section is '''informative'''.
 
The following sites have implemented VoteLinks , 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 marked up with VoteLinks, feel free to add it to the top of this list. Once the list grows too big, we'll make a separate wiki page.
<!--
 
          Add new items to the top of the list
 
-->
* [http://www.likeorhate.com/ LikeOrHate] uses Vote-Links all over the site, to rate anything, items, comments, users. Valid votes are Like, Hate, Whatever ("vote-for", "vote-against", "vote-abstain"). CSS is used to "check" votes so logged users can remember them later.
* [http://www.weboffate.com/ Web of Fate] Web of Fate publishes Vote-Links for prediction probability scoring. Users can vote Agree, Disagree, Witness ("vote-for", "vote-against", "vote-abstain")
* [http://tommorris.org/blog/ Tom Morris] has vote links on del.icio.us links (based on tags "vote-for", "vote-against" and "vote-abstain").
<!--
 
          Add new items to the top of the list
 
-->
 
== References ==
 
=== Normative References ===
* [http://gmpg.org/xmdp/ XMDP]
* [http://gmpg.org/xmdp/ XMDP]


=== Informative References ===
* [http://www.artweb-design.de/articles/2006/06/05/distributed-votings-using-microformats Distributed votings using microformats] from Artweb Design
* [http://24ways.org/2006/boost-your-hyperlink-power Boost Your Hyperlink Power] - Jeremy Keith, using CSS to surface vote information
* Contributed from <nowiki>http://developers.technorati.com/wiki/VoteLinks</nowiki> ([https://web.archive.org/web/20040301041935/http://developers.technorati.com/wiki/VoteLinks 2004-03-01 Internet Archive copy])
== Related Work ==
== Related Work ==
* [[xoxo]]
* [[xoxo]]
Line 88: Line 139:
* See [[vote-links-faq]] and the broader [[rel-faq]].
* See [[vote-links-faq]] and the broader [[rel-faq]].
* See also [[vote-links-issues]] for issues which have been raised with the votelinks [[microformat]].
* See also [[vote-links-issues]] for issues which have been raised with the votelinks [[microformat]].
[[Category:Specifications]]
[[Category:vote-links]]

Latest revision as of 21:41, 26 July 2023

Specification 2005

Editor

Concept

Authors

Copyright

Public Domain Contribution Requirement. Since the author(s) released this work into the public domain, in order to maintain this work's public domain status, all contributors to this page agree to release their contributions to this page to the public domain as well. Contributors may indicate their agreement by adding the public domain release template to their user page per the Voluntary Public Domain Declarations instructions. Unreleased contributions may be reverted/removed.

  • Tantek: I release all my contributions to this specification into the public domain and I encourage the other authors to do so as well.
  • Kevin Marks: I release all my contributions to this specification into the public domain and I encourage the other authors to do so as well.

Patents

This specification is subject to a royalty free patent policy, e.g. per the W3C Patent Policy, and IETF RFC3667 & RFC3668.

Inspiration and Acknowledgments

Thanks to everyone who has given feedback on VoteLinks. Thanks especially to EtanWexler, who provided the first really good documentation that VoteLinks should be using 'rev' instead of 'rel' (see VoteLinksFAQ), and John Allsopp who similarly challenged the use of 'rel', and helped co-author the RelFAQ exploring questions and issues about the use of the HTML4 'rel', 'rev' attributes and linktypes in general.

Introduction

Indexing and tracking applications treat all links as endorsements, or expressions of support. This is a problem, as we need to link to those we disagree with as well, to discuss why.

Specification

VoteLinks is an elemental microformat, one of several microformat open standards. We propose a set of three new values for the rev attribute of the <a> (hyperlink) tag in HTML.

The new values are "vote-for" "vote-abstain" or "vote-against", which are mutually exclusive, and represent agreement, abstention or indifference, and disagreement respectively.

A link without an explicit vote 'rev' value is deemed to have value "vote-for" or "vote-abstain", depending on the application.

Additional human-readable commentary can be added using the existing 'title' attribute, which most browsers show as a rollover.

Examples:

<a rev="vote-for" href="http://example.com/cheesevote"  
   title="Melt the cheese!">Do it!</a>
<a rev="vote-against" href="http://example.com/cheesevote"  
   title="Don't melt the cheese!">Don't do it!</a>

Deprecated: Using 'rel' for VoteLinks

A previous draft of the specification used the 'rel' attribute instead of the 'rev' attribute. Analysis and feedback has demonstrated this to have been inappropriate use of the 'rel' attribute, when the 'rev' attribute was much more important. See the RelFAQ for more details.

Implementations MAY support links with the VoteLinks values in the 'rel' attribute for backward compatibility with any existing VoteLinks content.

Authors MUST NOT use 'rel' for VoteLinks values.

XMDP profile

The following is an XMDP profile for the vote-links specification.

URLs

This profile is hosted as a separate XMDP file on microformats.org:

Usage

Profiles are referenced in (X)HTML files in the <HEAD> tag, e.g.:

<head profile='http://microformats.org/profile/vote-links'>

Profile

<dl class="profile">
 <dt id="rev">rev</dt>
 <dd><p>
   <a rel="help" href="http://www.w3.org/TR/html401/struct/links.html#adef-rev">
     HTML4 definition of the 'rev' attribute.</a>  
   Here are additional values as defined in the
   <a rel="help start" href="http://microformats.org/wiki/vote-links">
   vote-links specification</a> 
   .</p>
  <dl>
   <dt id="vote-for">vote-for</dt>
   <dd>Indicates agreement with or recommendation for the referred resource.</dd>
   <dt id="vote-abstain">vote-abstain</dt>
   <dd>Indicates abstention or indifference for the referred resource.</dd>
   <dt id="vote-against">vote-against</dt>
   <dd>Indicates disagreement with or recommendation against the referred resource.</dd>
  </dl>
 </dd>
</dl>

Implementations

This section is informative.

  • Wordpress VoteBack (vote-link aware pingback and trackback) plugin is in testing at VoteBack (Steve Ivy) - looking for testers!
    • Any examples of WordPress sites running this? - Tantek 23:42, 30 July 2012 (UTC)

past implementations

The following implementations went away or stopped working at some point:

  • Folksr.de - Apache test page (2012-07-30). Was: using VoteLinks to vote on the World Cup 2006
  • jyte.com - "jyte is sleeping" (2012-07-30). Was: Following a vote-links claim Brian Ellin implemented vote-links on Jyte within less than 30 minutes.
  • moloko.itc.it site is unresponsive. was: Paolo Massa created SemanticLinks, a small Firefox extension that shows vote-for, vote-against links information. (Note the download links for SemanticLinks have been removed by the author.)

Examples in the wild

This section is informative.

The following sites have implemented VoteLinks , 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 marked up with VoteLinks, feel free to add it to the top of this list. Once the list grows too big, we'll make a separate wiki page.

  • LikeOrHate uses Vote-Links all over the site, to rate anything, items, comments, users. Valid votes are Like, Hate, Whatever ("vote-for", "vote-against", "vote-abstain"). CSS is used to "check" votes so logged users can remember them later.
  • Web of Fate Web of Fate publishes Vote-Links for prediction probability scoring. Users can vote Agree, Disagree, Witness ("vote-for", "vote-against", "vote-abstain")
  • Tom Morris has vote links on del.icio.us links (based on tags "vote-for", "vote-against" and "vote-abstain").

References

Normative References

Informative References

Related Work

FAQ