View source

You do not have permission to edit pages, for the following reason:
The action you have requested is limited to users in the group Users.
You can view and copy the source of this page:
<entry-title> hReview 0.3 </entry-title>
<!-- english: 2009-11-17T02:42:45 -->
{{DraftSpecification-ja}}

[[hreview|hReview]] はHTMLやXHTML, Atom, RSS, 任意のXMLなどにレビュー（商品、サービス、ビジネス、イベントなど）を埋め込むのに適したシンプルかつオープンで分散型のフォーマットです。hReviewはオープンスタンダードな[[microformats]]の一つです。

[[hreview|hReview]]を使い始めてみたいなら、[http://microformats.org/code/hreview/creator hReview creator]でレビューを書いて、作成したコードをページに貼り付けてみてください。

== Microformats Draft Specification 2006-02-22 ==
<div class="vcard">
;<span class="role">Editor</span>
:<span class="fn">[[User:Tantek|Tantek Çelik]]</span> (<span class="url">http://tantek.com/</span>, and before at [http://technorati.com Technorati, Inc.])
</div>
; Authors
: [[User:Tantek|Tantek Çelik]] (affiliations above)
: <span class="vcard"><span class="fn">[http://360.yahoo.com/alidiabali Ali Diab]</span></span> ([http://yahoo.com Yahoo! Inc.])
: <span class="vcard"><span class="fn">[http://ianmcall.blogspot.com/ Ian McAllister]</span></span> ([http://amazon.com/ Amazon.com])
: <span class="vcard"><span class="fn">[http://journals.aol.com/panzerjohn/abstractioneer John Panzer]</span></span> ([http://www.aol.com America Online, Inc.])
: <span class="vcard"><span class="fn">[http://ifindkarma.com/blog Adam Rifkin]</span></span> ([http://labs.commerce.net/ CommerceNet Labs])
: <span class="vcard"><span class="fn">[http://sippey.typepad.com/ Michael Sippey]</span></span> ([http://sixapart.com Six Apart, Ltd])
[[hreview#Copyright|copyright]] and [[hreview#Patents|patents]] statements apply.

== Status ==
hReview 0.3 は microformats.org の仕様ドラフトです。[[hreview-feedback]]、irc.freenode.net 上の #microformats、[http://microformats.org/discuss/mail/microformats-discuss/ マイクロフォーマット議論メーリングリスト] で hReview に関する公開の議論が行われています。

=== Available languages ===
この仕様の英語版が唯一もととなるバージョンです。この文書の翻訳については [[#Translations]] の節をご覧ください。

=== Errata and Updates ===
この仕様での機知の間違いと問題は[[hreview-issues-resolved|考慮済み]]と[[hreview-issues-closed|解決済み]]問題ページで修正されています。[[hreview-issues|問題]]を報告する前にここを確認してください。

hReview 0.4 へのアップデートは、[[value-class-pattern-ja|value-class パターン]]同様開発中で、機知の訂正事項も含んでいます。

== Introduction ==
非常に多くのウェブサイトが、製品（映画、音楽、本）から企業（レストラン、ホテル、店）、イベント（コンサート、演劇）、人物（歌手、指導者、有名人）、場所（歴史的建造物、公園）、オンラインリソース（ウェブページ、ファイル）やレビューのレビューにいたるまで、あらゆる種類の事物に関する幅広い形式のレビューを公開しています。

こういったレビューの共有、配布、シンジケーション（配信）、アグリゲーション（集約）を可能にし、促進するため、hReview マイクロフォーマットを提案します。これはレビュー配布のオープンスタンダードです。既存の色々な[[review-examples|レビューの例]]や、[[review-formats|レビュー形式]]についての先人の試みを調べ、レビューのおおよそ最小のスキーマとして hReview を設計しました。フィードバックは [[hreview-feedback|hReview フィードバック]]ページにお願いします。

{{rfc-2119-intro-ja}}

=== Scope ===
多くのレビューでは、いくつか一般的な側面が共通しています。この最小の共通部分に基いている所では、hReview が使えます。

==== Out of scope ====
hReview ではレビューの特定の項目に特化したプロパティは除外されています。初めからシンプルかつ最小であり続けることが重要なのです。機能の追加は実装上必要だと認められた時に行われます。

「universal object identifier（統一物品識別子）」の概念――異なるショッピングサイトからいかにして同じ物品・項目・製品を特定するか――は、とても役に立つものもありますが、このフォーマットの範囲外です。

== Format ==
=== 一般 ===
hReviewフォーマットは、現在ウェブ上にたくさんあるレビューサイトとフォーマットに共通して使われているプロパティに基づいています。
使用できるプロパティ名は、[[hcard-ja|hCard]]と[[hcalendar-ja|hCalendar]]標準仕様に関連して定義されているものを元にして選ばれています。

=== Schema ===
hReviewのスキーマは以下の通りです:

* hReview ('''<code>hreview</code>''')
** '''<code>version</code>'''. 任意。テキスト。
** '''<code>summary</code>'''. 任意。テキスト
** item '''<code>type</code>'''. 任意。 product | business | event | person | place | website | url.
** '''<code>item</code>''' info. 必須。'''<code>fn</code>''' ('''<code>url</code>''' || '''<code>photo</code>''' ) | '''[[hcard-ja|hCard]]''' (人物または企業の場合) | '''[[hcalendar-ja|hCalendar]]''' (イベントの場合)
** '''<code>reviewer</code>'''. 任意。'''[[hcard-ja|hCard]]'''。
** '''<code>dtreviewed</code>'''. 任意。 ISO8601 絶対日時（absolute date time）
** '''<code>rating</code>'''. 任意。固定小数点数 [1.0-5.0]。あるいは、任意の '''<code>worst</code>''' (デフォルト：1.0) または '''<code>best</code>'''（デフォルト：5.0）またはその両方を持つ固定小数点数で、この場合も厳密な '''<code>value</code>''' を持つ。
** '''<code>description</code>'''. 任意。任意の妥当な HTML でマークアップされたテキスト。
** tags. 任意。キーワードやフレーズ。'''[[rel-tag-ja|rel-tag]]'''を使い、それぞれ任意の rating を持つ。
** permalink. 任意。'''[[rel-bookmark]]'''と'''[[rel-self]]'''を使う。
** license. 任意。'''[[rel-license]]'''を使う。

=== プロパティの詳細 ===
hReviewのプロパティの詳細は次の通りです。

'''version''':: この任意のプロパティには、コンテンツ中で使用しているhReviewのバージョンを指定することができます。このプロパティを省略すると、hReview仕様のv2.0またはそれ以降の任意のバージョンによって解釈をしていいと宣言したことになります。
実際には、この仕様の著者たちは、初期のバージョンの仕様によって生成されたコンテンツに対する後方互換性を維持することにコミットしています。
このプロパティはvCard RFC2426 section "3.6.9 VERSION Type Definition"で定義されている"VERSION"の文法と互換性があり、
結果としてそれを再利用したものになっています。 本仕様に対するこのプロパティの値は"0.3"です。

'''summary''':: この任意のプロパティは、レビュー自体のタイトルを表します。

'''item type''':: この"type"という任意のプロパティはレビューされるitemのタイプを示し、それらは、product、business、event、person、place, website、urlのいずれか一つです。省略されている場合は、そのitemのタイプを導出してよい場合があります。もしitemが[[hcard-ja|hCard]]でもある場合は、そのitemのタイプはhCardの内容に基づいて"business"または"person"になります。もしitemが[[hcalendar-ja|hCalendar]]のeventでもある場合は、itemのタイプは"event"です。

'''item info''':: この必須プロパティは少なくとも''その''item(1つのhReviewは、ただ1つのitemについて説明します)の名前("fn"というサブプロパティを使用 - その名前に対応する整形済み文字列。ただし、イベントの item を除きます。イベントの場合は hCalendar の各 "vevent" の中に "summary" サブプロパティがなければなりません({{must}}))を持たなければなりません({{must}})。そして、そのitemに対応する少なくとも1つのURI ("url")を持つべきです({{should}})。さらに、そのitemの写真または絵("photo")のURLを含めることができます({{may}})。 
itemのタイプが"person"または"business"の場合は、そのitem info (fn, url, photo)は[[hcard-ja|hCard]]の中に囲まれている必要があります({{must}})。
itemのタイプが"event"の場合は、そのitem infoは[[hcalendar-ja|hCalendar]] veventの中に囲まれているべきです({{should}})。
itemのURLではないユニークな識別子(e.g. ISBN、UPC など)は、そのitemのURN ("url")として表現することができます({{may}})。
itemの内側に含まれるmicroformats (現在は[[hcard|hCard]]と[[hcalendar|hCalendar]] event)は、item自体にセットすることができます。(e.g. class="item vcard")  しかし、item infoの下位プロパティ("fn"、"url"、"photo")を使用する場合は、それらはitemの要素の<em>内側</em>になければなりません({{must}})。

'''reviewer''':: この任意のプロパティはレビューを書いた人を示します。
もしもreviewerが指定されている場合、そのreviewerを表現するhCardが必要です({{must}})。匿名のレビューにするには、"anonymous"(引用符を除く)をその"reviewer"のフルネームとしてください。
"reviewer"がhReviewの内側にない場合、パーザーはそのページのhReviewの外側を探すべきです。
"reviewer"がhReviewの外側にもない場合、 パーザーは、そのドキュメントが使用している言語の中で定義されている著者を使うべきです。
すなわち、HTMLドキュメントの場合、 <code><nowiki><address></nowiki></code>で示されているそのページについての連絡先(これは [[hcard|hCard]]で同様にマークアップされているのが理想的です)、Atom 1.0では、<code><nowiki><entry></nowiki></code> <code><nowiki><author></nowiki></code>、または、それがなければ<code><nowiki><feed></nowiki></code> <code><nowiki><author></nowiki></code>、RSSでは<code><nowiki><item></nowiki></code>要素の内側にある<code><nowiki><author></nowiki></code>となります。

'''dtreviewed''':: 公開した時点に関するこの任意のプロパティは、レビューが書かれたか生み出された時点の [[ISO-8601|ISO8601]] 絶対日時（absolute date time）を提供''しなければなりません''（{{must}}）。このプロパティは UTC を使う''べき''（{{should}}）ですが、タイムゾーンオフセット構文を使うことも''できます''（{{may}}）。hReview に dtreviewed が無い場合は、外部の、hReview を取り囲む文脈中を見ます。その文脈が [[hatom|hAtom]] エントリーだった場合、フィードの "published"（見つからなければ "updated"）の日時を使います。それ以外の場合、dtreviewed として hReview を含む文書の（訳注：XML としての）言語（例えば Atom フィードの "published"/"updated" のような物）を参照して作成日時（見つからなければ更新日時）の情報を使い、それも無ければプロトコル（例えば HTTP Last-Modified や ファイルシステムの最終更新日時）を使います。

'''rating''':: rating（格付け）は、項目の評価を含んだ 1.0 から 5.0 までの（精度が 10 進小数点以下一桁の）固定小数点数で、デフォルトでは高い値が良い評価を表します。任意で、別の "worst" または "best" またはその両方の数値を定義して違った範囲（例えば 0-10 の 6）を設定することも''できます''（{{may}}）。"best" の値を "worst" よりも小さい数にしてもかまいません。

'''description''':: この任意のプロパティにはレビュアーの意見を書いたテキスト全文が入ります。このプロパティには妥当な HTML マークアップが含まれていても''かまいません''（{{may}}）。ユーザーエージェントは全てのマークアップを保持する''べきです''（{{should}}）。多角的な記述や節をまたぐ記述（例えば賛否や長短）は description プロパティに含まれる''べきです''（{{should}}）。

'''tags''':: タグはレビュアーが item と結びつけたキーワードやフレーズ（ここのキーワードやフレーズのタグには [[rel-tag-ja|rel-tag]] マイクロフォーマットを使います）のリストを使って表現されます。レビュアーは任意で、そのタグに関する rating を各 [[rel-tag-ja|rel-tag]] の中で提供することが''できます''（{{may}}）。例：ambience:5。あるタグのデフォルトの rating は、もしあれば item 全体の rating 範囲を使います。worst～best を設定し直して使うことも''できます''（{{may}}）。レビュー著者は、その方が使いやすければ、同じ意味を保持しながらこの構造を逆転させることも''できます''（{{may}}）。つまり、評価付きのタグを表すのに rating の中に [[rel-tag-ja|rel-tag]] を入れることもできるのです。注：評価付きのタグは、理想としては、そのタグが意味する物を説明しているタグスペース使う''べきです''（{{should}}）。例えば Food:18/30 というのは、Food タグとして 30 点中 18 点が何を意味しているのか説明している Food のタグスペースにリンクしている''べきです''（{{should}}）。

'''permalink''':: この任意のプロパティは hReview の URL です。あるハイパーリンクがレビュー自身の固定リンクだと示すには、このプロパティの <code><a href></code> タグに加えて、<code>rel="self bookmark"</code> を使''わなければなりません''（{{must}}）。ハイパーリンクに既に <code>rel</code> が含まれている場合は、この属性の中に空白で区切って <code>self</code> と <code>bookmark</code> という値を含め''なければなりません''（{{must}}）。索引作成者／プログラムは、（一つのページから何度も索引を作るなど）複数の情報源から同じレビューを特定して照合するための一意の ID として、レビューの固定リンクを使うことが''できます''（{{may}}）。レビュー著者は固定リンクだと示すために、要素に "permalink" というクラス名を使うことができますが、必須ではありません。

'''license''':: hReview はの記事自身が基づいているライセンスへのリンクを'''[[rel-license-ja|rel-license]]''' マイクロフォーマットを使って示します。

次のプロパティ名は [[hcard-ja|hCard]] と [[hcalendar-ja|hCalendar]] マイクロフォーマットからの再利用です： <code>version, summary, fn, url, photo, description</code>。さらに、hCard で記された item とレビュアーには hCard のどのプロパティが含まれていても''かまいません''（{{may}}）。rel 属性の "self" という値は [http://atompub.org/2005/07/11/draft-ietf-atompub-format-10.html Atom 1.0 仕様]からの再利用です。

いくつかのプロパティでは、より多くの意味を持つこともあります。ですから、それについては特殊な扱いをしなければなりません。例： 

* 全ての "url" は、hReview の中の 'hreview' という class 名を持つ要素の内側で <code><a class="url" href="...">...</a></code> を使う
*また、"photo" については <code><img class="photo" src="..." alt="...の写真" /></code> を使う

* rating は画像や「☆☆☆」といった文字として表現されることも多い。そういった文字はこれについては明確な格付けの略記なので、<code>&lt;abbr&gt;</code> 要素が特に使いやすい。例：<code>&lt;abbr class="rating" title="3.0"&gt;☆☆☆&lt;/abbr&gt;</code>。これは次の節でもさらに検討される。

==== Language ====
* hReview が書かれている自然言語を明確に伝えるため、class="hreview" を持つ要素で HTML 標準の 'lang' 属性を使ってください。例：<code>&lt;div class="hreview" lang="en"&gt; ... &lt;/div&gt;</code>。（item 名などの）hReview の一部が異なる言語で書かれている場合は、その部分に 'lang' 属性を使ってください。
* レビューの言語を扱う必要のある hReview 処理プログラムは、HTML 標準の 'lang' を仕様に従って処理しなければなりません（{{must}}）。

=== Human vs. Machine Readable ===
プロパティに <code>&lt;abbr></code> 要素を使う場合、そのプロパティの値には、要素の内容ではなく '<code>title</code>' 属性を使います。そうすることで、また別のユーザーフレンドリーな値の表現を提供することができるのです。 

同様に、プロパティに <code><img /></code> を使う時には、次のように扱わなければなりません（{{must}}）。 

# "photo" プロパティや、値として URL を使う他のプロパティには <code>src="..."</code> 属性がその値を決めます。
# その他のプロパティには <code><img /></code> 要素の '<code>alt</code>' 属性がプロパティ値になります。

=== Object Includes ===

hReview 0.3 はオブジェクト[[include-pattern|インクルードパターン]]をサポートしています。

一つのページで一つのアイテムとそのアイテムに関する複数のレビューを並べることがよくあります。そのアイテムの各レビューで item info を繰り返さなければならないということを避けるため、次のようにするべきです。最初のレビューを hReview としてマークアップし、item info では一意な "id" 属性を付けます。それ以降のレビューではオブジェクト[[include-pattern|インクルードパターン]]を使って最初のレビューから item info をインクルードします。

=== Notes ===
この節は参考用です。

* レビューを hReview マイクロフォーマットでマークアップすることで、レビューが索引化できるようになるでしょう。これはレビュー自体の著作権には影響しません。レビューの著作権は、上の仕様で述べられているように、公開する人が [[rel-license-ja|rel-license]] を使って厳密に記述できます。
* 列挙された item type の項目は開発中で、拡張されるかもしれません。
* 特定のアイテムに関するより詳しい情報は、残りの情報と一緒に、そのアイテムの URL で記述されているべきです。
* 多くの格付けシステムが 1.0 から 5.0 の範囲を使い、そのほとんどが格付けを星の数（半分も可）で表現します。望むなら、サイトで格付けを表現するのに何らかの画像を使うこともできます。

== Examples ==
以下では現在のウェブサイトからレビューの例をいくつか取り上げて、どれほど簡単にレビューの構造化されたマイクロフォーマットである hReview をサポートするように改良できるかを示します。  

すぐに [[hreview-ja|hReview]] を始めたいという人は、[http://microformats.org/code/hreview/creator hReview creator] を使ってレビューを書き、自分のブログで公表してみてください。

=== Restaurant reviews ===

次はレストランの簡単なオンラインレビューです。

<pre><nowiki>
<div>
 <span>星5個中5個</span>
 <h4>Crepes on Cole は最高</h4>
 <span>レビュアー：<span>Tantek</span> - 2005年4月18日
 <blockquote><p>
  Crepes on Cole はサンフランシスコの小さなクレープ屋で最高の所の一つだ。
  出す物もサービスも素晴らしい。大きい物から小さい物まで、
  パーティ用のいろいろな大きさのテーブルがある。窓側の席は、
  すぐそこに停まる N-Judah を眺めたり、N-Judah の方から見たりという素晴らしい体験ができる。
  わたしはここで近所の WiFi に助けられながらたくさんの仕事をしているのだが、
  何度も楽しい集会をしてもいる。
</p></blockquote>
 <p>訪問日：<span>2005年4月</span></p>
 <p>食べたもの：<span>フィレンツェ風クレープ（Florentine crepe）</span></p>
</div>
</nowiki></pre>

このレビューに hReview を付け加えるのはいい例です。

<pre><nowiki>
<div class="hreview">
 <span>星5個中<span class="rating">5</span>個</span>
 <h4 class="summary">Crepes on Cole は最高</h4>
 <span class="reviewer vcard">レビュアー：<span class="fn">Tantek</span> - 
 <abbr class="dtreviewed" title="20050418T2300-0700">2005年4月18日</abbr></span>
 <div class="description item vcard"><p>
  <span class="fn org">Crepes on Cole</span> は  
  <span class="adr"><span class="locality">サンフランシスコ</span></span>の小さなクレープ屋で最高の所の一つだ。
  出す物もサービスも素晴らしい。大きい物から小さい物まで、
  パーティ用のいろいろな大きさのテーブルがある。窓側の席は、
  すぐそこに停まる N-Judah を眺めたり、N-Judah の方から見たりという素晴らしい体験ができる。
  わたしはここで近所の WiFi に助けられながらたくさんの仕事をしているのだが、 
  何度も楽しい集会をしてもいる。
 </p></div>
 <p>訪問日：<span>2005年4月</span></p>
 <p>食べたもの：<span>フィレンツェ風クレープ（Florentine crepe）</span></p>
</div>
</nowiki></pre>

このレビュー例ではいくつか hReview としては記録されていないプロパティ（訪問日、食べたもの）があることに注意してください。これは hReview を最小で簡単なものにしておくため、敢えてしたことです。

この例の hReview は次のように表現できます。

星5語中5個<br />
'''Crepes on Cole は最高'''<br />
レビュアー：Tantek - 2005年4月18日<br />

Crepes on Cole はサンフランシスコの小さなクレープ屋で最高の所の一つだ。出す物もサービスも素晴らしい。大きい物から小さい物まで、パーティ用のいろいろな大きさのテーブルがある。窓側の席は、すぐそこに停まる N-Judah を眺めたり、N-Judah の方から見たりという素晴らしい体験ができる。わたしはここで近所の WiFi に助けられながらたくさんの仕事をしているのだが、何度も楽しい集会をしてもいる。

訪問日：2005年4月<br />
食べたもの：フィレンツェ風クレープ（Florentine crepe）<br />

==== Multidimensional Restaurant Review ====
レストランのレビューには、そのレストランの異なる面について格付けをしているものもあります。そういった詳細なレビューは、hReview ではタグのついた格付けを使って表現します。また、そのレビューの説明の中にあるインラインのタグに注意してください。

次はそのようなレビューをテキスト形式で表した例です。

 Cafe Borrone
 
 1010 El Camino Real, Menlo Park, CA 94025, +1-650-327-0830;
 cafeborrone.com
 
 食事：18/30；雰囲気：19/30；サービス：15/30価格：$$...
 
 このカフェはサンフランシスコ半島の素敵なオアシスだ。
 外にある噴水は、近くの El Camino の車の音を打ち消してくれる。
 Cafe Borrone は壮麗な個人書店の隣にあって、  
 新たに購入した本や輸入雑誌を広げながら 
 コーヒーや軽食を取るには理想的な場所だ。
 スープとサンドイッチの特別メニューは毎日変わる。
 温めたばかりのミニバゲットについてくる、 
 クルトン入りのコーンチャウダーとチーズの大きな塊が特にすばらしい。
 夜は混むことが多く、見知らぬ人と相席になることもある。
 エスプレッソ愛好家にはイッリのコーヒーがたまらないだろう。
 賑やかさは遅い朝の静けさから夜の圧倒されるようなジャズバンドまで、様々だ。

hReview ではこうなります。

<pre><nowiki>
<div class="hreview">
 <div class="item vcard">
  <div class="fn org summary">Cafe Borrone</div>
  <span class="adr">
   <span class="street-address">1010 El Camino Real</span>,
   <span class="locality">Menlo Park</span>,
   <span class="region">CA</span>
   <span class="postal-code">94025</span>,
  </span>
  <span class="tel">+1-650-327-0830</span>;
  <a class="url" href="http://cafeborrone.com">cafeborrone.com</a>
 </div>
 <ul>
  <li class="rating"><a href="http://en.wikipedia.org/wiki/Food" rel="tag">
   食事：<span class="value">18</span>/<span class="best">30</span></a>；</li>
  <li class="rating"><a href="http://flickr.com/photos/tags/Ambience" rel="tag">
   雰囲気：<span class="value">19</span>/<span class="best">30</span></a>；</li>
  <li class="rating"><a href="http://en.wikipedia.org/wiki/Service" rel="tag">
   サービス：<span class="value">15</span>/<span class="best">30</span></a>；</li>
  <li class="rating"><a href="http://en.wikipedia.org/wiki/Price" rel="tag">
   価格：<abbr class="value" title="2">$$</abbr>...</a></li>
 </ul>
 <div class="description"><p>
  この<abbr class="type" title="business">
  <a href="http://en.wikipedia.org/wiki/cafe" rel="tag">カフェ</a></abbr> 
  はサンフランシスコ半島の素敵なオアシスだ。
  外にある噴水は、近くの El Camino の車の音を打ち消してくれる。
  Cafe Borrone は壮麗な個人書店の隣にあって、 
  新たに購入した本や輸入雑誌を広げながら 
  <a href="http://en.wikipedia.org/wiki/coffee" rel="tag">コーヒー</a> 
  や軽食を取るには理想的な場所だ。
  <a href="http://technorati.com/tag/soup" rel="tag">スープ</a>と 
  <a href="http://technorati.com/tag/sandwich" rel="tag">サンドイッチ</a> 
  の特別メニューは毎日変わる。
  温めたばかりのミニバゲットについてくる、 
  クルトン入りのコーンチャウダーとチーズの大きな塊が特にすばらしい。
  夜は混むことが多く、見知らぬ人と相席になることもある。
  <a href="http://flickr.com/photos/tags/espresso" rel="tag">エスプレッソ</a> 
  愛好家には
  <a href="http://en.wikipedia.org/wiki/Illy" rel="tag">イッリ</a>のコーヒーがたまらないだろう。
  遅い朝の静けさから夜の圧倒されるような 
  <a href="http://en.wikipedia.org/wiki/jazz" rel="tag">ジャズ</a>バンドまで、様々だ。 </p></div>
 レビュー（<a href="http://microformats.org/wiki/hreview"> 
  hReview v<span class="version">0.3</span></a>）
 ：<span class="reviewer vcard"><span class="fn">匿名</span></span>。 
 <abbr class="dtreviewed" title="20050428T2130-0700">2005年4月18日</abbr>。
</div>
</nowiki></pre>

次のような CSS のスタイルシートを添えると……

<pre><nowiki>
a.url { display:block }
ul { margin:1em 0; padding:0 }
ul li { display:inline }
</nowiki></pre>

この hReview は元のテキストと同じように表示できます。

Cafe Borrone<br />
1010 El Camino Real, Menlo Park, CA 94025, +1-650-327-0830;<br />
[http://cafeborrone.com/ cafeborrone.com]<br />
<br />
[http://en.wikipedia.org/wiki/Food 食事：18/30];
[http://flickr.com/photos/tags/Ambience 雰囲気：19/30];
[http://en.wikipedia.org/wiki/Service サービス：15/30];
[http://en.wikipedia.org/wiki/Price 価格：$$...]<br />

この[http://en.wikipedia.org/wiki/cafe カフェ]はサンフランシスコ半島の素敵なオアシスだ。外にある噴水は、近くの El Camino の車の音を打ち消してくれる。Cafe Borrone は壮麗な個人書店の隣にあって、新たに購入した本や輸入雑誌を広げながら[http://en.wikipedia.org/wiki/coffee コーヒー]や軽食を取るには理想的な場所だ。[http://technorati.com/tag/soup スープ]と[http://technorati.com/tag/sandwich サンドイッチ]の特別メニューは毎日変わる。温めたばかりのミニバゲットについてくる、クルトン入りのコーンチャウダーとチーズの大きな塊が特にすばらしい。夜は混むことが多く、見知らぬ人と相席になることもある。[http://flickr.com/photos/tags/espresso エスプレッソ]愛好家には[http://en.wikipedia.org/wiki/Illy イッリ]のコーヒーがたまらないだろう。賑やかさは遅い朝の静けさから夜の圧倒されるような[http://en.wikipedia.org/wiki/jazz ジャズ]バンドまで、様々だ。

レビュー（[http://microformats.org/wiki/hreview hReview v0.3]）：匿名。2005年4月28日。

=== Product review ===
以下は製品レビューの例です。

<pre><nowiki>
<div>
 <a href="http://www.amazon.com/exec/obidos/ASIN/B000089CJI/">
  <img src="http://images.amazon.com/images/P/B000089CJI.01._SCTHUMBZZZ_.jpg" 
              alt="アルバムジャケット写真：The Postal Service：Give Up" />
 The Postal Service：Give Up</a>
 <blockquote><p>
   「相手の望み通りに接してあげる、 
    停止信号を守る、病気を治す……
    人はそういったことで褒められるべきだと思ってる。
    眠るから起こさないで……」
   </p><p>
   このアルバムでは「Nothing Better」もいい曲だ。 
 </p></blockquote>
 （★★★★★）
</div>
</nowiki></pre>

このレビューに hReview を足すのもとても簡単ですが、この場合は hReview に必須の rating と reviewer 用の要素を加える必要があります。

<pre><nowiki>
<div class="hreview"><span class="item">
 <a class="url fn" href="http://www.amazon.com/exec/obidos/ASIN/B000089CJI/">
  <img src="http://images.amazon.com/images/P/B000089CJI.01._SCTHUMBZZZ_.jpg" 
       alt="アルバムジャケット写真：The Postal Service：Give Up" />" 
       class="photo" />
  The Postal Service: Give Up</a></span>
 <div class="description"><p>
    「相手の望み通りに接してあげる、 
     停止信号を守る、病気を治す……
     人はそういったことで褒められるべきだと思ってる。
     眠るから起こさないで……」
   </p><p>
   このアルバムでは「Nothing Better」もいい曲だ。 
 </p></div>
 （<abbr class="rating" title="5">★★★★★</abbr>）
 <p class="reviewer vcard">レビュー： 
  <a class="url fn" href="http://ifindkarma.com/blog/">Adam Rifkin</a>。 
  <abbr class="dtreviewed" title="200502">2005年2月</abbr>。
 </p>
</div>
</nowiki></pre>

この hReview は例えばこう表示できます。


[アルバムジャケット写真：]
[The Postal Service：]
[      Give Up      ]

The Postal Service：Give Up

「相手の望み通りに接してあげる、停止信号を守る、病気を治す、送り主の住所を書いて手紙を送る……人はそういったことで褒められるべきだと思ってる。眠るから起こさないで……」

このアルバムでは「Nothing Better」もいい曲だ。 

（★★★★★）

レビュー：Adam Rifkin。2005年2月。

=== Movie Review ===
最後に、映画のレビューの例です。

<pre><nowiki>
<div>
 <span>anonymous, April 18th, 2005</span>
 <div>
  <a lang="zh" href="http://www.imdb.com/title/tt0299977/">
  Ying Xiong (<span lang="en">HERO</span>)
  </a>
 </div>
 <div>評価：5 点満点中 4 点</div>
 <blockquote><p>
  この映画は音楽と映像が素晴らしい。 </p></blockquote>
</div>
</nowiki></pre>

hReview ではこうです。

<pre><nowiki>
<div class="hreview">
 <span class="reviewer vcard">
  <span class="fn">anonymous</span>, 
  <abbr class="dtreviewed" title="20050418">April 18th, 2005</abbr>
 </span>
 <div class="item">
  <a lang="zh" class="url fn" href="http://www.imdb.com/title/tt0299977/">
  Ying Xiong (<span lang="en">HERO</span>)
  </a>
 </div>
 <div>評価：5 点満点中 <span class="rating">4</span> 点</div>
 <div class="description"><p>
  この映画は音楽と映像が素晴らしい。 </p></div>
</div>
</nowiki></pre>

このように表示できます。

匿名。2005年4月18日。<br />
Ying Xiong（HERO）<br />
評価：5 点満点中 4 点<br />

この映画は音楽と映像が素晴らしい。

== Examples in the wild ==
この説は'''参考情報'''です。この仕様の文中で書かれている可能性をはるかに超えて、実際に hReview を使っている例がたくさんあります。これは [[hreview-examples-in-wild|別ページ]]に移しました。

[[hreview-examples-in-wild|hReview Examples in the wild]] を参照してください。

== Implementations ==
この節は'''参考情報'''です。hReview の実装も、この文中で書かれている可能性以上にあります。[[hreview-implementations|別ページ]]に移しました。

[[hreview-implementations|hReview Implementations]] を参照してください。

== Design Principles ==
This section is '''informative'''.  hReview was designed using design [[principles]] similar to those that went into [[hCard]] and thus this overview is included for informational purposes.

{{semantic-xhtml-design-principles-ja}}

== Inspiration and Acknowledgments ==
hReview 開発参加のオープンな呼び掛けに応えてくれた皆さんに感謝します。特に次の人たちに、建設的な意見とフィードバックを頂いたことに謝意を示したいと思います。[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]、Mark Nottingham、[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]。

== References ==
=== Normative References ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [http://gmpg.org/xmdp/ XMDP]
* [[hcard-ja|hCard]]
* [[hcalendar-ja|hCalendar]]
* [[rel-tag-ja|rel-tag]]
* [http://www.ietf.org/rfc/rfc2119.txt RFC2119]
* [http://www.ietf.org/rfc/rfc3986.txt RFC3986]
* [http://www.ietf.org/rfc/rfc4287.txt RFC4287] (Atom 1.0)

=== 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.（国際標準化機構「データ要素と交換フォーマット――情報交換――日付及び時刻の表現」ISO 標準 8601、1988年7月）
* [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]
* [http://local.yahoo.com/details?id=21359628 Crepes on Cole reviews on Yahoo!Local]
* そのほかのレビューの取り組み。[[reviews-formats]]をご覧ください。
* http://developers.technorati.com/wiki/hReview に助けられました。

==== Similar Work ====
* [[hlisting-proposal|hListing]]
* [[xoxo-ja|XOXO]]

== Copyright ==
{{MicroformatCopyrightStatement2005}}

=== Patents ===
{{MicroFormatPatentStatement-ja}}

== Work in progress ==
この仕様は現在進行中です。更なる特徴が議論され、理解され、書かれた時には追加されるでしょう。 

=== Changes from v0.2 ===
hReview v0.3 では [[hreview-v0.2|hReview v0.2]] から以下の変更がなされました。

規範的な変更：
# 企業と人物の item の description には [[hcard-ja|hCard]] を（使うべき（SHOULD）ではなく）使わなければなりません（MUST）
# "reviewer" が変更されました
## Ryan King と Mark Nottingham のフィードバックにより、reviewer が ＊任意＊ になりました
## hReview に reviewer が無い場合には、そのページの中の hReview の外側を見て、レビュアーを見つけてください。外側にも "reviewer" が無い場合は、文書の言語に含まれている著者情報（HTML ページの <code><nowiki><address></nowiki></code> など）を reviewer として使ってください。
## レビュアー情報の表現には [[hcard-ja|hCard]] を（使うべき（SHOULD）ではなく）使わなければなりません（MUST）
# "dtreviewed" が変更されました
## Ryan King と Mark Nottingham のフォードバックにより、dtreviewed が ＊任意＊ になりました
## hReview に dtreviewed が無い場合は、外部の、hReview 取り囲む文脈中を見てください。その文脈が [[hatom|hAtom]] エントリーだった場合、dtreviewed として "published"（見つからなければ "updated"）を使ってください。もしエントリー中に無ければ、フィードの "published"（見つからなければ "updated"）を使ってください。それも無ければ、文書の言語に含まれている情報（例えば Atom フィードの"published"/"updated" のような物）を、その次にプロトコルの情報（例えば HTTP Last-Modified やファイルシステムの最終更新日時）を使ってください。
# 'type' が 'event' の item の表現には [[hcalendar-ja|hCalendar]] を使うべき（SHOULD）です
# 出版会の知識に基づいて、rating の値の桁を 10 進数で一桁加えました
# rating の best/worst を提示（マークアップ）する時に、より厳密に rating の値をマークアップするため [http://microformats.org/wiki/hcard-ja#.E5.80.A4.E3.81.AE.E6.8A.9C.E7.B2.8B hCard の "value" の構造]（例では "tel" プロパティの中で使われているような）を使ってください。
# その hReview 全体のライセンスを示すため [[rel-license-ja|rel-license]] を追加しました
# Eran Globen の提案により、関連する tag を提供するのに、tag の中に rating を入れるのと同じようにして、rating の中に tag を入れられるようにしました。
# item info を繰り返さずに同じ item に複数のレビューを書けるよう [[include-pattern]] のサポートを加えました。

参考すべき変更（いくつかあるが中でも特別な物）：
# 基準や関連項目のタグにはそのタグの格付けを説明しているタグスペースを使うのが理想であることに注意してください。例えば食事：18/30 が何を意味するか説明しているなど。
# 例は適宜更新されます。

== Further Reading ==
* [http://www.technorati.com/cosmos/referer.html このページについて議論しているブログ]（[http://technorati.com/search/http%3A%2F%2Fmicroformats.org%2Fwiki%2Fhreview 英語ページについて議論しているブログ]）もご覧ください。

== Related Pages ==
{{hreview-related-pages-ja}}

[[Category:hReview]]

== Translations ==
更に別の<span id="languages">言語</span>で hReview の仕様ドラフトを読んでみましょう。
* [[hreview|english]]
* [[hreview-fr|français]]
Templates used on this page:
Template:DraftSpecification-ja
Template:MicroFormatCopyrightStatement (protected)
Template:MicroFormatPatentStatement-ja
Template:MicroformatCopyrightStatement2005
Template:hreview-related-pages-ja
Template:may (protected)
Template:must (protected)
Template:must-not (protected)
Template:optional
Template:recommended
Template:required
Template:rfc-2119-intro-ja
Template:semantic-xhtml-design-principles-ja
Template:shall
Template:shall-not
Template:should (protected)
Template:should-not (protected)
Return to hreview-ja.
Retrieved from "http://mt.microformats.org/wiki/hreview-ja"
Views

Microformats Wiki

Toolbox

Hey! You're not logged in
