blog-post-brainstorming-fr: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
Line 679: Line 679:


* feed - "hfeed"
* feed - "hfeed"
** title - imply from <title> element
** title - sous-entendu à partir de l'élément <title>  
** subtitle - re-use "description" per vCalendar, iCalendar, [[hcalendar-fr|hCalendar]], [[xfolk-fr|xFolk]], and [[hreview-fr|hReview]].
** subtitle - réutilisation de "description" selon vCalendar, iCalendar, [[hcalendar-fr|hCalendar]], [[xfolk-fr|xFolk]], et [[hreview-fr|hReview]].
** id - imply from page URL
** id - sous-entendu à partir de URL page
** updated - "updated"
** updated - "updated" (mis à jour)
** author - "author", if none found, imply from <address> (which SHOULD be used anyway), either way, MUST be an [[hcard-fr|hCard]].
** author - "author", si rien trouvé, sous-entendu à partir de <address> (qui DEVRAIT être utilisé de toute façon), et DOIT être une [[hcard-fr|hCard]].
** generator - set by the converting script / XSLT, omit from hAtom.  Similar to PRODID in [[hcalendar|hCalendar]].
** generator - généré par le script de conversion / XSLT, omis à partir de hAtom. Similaire à PRODID dans [[hcalendar-fr|hCalendar]].
** logo - re-use "logo" from [[hcard-fr|hCard]]
** logo - réutilisation du "logo" en provenance de [[hcard-fr|hCard]]
** icon - define new [[rel-icon]] (see XHTML2) for this
** icon - définir la nouvelle [[rel-icon-fr|rel-icon]] (voir XHTML2) pour cela
** category - [[rel-tag-fr]] + [[rel-directory-fr]]
** category - [[rel-tag-fr]] + [[rel-directory-fr]]
** rights - [[rel-license-fr]]
** rights - [[rel-license-fr]]
* entry - "hentry"
* entry - "hentry"
** title - "headline"
** title - "headline"
** link - [[rel-bookmark-fr]] from HTML4
** link - [[rel-bookmark-fr]] de HTML4
** id - imply from permalink
** id - sous-tendu du permalink
** summary - "excerpt"
** summary - "excerpt"
** content - "content"
** content - "content"
** published - "published"
** published - "published"
** updated - "updated"
** updated - "updated"
** author - "author", MUST be [[hcard-fr|hCard]], SHOULD be <address>
** author - "author", doit être [[hcard-fr|hCard]], DEVRAIT être <address>
** rights - [[rel-license-fr]]
** rights - [[rel-license-fr]]


== Plusieurs fils sur une page ==
== Plusieurs fils sur une page ==


Post hAtom 1.0: support multiple feeds on a single page. Changes from above.
Billet hAtom 1.0 : supporte plusieurs fils sur une page unique. Changements à partir de ci-dessus.


* feed
* feed
** title - "headline", same as entry
** title - "headline", même que entry
** id - define new [[rel-canonical]] microformat for this.
** id - definir  un nouveau microformat [[rel-canonical]] pour cela
** author - "author" required.
** author - "author" requis.
* entry
* entry
** id - re-use "uid" from [[hcalendar|hCalendar]].
** id - réutilisation de "uid" à partir du [[hcalendar-fr|hCalendar]].


=== Discussion ===
=== Discussion ===
Line 715: Line 715:
==== titre du fil ====
==== titre du fil ====


I initially thought "fn" would make sense for the feed title, but having looked at some blogs/feeds, though in many cases the title of the blog/feed *is* the name of the blog/feed, this is often not the case.
Je pensais initialement que "fn" ferait du sens pour le titre du fils, mais en ayant regardé quelques blogs/fils, bien que dans bien des cas le titre du blog/fil *soit* le nom du blog/fil, ce n'est souvent pas le cas.


Two examples:
Deux exemples :
#. Some blog titles consist of the blog name and the date, e.g. Scripting News does this.
#. Quelques titres de blog consistent en le nom du blog et la date, par exemple Scripting News fait ça.
#. Some blog titles consist of the blog name and a short temporary phrase or saying
#. Quelques titres de blog consistent en le nom du blog et une phrase courte résumé ou une citation


