hreview-fr

From Microformats Wiki
hreview-fr /
Jump to navigation Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

hReview 0.3

hReview est un microformat simple, ouvert, distribué, adaptable pour 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 ouvert et standard.

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

Microformats Spécifications du 22 février 2006 Draft

Editeur
Tantek Çelik (Technorati, Inc.)
Auteurs
Tantek Çelik (Technorati, Inc.)
Ali Diab (Yahoo! Inc.)
Ian McAllister (Microsoft Corporation)
John Panzer (America Online, Inc.)
Adam Rifkin (CommerceNet Labs)
Michael Sippey (Six Apart, Ltd.)

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

(Traduction française User:ChristopheDucamp)


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.

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.

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 champs communs. La hReview a été basée sur ce sous-ensemble minimal commun.

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. 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.

Principes De Design XHTML Sémantique

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

Format

En Général

Le format hReview est fond√© sur un ensemble de champs communs √† de nombreux sites de critiques 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 avec hCard et hCalendar.

Schéma

Le sch√©ma hReview est constitu√© comme suit :

  • hReview (hreview)
    • version. optionnel. texte.
    • 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 event)
    • reviewer. optionnel. hCard.
    • dtreviewed. optionnel. date et heure absolus ISO8601.
    • 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-design-pattern-fr et rel-self.
    • license. optionnel, utilisant rel-license.

Détails des Champs

Les champs 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. En pratique, les auteurs de cette sp√©cification se 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..

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, 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, alors le type d'item est un "event".

item info  :: Ce champ requis DOIT (DOIT) avoir au minimum le nom ("fn" - le texte format√© correspondant au nom, exception faite pour un item √©v√©nement qui DOIT (DOIT) avoir la propri√©t√© "summary" dans le "vevent" respectif hCalendar) de l'item (un hReview ne d√©crit seulement qu'un item), DEVRAIT (DEVRAIT) fournir au moins un URI ("url") pour l'item, et PEUT (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 (DOIT) √™tre encapsul√©e dans une hCard. Pour les items de types 'event', l'info item DEVRAIT (DEVRAIT) √™tre encapsul√©e dans un hCalendar "vevent". Les items IDs non-URL uniques (par ex. ISBNs, UPCs) PEUVENT (PEUT) √™tre r√©pr√©sent√©es 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 (DOIT) √™tre imbriqu√©es √† l'int√©rieur de l'√©l√©ment item.

reviewer :: le champ optionnel 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 (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 :: Ce champ optionnel quand il est pr√©sent DOIT (DOIT) fournir un "date time" absolu ISO8601 du moment o√Ļ la critique a √©t√© √©crite ou autrement publi√©e. Ce champ DEVRAIT (DEVRAIT) utiliser UTC, mais PEUT (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 datetime "published" (ou "updated" si celui-ci manque) du fil. Autrement utilisez l'information 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. Optionnellement, une valeur de nombre entier diff√©rente "worst" et/ou une valeur "best" PEUT (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 :: Ce champ optionnel contient le texte clair repr√©sentant l'opinion √©crite du critique. Le champ PEUT (PEUT) inclure un balisage valide XHTML (par ex. des paragraphes). Les agents utilisateur DEVRAIENT (DEVRAIT) emp√™cher tout balisage. Plusieurs descriptions ou des descriptions de sections (par ex. pours et contres, plus et moins) DEVRAIENT (DEVRAIT) √™tre incluses dans le champ 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 :: Ce champ optionnel est une URL pour le hReview. En plus d'utiliser le tag <a href> pour ce champ, 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 (DOIT) √™tre incluses parmi l'ensemble espace-s√©par√© de valeurs dans l'attribut. Les indexeurs PEUVENT (PEUT) 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 (PEUT) aussi √™tre utilis√© pour indiquer l'origine de la critique. Les auteurs PEUVENT (PEUT) 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 :: Ce champ optionnel fait un lien vers la licence sous laquelle les contenus de la hReview elle-m√™me sont licenci√©s, en utilisant le microformat rel-license.

Les noms de champs suivants ont √©t√© r√©utilis√©s √† partir des microformats hCard et hCalendar : version, summary, fn, url, email, photo, description, categories. En plus, les items et critiques d√©crits par les hCards PEUVENT (PEUT) contenir n'importe quel champ 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 (X)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 (X)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 un 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 Objet

hReview 0.3 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>Reviewer: <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">Reviewer: <span class="fn">Tantek</span> - 
 <abbr class="dtreviewed" title="20050418T2300-0700">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 : April 2005
Plat d√©gust√© : Florentine crepe

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="20050428T2130-0700">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.

Review (hReview v0.3) 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
    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></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="200502">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="20050418">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

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.2

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

Changements normatifs :

  1. DOIVENT (au lieu de DEVRAIENT) utiliser hCard pour la description d'item d'un business ou d'une personne
  2. Changement "reviewer"
    1. Rendu le reviewer *optionnel* par un feedback de Ryan King et Mark Nottingham
    2. Si la critique est absente du hReview, regardez alors à l'extérieur de hReview, dans le contexte de la page, pour la critique. S'il n'y a pas de "reviewer" au-dehors, alors utilisez l'information de l'auteur selon le langage contenant le document (par ex. <address> pour les pages (X)HTML) comme le critique.
    3. DOIT (au lieu de DEVRAIT) utiliser hCard pour représenter l'information du critique
  3. Changements "dtreviewed"
    1. Rendu *optionnel* la dtreviewed suite à un feedback de Ryan King et Mark Nottingham
    2. Si dtreviewed est absent de la hReview, alors regardez à l'extérieur de hReview dans le contexte avoisinant. Si le contexte est une entrée hAtom, utilisez son datetime du fil "published" (ou "updated" si cela venait à manquer). Autrement utilisez l'information selon le langage 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").
  4. DEVRAIT utiliser hCalendar pour représenter un item de 'type' 'event'
  5. Ajouté un chiffre décimal de précision aux valeurs numériques d'évaluation en se basant sur l'expérience éditeur.
  6. Utiliser la "value" construite à partir de la hCard (comme elle est utilisée par exemple dans le propriétés "tel" par exemple) pour baliser plus explicitement la valeur d'évaluation quand elle fournit aussi (balisage) le best/worse d'une évaluation.
  7. Ajouté rel-license pour indiquer la licence de hReview comme un ensemble.
  8. Permettre les tags à l'intérieur des évaluations pour annoncer les tags évalués, les mêmes que les évaluations dans les tags selon une suggestion provenant de Eran Globen.
  9. Ajouté le support include-pattern pour permettre aux multiples critiques du même item de ne pas répéter l'info de l'item.

Changements Informatifs (plusieurs, mais en particulier):

  1. Notez que les tags scalaires/évalués utiliseraient idéalement un espace tag qui explique les évaluatons pour ce tag. Par ex. pour expliquer ce que veut dire Food:18/30.
  2. Exemples mis à jour en rapport.

Q&R

  • Si vous avez quelque question sur hReview, regardez les hReview FAQ, et si vous ne trouvez pas de r√©ponses, ajoutez vos questions √† la fin !

Pour aller plus loin