hreview-fr: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
m (Replace <entry-title> with {{DISPLAYTITLE:}})
 
(50 intermediate revisions by 3 users not shown)
Line 1: Line 1:
''Ceci est une traduction en cours de [[hreview]] seul lien de référence''
{{DISPLAYTITLE:hReview 0.4 (en cours)}}


{{DraftSpecification-fr}}


<h1> hReview 0.3 </h1>
[[hreview-fr|hReview]] est un microformat simple, ouvert, distribué, adaptable pour embarquer des critiques (de produits, services, business, événements, etc.) dans le HTML, XHTML, Atom, RSS et le XML arbitraire. hReview est l'un des nombreux standards [[microformats-fr|microformats]] ouvert.


[[hreview-fr|hReview]] est un microformat simple, ouvert, distribué, adaptable pour
Vous voulez démarrer par l'écriture d'un [[hreview-fr|hReview]] ? Utilisez le [http://microformats.org/code/hreview/creator hReview creator] pour écrire une critique et la publier.
l'embarquement de critiques (de produits, services, business, événements, etc.) dans le (X)HTML, Atom, RSS, et le XML arbitraire.  
hReview est l'un des nombreux [[microformats-fr]] ouverts et standards.


Vous voulez démarrer par l'écriture d'un [[hreview-fr|hReview]] ? 
Utilisez le [http://microformats.org/code/hreview/creator hReview creator] pour écrire une critique et la publier.


== Microformats Spécifications 22 février 2006 Draft ==
== Spécification Microformats Draft 2012 ==
<div class="vcard">
;<span class="role">Editor</span>
:<span class="fn">[[User:Tantek|Tantek Çelik]]</span> (<span class="url">http://tantek.com/</span>, [http://mozilla.org Mozilla])
</div>
 
<div class="vcard">
;<span class="role">traduction</span>
:<span class="fn">[[User:ChristopheDucamp|Christophe Ducamp]]</span>
</div>
 
Le [[hreview-fr#Copyright|copyright]] et les  déclarations de [[hreview-fr#Brevets|brevets]] pour les microformats s'appliquent.
 
== Statut ==
hReview 0.4 est une spécification microformats.org draft. Une discussion publique sur hReview se déroule sur [[hreview-feedback]], le canal [[irc-fr|irc]]  #microformats sur irc.freenode.net, et sur la [http://microformats.org/discuss/mail/microformats-discuss/ liste de discussion microformats-discuss].


; Editeur : [http://tantek.com/ Tantek Çelik], [http://technorati.com Technorati, Inc.]
=== Langues disponibles ===
; Auteurs : [http://tantek.com/ Tantek Çelik], [http://technorati.com Technorati, Inc.]
La version anglaise de cette spécification est la seule version normative : [[hreview|hReview]]. Pour des traductions de ce document, voir la section [[#traductions]].
: [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.]


Les déclarations Microformats pour le [http://microformats.org/wiki/hreview#Copyright copyright] et  
=== Errata et Mises à Jour ===
les [http://microformats.org/wiki/hreview#Patents patents] s'appliquent.
Des erreurs connues et problèmes dans cette spécification sont corrigé's dans les problématiques [[hreview-issues-resolved|résolues]] et [[hreview-issues-closed|fermées]]. Merci de regarder là avant de rendre compte des  [[hreview-issues|problématiques]].


__TOC__
La mise à jour hReview 0.4 est actuellement en développement et incorpore les corrections des errata connues tout comme le [[value-class-pattern-fr|modèle-de-classe-value]].


== Introduction ==
== Introduction ==
De nombreux sites web publient des critiques en utilisant une large variété  
De nombreux sites web publient des critiques en utilisant une très large variété de schémas de toutes sortes pour toutes sortes de choses, en partant des produits (films, musique, livres), en passant par les commerces (restaurants, hôtels, magasins), les événements (concerts, théâtre), les personnes (artistes, leaders, célébrités), des endroits (parcs, centres de loisirs), des ressources en ligne (pages web, fichiers) jusqu'aux critiques de critiques en elles-même.
de schémas de toutes sortes pour toutes sortes de produits (films, musique, livres), en passant par les commerces  
(restaurants, hôtels, magasins), les événements (concerts, théâtre), les personnes (artistes, leaders, célébrités),  
pour des endroits (parcs, centres de loisirs), des ressources en ligne (pages web, fichiers),
jusqu'aux critiques de critiques elles-même.


Afin de permettre et d'encourager le partage, la distribution, la syndication et l'agrégation de critiques, les auteurs proposent le microformat hReview, un standard ouvert pour les critiques distribuées.  
Afin de permettre et d'encourager le partage, la distribution, la syndication et l'agrégation de critiques, les auteurs proposent le microformat hReview, un standard ouvert pour les critiques distribuées. Les auteurs ont cherché de nombreux [[review-examples-fr|exemples de critiques]] dans la jungle et ont fait des premiers essais sur les [[review-formats-fr|formats de critiques]], et ont conçu hReview autour d'un schéma simple et minimal pour les critiques. Les réactions sont encouragées sur la page [[hreview-feedback-fr|hReview feedback]].
Les auteurs ont cherché tant de nombreux [[review-examples-fr|exemples de critiques]] dans la nature, ont fait des premiers essais sur [[review-formats-fr]], et ont conçu hReview autour d'un schéma simple et minimal pour les critiques.
Le Feedback est encouragé sur la page [[hreview-feedback-fr|hReview feedback]].


=== Inspiration et Remerciements ===
{{rfc-2119-intro-fr}}
Merci à tous ceux qui ont répondu à l'appel ouvert pour participation à l'implémentation du hReview. 
Les auteurs souhaitent tout particulièrement remercier les individus suivants pour leurs avis constructifs et leurs 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],
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].


=== Etendue ===
=== Etendue ===
Les critiques partagent de manière cohérente plusieurs champs communs.  
Les critiques partagent de manière cohérente plusieurs aspects communs. A chaque fois que cela a été possible, hReview a été basée sur ce sous-ensemble minimal commun.
Le hReview a été basé sur ce sous-ensemble minimal commun.


==== Hors-sujet  ====
==== Hors-sujet  ====
Les champs qui sont spécifiques à un type ont été omis de hReview. Il est important que hReview soit maintenu simple et minimal dès le démarrage.
Les portions d'avis qui sont spécifiques à des types particuliers d'items ont été omis de hReview. Il est important que hReview soit maintenu simple et minimal dès le démarrage. Des fonctionnalités supplémentaires peuvent être ajoutées par l'expérience pratique de mise en oeuvre.
Des fonctionalités supplémentaires peuvent être ajoutées par l'expérience pratique de mise en oeuvre.


Le concept d'un "identifiant universel d'objet", ce qui veut dire, comment identifier le même objet/item/produit à travers différents sites de commerce, même s'il est quelque part très utile d'en disposer, est ici hors du champ d'application de ce format.
Le concept d'un "identifiant universel d'objet", ce qui veut dire, comment identifier le même objet/item/produit à travers différents sites de commerce, même s'il est quelque part très utile d'en disposer, est ici hors du champ d'application de ce format.
== Principes De Design XHTML Sémantique ==
{{semantic-xhtml-design-principles}}


== Format ==
== Format ==
=== En Général ===
=== En Général ===
Le format hReview est fondé sur un ensemble de champs communs à de nombreux sites de critiques  
Le format hReview est fondé sur un ensemble de propriétés communes à de nombreux sites de critiques et formats en usage aujourd'hui sur le web. A chaque fois que possible, des noms de propriétés ont été choisis en se fondant sur ceux définis par les standards apparentés avec [[hcard-fr|hCard]] et [[hcalendar-fr|hCalendar]].
et formats en usage aujourd'hui sur le web. Là où les noms de champs possibles ont été choisis en se fondant sur ceux définis par les standards apparentés  
[[hcard-fr|hCard]] et [[hcalendar-fr|hCalendar]].


=== Schéma ===
=== Schéma ===
Line 74: Line 56:


* hReview ('''<code>hreview</code>''')
* hReview ('''<code>hreview</code>''')
** '''<code>version</code>'''. optionnel. texte.
** '''<code>summary</code>'''. optionnel. texte.
** '''<code>summary</code>'''. optionnel. texte.
** item '''<code>type</code>'''. optionnel. product | business | event | person | place | website | url.
** item '''<code>type</code>'''. optionnel. product | business | event | person | place | website | url.
** '''<code>item</code>''' info. requis. ('''<code>fn</code>''' || '''<code>url</code>''' || '''<code>photo</code>''' ) | '''[[hcard-fr|hCard]]''' (pour personne ou business) | '''[[hcalendar-fr|hCalendar]]''' (pour événement event)
** '''<code>item</code>''' info. requis. '''<code>fn</code>''' || ('''<code>url</code>''' || '''<code>photo</code>''') | '''[[hcard-fr|hCard]]''' (pour personne ou business) | '''[[hcalendar-fr|hCalendar]]''' (pour événement)
** '''<code>reviewer</code>'''. optionnel. '''[[hcard-fr|hCard]]'''.
** '''<code>reviewer</code>'''. optionnel. '''[[hcard-fr|hCard]]'''.
** '''<code>dtreviewed</code>'''. optionnel. ISO8601 absolute date time.
** '''<code>dtreviewed</code>'''. optionnel. ISO8601 date ou date-heure absolus. Utilisez le [[value-class-pattern-fr|modèle-classe-value]] si nécessaire tout particulièrement pour l'[[accessibility-fr|accessibilité]]. ([http://www.w3.org/TR/NOTE-datetime http://www.w3.org/TR/NOTE-datetime])
** '''<code>rating</code>'''. optionnel. fixed point integer [1.0-5.0], with optional alternate '''<code>worst</code>''' (default:1.0) and/or '''<code>best</code>''' (default:5.0), also fixed point integers, and explicit '''<code>value</code>'''.
** '''<code>rating</code>'''. optionnel. nombre entier [1.0-5.0], avec alternative optionnelle '''<code>worst</code>''' (par défaut:1.0) et/ou '''<code>best</code>''' (par défaut:5.0), aussi nombres entiers et '''<code>value</code>''' explicite.
** '''<code>description</code>'''. optionnel. texte avec balisage optionnel XHTML valide.
** '''<code>description</code>'''. optionnel. texte avec balisage optionnel XHTML valide.
** tags. optionnel. mots-clés ou phrases,utilisant '''[[rel-tag-fr]]''', chacun avec une notation en option.
** tags. optionnel. mots-clés ou phrases, utilisant '''[[rel-tag-fr|rel-tag]]''', chacun avec une notation en option.
** permalink. optionnel, utilisant '''[[rel-bookmark-fr]]''' et '''[[rel-self-fr]]'''.
** permalink. optionnel, utilisant '''[[rel-bookmark-fr]]''' et '''[[rel-self-fr|rel-self]]'''.
** license. optionnel, utilisant '''[[rel-license-fr]]'''.
** license. optionnel, utilisant '''[[rel-license-fr|rel-license]]'''.


=== Détails des Champs ===
=== Détails des Propriétés ===
Les champs du schéma hReview représentent ce qui suit :
Les propriétés du schéma hReview représentent ce qui suit :


'''version''':: Ce champ optionnel permet aux auteurs de hReview de spécifier une version particulière du hReview que leur contenu utilise.  En omettant ce champ, l'auteur déclare que les implémentations peuvent interpréter les hReviews selon n'importe quelle version de la spécification hReview v0.2 ou suivante. 
'''summary''' :: Cette propriété optionnelle sert de synopsis court, titre, ou nom de la critique. Réutilisé à partir de [[hcalendar-fr|hCalendar]] qui le réutilise de iCalendar (section 4.8.1.12 de la RFC 2445).
En pratique, les auteurs de cette spécification sont engagés pour maintenir une compatibilité descendante avec le contenu produit par l'utilisation de versions plus anciennes de la spécification. 
Ce champ est compatible avec la syntaxe, et réutilise de ce fait la sémantique de "VERSION" comme définie dans la vCard RFC2426 section "3.6.9 VERSION Type Definition".
La valeur de ce champ pour cette spécification est "0.3".


'''summary''' :: Ce champ optionnel sert de titre pour la critique elle-même..
'''type''' :: Cette propriété optionnelle "type" fournit le type d'item étant critiqué, l'un des suivants : <code>product, business, event, person, place, website, url</code>.  Si elle est omise, alors dans quelques cas, l'item peut être inféré. Si l'item est aussi une [[hcard-fr|hCard]], alors le type d'item est un "business", "place" ou "person" basé sur ceux représentés par la hCard. Si l'item est aussi un événement [[hcalendar|hCalendar]], alors le type d'item est un "event".


'''item type''' :: Ce champ optionnel "type" fournit le type d'item étant critiqué, l'un des suivants : product, business, event, person, place, website, url.  S'il est omis, alors dans quelques cas, l'item peut être inféré. Si l'item est aussi un [[hcard-fr|hCard]], alors le type d'item est "business" ou "person" basé selon quel est le type de hCard représenté. Si l'item est aussi un événement [[hcalendar|hCalendar]], alors le type d'item est un "event".
'''item''' :: Cette propriété requise item {{must-fr}} avoir au minimum le nom (en utilisant la sous-propriété "fn" - le texte formaté correspondant au nom, exception faite pour un item événement qui {{must-fr}} avoir la propriété sous-propriété "summary" dans le "vevent" respectif hCalendar) de ''l'item'' (un hReview ne décrit seulement qu'un item), {{should-fr}} fournir au moins un URI ("url") pour l'item, et {{may-fr}} fournir au moins une URL vers une photo ou une représentation ("photo") de l'item. Pour les items de type 'person' ou 'business', l'info item (fn, url, photo) {{must-fr}} être embarquée dans une [[hcard-fr|hCard]]. Pour les items de types 'event', l'info item {{should-fr}} être encapsulée dans un [[hcalendar-fr|hCalendar]] "vevent". Les items IDs non-URL uniques (par ex. ISBNs, UPCs) PEUVENT être représentés sous un URN ("url") pour l'item. Les microformats encapsulés (par ex. [[hcard-fr|hCard]] et les événements [[hcalendar-fr|hCalendar]] à cette heure) peuvent être réglés sur l'item lui-même (par ex. class="item vcard"). Néanmoins, lors de l'utilisation de sous-propriétés d'info item ("fn", "url", "photo"), elles DOIVENT être imbriquées <em>à l'intérieur</em> de l'élément item.


'''item info''' :: Ceci est un champ requis qui DOIT avoir au minimum le nom ("fn" - le texte formaté correpondant au nom) de ''l'item'' (un hReview ne décrit seulement qu'un item), DEVRAIT fournir au moins un URI ("url") pour l'item, et PEUT fournir au moins un URL vers une photo ou depiction ("photo") de l'item. Pour les items de type person ou business, l'info item (fn, url, photo) DOIT être encapsulée dans un [[hcard-fr|hCard]]
'''reviewer''' :: Cette propriété optionnelle spécifie la personne qui a écrit la critique.  Si l'auteur de la critique est spécifié, une hCard représentant l'auteur de la critique {{must-fr}} être fournie. Pour les critiques anonymes, utilisez "anonymous" (sans guillemets) pour le nom propre de la critique. Si aucun "reviewer" n'est trouvé dans le hReview, les parseurs devraient ({{should-fr}}) regarder à l'extérieur du hReview, dans le contexte de la page, pour le "reviewer". S'il n'y a pas de "reviewer" à l'extérieur, alors les parseurs devraient ({{should-fr}}) utiliser l'auteur défini par le "containing document language", par ex. pour des documents (X)HTML, l'info de contact <code><nowiki><address></nowiki></code> pour la page (qui est idéalement balisée aussi comme une [[hcard-fr|hCard]]), pour Atom 1.0 le <code><nowiki><entry></nowiki></code> <code><nowiki><author></nowiki></code> si présent et si non code><nowiki><feed></nowiki></code> <code><nowiki><author></nowiki></code>, pour RSS le <code><nowiki><author></nowiki></code> dans l'élément <code><nowiki><item></nowiki></code>.
Pour les items de types event, l'info item DEVRAIT être encapsulée dans un [[hcalendar-fr|hCalendar]] "vevent".
Les items à IDs uniques (par ex. ISBNs, UPCs) PEUVENT être réprésentés comme un URN ("url") pour l'item.


'''reviewer''' :: le champ optionnel spécifie la personne qui a écrite la critique. Si l'auteur de la critique est spécifié, un hCard représentant l'auteur de la critique DOIT être fourni. Pour les critiques anonymes, utilisez "anonymous" (sans guillemets) pour le nom propre de la critique.  
'''dtreviewed''' :: Cette propriété optionnelle quand elle est présente {{must-fr}} fournir une date ou date-horaire absolu [[ISO-8601-fr|ISO8601]] du moment où la critique a été écrite ou autrement publiée ([http://www.w3.org/TR/NOTE-datetime http://www.w3.org/TR/NOTE-datetime]). Cette propriété doit utiliser le [[value-class-pattern-fr|modèle de classe value]] si nécessaire (par ex. pour l'[[accessibility-fr|accessibilité]], DEVRAIT utiliser UTC, mais PEUT utiliser la syntaxe du fuseau horaire. Si dtreviewed est absent de hReview, alors regardez en dehors de hReview, dans le contexte environnant. Si le contexte est une entrée [[hatom-fr|hAtom]], utilisez son date-horaire "published" (ou "updated" si celui-ci manque) comme le dtreviewed, s'il n'est pas présent sur l'entrée, utilisez le "published" (ou "updated" si celui-ci est manquant) du flux. Autrement utilisez l'information de date de création (ou date de modification si celle-ci manque) selon la langue du document conteneur (par ex. "published"/"updated" de la même manière que pour les fils Atom), puis le protocole (par ex. HTTP Last-Modified, ou "file system last modified datetime") comme la dtreviewed.
Si aucun "reviewer" n'est trouvé dans le hReview, les parseurs devraient regarder à l'extérieur du hReview, dans le contexte de la page, pour le "reviewer". S'il n'y a pas de "reviewer" à l'extérieur, alors les parseurs devraient utiliser l'auteur défini par le "containing document language", par ex. pour des documents (X)HTML, l'info de contact <code><nowiki><address></nowiki></code> pour la page (qui est idéalement balisée aussi comme un [[hcard-fr|hCard]]), pour Atom 1.0 le
<code><nowiki><entry></nowiki></code> <code><nowiki><author></nowiki></code> si présent et si non
<code><nowiki><feed></nowiki></code> <code><nowiki><author></nowiki></code>, pour RSS le <code><nowiki><author></nowiki></code> dans l'élément <code><nowiki><item></nowiki></code>.


'''dtreviewed''':: Ce champ optionnel quand il est présent DOIT fournir un "date time" absolu ISO8601 du moment où la critique a été écrite ou autrement publiée. Ce champ DEVRAIT utiliser UTC, mais PEUT utiliser la syntaxe du fuseau horaire. Si dtreviewed est absent de hReview, alors regardez en dehors de hReview, dans le contexte environnant. Si le contexte est une entrée [[hatom-fr|hAtom]], utilisez son datetime "published" (ou "updated" si celui-ci manque) du fil. Autrement utilisez l'information  date de création (ou date modifiée si celle-ci manque) selon la langue du document conteneur (par ex. "published"/"updated" de la même manière pour les fils Atom), puis le protocole (par ex. HTTP Last-Modified, ou "file system last modified datetime") comme dtreviewed.
'''rating''' :: Le rating est un nombre entier fixé (une décimale pour la précision partant de 1.0 jusqu'à 5.0 inclus indiquant une évaluation pour l'item, le plus haut indiquant une meilleure évaluation par défaut. Facultativement, une valeur de nombre entier différente "worst" et/ou une valeur "best" {{may-fr}} être spécifiée pour indiquer une étendue différente (par ex. 6 de 0-10). La valeur "best" peut être numériquement plus petite que la valeur "worst".


'''rating''':: The rating is a fixed point integer (one decimal point of precision) from 1.0 to 5.0 inclusive indicating a rating for the item, higher indicating a better rating by default. Optionally a different integral "worst" value and/or "best" value MAY be specified (e.g. 6 from 0-10).  The "best" value may be numerically smaller than the "worst" value.
'''description''' :: Cette propriété optionnelle sert à délivrer un synopsis plus détaillé de la critique (par exemple, le texte complet représentant l'opinion écrite du critique) que celui fourni par "summary". La propriété PEUT inclure un balisage valide XHTML (par ex. des paragraphes).  Plusieurs descriptions ou des descriptions de sections (par ex. pours et contres, plus et moins) DEVRAIENT être incluses dans la propriété description.


'''description''':: This optional field contains the full text representing the written opinion of the reviewer. 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''' :: Les tags sont représentés en utilisant une liste de mots-clés ou phrases (en utilisant le microformat [[rel-tag-fr|rel-tag]] pour chaque mot-clé individuel ou tag de phrase) que le critique associera à l'item. Le critique PEUT ({{may-fr}}) en option fournir un tag-spécifique d'évaluation à l'intérieur de chaque [[rel-tag-fr|rel-tag]], par ex. ambience:5. Les évaluations tag-spécifiques par défaut utilisent la même gamme comme une évaluation globale pour l'item si présentes, et PEUVENT ({{may-fr}}) avoir aussi une gamme spécifiée allant de worst... à best. Les auteurs PEUVENT ({{may-fr}}) aussi inverser cette structure pour la même sémantique si elle est plus commode pour leur balisage, ce qui veut dire placer le [[rel-tag-fr|rel-tag]] à l'intérieur d'une évaluation pour indiquer un tag évalué. Note : les tags évalués devraient ({{should-fr}}) idéalement utiliser un espace tag qui explique ce que signifient les évaluations pour ce tag. Par ex. Food:18/30 devrait ({{should-fr}}) lier vers un espace tags pour Food qui explique ce que veut dire un 18 sur 30 pour le tag Food.


'''tags''':: Tags are represented using a list of keywords or phrases (using the [[rel-tag-fr]] microformat for each individual keyword or phrase tag) that the reviewer associates with the item. The reviewer MAY optionally provide a tag-specific rating inside each [[rel-tag-fr]], e.g. ambience:5. Tag-specific ratings by default use the same range as an overall rating for the item if present, and MAY also have a custom worst...best range specified.  Authors MAY also invert this structure for the same semantic if it is more convenient for their markup, that is, place the [[rel-tag]] inside a rating to indicate a rated tag.  Note: rated tags should ideally use a tag space that explains what the ratings for that tag mean. E.g. Food:18/30 should link to a tags space for Food that explains what an 18 out of 30 means for the Food tag.
'''permalink''' :: Cette propriété optionnelle est une URL pour le hReview. En plus d'utiliser le tag <code><a href></code> pour cette propriété, l'attribut <code>rel="self bookmark"</code> DOIT être utilisé pour dire que l'hyperlien est un lien permanent de la critique elle-même. Si l'hyperlien contient déjà un attribut <code>rel</code>, alors les valeurs <code>self</code> et <code>bookmark</code> DOIVENT être incluses parmi l'ensemble espace-séparé de valeurs dans l'attribut. Les indexeurs PEUVENT traiter le permalien d'une critique comme un ID unique afin d'identifier et réunir les même critiques provenant de sources multiples (comme le fait d'indexer une page plusieurs fois). Le permalien {{may-fr}} aussi être utilisé pour indiquer l'origine de la critique. Les auteurs PEUVENT utiliser le nom de classe d'un "permalink" sur l'élément représentant le permalien, mais ne sont pas obligés de faire ainsi.


'''permalink''':: This optional field is a URL for the hReview.  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 review 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 review as a unique ID in order to identify and collate the same review from multiple sources (such as indexing a page multiple times).  The permalink MAY also be used to indicate or imply the origin of the review.  Authors MAY use the classname of "permalink" on the element representing the permalink, but are not required to do so.
'''license''' :: une hReview indique la licence pour ses contenus en utilisant le microformat '''[[rel-license-fr|rel-license]]'''.


The following field names have been reused from the [[hcard-fr|hCard]] and [[hcalendar-fr|hCalendar]] microformats: <code>version, summary, fn, url, email, photo, description, categories</code>.  In addition, items and reviewers described by hCards MAY contain any hCard fieldThe rel value "self" has been reused from the [http://atompub.org/2005/07/11/draft-ietf-atompub-format-10.html Atom 1.0 specification].
Les noms de propriétés suivants ont été réutilisés à partir des microformats [[hcard-fr|hCard]] et [[hcalendar-fr|hCalendar]] : <code>summary, fn, url, email, photo, description, categories</code>.  En plus, les items et critiques décrits par les hCards PEUVENT contenir n'importe quelle propriété hCard.  La valeur rel "self" a été réutilisée à partir de la [http://atompub.org/2005/07/11/draft-ietf-atompub-format-10.html spécification Atom 1.0].
 
'''license''':: This optional field links to the license under which the contents of the hReview itself is licensed, using the '''[[rel-license-fr]]''' microformat.


=== Plus d'Equivalents Sémantiques ===
=== Plus d'Equivalents Sémantiques ===
Pour quelques propriétés, il existe un équivalent plus sémantique, et par conséquent elles reçoivent un traitement spécial, par ex. :


For some properties there is a more semantic equivalent, and therefore they get special treatment, e.g.:
* Pour toute "url", utilisez <code><a class="url" href="...">...</a></code> à l'intérieur de l'élément avec le nom de classe 'hreview' dans hReview.
* Et pour une "photo", utilisez <code><img class="photo" src="..." alt="Photo de ..." /></code>


* For any "url", use <code><a class="url" href="...">...</a></code> inside the element with the class name 'hreview' in hReview.
* Les évaluations sont souvent présentées comme un ensemble d'images ou caractères, par ex. "***".  Pour cela, l'élément <code>&lt;abbr&gt;</code> est particulièrement utile, parce que de tels caractères sont une abréviation pour l'évaluation précise, par ex. <code>&lt;abbr class="rating" title="3.0"&gt;***&lt;/abbr&gt;</code>.  Ceci est exploré plus à fond dans la section suivante.
* 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>
 
* Ratings are often presented either as a set of images or characters, e.g. "***".  For these, the <code>&lt;abbr&gt;</code> element is particularly useful, as such characters are an abbreviation for the precise rating, e.g. <code>&lt;abbr class="rating" title="3"&gt;***&lt;/abbr&gt;</code>.  This is further explored in the next section.


==== Langue ====
==== Langue ====
* To explicitly convey the natural language that an hReview is written in, use the standard (X)HTML 'lang' attribute on the element with class="hreview", e.g. <code>&lt;div class="hreview" lang="en"&gt; ... &lt;/div&gt;</code> If portions of an hReview (e.g. the item name) are in a different language, use the 'lang' attribute on those portions.
* Pour porter explicitement la langue naturelle dans laquelle une hReview est écrite, utiliser l'attribut standard HTML 'lang' sur l'élément avec class="hreview", par ex. <code>&lt;div class="hreview" lang="fr"&gt; ... &lt;/div&gt;</code> Si des portions d'une hReview (par ex. le nom de l'item) sont dans une langue différente, utilisez l'attribut 'lang' sur ces portions.
* hReview processors which need to handle the language of reviews MUST process the standard (X)HTML 'lang' attribute as specified.
* Les processeurs hReview qui ont besoin de gérer la langue des critiques DOIVENT traiter l'attribut standard HTML 'lang' comme spécifié.


=== Lisible par Human vs. Machine  ===
=== Lisible par Human vs. Machine  ===
If an <code>&lt;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.  
Si un élément <code>&lt;abbr></code> est utilisé pour une propriété, alors son attribut '<code>title</code>' est utilisé pour la valeur de la propriété, au lieu des contenus de l'élément, ce qui peut être ensuite utilisé pour fournir une présentation alternative de la valeur plus sympathique pour l'utilisateur.


Similarly, if an <code><img /></code> element is used for one or more properties, it MUST be treated as follows:  
De la même façon, si un élément <code><img /></code> est utilisé pour une ou plusieurs propriétés, il DOIT être traité comme suit :  


# For the "photo" property and any other property that takes a URL as its value, the <code>src="..."</code> attribute provides the property value.  
# Pour la propriété "photo" et toute autre propriété qui prend une URL comme sa valeur, l'attribut <code>src="..."</code> fournit la valeur de la propriété.
# For other properties, the <code><img /></code> element's '<code>alt</code>' attribute is the value of the property.
# Pour d'autres propriétés, l'attribut de l'élément <code><img /></code> '<code>alt</code>' est la valeur de la propriété.


=== Includes Objet ===
=== Includes ===


hReview 0.3 includes support for the object [[include-pattern]].
hReview 0.4 inclut le support pour l'objet [[include-pattern-fr|include-pattern]].
 
Often a single page lists an item, and then several reviews for that item.  In order to avoid having to repeat the item info for each review of the item, the first review should be marked up as an hReview, with a unique "id" attribute on the item info, and then following reviews should use the object [[include-pattern]] to include the item info from the first review.


Souvent une page unique liste un item, et puis plusieurs critiques pour cet item. Afin d'éviter d'avoir à répéter l'information pour chaque critique de l'item, la première critique devrait être balisée comme une hReview, avec un attribut unique "id" sur l'info item, et puis les critiques suivantes devraient utiliser l'objet [[include-pattern-fr|include-pattern]] pour inclure l'info item à partir de la première critique.


=== Notes ===
=== Notes ===
This section is informative.
Cette section est informative.


* By marking up a review with the hReview microformat, the expectation is communicated that the review MAY be indexed. This has no impact on the copyright of the review itself which the publisher may explicitly specify using [[rel-license]] as specified above.
* En balisant une critique avec le microformat hReview, l'attente est communiquée que la critique PEUT être indexée. Ceci n'a aucun impact sur le copyright de la critique elle-même que l'éditeur peut explicitement spécifier en utilisant la [[rel-license-fr|rel-license]] comme spécifié au-dessus.
* The enumerated list of item types is under development and may be extended.
* La liste énumérée des types d'items est en développement et peut être étendue.
* Each type may have custom hReview fields that follow the common set.
* Chaque type peut avoir des champs hReview personnalisés qui suivent l'ensemble commun.
* Additional details about a particular item should be specified with the rest of the item's info at the URL provided for the item.
* Des détails supplémentaires à propos d'un item particulier devraient être spécifiés avec le reste de l'info de l'item sur l'URL fournie pour l'item.
* Most rating systems use the range 1.0 to 5.0, and most of those represent the rating as a number (and possibly half) of stars. Sites may use whatever graphic they wish to represent the rating.
* La plupart des systèmes d'évaluation utilisent la gamme de 1.0 à 5.0, et la plupart de ceux-ci représent l'évaluation comme un nombre (et possiblement une moitié) d'étoiles. Les sites peuvent utiliser n'importe quel graphique qu'ils souhaitent pour représenter l'évaluation.


== Exemples ==
== Exemples ==
Here are a few examples of reviews from current web sites, and how they could be easily enhanced to support the hReview structured review microformat.
Voilà quelques exemples de critiques à partir de sites web actuels, et comment elles pourraient être facilement améliorées pour supporter le microformat structuré de critique hReview.


Want to get started with writing an [[hreview|hReview]]?  Use the [http://microformats.org/code/hreview/creator hReview creator] to write a review and publish it on your blog.
Vous voulez commencer par écrire vous-même un [[hreview-fr|hReview]] ?  Utilisez le [http://microformats.org/code/hreview/creator hReview creator] pour écrire une critique et la publier sur votre blog.


=== Critiques Restaurant ===
=== Critiques Restaurant ===


Here is an example of a simple online restaurant review:
Voici un exemple d'une simple critique de restaurant en ligne :


<pre><nowiki>
<source lang=html4strict>
<div>
<div>
  <span>5 stars out of 5 stars</span>
  <span>5 étoiles sur 5</span>
  <h4>Crepes on Cole is awesome</h4>
  <h4>Crepes on Cole est génial</h4>
  <span>Reviewer: <span>Tantek</span> - April 18, 2005</span>
  <span>Critique : <span>Tantek</span> - 18 avril 2005</span>
  <blockquote><p>
  <blockquote><p>
   Crepes on Cole is one of the best little creperies in San Francisco.  
   Crepes on Cole est l'une des meilleures petites crêperies dans San Francisco.  
   Excellent food and service. Plenty of tables in a variety of sizes
   Nourriture et service excellents. Beaucoup de tables de différentes tailles
   for parties large and small. Window seating makes for excellent
   pour les fêtes qu'elles soient petites et grandes. Celles près de la fenêtre sont
   people watching to/from the N-Judah which stops right outside.
   merveilleuses pour regarder les gens. J'ai eu l'occasion d'avoir beaucoup de rencontres ici
  I've had many fun social gatherings here, as well as gotten
   tout comme le fait de réaliser beaucoup de travail grâce au WiFi avoisinant.
   plenty of work done thanks to neighborhood WiFi.
  </p></blockquote>
  </p></blockquote>
  <p>Visit date: <span>April 2005</span></p>
  <p>Date de visite : <span>Avril 2005</span></p>
  <p>Food eaten: <span>Florentine crepe</span></p>
  <p>Plat dégusté : <span>Crêpe Florentine</span></p>
</div>
</div>
</nowiki></pre>
</source>


Adding hReview to this review is quite simple:
ajouter une hReview à cette critique est vraiment simple :


<pre><nowiki>
<source lang=html4strict>
<div class="hreview">
<div class="hreview">
  <span><span class="rating">5</span> out of 5 stars</span>
  <span><span class="rating">5</span> étoiles sur 5</span>
  <h4 class="summary">Crepes on Cole is awesome</h4>
  <h4 class="summary">Crepes on Cole est génial</h4>
  <span class="reviewer vcard">Reviewer: <span class="fn">Tantek</span> -  
  <span class="reviewer vcard">Critique : <span class="fn">Tantek</span> -  
  <abbr class="dtreviewed" title="20050418T2300-0700">April 18, 2005</abbr></span>
  <abbr class="dtreviewed" title="2005-04-18">18 avril 2005</abbr></span>
  <div class="description item vcard"><p>
  <div class="description item vcard"><p>
   <span class="fn org">Crepes on Cole</span> is one of the best little
   <span class="fn org">Crepes on Cole</span> est l'une des meilleures petites 
   creperies in <span class="adr"><span class="locality">San Francisco</span></span>.
   crêperies à <span class="adr"><span class="locality">San Francisco</span></span>.
   Excellent food and service. Plenty of tables in a variety of sizes
   Nourriture et service excellents. Beaucoup de tables de différentes tailles
   for parties large and small. Window seating makes for excellent
   pour les fêtes qu'elles soient petites et grandes. Celles près de la fenêtre sont
   people watching to/from the N-Judah which stops right outside.   
   merveilleuses pour regarder les gens..J'ai eu l'occasion d'avoir beaucoup
   I've had many fun social gatherings here, as well as gotten
   de rencontres ici tout comme le fait de réaliser beaucoup de travail grâce au WiFi
   plenty of work done thanks to neighborhood WiFi.
   avoisinant.
  </p></div>
  </p></div>
  <p>Visit date: <span>April 2005</span></p>
  <p>Date de visite : <span>Avril 2005</span></p>
  <p>Food eaten: <span>Florentine crepe</span></p>
  <p>Plat dégusté : <span>Crêpe Florentine</span></p>
</div>
</div>
</nowiki></pre>
</source>


Note that some of the properties of this sample review are not captured by hReview (visit date, food eaten). This is deliberate per the scope of keeping hReview minimal and simple.
Remarquez que quelques-unes des propriétés de cette critique échantillon ne sont pas saisies par hReview (date de visite, nourriture). Ceci est délibéré par le fait de vouloir conserver une hReview minimale et simple.


This sample hReview could be rendered like this:
Ce échantillon de hReview pourrait être restitué comme ça :  


5 stars out of 5 stars<br />
5 étoiles sur 5 <br />
'''Crepes on Cole is awesome'''<br />
'''Crepes on Cole est génial'''<br />
Reviewer: Tantek - April 18, 2005<br />
Critique : Tantek - 18 avril 2005<br />


Crepes on Cole is one of the best little creperies in San Francisco. Excellent food and service.  
Crepes on Cole est l'une des meilleures petites crêperies dans San Francisco.  
Plenty of tables in a variety of sizes for parties large and small.   
Nourriture et service excellents. Beaucoup de tables de différentes tailles
Window seating makes for excellent people watching to/from the N-Judah which stops right outside.
pour les fêtes qu'elles soient petites et grandes. Celles près de la fenêtre sont merveilleuses pour regarder les gens..J'ai eu l'occasion d'avoir beaucoup de rencontres ici tout comme le fait de réaliser beaucoup de travail grâce au WiFi avoisinant.
I've had many fun social gatherings here, as well as gotten plenty of work done thanks to neighborhood wifi.


Visit date: April 2005<br />
Date de visite : Avril 2005<br />
Food eaten: Florentine crepe<br />
Plat dégusté : Crêpe Florentine<br />


==== Critique Restaurant Multidimensionnnelle ====
==== Critique Restaurant Multidimensionnnelle ====
Some restaurant reviews indicate ratings for different aspects of the restaurant. Such details are represented in hReview using tagged ratings. In addition, note the inline tags inside the description of this review.
Quelques critiques de restaurants indiquent des évaluations pour différents aspects du restaurant. De tels détails sont représentés dans hReview en utilisant les évaluations taguées. En plus, remarquez les tags dans la ligne dans la description de cette critique.


Here is one such review in text format:
Voilà une telle critique en format texte :  


  Cafe Borrone
  Cafe Borrone
Line 247: Line 213:
  jazz band nights.
  jazz band nights.


As an hReview:
Sous un hReview :


<pre><nowiki>
<source lang=html4strict>
<div class="hreview">
<div class="hreview">
  <div class="item vcard">
  <div class="item vcard">
Line 262: Line 228:
   <a class="url" href="http://cafeborrone.com">cafeborrone.com</a>
   <a class="url" href="http://cafeborrone.com">cafeborrone.com</a>
  </div>
  </div>
  <ul class="categories">
  <ul>
   <li class="rating"><a href="http://en.wikipedia.org/wiki/Food" rel="tag">
   <li class="rating"><a href="http://en.wikipedia.org/wiki/Food" rel="tag">
   Food: <span class="value">18</span>/<span class="best">30</span></a>;</li>
   Food: <span class="value">18</span>/<span class="best">30</span></a>;</li>
Line 295: Line 261:
   hReview v<span class="version">0.3</span></a>)
   hReview v<span class="version">0.3</span></a>)
  by <span class="reviewer vcard"><span class="fn">anonymous</span></span>,  
  by <span class="reviewer vcard"><span class="fn">anonymous</span></span>,  
  <abbr class="dtreviewed" title="20050428T2130-0700">April 28th, 2005</abbr>.
  <abbr class="dtreviewed" title="2005-04-28">April 28th, 2005</abbr>.
</div>
</div>
</nowiki></pre>
</source>


With an accompanying CSS style sheet like:
Avec une feuille de style l'accompagnant comme :  


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


This hReview could be presented similar to the original text:
Cette hReview pourrait être présentée de la même manière que le texte original :


Cafe Borrone<br />
Cafe Borrone<br />
Line 320: Line 286:
This [http://en.wikipedia.org/wiki/cafe cafe] is a welcoming oasis on the Peninsula.  It even has a fountain outside which cloaks the nearby sounds of El Camino traffic.  Next door to a superb indy bookstore, Cafe Borrone is an ideal spot to grab a [http://en.wikipedia.org/wiki/coffee coffee] or a snack to accompany a newly purchased book or imported periodical.  [http://technorati.com/tag/soup Soups] and [http://technorati.com/tag/sandwich sandwich] specials rotate daily.  The corn chowder with croutons and big chunks of cheese goes especially well with a freshly toasted mini-baguette.  Evenings are often crowded and may require sharing a table with a perfect stranger.  [http://flickr.com/photos/tags/espresso Espresso] afficionados will appreciate the [http://en.wikipedia.org/wiki/Illy Illy] coffee.  Noise levels can vary from peaceful in the late mornings to nearly overwhelming on [http://en.wikipedia.org/wiki/jazz jazz] band nights.
This [http://en.wikipedia.org/wiki/cafe cafe] is a welcoming oasis on the Peninsula.  It even has a fountain outside which cloaks the nearby sounds of El Camino traffic.  Next door to a superb indy bookstore, Cafe Borrone is an ideal spot to grab a [http://en.wikipedia.org/wiki/coffee coffee] or a snack to accompany a newly purchased book or imported periodical.  [http://technorati.com/tag/soup Soups] and [http://technorati.com/tag/sandwich sandwich] specials rotate daily.  The corn chowder with croutons and big chunks of cheese goes especially well with a freshly toasted mini-baguette.  Evenings are often crowded and may require sharing a table with a perfect stranger.  [http://flickr.com/photos/tags/espresso Espresso] afficionados will appreciate the [http://en.wikipedia.org/wiki/Illy Illy] coffee.  Noise levels can vary from peaceful in the late mornings to nearly overwhelming on [http://en.wikipedia.org/wiki/jazz jazz] band nights.


Review ([http://microformats.org/wiki/hreview hReview v0.3]) by anonymous, April 28th, 2005.
([http://microformats.org/wiki/hreview hReview]) by anonymous, April 28th, 2005.


=== Critique produit ===
=== Critique produit ===
Here is an example of a product review:
Voilà un exemple d'une critique de produit :  


<pre><nowiki>
<source lang=html4strict>
<div>
<div>
  <a href="http://www.amazon.com/exec/obidos/ASIN/B000089CJI/">
  <a href="http://www.amazon.com/exec/obidos/ASIN/B000089CJI/">
   <img src="http://images.amazon.com/images/P/B000089CJI.01._SCTHUMBZZZ_.jpg"  
   <img src="http://images.amazon.com/images/P/B000089CJI.01._SCTHUMBZZZ_.jpg"  
               alt="Album cover photo: The Postal Service: Give Up." />
               alt="photo couverture album : The Postal Service : Give Up." />
  The Postal Service: Give Up</a>
  The Postal Service : Give Up</a>
  <blockquote><p>
  <blockquote><p>
   "The people thought they were just being rewarded for treating others
   "Les gens pensaient qu'ils ont été simplement récompensés sur le fait de traiter les autres
     as they like to be treated, for obeying stop signs and curing diseases,  
     comme ils aiment être traités, pour obéir à des panneaux stop et guérir des maladies, pour
     for mailing letters with the address of the sender... Don't wake me,  
     des lettres de mailing avec l'adresse de l'expéditeur... Ne m'éveillez pas, je prévois de
     I plan on sleeping in..."
     dormir dedans..."
   </p><p>
   </p><p>
   "Nothing Better" is a great track on this album, too...  
   "Nothing Better" est aussi une plage géniale sur cet album...
  </p></blockquote>
  </p></blockquote>
  (*****)
  (*****)
</div>
</div>
</nowiki></pre>
</source>


Adding hReview to this review is also quite simple, but in this case requires a few more elements for the rating and reviewer which are required by hReview:
Ajouter hReview à cette critique est aussi tout à fait simple, mais requiert dans ce cas quelques éléments supplémentaires pour l'évaluation et le critique qui sont requis par hReview :


<pre><nowiki>
<source lang=html4strict>
<div class="hreview">
<div class="hreview"><span class="item">
  <a class="item url" href="http://www.amazon.com/exec/obidos/ASIN/B000089CJI/">
  <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"  
   <img src="http://images.amazon.com/images/P/B000089CJI.01._SCTHUMBZZZ_.jpg"  
       alt="Album cover photo: The Postal Service: Give Up. "  
       alt="Photo de couverture de l'album : The Postal Service: Give Up. "  
       class="photo" />
       class="photo" />
<span class="fn">The Postal Service: Give Up</span></a>
  The Postal Service : Give Up</a></span>
  <div class="description"><p>
  <div class="description"><p>
     "The people thought they were just being rewarded for treating others
     "Les gens pensaient qu'ils ont été simplement récompensés sur le fait de traiter les autres
    as they like to be treated, for obeying stop signs and curing diseases,  
    comme ils aiment être traités, pour obéir à des panneaux stop et guérir des maladies, pour
    for mailing letters with the address of the sender... Don't wake me,  
    de lettres de mailing avec l'adresse de l'expéditeur... Ne m'éveillez pas, je prévois de
    I plan on sleeping in..."
    dormir dedans..."
   </p><p>
   </p><p>
   "Nothing Better" is a great track on this album, too...  
   "Nothing Better" est aussi une plage géniale sur cet album...
  </p></div>
  </p></div>
  (<abbr class="rating" title="5">*****</abbr>)
  (<abbr class="rating" title="5">*****</abbr>)
  <p class="reviewer vcard">Review by  
  <p class="reviewer vcard">Review by  
   <a class="url fn" href="http://ifindkarma.com/blog/">Adam Rifkin</a>,  
   <a class="url fn" href="http://ifindkarma.com/blog/">Adam Rifkin</a>,  
   <abbr class="dtreviewed" title="200502">February 2005</abbr>
   <abbr class="dtreviewed" title="2005-02">February 2005</abbr>
  </p>
  </p>
</div>
</div>
</nowiki></pre>
</source>


And this hReview might be presented like this:
Et ce hReview pourrait être présenté comme suit :  




[Album cover photo: ]
[Photo de couverture de l'album: ]
[The Postal Service:]
[The Postal Service:]
[      Give Up      ]
[      Give Up      ]
Line 377: Line 343:
The Postal Service: Give Up
The Postal Service: Give Up


"The people thought they were just being rewarded for treating others as they like to be treated, for obeying stop signs and curing diseases, for mailing letters with the address of the sender... Don't wake me, I plan on sleeping in..."
"Les gens pensaient qu'ils ont été simplement récompensés sur le fait de traiter les autres comme ils aiment être traités, pour obéir à des panneaux stop et guérir des maladies, pour
 
des lettres de mailing avec l'adresse de l'expéditeur... Ne m'éveillez pas, je prévois de dormir dedans..."
"Nothing Better" is a great track on this album, too...
"Nothing Better" est aussi une plage géniale sur cet album...


(*****)
(*****)


Review by Adam Rifkin, February 2005.
Critique d'Adam Rifkin, février 2005.


=== Movie Review ===
=== Critique de Film ===
Finally, here is an example of a movie review.
Pour finir, voilà un exemple d'une critique de film.


<pre><nowiki>
<source lang=html4strict>
<div>
<div>
  <span>anonymous, April 18th, 2005</span>
  <span>anonyme, le 18 avril 2005</span>
  <div>
  <div>
   <a lang="zh" href="http://www.imdb.com/title/tt0299977/">
   <a lang="zh" href="http://www.imdb.com/title/tt0299977/">
Line 396: Line 362:
   </a>
   </a>
  </div>
  </div>
  <div>Rating: 4 out of 5</div>
  <div>Notation : 4 sur 5</div>
  <blockquote><p>
  <blockquote><p>
   This movie has great visuals and music.
   Ce film a des images et une musique vraiment au top.
  </p></blockquote>
  </p></blockquote>
</div>
</div>
</nowiki></pre>
</source>


With hReview:
Avec hReview:


<pre><nowiki>
<source lang=html4strict>
<div class="hreview">
<div class="hreview">
  <span class="reviewer vcard">
  <span class="reviewer vcard">
   <span class="fn">anonymous</span>,  
   <span class="fn">anonyme</span>,  
   <abbr class="dtreviewed" title="20050418">April 18th, 2005</abbr>
   <abbr class="dtreviewed" title="2005-04-18">18 avril 2005</abbr>
  </span>
  </span>
  <div class="item">
  <div class="item">
Line 416: Line 382:
   </a>
   </a>
  </div>
  </div>
  <div>Rating: <span class="rating">4</span> out of 5</div>
  <div>Notation : <span class="rating">4</span> sur 5</div>
  <div class="description"><p>
  <div class="description"><p>
   This movie has great music and visuals.
   Ce film a des images et une musique vraiment au top.
  </p></div>
  </p></div>
</div>
</div>
</nowiki></pre>
</source>


Which could be presented like this:
Qui pourrait être présenté comme ça :  


anonymous, April 18th, 2005<br />
anonyme, 18 avril 2005<br />
Ying Xiong (HERO)<br />
Ying Xiong (HERO)<br />
Rating: 4 out of 5<br />
Notation : 4 sur 5<br />


This movie has great music and visuals.
Ce film a des images et une musique vraiment au top.


== Examples in the wild ==
== Exemples dans la jungle ==
This section is '''informative'''.
Cette section est '''informative'''.


The following sites have published hReviews, 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 hReviews 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.
Le nombre d'exemples hReview dans la jungle a grandi si vite et bien au delà de la capacité à pouvoir être maintenu en ligne dans cette spécification. Ils ont été migré sur une [[hreview-examples-in-wild-fr|page séparée]].


Want to get started with writing an [[hreview|hReview]]?  Use the [http://microformats.org/code/hreview/creator hReview creator] to write a review and publish it on your blog.
Voir [[hreview-examples-in-wild-fr|hReview-exemples-dans-la-jungle]].


* [http://corkd.com/ Cork'd] is a community site for reviewing and sharing wine.  Member-created "Tasting Notes" are published using hReview.
== Implémentations ==
* [[User:ChrisCasciano]] has started using hReview in his blog postings including these reviews of [http://chunkysoup.net/article/211/TechnoratisNewToys Pingerati and Technorati Microformat Search].
Cette section est '''informative'''. Le nombre d'implémentations de hReview a aussi grandi au delà de la capacité à pouvoir les maintenir dan la page. Elles ont été migrées sur une [[hreview-implementations-fr|page séparée]].
* [http://www.judysbook.com/ Judy's Book] is a local reviews community.  All reviews are published in hReview format, and all business listings and members (review authors) in the hCard format.
* [http://www.judysbook.com/ Judy's Book] is a local reviews community. All reviews are published in hReview format, and all business listings and members (review authors) in the hCard format.
* [http://tech.yahoo.com/ Yahoo! Tech] has launched with hReview markup on all their reviews! Hat tips: [http://nerddawg.blogspot.com/2006/05/hreview-microformat-on-yahoo-tech.html Ashish Shetty] and [http://jeremy.zawodny.com/blog/archives/006729.html Jeremy Zawodny] both via [http://www.moskalyuk.com/blog/yahoo-tech-tip-of-the-day/1058 Alex Moskalyuk].  [http://jeremy.zawodny.com/blog/archives/006729.html#comment-27779 Alex says]: "when we launched, the press reported on 300,000 tech products in our database. Some popular items, like [http://tech.yahoo.com/pr/apple-ipod-video-30gb-black-mp3-player/1992981873 this Apple iPod], have over 200 reviews."
* [http://3spots.blogspot.com/2006/05/social-bookmarking-smarking.html 3spots: Social + bookMARKING = Smarking] has an hReview of [http://smarking.com/ Smarking.com] (a social bookmarking service) which marks up their tagged links with [[xfolk|xFolk]].
* [http://www.pacificspirit.com Dave Orchard] provides hreview marked [http://www.pacificspirit.com/Restaurants-Vancouver.html Vancouver Restaurant reviews]
* [http://3spots.blogspot.com/2006/04/what-is-wikio-definitely-web-20-but.html hReview of Wikio]
* [http://jg.typepad.com/ciel/ Joan] has published [http://jg.typepad.com/ciel/2006/02/daniel_bouluds_.html an hReview of Garçon]
* [http://zipingo.typepad.com/ Zipingo Team Blog], a collaborative blog by the Zipingo Product Development Team at Intuit, used the hReview format to tag [http://zipingo.typepad.com/my_weblog/2005/12/finding_an_elec.html the backstory] of a review on a San Mateo electrician, written by one of the Zipingo team members ZipingoJim. Jim's post also links to his review on [http://www.zipingo.com Zipingo], a consumer opinion site.
* [http://mincedmedia.blogspot.com/ Minced Media], a media blog by author/writer [http://www.kimbayne.com Kim M. Bayne], used the hReview format to tag her rant about [http://mincedmedia.blogspot.com/2005/09/old-yeller.html customer service]. Future reviews of business and media will contain hReview.
* [http://ukfilmreview.blogspot.com/ UK Film Review] a new blog using hReview format to review Films and DVD releases in the UK
* [http://www.debaser.it/ DeBaser.it] publishes music reviews (in Italian) supporting hReview.
* [http://blog.ftwr.co.uk/ Peter Westwood] posted an [http://blog.ftwr.co.uk/archives/2006/01/05/the-fox-inn/ hReview of The Fox Inn]
* [http://www.livejournal.com/users/danieljohn/ Daniel John] provides a [http://www.livejournal.com/users/danieljohn/58674.html scathing hReview of CIBC].
* [http://uk.movies.yahoo.com/movie-reviews/ Yahoo UK Movie Reviews] now supports hReview on all (>2000) reviews, e.g. [http://uk.movies.yahoo.com/h/Harry-Potter-and-the-Goblet-of-Fire/review-41195.html Harry Potter and the Goblet of Fire Review]
* [http://adam.typepad.com/impossiblethings/ Adam Hertz] wrote hReviews of [http://adam.typepad.com/impossiblethings/2005/11/soluna.html Soluna] and [http://adam.typepad.com/impossiblethings/2006/05/cafe_gibraltar.html Cafe Gibraltar]
* [http://www.mattmcalister.com/blog/ Matt McAllister] wrote an [http://www.mattmcalister.com/blog/_archives/2005/11/16/1408893.html hReview of the TV show: "The Office"]
* [http://www.bmannconsulting.com/blog/bmann/ Boris Mann] wrote an [http://www.bmannconsulting.com/blog/bmann/doubletake-best-panorama-stitch-tool-for-mac-os-x hReview of DoubleTake, a panorama stitch tool for Mac OS X]
* [http://blog.ftwr.co.uk/ Peter Westwood] has written an [http://blog.ftwr.co.uk/archives/2005/10/03/blubeckers-hampton-court/ hReview of Blubeckers Hampton Court] and an [http://blog.ftwr.co.uk/archives/2006/01/05/the-fox-inn/ hReview of The Fox Inn Bucks Green, West Sussex]
* [http://dougal.gunters.org/blog/ Dougal] has published an [http://dougal.gunters.org/blog/2005/08/03/french-vanilla-latte hReview of Wolfgang Puck’s Gourmet French Vanilla Latte].
* [http://www.dinnerbuzz.com/ Dinnerbuzz] is a great site for posting tagged reviews of restaurants, and they publish and summarize all their reviews in hReview!
* [http://soldierant.net/ Bryce Glass] posted an [http://soldierant.net/archives/2005/06/product_review.html hReview of the Uniden ELBT 595 Bluetooth Cordless Phone].
* dda posted an [http://sungnyemun.org/wordpress/?p=20 hReview of hReview] :)
* An [http://tbp.xomerang.com/?p=3 hReview of Caffè Camardo coffee].
* [http://loadaveragezero.com/hnav/contact.php Douglas Clifton] posted [http://loadaveragezero.com/#May-12-2005 comments] regarding adapting his list of ~800 [http://loadaveragezero.com/app/drx Developer Resources] as a format for evaluating hReview.
* [http://www.oliverbrown.me.uk/ Oliver Brown] [http://www.oliverbrown.me.uk/2005/05/09/sitereviewsorg-supports-hreview-i-think/ has announced] that his [http://en-us.sitereviews.org/ SiteReviews.org] (which reviews websites) publishes its reviews using hReview, e.g. here is the [http://en-us.sitereviews.org/review-photomatt.net review on SiteReviews.org for photomatt.net].
* [http://www.myelin.co.nz/post/ Phillip Pearson] is publishing hReviews in the [http://coffee.gen.nz/rss/reviews RSS feed of cafe reviews] on his [http://coffee.gen.nz/ kiwi coffee review site], which of course has the reviews in HTML with embedded hReview markup as well.
* [http://station11.net/ticker/ Kjell] is publishing his link blog as a [http://station11.net/ticker/ list of hReviews].
* [http://epeus.blogspot.com/ Kevin Marks] has [http://epeus.blogspot.com/2005_04_01_epeus_archive.html#111484565269684374 published two hReviews] and used unicode "star" characters for his ratings!
* JamesStewart is publishing hReviews in the location pages at his [http://grwifi.net Grand Rapids WiFi site].
* [http://soldierant.net/ Soldier Ant] has [http://soldierant.net/archives/2005/06/product_review.html reviewed a cordless phone].
* [http://www.happenchance.co.uk/ Paul Livingstone] uses hreview to voice his opinion on [http://www.happenchance.co.uk/archives/2005/07/war_of_the_worl.php books], [http://www.happenchance.co.uk/archives/2005/03/im_going_to_fin.php movies] and [http://www.happenchance.co.uk/archives/2005/05/eels_carling_ac.php music].
* [http://www.stuffandnonsense.co.uk/ Andy Clarke] uses hReview for his [http://www.stuffandnonsense.co.uk/general/recommended-reading.html recommended reading list].
* [http://www.tjameswhite.com/blog Tim White] has begun implementing hReviews at [http://reviews.gale.com at work].
* [http://nachlin.com/ Jim Nachlin] has added hReview publishing to the CMS he uses to publish  [http://daysofleisure.com/writing his blog].
* [http://whumpdotcom.livejournal.com/236856.html Bill Humphries] has reviewed the book "A Brother's Price" on his LiveJournal.
* [http://www.thinkvitamin.com/ Vitamin] uses hReview on it's [http://www.thinkvitamin.com/reviews/ reviews] section (e.g. a [http://www.thinkvitamin.com/reviews/webapps/fluxiom/ review of Fluxiom]).
* [http://www.openguides.org/ OpenGuides] has support for the hReview microformat in svn, and for now you can see it in action on the [http://cotswolds.openguides.org/ Cotswolds OpenGuide].
* [http://paulgoscicki.com Paul Goscicki] is publishing his [http://paulgoscicki.com/#wp_movie_ratings movie ratings] using hReview.
* [http://www.liptrot.org Adam Liptrot] publishes movie reviews using hReview and hCard. See article at [http://www.liptrot.org/journal/entries/movies_and_microformats/ Movies and Microformats].


== Implementations ==
Voir [[hreview-implementations-fr|hReview-implémentations]]
This section is '''informative'''.


The following implementations have been developed which either generate or parse hReviews. If you have an hReview 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.
=== Inspiration et Remerciements ===
Merci à tous ceux qui ont répondu à l'appel ouvert pour participation à l'implémentation du hReview. Les auteurs souhaitent tout particulièrement remercier les individus suivants pour leurs avis constructifs et leurs réactions :
[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].


* [http://kitchen.technorati.com/search Technorati Microformats Search] indexes [[hcard|hCard]], [[hcalendar|hCalendar]], and [[hreview|hReview]] as [http://tantek.com/log/2006/05.html#d31t1802 announced by Tantek].
; Auteurs hReview v0.3
* [http://blog.codeeg.com/2006/03/20/flock-tails-flocktails/ Flocktails] - port of Tails extension for Flock 0.5.12 that looks for hCards, hCalendar, xFolk and hReview and tosses them into a handy topbar
: [[User:Tantek|Tantek Çelik]] (tantek.com, et avant chez [http://technorati.com/ Technorati])
* [http://www.reevoo.com/blogs/bengriffiths/ Revieworld CTO Ben Griffiths] has announced that they have built support into [http://www.reevoo.com/ Reevoo] to [http://www.reevoo.com/blogs/bengriffiths/2006/02/01/join-the-reevolution/ aggregate reviews of products that are published on blogs using hReview] ([http://opensource.reevoo.com/2006/03/08/release-uformats-12/ open source parser for Ruby])
: <span class="vcard"><span class="fn">[http://360.yahoo.com/alidiabali Ali Diab]</span></span> ([http://yahoo.com Yahoo! Inc.])
* [http://brain.lionsden.com/ Leo Cerebellum Annotare] notes that [http://brain.lionsden.com/?p=229 ReviewZilla Alpha 2 includes MicroFormat hReview markup]
: <span class="vcard"><span class="fn">[http://ianmcall.blogspot.com/ Ian McAllister]</span></span> ([http://amazon.com/ Amazon.com])
* [http://blog.codeeg.com/ Calvin Yu] has written a  [http://blog.codeeg.com/2006/01/28/using-microformats-to-plot-my-favorite-places/ web service that will allow you plot and describe places on a Yahoo Map easily] using [[hreview|hReview]] and [[geo]].
: <span class="vcard"><span class="fn">[http://journals.aol.com/panzerjohn/abstractioneer John Panzer]</span></span> ([http://www.aol.com America Online, Inc.])
* [http://blog.codeeg.com/tails-firefox-extension/ Tails is a Firefox Extension] that will display the presence of microformats ([[hcard|hCard]], [[hcalendar|hCalendar]], [[hreview|hReview]], [[xfolk|xFolk]]) on a webpage.
: <span class="vcard"><span class="fn">[http://ifindkarma.com/blog Adam Rifkin]</span></span> ([http://labs.commerce.net/ CommerceNet Labs])
* [http://kritx.com Kritx] is a site that indexes hReviews and other reviews on the Web.
: <span class="vcard"><span class="fn">[http://sippey.typepad.com/ Michael Sippey]</span></span> ([http://sixapart.com Six Apart, Ltd])
* [http://www.goodpic.com/mt/aws/index_us.html Goodpic] has written:
** [http://www.goodpic.com/mt/aws/index_us.html hReview creator for Amazon.com products]
** [http://www.goodpic.com/mt/aws/index_uk.html hReview creator for Amazon.co.uk products]
** [http://www.goodpic.com/mt/aws/index_uk.html hReview creator for Amazon.co.jp products]
** be sure to choose the "hRview" tab from among the choices on the page that says "You can choose from more than 30 designs, please click the tab to select categories."
* See the microformats.org [http://microformats.org/code/hreview/creator hReview creator]
* [http://www.eigaseikatu.com/ Eigaseikatu], one of the largest movie community sites in Japan, provides [http://www.eigaseikatu.com/hreview/ hReview creator] for movie review.
* [http://sungnyemun.org/wordpress/?p=22 hReview plugin for WordPress]
* [http://paulgoscicki.com/projects/wp-movie-ratings/ WP Movie Ratings] is a [http://wordpress.org WordPress] plugin made by [http://paulgoscicki.com Paul Goscicki] which lets you rate (and review) movies and publish those ratings as hReviews.
* [http://theryanking.com/ Ryan King] has an [http://theryanking.com/microformats/hreview-creator.html hReview Creator].
* [http://rvu.ning.com/ Rvu] is a [http://ning.com Ning] app that lets you write reviews of reviews and publishes them in hReview
* [http://randomchaos.com/microformats/base/ Microformat Base] is an open-source PHP microformat aggregation crawler, currently recognizing hreview, hcalendar, and hcard.


== References ==
 
=== Normative References ===
== Principes De Design XHTML Sémantique ==
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
Cette section est '''informative'''.  hReview a été conçu en utilisant les [[principles-fr|principes de design]] similaires à ceux qui étaient dans [[hcard-fr|hCard]] et par conséquent cet aperçu est inclus à des fins d'information.
{{semantic-xhtml-design-principles-fr}}
 
== Références ==
=== Références Normatives ===
* [http://w3.org/html5 HTML5]
* [http://gmpg.org/xmdp/ XMDP]
* [http://gmpg.org/xmdp/ XMDP]
* [[hcard|hCard]]
* [[hcard-fr|hCard]]
* [[hcalendar|hCalendar]]
* [[hcalendar-fr|hCalendar]]
* [[rel-tag]]
* [[rel-tag-fr|rel-tag]]
* [http://www.ietf.org/rfc/rfc2119.txt RFC2119]
* [http://www.ietf.org/rfc/rfc2119.txt RFC2119]
* [http://www.ietf.org/rfc/rfc3986.txt RFC3986]
* [http://www.ietf.org/rfc/rfc3986.txt RFC3986]
* [http://www.ietf.org/rfc/rfc4287.txt RFC4287] (Atom 1.0)
* [http://www.ietf.org/rfc/rfc4287.txt RFC4287] (Atom 1.0)


=== Informative References ===
=== Références Informatives ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [http://www.w3.org/TR/REC-CSS1 CSS1]
* [http://www.w3.org/TR/REC-CSS1 CSS1]
* ISO.8601.1988
* ISO.8601 [http://www.w3.org/TR/NOTE-datetime http://www.w3.org/TR/NOTE-datetime]
** International Organization for Standardization, "Data elements and interchange formats - Information interchange - Representation of dates and times", ISO Standard 8601, June 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/rfc3667.txt RFC3667]
* [http://www.ietf.org/rfc/rfc3668.txt RFC3668]
* [http://www.ietf.org/rfc/rfc3668.txt RFC3668]
* [http://www.w3.org/Consortium/Patent-Policy-20040205/ W3C Patent Policy]
* [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]
* [http://local.yahoo.com/details?id=21359628 Crepes on Cole reviews on Yahoo! Local]
* Other reviews efforts. See [[reviews-formats-fr]].
* Autres efforts de critiques. Voir [[reviews-formats-fr|review-formats]].
* Contributed from http://developers.technorati.com/wiki/hReview.
* Contribué à partir de http://developers.technorati.com/wiki/hReview.
 
==== Travaux similaires ====
* [[hlisting-proposal-fr|hListing]]
* [[xoxo-fr|XOXO]]
 
== Copyright ==
{{MicroformatCopyrightStatement2005-fr}}
 
* [[User:Tantek|Tantek]] : Je sors toutes mes contributions à cette spécification dans le domaine public et j'encourage les autres auteurs à faire de même.
** Quand tous les auteurs/éditeurs auront fait ainsi, nous pourrons retirer la référence au modèle  MicroFormatCopyrightStatement et la remplacer avec le modèle MicroFormatPublicDomainContributionStatement.
 
== Brevets ==
{{MicroFormatPatentStatement-fr}}


==== Similar Work ====
== Chantier en cours ==
* [[hlisting-proposal|hListing]]
Cette spécification est un chantier en cours. Au fur et à mesure que des aspects supplémentaires sont discutés, compris et écrits, ils seront ajoutés.
* [[xoxo|XOXO]]


=== Copyright ===
=== Modifications à partir de la  v0.3 ===
{{MicroformatCopyrightStatement2005}}
Les modifications suivantes ont été produites dans hReview v0.3 sur [[hreview-v0.2|hReview v0.2]] :


=== Patents ===
Changements normatifs :
{{MicroFormatPatentStatement}}
# Ajouté références normatives à
## [[value-class-pattern-fr|modèle de classe value]] - requis pour support.
## [[html5-fr|HTML5]] - pour le parsage/DOM  HTML5
# Changé références normatives vers "informative" :
## Includes delegué pleinement [[include-pattern-fr|includepattern]] plutôt que de spécifier "Object Includes"
## propriété '''version''' abandonnée. Petite si quelque publication en pratique, et pas d'usages pratiques trouvés. Smaller is better.
## '''dtreviewed''' peut être aussi une date absolue ISO8601, et doit utiliser le [[value-class-pattern-fr|modèle de classe value]] si nécessaire.


== Work in progress ==
Modifications informatives (plusieurs, mais en particulier) :
This specification is a work in progress. As additional aspects are discussed, understood, and written, they will be added.  
# changé éditeur/auteur à simplement [[Tantek]] pour préparer et reprendre une récriture.
# exemples mis à jour :
## valeurs de propriété '''dtreviewed''' utilisent le [[date-pattern-fr|date-pattern]]
## propriété de '''version''' abandonnée


=== Changes from v0.2 ===
The following changes have been made in hReview v0.3 over [[hreview-v0.2|hReview v0.2]]:


Normative changes:
== Articles ==
# MUST (instead of SHOULD) use [[hcard-fr|hCard]] for the item description of a business or person
Cette <span id="Pour_aller_plus_loin">section</span> est <strong>informative</strong>.  
# "reviewer" changes
## Made reviewer *optional* per feedback from Ryan King and Mark Nottingham
## If reviewer is absent from the hReview, then look outside the hReview, in the context of the page, for the reviewer.  If there is no "reviewer" outside either, then use the author information according to the containing document language (e.g. <code><nowiki><address></nowiki></code> for (X)HTML pages) as the reviewer.
## MUST (instead of SHOULD) use [[hcard-fr|hCard]] to represent reviewer information
# "dtreviewed" changes
## Made dtreviewed *optional* per feedback from Ryan King and Mark Nottingham
## If dtreviewed is absent from the hReview, then look outside the hReview, in the surrounding context.  If the context is an [[hatom|hAtom]] entry, use its "published" (or "updated" if that is missing) datetime as the dtreviewed, if not present on the entry, use the "published" (or "updated" if that is missing) of the feed.  Otherwise use the information according to the containing document language (e.g. "published"/"updated" similarly for Atom feeds), then protocol (e.g. HTTP Last-Modified, or file system last modified datetime).
# SHOULD use [[hcalendar-fr|hCalendar]] to represent an item of 'type' 'event'
# Added one decimal digit of precision to ratings' numerical values based on publisher experience.
# Use [http://microformats.org/wiki/hcard#Value_excerpting the "value" construct from hCard] (as it is used in "tel" properties for example) to more explicitly markup the rating value when also providing (marking up) the best/worst of a rating.
# Added [[rel-license-fr]] to indicate the license of the hReview as a whole.
# Permit tags inside ratings to denote rated tags, the same as ratings inside tags per suggestion from Eran Globen.
# Add [[include-pattern]] support to allow multiple reviews for the same item to not repeat the item info.


Informative changes (several, but in particular):
Voir : [[hreview-articles-fr|hReview-articles]].
# Note that scalar/rated tags would ideally use a tag space that explain the ratings for that tag.  E.g. to explain what Food:18/30 means.
# Updated examples accordingly.


== Discussions ==
== Pour aller plus loin ==
* Feedback is encouraged on the [[hreview-feedback-fr]] page.
{{hreview-related-pages-fr}}
* See also [http://www.technorati.com/cosmos/referer.html blogs discussing this page].


=== Q&A ===
[[Category:Draft Specifications]]
* If you have any questions about hReview, check the [[hreview-faq-fr|hReview FAQ]], and if you don't find answers, add your questions to the end!
[[Category:hReview]]


=== Issues ===
== Traductions ==
* Please add any issues with the specification to the separate [[hreview-issues-fr|hReview issues]] document.
La spécification draft normative est [[hreview]] en anglais-US.
Lisez la spécification draft dans les langues suivantes :
* [[hreview-ja|日本語]]
* ...

Latest revision as of 16:27, 18 July 2020


Ce document est une spécification microformat draft. Bien que les "drafts" soient en quelque sorte mâtures dans le processus de développement, la stabilité de ce document ne peut être garantie, et les implémenteurs doivent être prêts à rester informés des futurs développements et modifications. Suivez cette page wiki, ou suivez les discussions sur la liste de discussion microformats-new pour rester informé.

hReview est un microformat simple, ouvert, distribué, adaptable pour embarquer des critiques (de produits, services, business, événements, etc.) dans le HTML, XHTML, Atom, RSS et le XML arbitraire. hReview est l'un des nombreux standards microformats ouvert.

Vous voulez démarrer par l'écriture d'un hReview ? Utilisez le hReview creator pour écrire une critique et la publier.


Spécification Microformats Draft 2012


traduction
Christophe Ducamp

Le copyright et les déclarations de brevets pour les microformats s'appliquent.

Statut

hReview 0.4 est une spécification microformats.org draft. Une discussion publique sur hReview se déroule sur hreview-feedback, le canal irc #microformats sur irc.freenode.net, et sur la liste de discussion microformats-discuss.

Langues disponibles

La version anglaise de cette spécification est la seule version normative : hReview. Pour des traductions de ce document, voir la section #traductions.

Errata et Mises à Jour

Des erreurs connues et problèmes dans cette spécification sont corrigé's dans les problématiques résolues et fermées. Merci de regarder là avant de rendre compte des problématiques.

La mise à jour hReview 0.4 est actuellement en développement et incorpore les corrections des errata connues tout comme le modèle-de-classe-value.

Introduction

De nombreux sites web publient des critiques en utilisant une très large variété de schémas de toutes sortes pour toutes sortes de choses, en partant des produits (films, musique, livres), en passant par les commerces (restaurants, hôtels, magasins), les événements (concerts, théâtre), les personnes (artistes, leaders, célébrités), des endroits (parcs, centres de loisirs), des ressources en ligne (pages web, fichiers) jusqu'aux critiques de critiques en elles-même.

Afin de permettre et d'encourager le partage, la distribution, la syndication et l'agrégation de critiques, les auteurs proposent le microformat hReview, un standard ouvert pour les critiques distribuées. Les auteurs ont cherché de nombreux exemples de critiques dans la jungle et ont fait des premiers essais sur les formats de critiques, et ont conçu hReview autour d'un schéma simple et minimal pour les critiques. Les réactions sont encouragées sur la page hReview feedback.

Les mots-clés "DOIT", "NE DOIT PAS", "OBLIGATOIRE", "DEVRA", "NE DEVRA PAS", "DEVRAIT", "NE DEVRAIT PAS", "RECOMMANDÉ", "PEUT" et "OPTIONNELLE" dans ce document doivent être interprétés comme décrits dans la RFC 2119.

Etendue

Les critiques partagent de manière cohérente plusieurs aspects communs. A chaque fois que cela a été possible, hReview a été basée sur ce sous-ensemble minimal commun.

Hors-sujet

Les portions d'avis qui sont spécifiques à des types particuliers d'items ont été omis de hReview. Il est important que hReview soit maintenu simple et minimal dès le démarrage. Des fonctionnalités supplémentaires peuvent être ajoutées par l'expérience pratique de mise en oeuvre.

Le concept d'un "identifiant universel d'objet", ce qui veut dire, comment identifier le même objet/item/produit à travers différents sites de commerce, même s'il est quelque part très utile d'en disposer, est ici hors du champ d'application de ce format.

Format

En Général

Le format hReview est fondé sur un ensemble de propriétés communes à de nombreux sites de critiques et formats en usage aujourd'hui sur le web. A chaque fois que possible, des noms de propriétés ont été choisis en se fondant sur ceux définis par les standards apparentés avec hCard et hCalendar.

Schéma

Le schéma hReview est constitué comme suit :

  • hReview (hreview)
    • summary. optionnel. texte.
    • item type. optionnel. product | business | event | person | place | website | url.
    • item info. requis. fn || (url || photo) | hCard (pour personne ou business) | hCalendar (pour événement)
    • reviewer. optionnel. hCard.
    • dtreviewed. optionnel. ISO8601 date ou date-heure absolus. Utilisez le modèle-classe-value si nécessaire tout particulièrement pour l'accessibilité. (http://www.w3.org/TR/NOTE-datetime)
    • rating. optionnel. nombre entier [1.0-5.0], avec alternative optionnelle worst (par défaut:1.0) et/ou best (par défaut:5.0), aussi nombres entiers et value explicite.
    • description. optionnel. texte avec balisage optionnel XHTML valide.
    • tags. optionnel. mots-clés ou phrases, utilisant rel-tag, chacun avec une notation en option.
    • permalink. optionnel, utilisant rel-bookmark-fr et rel-self.
    • license. optionnel, utilisant rel-license.

Détails des Propriétés

Les propriétés du schéma hReview représentent ce qui suit :

summary :: Cette propriété optionnelle sert de synopsis court, titre, ou nom de la critique. Réutilisé à partir de hCalendar qui le réutilise de iCalendar (section 4.8.1.12 de la RFC 2445).

type :: Cette propriété optionnelle "type" fournit le type d'item étant critiqué, l'un des suivants : product, business, event, person, place, website, url. Si elle est omise, alors dans quelques cas, l'item peut être inféré. Si l'item est aussi une hCard, alors le type d'item est un "business", "place" ou "person" basé sur ceux représentés par la hCard. Si l'item est aussi un événement hCalendar, alors le type d'item est un "event".

item  :: Cette propriété requise item DOIT avoir au minimum le nom (en utilisant la sous-propriété "fn" - le texte formaté correspondant au nom, exception faite pour un item événement qui DOIT avoir la propriété sous-propriété "summary" dans le "vevent" respectif hCalendar) de l'item (un hReview ne décrit seulement qu'un item), DEVRAIT fournir au moins un URI ("url") pour l'item, et PEUT fournir au moins une URL vers une photo ou une représentation ("photo") de l'item. Pour les items de type 'person' ou 'business', l'info item (fn, url, photo) DOIT être embarquée dans une hCard. Pour les items de types 'event', l'info item DEVRAIT être encapsulée dans un hCalendar "vevent". Les items IDs non-URL uniques (par ex. ISBNs, UPCs) PEUVENT être représentés sous un URN ("url") pour l'item. Les microformats encapsulés (par ex. hCard et les événements hCalendar à cette heure) peuvent être réglés sur l'item lui-même (par ex. class="item vcard"). Néanmoins, lors de l'utilisation de sous-propriétés d'info item ("fn", "url", "photo"), elles DOIVENT être imbriquées à l'intérieur de l'élément item.

reviewer :: Cette propriété optionnelle spécifie la personne qui a écrit la critique. Si l'auteur de la critique est spécifié, une hCard représentant l'auteur de la critique DOIT être fournie. Pour les critiques anonymes, utilisez "anonymous" (sans guillemets) pour le nom propre de la critique. Si aucun "reviewer" n'est trouvé dans le hReview, les parseurs devraient (DEVRAIT) regarder à l'extérieur du hReview, dans le contexte de la page, pour le "reviewer". S'il n'y a pas de "reviewer" à l'extérieur, alors les parseurs devraient (DEVRAIT) utiliser l'auteur défini par le "containing document language", par ex. pour des documents (X)HTML, l'info de contact <address> pour la page (qui est idéalement balisée aussi comme une hCard), pour Atom 1.0 le <entry> <author> si présent et si non code><feed> <author>, pour RSS le <author> dans l'élément <item>.

dtreviewed :: Cette propriété optionnelle quand elle est présente DOIT fournir une date ou date-horaire absolu ISO8601 du moment où la critique a été écrite ou autrement publiée (http://www.w3.org/TR/NOTE-datetime). Cette propriété doit utiliser le modèle de classe value si nécessaire (par ex. pour l'accessibilité, DEVRAIT utiliser UTC, mais PEUT utiliser la syntaxe du fuseau horaire. Si dtreviewed est absent de hReview, alors regardez en dehors de hReview, dans le contexte environnant. Si le contexte est une entrée hAtom, utilisez son date-horaire "published" (ou "updated" si celui-ci manque) comme le dtreviewed, s'il n'est pas présent sur l'entrée, utilisez le "published" (ou "updated" si celui-ci est manquant) du flux. Autrement utilisez l'information de date de création (ou date de modification si celle-ci manque) selon la langue du document conteneur (par ex. "published"/"updated" de la même manière que pour les fils Atom), puis le protocole (par ex. HTTP Last-Modified, ou "file system last modified datetime") comme la dtreviewed.

rating :: Le rating est un nombre entier fixé (une décimale pour la précision partant de 1.0 jusqu'à 5.0 inclus indiquant une évaluation pour l'item, le plus haut indiquant une meilleure évaluation par défaut. Facultativement, une valeur de nombre entier différente "worst" et/ou une valeur "best" PEUT être spécifiée pour indiquer une étendue différente (par ex. 6 de 0-10). La valeur "best" peut être numériquement plus petite que la valeur "worst".

description :: Cette propriété optionnelle sert à délivrer un synopsis plus détaillé de la critique (par exemple, le texte complet représentant l'opinion écrite du critique) que celui fourni par "summary". La propriété PEUT inclure un balisage valide XHTML (par ex. des paragraphes). Plusieurs descriptions ou des descriptions de sections (par ex. pours et contres, plus et moins) DEVRAIENT être incluses dans la propriété description.

tags :: Les tags sont représentés en utilisant une liste de mots-clés ou phrases (en utilisant le microformat rel-tag pour chaque mot-clé individuel ou tag de phrase) que le critique associera à l'item. Le critique PEUT (PEUT) en option fournir un tag-spécifique d'évaluation à l'intérieur de chaque rel-tag, par ex. ambience:5. Les évaluations tag-spécifiques par défaut utilisent la même gamme comme une évaluation globale pour l'item si présentes, et PEUVENT (PEUT) avoir aussi une gamme spécifiée allant de worst... à best. Les auteurs PEUVENT (PEUT) aussi inverser cette structure pour la même sémantique si elle est plus commode pour leur balisage, ce qui veut dire placer le rel-tag à l'intérieur d'une évaluation pour indiquer un tag évalué. Note : les tags évalués devraient (DEVRAIT) idéalement utiliser un espace tag qui explique ce que signifient les évaluations pour ce tag. Par ex. Food:18/30 devrait (DEVRAIT) lier vers un espace tags pour Food qui explique ce que veut dire un 18 sur 30 pour le tag Food.

permalink :: Cette propriété optionnelle est une URL pour le hReview. En plus d'utiliser le tag <a href> pour cette propriété, l'attribut rel="self bookmark" DOIT être utilisé pour dire que l'hyperlien est un lien permanent de la critique elle-même. Si l'hyperlien contient déjà un attribut rel, alors les valeurs self et bookmark DOIVENT être incluses parmi l'ensemble espace-séparé de valeurs dans l'attribut. Les indexeurs PEUVENT traiter le permalien d'une critique comme un ID unique afin d'identifier et réunir les même critiques provenant de sources multiples (comme le fait d'indexer une page plusieurs fois). Le permalien PEUT aussi être utilisé pour indiquer l'origine de la critique. Les auteurs PEUVENT utiliser le nom de classe d'un "permalink" sur l'élément représentant le permalien, mais ne sont pas obligés de faire ainsi.

license :: une hReview indique la licence pour ses contenus en utilisant le microformat rel-license.

Les noms de propriétés suivants ont été réutilisés à partir des microformats hCard et hCalendar : summary, fn, url, email, photo, description, categories. En plus, les items et critiques décrits par les hCards PEUVENT contenir n'importe quelle propriété hCard. La valeur rel "self" a été réutilisée à partir de la spécification Atom 1.0.

Plus d'Equivalents Sémantiques

Pour quelques propriétés, il existe un équivalent plus sémantique, et par conséquent elles reçoivent un traitement spécial, par ex. :

  • Pour toute "url", utilisez <a class="url" href="...">...</a> à l'intérieur de l'élément avec le nom de classe 'hreview' dans hReview.
  • Et pour une "photo", utilisez <img class="photo" src="..." alt="Photo de ..." />
  • Les évaluations sont souvent présentées comme un ensemble d'images ou caractères, par ex. "***". Pour cela, l'élément <abbr> est particulièrement utile, parce que de tels caractères sont une abréviation pour l'évaluation précise, par ex. <abbr class="rating" title="3.0">***</abbr>. Ceci est exploré plus à fond dans la section suivante.

Langue

  • Pour porter explicitement la langue naturelle dans laquelle une hReview est écrite, utiliser l'attribut standard HTML 'lang' sur l'élément avec class="hreview", par ex. <div class="hreview" lang="fr"> ... </div> Si des portions d'une hReview (par ex. le nom de l'item) sont dans une langue différente, utilisez l'attribut 'lang' sur ces portions.
  • Les processeurs hReview qui ont besoin de gérer la langue des critiques DOIVENT traiter l'attribut standard HTML 'lang' comme spécifié.

Lisible par Human vs. Machine

Si un élément <abbr> est utilisé pour une propriété, alors son attribut 'title' est utilisé pour la valeur de la propriété, au lieu des contenus de l'élément, ce qui peut être ensuite utilisé pour fournir une présentation alternative de la valeur plus sympathique pour l'utilisateur.

De la même façon, si un élément <img /> est utilisé pour une ou plusieurs propriétés, il DOIT être traité comme suit :

  1. Pour la propriété "photo" et toute autre propriété qui prend une URL comme sa valeur, l'attribut src="..." fournit la valeur de la propriété.
  2. Pour d'autres propriétés, l'attribut de l'élément <img /> 'alt' est la valeur de la propriété.

Includes

hReview 0.4 inclut le support pour l'objet include-pattern.

Souvent une page unique liste un item, et puis plusieurs critiques pour cet item. Afin d'éviter d'avoir à répéter l'information pour chaque critique de l'item, la première critique devrait être balisée comme une hReview, avec un attribut unique "id" sur l'info item, et puis les critiques suivantes devraient utiliser l'objet include-pattern pour inclure l'info item à partir de la première critique.

Notes

Cette section est informative.

  • En balisant une critique avec le microformat hReview, l'attente est communiquée que la critique PEUT être indexée. Ceci n'a aucun impact sur le copyright de la critique elle-même que l'éditeur peut explicitement spécifier en utilisant la rel-license comme spécifié au-dessus.
  • La liste énumérée des types d'items est en développement et peut être étendue.
  • Chaque type peut avoir des champs hReview personnalisés qui suivent l'ensemble commun.
  • Des détails supplémentaires à propos d'un item particulier devraient être spécifiés avec le reste de l'info de l'item sur l'URL fournie pour l'item.
  • La plupart des systèmes d'évaluation utilisent la gamme de 1.0 à 5.0, et la plupart de ceux-ci représent l'évaluation comme un nombre (et possiblement une moitié) d'étoiles. Les sites peuvent utiliser n'importe quel graphique qu'ils souhaitent pour représenter l'évaluation.

Exemples

Voilà quelques exemples de critiques à partir de sites web actuels, et comment elles pourraient être facilement améliorées pour supporter le microformat structuré de critique hReview.

Vous voulez commencer par écrire vous-même un hReview ? Utilisez le hReview creator pour écrire une critique et la publier sur votre blog.

Critiques Restaurant

Voici un exemple d'une simple critique de restaurant en ligne :

<div>
 <span>5 étoiles sur 5</span>
 <h4>Crepes on Cole est génial</h4>
 <span>Critique : <span>Tantek</span> - 18 avril 2005</span>
 <blockquote><p>
  Crepes on Cole est l'une des meilleures petites crêperies dans San Francisco. 
  Nourriture et service excellents. Beaucoup de tables de différentes tailles 
  pour les fêtes qu'elles soient petites et grandes. Celles près de la fenêtre sont
  merveilleuses pour regarder les gens. J'ai eu l'occasion d'avoir beaucoup de rencontres ici
  tout comme le fait de réaliser beaucoup de travail grâce au WiFi avoisinant.
 </p></blockquote>
 <p>Date de visite : <span>Avril 2005</span></p>
 <p>Plat dégusté : <span>Crêpe Florentine</span></p>
</div>

ajouter une hReview à cette critique est vraiment simple :

<div class="hreview">
 <span><span class="rating">5</span> étoiles sur 5</span>
 <h4 class="summary">Crepes on Cole est génial</h4>
 <span class="reviewer vcard">Critique : <span class="fn">Tantek</span> - 
 <abbr class="dtreviewed" title="2005-04-18">18 avril 2005</abbr></span>
 <div class="description item vcard"><p>
  <span class="fn org">Crepes on Cole</span> est l'une des meilleures petites  
  crêperies à <span class="adr"><span class="locality">San Francisco</span></span>.
  Nourriture et service excellents. Beaucoup de tables de différentes tailles 
  pour les fêtes qu'elles soient petites et grandes. Celles près de la fenêtre sont
  merveilleuses pour regarder les gens...  J'ai eu l'occasion d'avoir beaucoup 
  de rencontres ici tout comme le fait de réaliser beaucoup de travail grâce au WiFi 
  avoisinant.
 </p></div>
 <p>Date de visite : <span>Avril 2005</span></p>
 <p>Plat dégusté : <span>Crêpe Florentine</span></p>
</div>

Remarquez que quelques-unes des propriétés de cette critique échantillon ne sont pas saisies par hReview (date de visite, nourriture). Ceci est délibéré par le fait de vouloir conserver une hReview minimale et simple.

Ce échantillon de hReview pourrait être restitué comme ça :

5 étoiles sur 5
Crepes on Cole est génial
Critique : Tantek - 18 avril 2005

Crepes on Cole est l'une des meilleures petites crêperies dans San Francisco. Nourriture et service excellents. Beaucoup de tables de différentes tailles pour les fêtes qu'elles soient petites et grandes. Celles près de la fenêtre sont merveilleuses pour regarder les gens... J'ai eu l'occasion d'avoir beaucoup de rencontres ici tout comme le fait de réaliser beaucoup de travail grâce au WiFi avoisinant.

Date de visite : Avril 2005
Plat dégusté : Crêpe Florentine

Critique Restaurant Multidimensionnnelle

Quelques critiques de restaurants indiquent des évaluations pour différents aspects du restaurant. De tels détails sont représentés dans hReview en utilisant les évaluations taguées. En plus, remarquez les tags dans la ligne dans la description de cette critique.

Voilà une telle critique en format texte :

Cafe Borrone

1010 El Camino Real, Menlo Park, CA 94025, +1-650-327-0830;
cafeborrone.com

Food: 18/30; Ambience: 19/30; Service: 15/30; Price: $$...

This cafe is a welcoming oasis on the Peninsula.  It even has a fountain
outside which cloaks the nearby sounds of El Camino traffic.  Next door to a  
superb indy bookstore, Cafe Borrone is an ideal spot to grab a coffee or a 
snack to accompany a newly purchased book or imported periodical.  Soups and 
sandwich specials rotate daily.  The corn chowder with croutons and big 
chunks of cheese goes especially well with a freshly toasted mini-baguette.  
Evenings are often crowded and may require sharing a table with a perfect 
stranger.  Espresso afficionados will appreciate the Illy coffee.  Noise 
levels can vary from peaceful in the late mornings to nearly overwhelming on 
jazz band nights.

Sous un hReview :

<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">
   Food: <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">
   Ambience: <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">
   Service: <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">
   Price: <abbr class="value" title="2">$$</abbr>...</a></li>
 </ul>
 <div class="description"><p>
  This <abbr class="type" title="business">
  <a href="http://en.wikipedia.org/wiki/cafe" rel="tag">cafe</a></abbr> 
  is a welcoming oasis on the Peninsula.  
  It even has a fountain outside which nearly eliminates 
  the sounds of El Camino traffic.  Next door to a superb indy bookstore, 
  Cafe Borrone is an ideal spot to grab a 
  <a href="http://en.wikipedia.org/wiki/coffee" rel="tag">coffee</a> 
  or a meal to accompany a newly purchased book or imported periodical.  
  <a href="http://technorati.com/tag/soup" rel="tag">Soups</a> and 
  <a href="http://technorati.com/tag/sandwich" rel="tag">sandwich</a> 
  specials rotate daily.  The corn chowder with croutons and big chunks of cheese 
  goes especially well with a freshly toasted mini-baguette.  Evenings are 
  often crowded and may require sharing a table with a perfect stranger. 
  <a href="http://flickr.com/photos/tags/espresso" rel="tag">Espresso</a> 
  afficionados will appreciate the 
  <a href="http://en.wikipedia.org/wiki/Illy" rel="tag">Illy</a> coffee.  
  Noise levels can vary from peaceful in the late mornings to nearly overwhelming on 
  <a href="http://en.wikipedia.org/wiki/jazz" rel="tag">jazz</a> band nights.
 </p></div>
 Review (<a href="http://microformats.org/wiki/hreview"> 
  hReview v<span class="version">0.3</span></a>)
 by <span class="reviewer vcard"><span class="fn">anonymous</span></span>, 
 <abbr class="dtreviewed" title="2005-04-28">April 28th, 2005</abbr>.
</div>

Avec une feuille de style l'accompagnant comme :

a.url { display:block }
ul { margin:1em 0; padding:0 }
ul li { display:inline }

Cette hReview pourrait être présentée de la même manière que le texte original :

Cafe Borrone
1010 El Camino Real, Menlo Park, CA 94025, +1-650-327-0830;
cafeborrone.com

Food: 18/30; Ambience: 19/30; Service: 15/30; Price: $$...

This cafe is a welcoming oasis on the Peninsula. It even has a fountain outside which cloaks the nearby sounds of El Camino traffic. Next door to a superb indy bookstore, Cafe Borrone is an ideal spot to grab a coffee or a snack to accompany a newly purchased book or imported periodical. Soups and sandwich specials rotate daily. The corn chowder with croutons and big chunks of cheese goes especially well with a freshly toasted mini-baguette. Evenings are often crowded and may require sharing a table with a perfect stranger. Espresso afficionados will appreciate the Illy coffee. Noise levels can vary from peaceful in the late mornings to nearly overwhelming on jazz band nights.

(hReview) by anonymous, April 28th, 2005.

Critique produit

Voilà un exemple d'une critique de produit :

<div>
 <a href="http://www.amazon.com/exec/obidos/ASIN/B000089CJI/">
  <img src="http://images.amazon.com/images/P/B000089CJI.01._SCTHUMBZZZ_.jpg" 
              alt="photo couverture album : The Postal Service : Give Up." />
 The Postal Service : Give Up</a>
 <blockquote><p>
   "Les gens pensaient qu'ils ont été simplement récompensés sur le fait de traiter les autres 
    comme ils aiment être traités, pour obéir à des panneaux stop et guérir des maladies, pour
    des lettres de mailing avec l'adresse de l'expéditeur... Ne m'éveillez pas, je prévois de
    dormir dedans..."
   </p><p>
   "Nothing Better" est aussi une plage géniale sur cet album...
 </p></blockquote>
 (*****)
</div>

Ajouter hReview à cette critique est aussi tout à fait simple, mais requiert dans ce cas quelques éléments supplémentaires pour l'évaluation et le critique qui sont requis par hReview :

<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="Photo de couverture de l'album : The Postal Service: Give Up. " 
       class="photo" />
  The Postal Service : Give Up</a></span>
 <div class="description"><p>
    "Les gens pensaient qu'ils ont été simplement récompensés sur le fait de traiter les autres 
    comme ils aiment être traités, pour obéir à des panneaux stop et guérir des maladies, pour
    de lettres de mailing avec l'adresse de l'expéditeur... Ne m'éveillez pas, je prévois de
    dormir dedans..."
   </p><p>
   "Nothing Better" est aussi une plage géniale sur cet album...
 </p></div>
 (<abbr class="rating" title="5">*****</abbr>)
 <p class="reviewer vcard">Review by 
  <a class="url fn" href="http://ifindkarma.com/blog/">Adam Rifkin</a>, 
  <abbr class="dtreviewed" title="2005-02">February 2005</abbr>
 </p>
</div>

Et ce hReview pourrait être présenté comme suit :


[Photo de couverture de l'album: ] [The Postal Service:] [ Give Up ]

The Postal Service: Give Up

"Les gens pensaient qu'ils ont été simplement récompensés sur le fait de traiter les autres comme ils aiment être traités, pour obéir à des panneaux stop et guérir des maladies, pour des lettres de mailing avec l'adresse de l'expéditeur... Ne m'éveillez pas, je prévois de dormir dedans..." "Nothing Better" est aussi une plage géniale sur cet album...

(*****)

Critique d'Adam Rifkin, février 2005.

Critique de Film

Pour finir, voilà un exemple d'une critique de film.

<div>
 <span>anonyme, le 18 avril 2005</span>
 <div>
  <a lang="zh" href="http://www.imdb.com/title/tt0299977/">
  Ying Xiong (<span lang="en">HERO</span>)
  </a>
 </div>
 <div>Notation : 4 sur 5</div>
 <blockquote><p>
  Ce film a des images et une musique vraiment au top.
 </p></blockquote>
</div>

Avec hReview:

<div class="hreview">
 <span class="reviewer vcard">
  <span class="fn">anonyme</span>, 
  <abbr class="dtreviewed" title="2005-04-18">18 avril 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>Notation : <span class="rating">4</span> sur 5</div>
 <div class="description"><p>
  Ce film a des images et une musique vraiment au top.
 </p></div>
</div>

Qui pourrait être présenté comme ça :

anonyme, 18 avril 2005
Ying Xiong (HERO)
Notation : 4 sur 5

Ce film a des images et une musique vraiment au top.

Exemples dans la jungle

Cette section est informative.

Le nombre d'exemples hReview dans la jungle a grandi si vite et bien au delà de la capacité à pouvoir être maintenu en ligne dans cette spécification. Ils ont été migré sur une page séparée.

Voir hReview-exemples-dans-la-jungle.

Implémentations

Cette section est informative. Le nombre d'implémentations de hReview a aussi grandi au delà de la capacité à pouvoir les maintenir dan la page. Elles ont été migrées sur une page séparée.

Voir hReview-implémentations

Inspiration et Remerciements

Merci à tous ceux qui ont répondu à l'appel ouvert pour participation à l'implémentation du hReview. Les auteurs souhaitent tout particulièrement remercier les individus suivants pour leurs avis constructifs et leurs réactions : Richard Ault, Danny Ayers, Jeffrey Barr,Adrian Cuthbert,Jason DeFillippo, Brian Del Vecchio, Scott Derringer, Bud Gibson, Joi Ito, Gen Kanai,Niall Kennedy, Rohit Khare, Ryan King, Jonas Luster, Kevin Marks, Mark Nottingham, Derek Powazek, Jeff Rodenburg, David Sifry, James Stewart, Adriaan Tijsseling, Phillip Torrone, Thai Tran, Phillip Winn, YAMAMOTO Yohei.

Auteurs hReview v0.3
Tantek Çelik (tantek.com, et avant chez Technorati)
Ali Diab (Yahoo! Inc.)
Ian McAllister (Amazon.com)
John Panzer (America Online, Inc.)
Adam Rifkin (CommerceNet Labs)
Michael Sippey (Six Apart, Ltd)


Principes De Design XHTML Sémantique

Cette section est informative. hReview a été conçu en utilisant les principes de design similaires à ceux qui étaient dans hCard et par conséquent cet aperçu est inclus à des fins d'information. Note : les Principes de Design XHTML Sémantique ont été écrits initialement dans le contexte de développement de hCard et hCalendar, par conséquent il peut être plus facile de comprendre ces principes dans le contexte de la méthodologie de design hCard (ce qui veut dire, lisez ça d'abord). Tantek

XHTML est construit sur du XML, et par conséquent les formats fondés sur XHTML peuvent être utilisés non seulement pour une présentation d'affichage pratique, mais aussi à des fins d'échanges de données. A bien des façons, les formats fondés sur XHTML illustrent le meilleur des mondes tant du HTML que du XML. Néanmoins au moment de construire des formats basés sur XHTML, cela aide d'avoir un ensemble de principes directeurs.

  1. Réutilisez autant que possible le schéma (noms, objets, propriétés, valeurs, types, hiérarchies, contraintes) à partir des standards de référence établis et bien supportés. Evitez de redéclarer les contraintes exprimées dans le standard source. Des mentions à titre d'information peuvent passer.
    1. Pour les types avec plusieurs composants, utilisez des éléments imbriqués avec des noms de classe équivalents aux noms des composants.
    2. Les composants pluriels sont produits au singulier, et par conséquent plusieurs éléments imbriqués sont utilisés pour représenter plusieurs valeurs de texte qui sont délimitées par des virgules.
  2. Utilisez la sémantique XHTML la plus précise pour construire des blocs pour chaque objet, etc.
  3. Autrement utilisez un élément générique structurel (par ex. <span> ou <div>), ou l'élément contextuel approprié (par ex. un <li> dans un <ul> ou <ol>).
  4. Utilisez des noms de classes basés sur des noms extraits du schéma original, à moins que le XHTML sémantique de construction de bloc ne représente précisément cette partie du schéma original. Si les noms dans le schéma original ne sont pas sensibles la casse, alors mettez tout dans un équivalent en bas de casse. Les noms de composants implicites en prose (plutôt qu'explicites dans le schéma défini) devraient aussi utiliser les équivalents bas de casse pour une facilité d'utilisation. Les espaces dans les noms des composants deviennent des caractères tiret '-'.
  5. Pour finir, si le format de la donnée selon le schéma original est trop long et/ou non amical sur le plan humain, utilisez <abbr> au lieu d'un élément générique structurel, et placez les données littérales dans l'attribut 'title' (là où vont les expansions abbr), et l'équivalent le plus bref et le plus lisible humainement dans l'élément lui-même. De plus amples explications de cet usage de <abbr> : Human vs. ISO8601 dates problem solved

Références

Références Normatives

Références Informatives

Travaux similaires

Copyright

Cette spécification est (C) 2005 par les auteurs. Néanmoins, les auteurs ont pour but de soumettre cette spécification à un corps de standards avec une politique libérale de copyright/licence telle que GMPG, IETF, et/ou W3C. Quiconque souhaite contribuer devrait lire avant de contribuer leurs principes de copyright, politiques et licences (par ex. les Principes GMPG) et être d'accord avec eux, y compris le fait de licencier toutes les contributions sous les licences nécessaires (par ex. CC-by 1.0 et suivantes).

  • Tantek : Je sors toutes mes contributions à cette spécification dans le domaine public et j'encourage les autres auteurs à faire de même.
    • Quand tous les auteurs/éditeurs auront fait ainsi, nous pourrons retirer la référence au modèle MicroFormatCopyrightStatement et la remplacer avec le modèle MicroFormatPublicDomainContributionStatement.

Brevets

Cette spécification est sujette à une politique de brevets libres de droits, par ex. pour la Politique de Brevet du W3C, IETF RFC3667 et RFC3668.

Chantier en cours

Cette spécification est un chantier en cours. Au fur et à mesure que des aspects supplémentaires sont discutés, compris et écrits, ils seront ajoutés.

Modifications à partir de la v0.3

Les modifications suivantes ont été produites dans hReview v0.3 sur hReview v0.2 :

Changements normatifs :

  1. Ajouté références normatives à
    1. modèle de classe value - requis pour support.
    2. HTML5 - pour le parsage/DOM HTML5
  2. Changé références normatives vers "informative" :
    1. Includes delegué pleinement includepattern plutôt que de spécifier "Object Includes"
    2. propriété version abandonnée. Petite si quelque publication en pratique, et pas d'usages pratiques trouvés. Smaller is better.
    3. dtreviewed peut être aussi une date absolue ISO8601, et doit utiliser le modèle de classe value si nécessaire.

Modifications informatives (plusieurs, mais en particulier) :

  1. changé éditeur/auteur à simplement Tantek pour préparer et reprendre une récriture.
  2. exemples mis à jour :
    1. valeurs de propriété dtreviewed utilisent le date-pattern
    2. propriété de version abandonnée


Articles

Cette section est informative.

Voir : hReview-articles.

Pour aller plus loin

Traductions

La spécification draft normative est hreview en anglais-US. Lisez la spécification draft dans les langues suivantes :