I have seen both of these in the wild often enough to believe that blog title and blog name are not the same, thus it is inappropriate to re-use "fn" from [[hcard|hCard]], since the feed title does not mean the same thing as the *name* of the feed. Thus I have removed the suggestion to re-use "fn" for feed title, and instead propose re-using "headline" from the entry, which does appear to have the same semantic.
J'ai vu assez souvent ces deux cas dans la jungle pour croire que le titre du blog et le nom du blog ne sont pas les mêmes, de ce fait il est approprié de réutiliser "fn" à partir de la [[hcard-fr|hCard]], parce que le titre du fil ne veut pas dire la même chose que le *nom* du fil. De ce fait j'ai ôté la suggestion de réutiliser "fn" pour le titre du fil, et au lieu de cela je propose de réutiliser le "headline" à partir de l'entrée, ce qui apparaît vraiment comme ayant la même sémantique.


== Possibilités Supplémentaires ==
== Possibilités Supplémentaires ==


More post hAtom 1.0 thoughts:
Plus d'idées sur le billet hAtom 1.0 :


* entry
* entry
** summary - "excerpt" or "abstract"
** summary - "excerpt" ou "abstract"
** contributor - "contributor"
** contributor - "contributor"
** source - use <blockquote cite="">, put source in cite attribute.
** source - utiliser <blockquote cite="">, mettre la source dans l'attribut cite>.


= Possible Uses =
= Possible Uses =

Revision as of 15:06, 24 July 2006

Participants à la Discussion

Editeurs

Auteurs

(Traduction en cours par Christophe Ducamp à mettre en to-do-fr)

Objectif

Le 'blog-post-microformat' propose une codification de la manière dont les billets de blogs sont identifiés dans les blogs. Il est espéré que ceci devrait être considéré pour être 'expansif' : par exemple la proposition pourrait être utilisé sur CNN.com pour baliser les articles d'actualités et les pages résumé.

Terminologie

