rel-tag-ja: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
No edit summary
 
(start translating)
Line 1: Line 1:
= rel="tag" =
<h1> rel-tag </h1>
<!-- English: 14:44, 13 Jul 2006 -->
__TOC__
__TOC__


== Draft Specification 2005-01-10 ==
== 仕様ドラフト 2005-01-10 ==
=== Editor/Author ===
=== 編者/作者 ===
[http://tantek.com/ Tantek Çelik]
[http://tantek.com/ Tantek Çelik]


=== Concept ===
=== 原案 ===
[http://powazek.com/ Derek Powazek]
[http://powazek.com/ Derek Powazek]
[http://epeus.blogspot.com/ Kevin Marks]
[http://epeus.blogspot.com/ Kevin Marks]


=== Copyright ===
=== 著作権 ===
{{MicroFormatCopyrightStatement2004}}
{{MicroFormatCopyrightStatement2004}}


=== Patents ===
=== 特許 ===
{{MicroFormatPatentStatement}}
{{MicroFormatPatentStatement}}


== Abstract ==
== 概要 ==
[[Rel-Tag]] is one of several [[MicroFormats]].  By adding <code>rel="tag"</code> to a hyperlink, a page indicates that the destination of that hyperlink is an author-designated "tag" (or keyword/subject) of the current page. Note that a tag may just refer to a major portion of the current page (i.e. a blog post). e.g. by placing this link on a page,
[[rel-tag-ja]][[microformats-ja]]のひとつです。ハイパーリンクに<code>rel=&quot;tag&quot;</code>を書き加える事により、リンク元のページに対しページ作者が定義した「タグ(キーワードやテーマ)」を関連づけることができます。
タグはblogの記事内容すべてに関係する言葉とは限りません。たとえば次のようなリンクでタグを関連づけるとします。


<pre><nowiki><a href="http://technorati.com/tag/tech" rel="tag">tech</a></nowiki></pre>
<pre><nowiki><a href=&quot;http://technorati.com/tag/tech&quot; rel=&quot;tag&quot;>tech</a></nowiki></pre>


the author indicates that the page (or some portion of the page) has the tag "tech".
これは作者がこのWebページ(または内容の一部)に「tech」というタグをつけていることを意味します。


The linked page SHOULD exist, and it is the linked page, rather than the link text that defines the tag.
リンク先のページはWeb上に存在するべき(SHOULD)であり、またタグの意味はリンクテキストの内容よりも、リンク先のページが持つ情報が優先されます。たとえば次のようなマークアップでページに対しタグ付けを行ったとします。
 
<pre><nowiki><a href=&quot;http://technorati.com/tag/tech&quot; rel=&quot;tag&quot;>fish</a></nowiki></pre>
 
URLの最後にある単語がタグの意味として扱われるので、この場合ページのタグは「fish」ではなく「tech」となります。


== Scope ==
== Scope ==
rel="tag" is specifically designed for "tagging" content, typically web pages (or portions thereof, like blog posts).
rel=&quot;tag&quot; is specifically designed for &quot;tagging&quot; content, typically web pages (or portions thereof, like blog posts).


rel="tag" is NOT designed for "tagging" arbitrary URLs or external content.  There is demand for a general decentralized syntax for tagging URLs, and that is certainly something to think about, but this is not meant for that.  
rel=&quot;tag&quot; is NOT designed for &quot;tagging&quot; arbitrary URLs or external content.  There is demand for a general decentralized syntax for tagging URLs, and that is certainly something to think about, but this is not meant for that.  See [[xfolk|xFolk]] and [[hreview|hReview]] for ways to tag arbitrary URLs.


== XMDP profile ==
== XMDP profile ==
<pre><nowiki>
<pre><nowiki>
<dl class="profile">
<dl class=&quot;profile&quot;>
  <dt id="rel">rel</dt>
  <dt id=&quot;rel&quot;>rel</dt>
  <dd><p>
  <dd><p>
   <a rel="help" href="http://www.w3.org/TR/html401/struct/links.html#adef-rel">
   <a rel=&quot;help&quot; href=&quot;http://www.w3.org/TR/html401/struct/links.html#adef-rel&quot;>
     HTML4 definition of the 'rel' attribute.</a>   
     HTML4 definition of the 'rel' attribute.</a>   
   Here is an additional value.</p>
   Here is an additional value.</p>
   <dl>
   <dl>
   <dt id="tag">tag</dt>
   <dt id=&quot;tag&quot;>tag</dt>
   <dd>Indicates that the referred resource serves as a "tag",  
   <dd>Indicates that the referred resource serves as a &quot;tag&quot;,  
       or keyword/subject, for the referring page.</dd>
       or keyword/subject, for the referring page.</dd>
   </dl>
   </dl>
Line 49: Line 55:
== Tag Spaces ==
== Tag Spaces ==


Tags are embedded in HTTP URIs in a well-defined manner so that the tag embedded in an HTTP URI can be mechanically extracted from that URI. Specifically, the last segment of the path portion of the URI contains the tag value. For example, the URI <pre><nowiki>http://www.example.com/tags/foo</nowiki></pre> contains the tag "foo".  
Tags are embedded in HTTP URIs in a well-defined manner so that the tag embedded in an HTTP URI can be mechanically extracted from that URI. Specifically, the last segment of the path portion of the URI (after the final "/" character) contains the tag value. For example, the URI <pre><nowiki>http://www.example.com/tags/foo</nowiki></pre> contains the tag &quot;foo&quot;.  


Thus, for the purposes of comparing two HTTP URIs as tags, the last segment of the path portion should be extracted and only that value (that value of the tag) should be compared.
Thus, for the purposes of comparing two HTTP URIs as tags, the last segment of the path portion should be extracted and only that value (that value of the tag) should be compared.
Line 55: Line 61:
''Need more formal language about comparison and extraction process.''
''Need more formal language about comparison and extraction process.''


The destination of a rel="tag" hyperlink is required to be a tag space (a place that collates or defines tags), where the last component of the URL is the tag, e.g.  
The destination of a rel=&quot;tag&quot; hyperlink is required to be a tag space (a place that collates or defines tags), where the last segment of the path of the URL is the tag, e.g.  


<pre><nowiki>http://technorati.com/tag/tech </nowiki></pre>
<pre><nowiki>http://technorati.com/tag/tech </nowiki></pre>


is a URL for the tag "tech".
is a URL for the tag &quot;tech&quot;.


Since the only part of a tag space URL of which any structure is required is the last segment, a tag space URL can be hosted at any domain.  Authors may choose to link to a tag at a particular tag space in order to provide a specific meaning.  E.g. a tag for technology could link to:
Tags may only be placed in the URL path, and only in the last segment of the path.  Tags may not be placed in query parameters or fragment identifiers.  e.g.
 
<pre><nowiki>http://technorati.com/tag/tech?tag=fish#emu </nowiki></pre>
 
is still a URL for the tag &quot;tech&quot;, not &quot;fish&quot; or &quot;emu&quot;.
 
Since the only part of a tag space URL of which any structure is required is the last path segment, a tag space URL can be hosted at any domain.  Authors may choose to link to a tag at a particular tag space in order to provide a specific meaning.  E.g. a tag for technology could link to:


<pre><nowiki>  http://en.wikipedia.org/wiki/Technology </nowiki></pre>
<pre><nowiki>  http://en.wikipedia.org/wiki/Technology </nowiki></pre>
Trailing slashes in tag URLs are ignored, that is:
<pre><nowiki>  http://technorati.com/tag/Technology/ </nowiki></pre>
as a rel-tag URL is treated as:
<pre><nowiki>  http://technorati.com/tag/Technology </nowiki></pre>


== Encoding issues ==
== Encoding issues ==
Spaces can be encoded either as <code>+</code> or <code>%20</code>. Unicode characters are encoded as specified in [http://www.ietf.org/rfc/rfc3986.txt RFC 3986]. For example:
Spaces can be encoded either as <code>+</code> or <code>%20</code>. Unicode characters are encoded as specified in [http://www.ietf.org/rfc/rfc3986.txt RFC 3986]. For example:


<pre><nowiki><a href="http://technorati.com/tag/Sant%C3%A9+et+bien-%C3%AAtre" rel="tag">Santé et bien-être</a> </nowiki></pre>
<pre><nowiki><a href=&quot;http://technorati.com/tag/Sant%C3%A9+et+bien-%C3%AAtre&quot; rel=&quot;tag&quot;>Santé et bien-être</a> </nowiki></pre>
 
Note that if using Wikipedia as a tagspace, as discussed above, you should use <code>%20</code> as they remap '+' to <code>%2B</code>, causing  a page with a plus sign in the title (which usually does not exist) to appear.


== Tags Are Visible Metadata ==
== Tags Are Visible Metadata ==
<code>rel="tag"</code> hyperlinks are intended to be visible links on pages and posts.  This is in stark contrast to meta keywords (which were invisible and typically never revealed to readers), and thus is at least somewhat more resilient to the problems which plagued meta keywords.
<code>rel=&quot;tag&quot;</code> hyperlinks are intended to be visible links on pages and posts.  This is in stark contrast to meta keywords (which were invisible and typically never revealed to readers), and thus is at least somewhat more resilient to the problems which plagued meta keywords.


Making tag hyperlinks visible has the additional benefit of making it more obvious to readers if a page is abusing tag links, and thus providing more peer pressure for better behavior.  It also makes it more obvious to authors, who may not always be aware what invisible metadata is being generated on their behalf.
Making tag hyperlinks visible has the additional benefit of making it more obvious to readers if a page is abusing tag links, and thus providing more peer pressure for better behavior.  It also makes it more obvious to authors, who may not always be aware what invisible metadata is being generated on their behalf.


As a result the invisible tag link syntax variant: <code><link rel="tag" href="..." /></code> SHOULD NOT be supported by implementations.
As a result the invisible tag link syntax variant: <code><link rel=&quot;tag&quot; href=&quot;...&quot; /></code> SHOULD NOT be supported by implementations.


== Implementations ==
== Implementations ==
Line 82: Line 102:
The following implementations have been developed which either generate or parse rel-tag links. If you have a rel-tag 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.
The following implementations have been developed which either generate or parse rel-tag links. If you have a rel-tag 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.


* Nutch has a [[rel-tag]] parser [http://www.mail-archive.com/nutch-commits@lucene.apache.org/msg01014.html committed to their svn repository].
* [http://www.webstandards.org/action/dwtf/microformats/ Dreamweaver Extension suite] from the [http://webstandards.org/ Web Standards Project] enables rel-tagging from within Dreamweaver 8.
* [http://scooch.gr0w.com/ Scooch] slide show creator allows authors to generate rel-tags and group slide shows by rel-tag via a list or cloud with tag usage count.
* The Freetag plugin for the [http://www.s9y.org Serendipity] blog software supports rel-tags on a per-entry basis, as well as inside of its tag clouds.  (The Freetag plugin is available inside of SPARTACUS)
* [http://placenamehere.com/TXP/pnh_mf/ pnh_mf] is a plugin for [http://textpattern.com/ Textpattern] that supports embedding rel-tags and other microformats in templates and blog posts. Written by [http://placenamehere.com/ Chris Casciano].
* [http://www.truist.com/blog/493/trutags-a-tagging-plugin-for-textpattern tru_tags] is a plugin for [http://textpattern.com/ Textpattern] that supports rel-tagging blog posts via the Keywords field.
* [http://news.livejournal.com/86492.html?thread=24881884 LiveJournal] - see also [http://www.livejournal.com/support/faq.bml?cat=tags their FAQ regarding their tags support]
* [http://trac.labnotes.org/cgi-bin/trac.cgi/wiki/TagsLinks TagsLinks] Turn each tag into links that let you find related content on tagging services.
* [http://trac.labnotes.org/cgi-bin/trac.cgi/wiki/TagsLinks TagsLinks] Turn each tag into links that let you find related content on tagging services.
* [http://odeo.com ODEO] [http://odeo.com/blog/2005/07/adding-microformats-to-odeo.html publishes] rel-tags for user entered tags.
* [http://odeo.com ODEO] [http://odeo.com/blog/2005/07/adding-microformats-to-odeo.html publishes] rel-tags for user entered tags.
* [http://evdb.com EVDB] publishes rel-tags for user entered tags.
* [http://evdb.com EVDB] publishes rel-tags for user entered tags.
* [http://dev.wp-plugins.org/wiki/BunnysTechnoratiTags "Tag plugin for wordpress"]
* [http://dev.wp-plugins.org/wiki/BunnysTechnoratiTags Tag plugin for WordPress]
* [http://noone.org/blog/tags/Tagging Tag plugin for Blosxom]
* Technorati first implemented rel-tag in its [http://technorati.com/tag/ Technorati Tags] service.  Technorati indexes rel-tag tags.
* Technorati first implemented rel-tag in its [http://technorati.com/tag/ Technorati Tags] service.  Technorati indexes rel-tag tags.
* [http://consumingexperience.blogspot.com/2005/12/updated-multiple-word-technorati-tag.html Greasemonkey script for Firefox that generates tags for Blogger]


== References ==
== References ==
Line 93: Line 122:
* [http://www.w3.org/TR/xhtml1/ XHTML 1]
* [http://www.w3.org/TR/xhtml1/ XHTML 1]
* [http://gmpg.org/xmdp/ XMDP]
* [http://gmpg.org/xmdp/ XMDP]
* [http://www.ietf.org/rfc/rfc3986.txt RFC 3986 specifies URL syntax]
* RFC 3986 specifies URL syntax.  Section 3.3 specifies URL paths and path segments.


=== Informative References ===
=== Informative References ===
Line 102: Line 131:
* [[hcalendar|hCalendar]] can use rel-tag for categories
* [[hcalendar|hCalendar]] can use rel-tag for categories
* [http://technorati.com/help/tags.html Using Technorati Tags]
* [http://technorati.com/help/tags.html Using Technorati Tags]
* Contributed from http://developers.technorati.com/wiki/RelTag


== Discussions ==
== Discussions ==
 
* Feedback is encouraged on the [[rel-tag-feedback]] page.
* See [http://www.technorati.com/cosmos/referer.html blogs discussing this page].
* See also [http://www.technorati.com/cosmos/referer.html blogs discussing this page].
* History: [http://www.powazek.com/2005/07/000532.html How Tags Happened at Technorati] by [http://www.powazek.com/ Derek Powazek]


=== Q&A ===
=== Q&A ===
* If you have any questions about rel-tag, check the [[rel-faq|rel FAQ]], and if you don't find answers, add your questions!
* If you have any questions about rel-tag, check the [[rel-faq|rel FAQ]] first for general rel attribute questions, then check the [[rel-tag-faq|rel-tag FAQ]], and then if you don't find answers, ask your question on the [http://microformats.org/discuss microformats-discuss] mailing list.


=== Issues ===
=== Issues ===
* Please add any issues with the specification to the separate [[rel-tag-issues|rel-tag issues]] document.
* Please add any issues with the specification to the separate [[rel-tag-issues|rel-tag issues]] document.

Revision as of 08:45, 14 July 2006

rel-tag

仕様ドラフト 2005-01-10

編者/作者

Tantek Çelik

原案

Derek Powazek Kevin Marks

著作権

This specification is (C) 2004-2024 by the authors. However, the authors intend to submit (or already have submitted, see details in the spec) this specification to a standards body with a liberal copyright/licensing policy such as the GMPG, IETF, and/or W3C. Anyone wishing to contribute should read their copyright principles, policies and licenses (e.g. the GMPG Principles) and agree to them, including licensing of all contributions under all required licenses (e.g. CC-by 1.0 and later), before contributing.

特許

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

概要

rel-tag-jamicroformats-jaのひとつです。ハイパーリンクにrel="tag"を書き加える事により、リンク元のページに対しページ作者が定義した「タグ(キーワードやテーマ)」を関連づけることができます。 タグはblogの記事内容すべてに関係する言葉とは限りません。たとえば次のようなリンクでタグを関連づけるとします。

<a href="http://technorati.com/tag/tech" rel="tag">tech</a>

これは作者がこのWebページ(または内容の一部)に「tech」というタグをつけていることを意味します。

リンク先のページはWeb上に存在するべき(SHOULD)であり、またタグの意味はリンクテキストの内容よりも、リンク先のページが持つ情報が優先されます。たとえば次のようなマークアップでページに対しタグ付けを行ったとします。

<a href="http://technorati.com/tag/tech" rel="tag">fish</a>

URLの最後にある単語がタグの意味として扱われるので、この場合ページのタグは「fish」ではなく「tech」となります。

Scope

rel="tag" is specifically designed for "tagging" content, typically web pages (or portions thereof, like blog posts).

rel="tag" is NOT designed for "tagging" arbitrary URLs or external content. There is demand for a general decentralized syntax for tagging URLs, and that is certainly something to think about, but this is not meant for that. See xFolk and hReview for ways to tag arbitrary URLs.

XMDP profile

<dl class="profile">
 <dt id="rel">rel</dt>
 <dd><p>
   <a rel="help" href="http://www.w3.org/TR/html401/struct/links.html#adef-rel">
     HTML4 definition of the 'rel' attribute.</a>  
   Here is an additional value.</p>
  <dl>
   <dt id="tag">tag</dt>
   <dd>Indicates that the referred resource serves as a "tag", 
       or keyword/subject, for the referring page.</dd>
  </dl>
 </dd>
</dl>

Tag Spaces

Tags are embedded in HTTP URIs in a well-defined manner so that the tag embedded in an HTTP URI can be mechanically extracted from that URI. Specifically, the last segment of the path portion of the URI (after the final "/" character) contains the tag value. For example, the URI

http://www.example.com/tags/foo

contains the tag "foo".

Thus, for the purposes of comparing two HTTP URIs as tags, the last segment of the path portion should be extracted and only that value (that value of the tag) should be compared.

Need more formal language about comparison and extraction process.

The destination of a rel="tag" hyperlink is required to be a tag space (a place that collates or defines tags), where the last segment of the path of the URL is the tag, e.g.

http://technorati.com/tag/tech 

is a URL for the tag "tech".

Tags may only be placed in the URL path, and only in the last segment of the path. Tags may not be placed in query parameters or fragment identifiers. e.g.

http://technorati.com/tag/tech?tag=fish#emu 

is still a URL for the tag "tech", not "fish" or "emu".

Since the only part of a tag space URL of which any structure is required is the last path segment, a tag space URL can be hosted at any domain. Authors may choose to link to a tag at a particular tag space in order to provide a specific meaning. E.g. a tag for technology could link to:

  http://en.wikipedia.org/wiki/Technology 

Trailing slashes in tag URLs are ignored, that is:

  http://technorati.com/tag/Technology/ 

as a rel-tag URL is treated as:

  http://technorati.com/tag/Technology 

Encoding issues

Spaces can be encoded either as + or %20. Unicode characters are encoded as specified in RFC 3986. For example:

<a href="http://technorati.com/tag/Sant%C3%A9+et+bien-%C3%AAtre" rel="tag">Santé et bien-être</a> 

Note that if using Wikipedia as a tagspace, as discussed above, you should use %20 as they remap '+' to %2B, causing a page with a plus sign in the title (which usually does not exist) to appear.

Tags Are Visible Metadata

rel="tag" hyperlinks are intended to be visible links on pages and posts. This is in stark contrast to meta keywords (which were invisible and typically never revealed to readers), and thus is at least somewhat more resilient to the problems which plagued meta keywords.

Making tag hyperlinks visible has the additional benefit of making it more obvious to readers if a page is abusing tag links, and thus providing more peer pressure for better behavior. It also makes it more obvious to authors, who may not always be aware what invisible metadata is being generated on their behalf.

As a result the invisible tag link syntax variant: <link rel="tag" href="..." /> SHOULD NOT be supported by implementations.

Implementations

This section is informative.

The following implementations have been developed which either generate or parse rel-tag links. If you have a rel-tag 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

  • HTML 4
  • XHTML 1
  • XMDP
  • RFC 3986 specifies URL syntax. Section 3.3 specifies URL paths and path segments.

Informative References

Discussions

Q&A

  • If you have any questions about rel-tag, check the rel FAQ first for general rel attribute questions, then check the rel-tag FAQ, and then if you don't find answers, ask your question on the microformats-discuss mailing list.

Issues

  • Please add any issues with the specification to the separate rel-tag issues document.