Cette section explore la terminologie qui devrait être utilisée pour discuter d'un microformat de billet de blog. Pour qu'il soit plus facile de parler des différents types de terminologie, nous utilisons une version d'espace-nom ala XML de façon à ce que nous puissions produire des déclarations comme atom:entry est approximativement équivalent à rss20:feed, atom:feed/atom:link@relalternate est approximativement équivalent à rss20:channel/rss20:link ou atom:author n'est pas équivalent à rss:entry/rss:author (parce que RSS 2.0 est uniquement la définition d'une adresse email).

Terminologie Commune dans les weblogs

En rédigeant les blog-post-formats-fr#Outils, on peut voir qu'il y a peu de standardisation parmi les outils ou même dans un outil individuel (tel que 'blogger') pour les noms des éléments des billets de blogs. Il existe néanmoins beaucoup d'éléments communs, comprenant :

  • un conteneur pour tous les billets/entrées
  • un conteneur pour les billets individuels
  • le contenu du billet, qui peut être complet, résumé avec un lien vers le lien complet, ou deux paragraphes avec des trucs javascript/CSS pour révéler le reste du contenu
  • le nom de l'auteur
  • la date du billet (dans beaucoup beaucoup de formats)

Bien que cela puisse ressembler un peu à un petit-déjeuner pour chien, il y a généralement une quantité raisonnable de rigueur derrière la présentation, parce que les fils Atom et/ou RSS peuvent être aussi produits à partir des mêmes outils.

En outre, en développant un microformat pour les billets de weblog, nous voulons être prudents pour ne pas casser n'importe quel (ou beaucoup) de gabarits. Notez que beaucoup de gabarits de weblog devront être mis à jour car ils produisent quelque chose comme du HTML pauvrement construit plutôt que du XHTML clair.

Terminologie Atom

Voir ici pour la spec et blog-post-formats-fr#Atom pour l'analyse.

  • atom:feed - (composite) une collection d'entrées plus de l'information à leur propos.
    • atom:author - (composite) l'auteur d'un fil (peut contenir atom:email, atom:name, atom:uri)
    • atom:id - un identifiant permanent pour un fil
    • atom:title - le titre d'un atom:entry ou un atom:feed
    • atom:updated - la dernière fois que le fil a été mis à jour
    • atom:link@relalternate - la page d'accueil du fil
    • atom:link@relself - l'URI du fil (où elle peut être téléchargée)
    • atom:entry - (composite) une entrée dans le fil
      • atom:content - le contenu du fil
      • atom:summary - un résumé du contenu du fil
      • atom:entry/link - l'URI permanente de l'entrée
      • atom:published - le moment de la création initiale ou la première disponibilité de l'entrée

Terminologie RSS 2.0

Regardez ici la spécification et blog-post-formats-fr#RSS pour l'analyse. Il y a beaucoup plus d'éléments dans RSS mais cela couvre ceux les plus communément utilisés. analysis.

  • rss2:channel - (composite) une collection d'entrées plus de l'information à leur propos
    • rss2:author - (composite) l'auteur d'un fil (peut contenir atom:email, atom:name, atom:uri)
    • rss2:link - L'URL vers le site web HTML correspondant au canal (comparer à atom:link@relalternate)
    • rss2:title - le titre d'un rss2:channel ou un rss2:item
    • rss2:pubDate - La date de publication pour le contenu dans le canal.
    • rss2:item - (composite) une entrée dans le fil
      • rss2:item/link - L'URL de l'item. Notez que cela peut ne pas être un lien permanent pour l'item ; ce peut être un lien vers quelque autre page sur l'Internet dont traite le rss2:item
      • rss2:description - Le synopsis item [sic]. Il n'y pas d'indication spéciale si c'est le contenu complet d'une entrée, un résumé ou une précision de ce que le rss2:item/link est en train de pointer
      • rss2:author - adresse email de l'auteur de l'item

Recommandation

Atom a un mécanisme beaucoup plus précis pour définir les fils de syndication et les données de weblog. Une transformation mécanique à partir de Atom -> RSS mènera toujours à un fil RSS correct ; une traduction RSS -> Atom devrait prendre une décision parmi de multiples définitions qui peuvent ne pas toujours être correctes. Par exemple, le format du balisage, le rôle d'un auteur, ou le sens d'un lien.

IMPORTANT : nous parlerons de choses comme le 'balisage d'éléments atom:feed' ; considérez cela purement comme une chose conceptuelle. Le texte 'atom:feed' n'apparaîtra pas dans le microformat XHTML -- nous pourrons décider plus tard d'utiliser la phrase exacte 'atom_feed', 'feed', 'items' ou 'googlybear'. Dans le cas où il n'y a pas de terminologie atom claire ou applicable, nous utiliserons 'weblog:xxx'.

Eléments Découverts

Cette section explore l'information découverte à partir des blog-post-formats en utilisant la terminologie discutée au-dessus. Nous nous concentrerons seulement sur les principaux éléments des billets de weblog :

  • l'Entrée Groupe
  • L'Entry individuelle
  • l'Entrée Titre
  • l'Entrée Contenu
  • l'Entrée Permalink
  • l'Entrée Datetimes

A cette heure, la codification des éléments suivants majeurs seront différés car il y a/peut avoir un chevauchement avec d'autres microformats qui devraient être explorés plus en profondeur.

  • L'EntréeGroupe Titre
  • L'EntréeGroupe Permalien
  • L'Entrée Posteur/Auteur - en particulier, est-ce que la hCard devrait être utilisée ?

Des entrées plus approfondies provenant de la communauté devraient être appréciées ici

GroupeEntry

En gros, ceci correpond à 'atom:feed' ou 'rss2:channel' (en particulier, les items dans ces éléments XML). Voir blog-post-examples-fr#GroupeEntry pour les différentes formes dans la jungle.

Recommandation Microformat

  • les pages weblog (y compris les pages d'accueil, archives, pages de catégories, pages tag et ainsi de suite) qui peuvent contenir plusieurs entrées DOIVENT enfermer les entrées dans un élément atom:feed
  • les pages weblog PEUVENT avoir plusieurs éléments atom:feed enfermant différents groupes d'entrées
  • les éléments atom:feed ne DOIVENT PAS être imbriqués
  • les pages weblog qui ont exactement une entrée PEUVENT utiliser le atom:feed

Exemple Transformation

Notez que la chaîne 'atom:feed' est un gardien de place pour quelque chose devant être décidé plus tard.

Original (évidemment, s'il n'y a pas d'élément de bloc GroupeEntry, un peut être ajouté) :

<div id="content">
 <h2 id="home-title">
  Dernières nouvelles des microformats
  <a href="http://www.microformats.org/feed/" title="lien vers le fil RSS" id="feed-link">
   <img src="/img/xml.gif" width="23" height="13" alt="XML" />
  </a>
 </h2>

 <div class="entry">
  <h3 id="post-60">
   <a href="http://www.microformats.org/blog/2006/...">Attaque Bliki</a>
  </h3>
  ...
 </div>

 ...
</div>

Transformé :

<div id="content" class="atom:feed">
 <h2 id="home-title">
  Dernières nouvelles des microformats
  <a href="http://www.microformats.org/feed/" title="lien vers le fil RSS" id="feed-link">
   <img src="/img/xml.gif" width="23" height="13" alt="XML" />
  </a>
 </h2>

 <div class="entry">
  <h3 id="post-60">
   <a href="http://www.microformats.org/blog/2006/...">Attaque Bliki</a>
  </h3>
  ...
 </div>

 ...
</div>

Groupe Entry Titre

Non couvert par cette proposition à cette heure.

Groupe Entry Permalien

Non couvert par cette proposition à cette heure.

Entrée Individuelle

Ceci correspond presque exactement aux éléments atom:entry ou rss2:item. Voir blog-post-examples-fr#Entrée_Individuelle pour les différentes formes vues dans la jungle.

Recommandation Microformat

  • Les entrées de weblog DOIVENT être enveloppées dans un élément unique atom:entry
  • Les éléments atom:entry NE DOIVENT PAS être imbriqués
  • atom:entry NE DOIT PAS appartenir à plus d'un élément atom:feed

Exemple Transformation

Notez que la chaîne 'atom:entry' est un gardien de place pour quelque chose devant être décidé plus tard.

Entrées dans bloc existant

Original :

 <div class="entry">
  <h3 id="post-60">
   <a href="http://www.microformats.org/blog/2005/...">Attaque Wiki</a>
  </h3>
  ... reste de l'entrée ...
 </div>

Transformé :

<div class="atom:feed">
 <div class="atom:entry entry">
  <h3 id="post-60">
   <a href="http://www.microformats.org/blog/2005/...">Attaque Wiki</a>
  </h3>
  ... reste de l'entrée ...
 </div>
 ... entrées additionnelles ...
</div>

Entrées n'étant pas dans un bloc existant

Original :

 <a name="112877372228959075">&nbsp;</a>
 <br>
  <strong>Just one problem, Minister.</strong> Last week, Bill Rammell, 
 <br>

Transformé:

<div class="atom:feed">
 <div class="atom:entry" id="112877372228959075">
  <br />
   <strong>Just one problem, Minister.</strong> Last week, Bill Rammell, 
  <br />
  ... reste de l'entrée
 </div>
 ... entrées additionnelles ...
</div>

Notez les modifications additionnelles aussi produites :

  • <br> a été rendu conforme XHTML
  • <a name="..."> a été converti ver un id="..." (confirmez que c'est OK)

Entrées Disjointes

Ignorer tout bloc existant et les traiter comme dans le cas précédent de pas de bloc.

Entrée Titre

Ceci correspond presque exactement aux éléments atom:title ou rss2:title. Voir blog-post-formats-fr#Titres pour des exemples à partir desquels nous voyons qu'il y a deux manières fondamentales dont les titres sont utilisés dans la jungle : au niveau bloc et dans la ligne. Notre proposition doit être capable de gérer les deux formes.

Microformat Recommandation

  • atom:entrys DEVRAIENT avoir au plus un titre
  • les titres au niveau bloc DEVRAIENT être représentés en utilisant <h#>, le premier élément atom:entry devrait être considéré comme le titre ; ceci devrait ne pas être balisé ou identifié sous quelque autre forme que le titre
  • les titres dans la ligne DOIVENT être balisés sous atom:title ; il est aussi possible de faire ça en utilisant la mise en forme au niveau bloc telle que <div>, mais ceci est découragé

Discussion : pourquoi pas toujours <h#>?

En utilisant CSS display: inline, les éléments de niveau bloc peuvent être convertis vers des éléments dans la ligne. Malheureusement, nous ne pouvons pas imbriquer <h#> à l'intérieur d'un bloc <p> pour parvenir à l'effet correct. C'est à dire que nous ne pouvons pas convertir ...

<p><strong>Le Titre</strong> : Le Texte...</p>

... en ...

<p><h3 style="display: inline">Le Titre</h3> : Le Texte...</p>

... parce que le XHTML ne validera pas. Aussi...

<h3 style="display: inline">Le Titre</h3><p> : Le Texte...</p>

... ne fonctionnera pas parce que l'effet de présentation sera différent de ce que l'utilisateur désire (parce qu le <p> introduira un saut de ligne).

Exemple Transformation

Notez que la chaîne 'atom:title' est un gardien de place pour quelque chose devant être décidé plus tard.

Header dans le bloc <h#>

Original (et Final) :

<div class="atom:entry">
 <h2 id="post-59">Web Essentials Audio</h2>
 ... réinitialisation de l'entrée ...
</div>

Aucune transformation n'est requise -- le microformat blog-post reconnaîtra ça come le atom:title.

Header dans un autre élément bloc

Original :

<div class="atom:entry">
 <div class"header">Web Essentials Audio</div>
</div>

Transformé (le niveau titre est à essayer) :

<div class="atom:entry">
 <h3>Web Essentials Audio</h3>
</div>

Il est possible d'ajouter class"atom:title" à la div mais nous ne le recommandons pas. Néanmoins nous reconnaissons qu'il peut y avoir certains blog-post-formats-fr#Forum_de_Discussion_.2F_Formats_de_Bulletin_Board Outils de BB que produire ce changement puisse être trop difficile.

Header dans l'élément dans la ligne

Original :

 <div class="atom:entry" id="112877372228959075">
  <br />
   <strong>Just one problem, Minister.</strong> Last week, Bill Rammell, 
  <br />
  ... reste de l'enrée ...
 </div>

Transformé :

 <div class="atom:entry" id="112877372228959075">
  <br />
   <strong class="atom:title">Just one problem, Minister.</strong> Last week, Bill Rammell, 
  <br />
  ... reste de l'entrée ...
 </div>

Entrée Contenu

Ceci correspond en gros aux éléments atom:content et/ou atom:summary. Voir blog-post-examples-fr#Entrée_Contenu pour les différentes formes vues dans la jungle.

Discussion : le problème du découpage du contenu

Le dernier item au-dessus (contenu brisé en plusieurs sections) présente quelques problèmes uniques. Il n'est pas suffisant d'enfermer toutes les sections de contenu différentes dans un élément atom:content, comme l'illustre l'exemple suivant :

 <div class="atom:entry">
  <div class="atom:content">
   ... première partie du contenu ...
   "En savoir plus"
   ... seconde partie du contenu ...
  </div>
 </div>

"En savoir plus" ne fait pas partie du contenu ! Par conséquent, nous proposons que plusieurs sections de contenus puissent aller dans un atom:entry unique. La concaténation de tous ces blocs de contenu définira le contenu complet :

 <div class="atom:entry">
  <div class="atom:content">
   ... première partie du contenu ...
  </div>
   "Read More"
  <div class="atom:content">
   ... seconde partie du contenu ...
  </div>
 </div>

Le même argument est applicable à atom:summary.

Recommandation Microformat

  • un atom:entry PEUT avoir zéro ou plus de sections atom:summary. Il n'y a pas d'obligation que différentes représentations de la même entrée (sur différents URIs) utilisent les mêmes résumés.
  • un atom:entry PEUT avoir zéro ou plus de sections atom:content. La concaténation sérielle de toutes les sections atom:content dans l'entrée DOIT représenter le contenu complet de l'entrée. Notez que la règle ici est légèrement différente que Atom qui n'autorise qu'un atom:content.

Exemple Transformation

Notez que les chaînes 'atom:summary' et 'atom:content' (etc.) sont des gardiens de place pour quelque chose à décider plus tard.

Entrée avec contenu résumé

Original :

<div class="inlineBlog">
 <h3 id="a003068">
  <a href="http://thecommunityengine.com/h.../xfolk_vegomatic.html" class="taggedlink">xFolk Veg-o-matic Alpha</a>
 </h3>
 <p class="abstract extended">
  We provide a way to surf the web and slice and dice information you find there into your own custom output stream.
 </p>
 ... quelque tag et truc de catégorie ...
 <p>
  Les types chez... le reste du contenu 
 </p>
 <p class="extended">
  <a href="http://thecommunityengine.com/.../xfolk_vegomatic.html#more">Continue reading "xFolk Veg-o-matic Alpha"</a>
 </p>
 ...
</div>

Transformation:

<div class="inlineBlog atom:entry">
 <h3 id="a003068">
  <a href="http://thecommunityengine.com/h.../xfolk_vegomatic.html" class="taggedlink atom:permalink">xFolk Veg-o-matic Alpha</a>
 </h3>
 <p class="abstract extended">
  We provide a way to surf the web and slice and dice information you find there into your own custom output stream.
 </p>
 ... some tag and category stuff ...
 <div class="atom:summary">
  <p>
   Les types chez... le reste du contenu 
  </p>
 </div>
 <p class="extended">
  <a href="http://thecommunityengine.com/.../xfolk_vegomatic.html#more">Continue reading "xFolk Veg-o-matic Alpha"</a>
 </p>
 ...
</div>

Notes :

  • nous n'avons rien fait avec la section "abstract" -- ceci est une discussion pour un autre jour
  • nous n'avons pas inclus le truc tag dans le résumé, et probablemetn ne le ferions pas si c'était le contenu complet.

Entrée avec contenu complet

Original :

<div class="entry single">
 <h2 id="post-61">Les attributs de classe sont plus que du stylisme</h2>

 <p>Quand les gens parlent de microformats, ... </p>
 
 <blockquote cite="http://www.w3.org/TR/REC-html40/struct/global.html#h-7.5.2">
  ... texte cité d'ailleurs
 </blockquote>

 <p>Il y a deux points dont j’aimerais parler ici :</p>
 
 ... plus de contenu...

 <h4 class="tags">Tags Technorati :</h4>
 <ul class="tags">
  <li><a href="http://www.technorati.com/tag/css" rel="tag">css</a></li>
  ...
 </ul>

 <ul class="post-info">
  ... trucs de pied de page ...
 </ul>
</div>

Transformation :

<div class="entry single atom:entry">
 <h2 id="post-61">Les attributs de classe sont plus que du stylisme</h2>

 <div class="atom:content">
  <p>Quand les gens parlent de microformats, ...</p>

  <blockquote cite="http://www.w3.org/TR/REC-html40/struct/global.html#h-7.5.2">
  ... texte cité d'ailleurs
  </blockquote>

  <p>There’s a couple of points I’d like to highlight here:</p>

  ... plus de contenu ...
 </div>

 <h4 class="tags">Technorati Tags:</h4>
 <ul class="tags">
  <li><a href="http://www.technorati.com/tag/css" rel="tag">css</a></li>
  ...
 </ul>

 <ul class="post-info">
  ... trucs de pied de page ...
 </ul>
</div>

Notes :

  • la seule chose qui avait vraiment besoin d'être faite est d'envelopper le contenu
  • ma préférence serait de migrer l'id du billet vers l'atom:entry

Entrée avec contenu découpé (plusieurs sections)

Original :

<div class="blogbody">
 <a name="008148"></a>

 <div class="title">
  Face to face: why places will continue to exist
 </div>

 <div class="posted">
  <strong>Brian Micklethwait (London)</strong>
    
  <a href="...">Science & Technology</a>
 </div>

 <p>It is not just that I dislike filling in forms....</p>
 ... the first section of the content ...

 ... this link makes the extended section show ...
 <span id="varP8148">
  <img src="http://www.samizdata.net/blog/img/bullet_tri.gif" width="16" height="10" alt="" />
  <a href="..." onclick="showMore(8148,'...');return false;">
   Read more.
  </a>
 </span>
  
 <div id="varXYZ8148" style="display: none">
  <p>The very gadgets – computers linked...</p>
  ... the rest of the extended content ...

  ... this link makes the extended section hide ...
  <img src="..." width="16" height="10" alt="" />
   <a href="#008148" onclick="showMore(8148,0);return true;">
    Read less.
   </a>
  </div>
 </div>
</div>

Transformation :

<div class="blogbody atom:entry" id="008148">
 <h3>
  Face to face: why places will continue to exist
 </h3>

 <div class="posted">
  <strong>Brian Micklethwait (London)</strong>
    
  <a href="...">Science & Technology</a>
 </div>

 <div class="atom:content">
  <p>It is not just that I dislike filling in forms....</p>
  ... the first section of the content ...
 </div>

 ... this link makes the extended section show ...
 <span id="varP8148">
  <img src="http://www.samizdata.net/blog/img/bullet_tri.gif" width="16" height="10" alt="" />
  <a href="..." onclick="showMore(8148,'...');return false;">
   Read more.
  </a>
 </span>
  
 <div id="varXYZ8148" style="display: none">
  <div class="atom:content">
   <p>The very gadgets – computers linked...</p>
   ... the rest of the extended content ...
  </div>

  ... this link makes the extended section hide ...
  <img src="..." width="16" height="10" alt="" />
   <a href="#008148" onclick="showMore(8148,0);return true;">
    Read less.
   </a>
  </div>
 </div>
</div>

Note :

  • atom:content divs ont été créés pour chacune des sections de texte, de façon que le non-contenu codé n'aurait pas été balisé incorrectement
  • il y a deux sections atom:content ; ensemble elles produisent le contenu complet
  • la conversion de <div class="header"> en <h3>
  • l'addition de atom:entry comme exigé
  • le retrait du <a name="008148"> en faveur de placer un id sur l'atom:entry
  • une manipulation plus approfondie de l'auteur pourrait être faite
  • une manipulation plus approfondie de la catégorie pourrait être faite

Entrée Permalien

Les Permaliens correspondent en gros à atom:link. Voir exemples de billets de blogs#Entrée Permaliens pour des exemples.

Un permalien est appelé canonique si c'est la meilleure représentation de l'URI pour cette entrée ; la définition de quelle 'meilleure représentation' est entièrement à la discrétion de l'auteur du weblog. Nous recommandons que les weblogs utilisent des URIs canoniques car cela permet de "filer" ensemble plusieurs billets et sources avec des comparaisons au niveau des bits. En général, l'URI canonique devrait être le lien utilisé dans une entrée Atom.

Recommandation Microformat

  • une Entrée ne DOIT PAS avoir plus d'un permalien balisé comme atom:link
  • les permaliens DEVRAIENT être des URIs absolus
  • les permaliens DEVRAIENT être canoniques
  • les permaliens DEVRAIENT être les mêmes comme le atom:link utilisé dans les fils de syndication

Exemple Transformations

Original :

<div class="entry">
 <h3 id="post-45">
  <a 
   href="http://www.microformats.org/blog/2005/08/21/foobar-microformats/" 
   rel="bookmark"
   title="Lien Permanent vers la FooBar Microformats">FooBar Microformats</a>
  </h3>
   ...
</div>

Transformation :

<div class="atom:entry entry">
 <h3 id="post-45">
  <a 
   href="http://www.microformats.org/blog/2005/08/21/foobar-microformats/" 
   rel="atom:link bookmark"
   title="Lien Permanent vers la FooBar Microformats">FooBar Microformats</a>
  </h3>
   ...
</div>

Original :

<h3>YET ANOTHER INSTANCE OF THE WORLD FINALLY CATCHING UP TO THE BLOG</h3>
<p>Today's news: Neuticles win ... award.</p>
<p class="posted">
Posted by judi on October  7, 2005 at 05:00 PM |
<a href="http://blogs.herald.com/dave_barrys_blog/2005/10/yet_another_ins.html">Permalink</a>
</p>

Transformation :

<div class="atom:entry">
 <h3>YET ANOTHER INSTANCE OF THE WORLD FINALLY CATCHING UP TO THE BLOG</h3>
 <p>Today's news: Neuticles win ... award.</p>
 <p class="posted">
 Posted by judi on October  7, 2005 at 05:00 PM |
 <a rel="atom:link" href="http://blogs.herald.com/dave_barrys_blog/2005/10/yet_another_ins.html">Permalink</a>
</p>

Entrée Datetimes - Création et Modified

Les weblogs affichent typiquement (en HTML) le moment de création de leurs billets (en gros mais ne correspondant pas exactement au atom:published) et moins souvent le moment de la dernière modification (atom:updated).

Regardez aussi datetime-design-pattern pour plus d'information sur la spécification du datetimes. La recommandation ici est stylée après le datetimes dans in hCalendar.

Formes vues dans la jungle

voir blog-post-formats#Datetimes-fr

Recommandation Microformat

  • les titres de date entre les entrées de weblogs sont en dehors de ce microformat
  • atom:published DEVRAIT être indiqué par un élément abbr autour de la version lisible par les humains de la date ou datetime.
    • l'attribut 'class' DOIT indiquer atom:published
    • l'attribut 'title' DOIT être un datetime complet, dans le format de datetime-design-pattern
  • aussi pour atom:updated, si présent

Exemple transformation

Notez que la chaîne 'atom:published' est un gardien de place pour quelque chose à décider plus tard.

Original :

<a href"...">Vendredi 30 septembre 2005 à 12:31</a>

Transformé :

<a href"..."><abbr 
 class"atom:published" 
 title"200050930T12:31:01-0500">Vendredi 30 septembre 2005 à 12:31</abbr></a>

Entrée Auteur

Un travail en progression

Recommandation Microformat

  • L'entrée Auteur DEVRAIT être dans un bloc <address>

Atom Possible vers mapping microformat(s)

  • feed - "hfeed"
    • title - sous-entendu à partir de l'élément <title>
    • subtitle - réutilisation de "description" selon vCalendar, iCalendar, hCalendar, xFolk, et hReview.
    • id - sous-entendu à partir de URL page
    • updated - "updated" (mis à jour)
    • author - "author", si rien trouvé, sous-entendu à partir de <address> (qui DEVRAIT être utilisé de toute façon), et DOIT être une hCard.
    • generator - généré par le script de conversion / XSLT, omis à partir de hAtom. Similaire à PRODID dans hCalendar.
    • logo - réutilisation du "logo" en provenance de hCard
    • icon - définir la nouvelle rel-icon (voir XHTML2) pour cela
    • category - rel-tag-fr + rel-directory-fr
    • rights - rel-license-fr
  • entry - "hentry"
    • title - "headline"
    • link - rel-bookmark-fr de HTML4
    • id - sous-tendu du permalink
    • summary - "excerpt"
    • content - "content"
    • published - "published"
    • updated - "updated"
    • author - "author", doit être hCard, DEVRAIT être <address>
    • rights - rel-license-fr

Plusieurs fils sur une page

Billet hAtom 1.0 : supporte plusieurs fils sur une page unique. Changements à partir de ci-dessus.

  • feed
    • title - "headline", même que entry
    • id - definir un nouveau microformat rel-canonical pour cela
    • author - "author" requis.
  • entry
    • id - réutilisation de "uid" à partir du hCalendar.

Discussion

titre du fil

Je pensais initialement que "fn" ferait du sens pour le titre du fils, mais en ayant regardé quelques blogs/fils, bien que dans bien des cas le titre du blog/fil *soit* le nom du blog/fil, ce n'est souvent pas le cas.

Deux exemples :

  1. . Quelques titres de blog consistent en le nom du blog et la date, par exemple Scripting News fait ça.
  2. . Quelques titres de blog consistent en le nom du blog et une phrase courte résumé ou une citation

J'ai vu assez souvent ces deux cas dans la jungle pour croire que le titre du blog et le nom du blog ne sont pas les mêmes, de ce fait il est approprié de réutiliser "fn" à partir de la hCard, parce que le titre du fil ne veut pas dire la même chose que le *nom* du fil. De ce fait j'ai ôté la suggestion de réutiliser "fn" pour le titre du fil, et au lieu de cela je propose de réutiliser le "headline" à partir de l'entrée, ce qui apparaît vraiment comme ayant la même sémantique.

Possibilités Supplémentaires

Plus d'idées sur le billet hAtom 1.0 :

  • entry
    • summary - "excerpt" ou "abstract"
    • contributor - "contributor"
    • source - utiliser <blockquote cite="">, mettre la source dans l'attribut cite>.

Possible Uses

This section describes potential applications for a blog post microformat

Usages Transformationnels

By transformational, we mean feeding a weblog post to some sort of transformation tool (such as XSLT) to produce a different version of the post fit for a different use.

Imprimer les Billets de Blogs

Reblogging

  • ZDNet has a reblog button that would be made obsolete (or could be substantially improved) by use of this microformat
  • Reblog.com was the inspiration for this idea. This may be renamed RedirectThis?

Usages d'Archives

By 'archival', we mean taking weblog entries and placing them in a database for later analysis, searching, aggregation and so forth.

Database Personnelle

Moteur de Recherche

Blogs avec Texte Partiels

Partial content blogs can be created by producing the full html content of a blog entry but not marking it up as such. The atom:summary portion of that entry can be marked up as summary, or could be written up and placed in a hidden block element within the html. hAtom parsers would ignore the unannotated content and produce summary information only.

Obstacles

Header Tag pour Entry Title?

--Bryan 14:55, 14 Aug 2005 (PDT)

Many weblog CMSes allow for concurrent publishing of entries in the following ways:

  • multiple entries on a page (an "Index," monthly archive, category archive, etc. see Example)
  • one entry on a page (see Example)

Early attempts at blog-post-formats have set the title of the blog post to use the h3 tag.

At least where individual entry pages are concerned (and possible including indexes and archives), I recommend using h1 for the entry title, given that the entry is by far the most important chunk of information on the page, and it's what we'd want search engines to recognize as such. In the case where the h1 was used for the site title, fears about "losing" this information should be allayed by simply including the site name in the title tag, after the title of the article / entry / post.

Whether an h3 or h1 is used is irrelevant, the semantics will be applied with classnames. This is a non-issue. --RyanKing 22:35, 18 Aug 2005 (PDT)


Voir aussi