Difference between revisions of "h-entry-fr"

From Microformats Wiki
h-entry-fr
Jump to navigation Jump to search
 
([fr: first draft translation to be reviewed])
Line 1: Line 1:
#redirect:[[microformats2-fr#h-entry]]
+
''Cette page a démarré sur [[h-entry]]''
 +
 
 +
<entry-title>h-entry</entry-title>
 +
* <span class="h-card vcard"><span class="p-name fn">[[User:Tantek|Tantek Çelik]]</span> (<span class="p-role role">Editor</span>)</span>
 +
* <span class="h-card vcard"><span class="p-name fn">[[User:ChristopheDucamp|Christophe Ducamp]]</span> (<span class="p-role role">Traducteur</span>)</span>
 +
 
 +
----
 +
<dfn style="font-style:normal;font-weight:bold">h-entry</dfn> est un format simple, ouvert pour le contenu épisodique ou chronodaté sur le web.
 +
h-entry est souvent utilisé avec du contenu destiné à être syndiqué, par exemple des billets de blog. h-entry est l'un des nombreux standards [[microformats-fr|microformats]] ouverts "draft" adapté pour embarquer de la data dans le HTML/HTML5.
 +
 
 +
h-entry est la mise à jour [[microformats2-fr|microformats2]] de [[hatom-fr|hAtom]].
 +
 
 +
== Exemple ==
 +
Voici un exemple simple de billet de blog :
 +
 
 +
<source lang=html4strict>
 +
<article class="h-entry">
 +
  <h1 class="p-name">Les microformats sont fascinants</h1>
 +
  <p>Publié par <a class="p-author h-card">W. Developer</a>
 +
    le <time class="dt-published" datetime="2013-06-01 12:00:00">1<sup>er</sup> juin 2013</time>
 +
 
 +
  <p class="p-summary">Dans le quel je loue les vertus d'utiliser les microformats.</p>
 +
 
 +
  <div class="e-content">
 +
    <p>Blah blah blah</p>
 +
  </div>
 +
</article>
 +
</source>
 +
 
 +
=== Démarrer ===
 +
La classe '''<code>h-entry</code>''' est un ''nom de classe racine'' qui indique la présence d'un h-entry.
 +
 
 +
'''p-name''', '''p-author''', '''dt-published''' et les autres propriétés-noms de classes de h-entry listées ci-dessous définissent les propriétés de h-entry.
 +
 
 +
Voir [[microformats2-parsing-fr|microformats2-parsing]] pour en savoir plus à propos des noms de classes propriétés.
 +
 
 +
== Propriétés==
 +
les propriétés h-entry, à l'intérieur d'un élément avec la classe '''h-entry''' :
 +
* '''<code>p-name</code>''' - nom de la note/titre
 +
* '''<code>p-summary</code>''' - petit résumé court de la note
 +
* '''<code>e-content</code>''' - contenu complet de la note
 +
* '''<code>dt-published</code>''' - quand la note a été publiée
 +
* '''<code>dt-updated</code>''' - quand la note a été mise à jour
 +
* '''<code>p-author</code>''' - qui a écrit la note, optionnellement embarquée avec [[h-card-fr|h-card]](s)
 +
* '''<code>p-category</code>''' - catégories/tags de la note
 +
* '''<code>u-url</code>''' - URL permalien de la note
 +
* '''<code>u-uid</code>''' - ID unique de la note
 +
* '''<code>p-geo</code>''' - lieu géophysique à partir duquel la note a été postée, embarque optionnellement [[h-geo-fr|h-geo]] {{main-fr|h-geo-fr}}
 +
* '''<code>p-latitude</code>''' - latitude décimale
 +
* '''<code>p-longitude</code>''' - longitude décimale
 +
* '''<code>p-altitude</code>''' - altitude décimale
 +
 
 +
Les propriétés suivantes expérimentales sont utilisées dans la jungle mais ne font pas encore partie de la spécification :
 +
 
 +
* '''<code>u-in-reply-to</code>''' - l'URL à laquelle la h-entry est considéré comme une réponse à ou un commentaire sur.
 +
** Potentiellement une h-entry embarquée (ou imbriquée ?) (pour les contextes de réponses) mais je suis le seul à faire ça à cette heure, aussi non considéré comme une recommandation --[[User:Barnabywalters|bw]] 16:44, 13 June 2013 (UTC)
 +
* '''<code>p-comment</code>''' - h-entries optionellement embarquées (ou imbriquées), chacune d'entre elles est un commentaire/réponse au h-entry parent. Voir [[comment-brainstorming]].
 +
 
 +
Les propriétés suivantes sont des ajouts proposés basés sur différentes conventions existantes de prévisualisation de lien qui ne sont ''pas'' encore utilisées dans la jungle (En rapport : [[link-preview-brainstorming]])
 +
* '''<code>u-photo</code>'''
 +
* '''<code>u-audio</code>''' - consider special u- parsing rules for <code>&lt;audio></code>
 +
* '''<code>u-video</code>''' - consider special u- parsing rules for <code>&lt;video></code>
 +
 
 +
Toutes les propriétés sont optionnelles.
 +
 
 +
== Statut ==
 +
'''h-entry''' est une spécification draft de microformats.org. La discussion publique sur h-entry a lieu sur [[h-entry-feedback]], le canal [[irc]] #microformats sur irc.freenode.net, et la [http://microformats.org/discuss/mail/microformats-new/ liste de discussion microformats-new].
 +
 
 +
h-entry est prêt à l'utilisation et à l'implémentation dans la jungle, mais pour des raisons de rétro-compatibilité vous devriez aussi baliser les h-entries en les enrichissant des notes classiques [[hatom-fr|hAtom]].
 +
 
 +
== Détails de Propriétés  ==
 +
(ébauche à compléter)
 +
 
 +
Les implémentations spécifiques-hAtom qui exécutent un affichage ou une traduction personnalisée (par ex. vers Atom XML) DEVRAIENT préférer <code>p-name</code> à <code>p-entry-title</code>, et utiliser les valeurs <code>p-entry-title</code> comme un plan de secours s'il n'existe pas de <code>p-name</code>.
 +
 
 +
== FAQ ==
 +
 
 +
<div class="discussion">
 +
* '''Qu'est-ce que le <code>p-name</code> d'une [http://indiewebcamp.com/note-fr note]?'''
 +
** Quelques options, de la plus simple à la plus détaillée.
 +
*** '''la même que la propriété p-content/e-content'''.
 +
*** '''la même que l'élément <code>title</code>''' sur le permalien de note de page. Au moment de publier une note sur sa propre page de permalien de post, les contenus de la note sont probablement abrégés pour le titre de la page. La même abréviation peut être utilisée pour le p-name.
 +
*** '''première phrase de la propriété p-content/e-content'''. Ce peut être mieux pour la [http://indiewebcamp.com/syndication-fr syndication] et les objectifs de [[link-preview-fr|prévisualisation de lien]] de fournir simplement la première phrase de la note comme le <code>p-name</code>. De la même manière, si seulement une portion du contenu est syndiquée sur d'autres sites, cette portion-la peut être balisée comme le <code>p-summary</code>.
 +
* ...
 +
</div>
 +
 
 +
== Exemples dans la jungle ==
 +
Les véritables exemples dans la jungle :
 +
 
 +
* ... ajoutez ici les usages de h-entry que vous voyez dans la jungle
 +
* L'UI du "Twitter archive browser" utilise h-entry et h-card en interne, malheureusement elle n'est pas exposée comme du HTML dans les fichiers statiques
 +
* Brett Comnes enrichit ses posts avec h-entry et h-card ([http://bret.io/2013/06/29/getting-started-with-bower/ exemple])
 +
* Ben Werdmuller enrichit ses posts avec h-card et h-entry, u-in-reply-to et u-like ([http://werd.io/view/51d5097fbed7ded0633a5956 example])
 +
* Sandeep Shetty enrichit ses posts avec h-card and h-entry, tout comme avec les propriétés expérimentales u-in-reply-to et u-like ([http://sandeep.io/101 exemple])
 +
* spreadly enrichit ses pages de permaliens de partage avec h-entry, tout comme avec les propriétés h-cards et p-like expérimental ([http://my.spread.ly/share/51d570bc09e9486562000002 exemple])
 +
* Laurent Eschenauer enrichit ses posts avec h-entry ([http://eschnou.com/entry/first-autonomous-flight-of-my-nodecopter-62-24992.html exemple])
 +
* Tom Morris enrichit ses posts avec h-entry ([http://tommorris.org/posts/8417 exemple])
 +
* Beaucoup de nouvelles specs du W3C specs, par ex.
 +
** [http://www.w3.org/TR/2013/CR-css3-values-20130404/ CSS Values and Units Module Level 3 - 2013-04-04]
 +
** [http://www.w3.org/TR/2013/CR-css3-conditional-20130404/ CSS Conditional Rules Module Level 3 - 2013-04-04]
 +
** [http://www.w3.org/TR/2013/WD-css3-page-20130314/ CSS Paged Media Module Level 3 - 2013-03-14]
 +
** [http://www.w3.org/TR/2013/WD-css-counter-styles-3-20130221/ CSS Counter Styles Level 3 - 2013-02-21]
 +
* [http://wordpress.org/extend/themes/sempress SemPress] est un thème WordPress qui supporte h-card, h-feed/h-entry.
 +
* [http://the-pastry-box-project.net/ The Pastry Box Project] utilise le marquage h-card et h-entry sur sa page d'accueil et les pages indivdiuelles de réflexion
 +
* Aaron Parecki utilise h-entry pour enrichir les notes, par ex. [http://aaronparecki.com/2012/230/reply/1 2012/230/reply/1].
 +
* [http://tantek.com/ Tantek Çelik] utilise h-entry sur sa page d'accueil, tout comme h-entry sur tous les permaliens de ses posts, par ex.  [http://tantek.com/2012/243/t1/name-beats-title-modern-use-dubline-core-wrong-uf2 2012-243 post], avec [[rel-prev]]/[[rel-next]] (si applicable) pour indiquer les posts précédents/suivants
 +
* [http://waterpigs.co.uk/ Barnaby Walters] utilise h-entry sur toutes les notes et articles, tout comme les imbrications dans les notes comme contextes de réponse [http://waterpigs.co.uk/notes/1468/ exemple] et commentaires [http://waterpigs.co.uk/notes/1482/ exemple].
 +
 
 +
 
 +
{{h-spec-section-validating-fr}}
 +
 
 +
== Rétro-compatibilité ==
 +
=== Compatibilité Éditeur ===
 +
Pour la compatibilité arrière, vous pouvez vouloir utiliser les noms de classes classiques [[hatom-fr|hAtom]] en plus des propriétés h-entry à venir, par exemple :
 +
 
 +
<source lang=html4strict>
 +
<div class="h-entry hentry">
 +
  <h1 class="p-name entry-title">Mon billet de blog génial</h1>
 +
</div>
 +
</source>
 +
 
 +
=== Compatibilité Parseurs ===
 +
Les parseurs microformats devraient détecter les propriétés classiques et les parser comme des propriétés microformats2. Si un "h-entry" est trouvé, ne pas chercher un "hentry" sur le même élément.
 +
 
 +
Le nom de classe racine compatible : <code id="hentry">hentry</code><br/>
 +
Propriétés : (parsées comme '''p-''' plein texte à moins qu'autre chose ne soit spécifié) :
 +
 
 +
* <code>entry-title</code> - parser comme '''<code>p-name</code>'''
 +
* <code>entry-summary</code> - parser comme '''<code>p-summary</code>'''
 +
* <code>entry-content</code> - parser comme '''<code>e-content</code>'''
 +
* <code>published</code> - parser comme '''dt-'''
 +
* <code>updated</code> - parser comme '''dt-'''
 +
* <code>author</code> - comprenant la racine compatible <code>vcard</code> en l'absence de <code>h-card</code>
 +
* <code>category</code>
 +
* <code>geo</code> - parser comme '''<code>p-geo h-geo</code>''' comprenant la racine compatible <code>geo</code>
 +
* <code>latitude</code>
 +
* <code>longitude</code>
 +
 
 +
== Historique ==
 +
Ce travail est basé sur le microformat existant [[hatom-fr|hAtom]], et le selfdogfooding complet dans la communauté [http://indiewebcamp.com indie web camp].
 +
 
 +
== Principes de Design ==
 +
 
 +
(ébauche à compléter)
 +
 
 +
== Voir aussi ==
 +
 
 +
* [[microformats2-fr|microformats2]]
 +
* [[microformats2-parsing-fr|microformats2-parsing]]
 +
* [[h-geo-frh-geo]]
 +
* [[hcard-fr|hCard]]
 +
 
 +
[[Category:Draft Specifications]]

Revision as of 07:56, 3 August 2013

Cette page a démarré sur h-entry

<entry-title>h-entry</entry-title>


h-entry est un format simple, ouvert pour le contenu épisodique ou chronodaté sur le web. h-entry est souvent utilisé avec du contenu destiné à être syndiqué, par exemple des billets de blog. h-entry est l'un des nombreux standards microformats ouverts "draft" adapté pour embarquer de la data dans le HTML/HTML5.

h-entry est la mise à jour microformats2 de hAtom.

Exemple

Voici un exemple simple de billet de blog :

<article class="h-entry">
  <h1 class="p-name">Les microformats sont fascinants</h1>
  <p>Publié par <a class="p-author h-card">W. Developer</a>
     le <time class="dt-published" datetime="2013-06-01 12:00:00">1<sup>er</sup> juin 2013</time>
  
  <p class="p-summary">Dans le quel je loue les vertus d'utiliser les microformats.</p>
  
  <div class="e-content">
    <p>Blah blah blah</p>
  </div>
</article>

Démarrer

La classe h-entry est un nom de classe racine qui indique la présence d'un h-entry.

p-name, p-author, dt-published et les autres propriétés-noms de classes de h-entry listées ci-dessous définissent les propriétés de h-entry.

Voir microformats2-parsing pour en savoir plus à propos des noms de classes propriétés.

Propriétés

les propriétés h-entry, à l'intérieur d'un élément avec la classe h-entry :

  • p-name - nom de la note/titre
  • p-summary - petit résumé court de la note
  • e-content - contenu complet de la note
  • dt-published - quand la note a été publiée
  • dt-updated - quand la note a été mise à jour
  • p-author - qui a écrit la note, optionnellement embarquée avec h-card(s)
  • p-category - catégories/tags de la note
  • u-url - URL permalien de la note
  • u-uid - ID unique de la note
  • p-geo - lieu géophysique à partir duquel la note a été postée, embarque optionnellement h-geo
    Article principal: h-geo
  • p-latitude - latitude décimale
  • p-longitude - longitude décimale
  • p-altitude - altitude décimale

Les propriétés suivantes expérimentales sont utilisées dans la jungle mais ne font pas encore partie de la spécification :

  • u-in-reply-to - l'URL à laquelle la h-entry est considéré comme une réponse à ou un commentaire sur.
    • Potentiellement une h-entry embarquée (ou imbriquée ?) (pour les contextes de réponses) mais je suis le seul à faire ça à cette heure, aussi non considéré comme une recommandation --bw 16:44, 13 June 2013 (UTC)
  • p-comment - h-entries optionellement embarquées (ou imbriquées), chacune d'entre elles est un commentaire/réponse au h-entry parent. Voir Brainstorming for a Comment Microformat.

Les propriétés suivantes sont des ajouts proposés basés sur différentes conventions existantes de prévisualisation de lien qui ne sont pas encore utilisées dans la jungle (En rapport : link-preview-brainstorming)

  • u-photo
  • u-audio - consider special u- parsing rules for <audio>
  • u-video - consider special u- parsing rules for <video>

Toutes les propriétés sont optionnelles.

Statut

h-entry est une spécification draft de microformats.org. La discussion publique sur h-entry a lieu sur h-entry-issues, le canal #microformats on freenode #microformats sur irc.freenode.net, et la liste de discussion microformats-new.

h-entry est prêt à l'utilisation et à l'implémentation dans la jungle, mais pour des raisons de rétro-compatibilité vous devriez aussi baliser les h-entries en les enrichissant des notes classiques hAtom.

Détails de Propriétés

(ébauche à compléter)

Les implémentations spécifiques-hAtom qui exécutent un affichage ou une traduction personnalisée (par ex. vers Atom XML) DEVRAIENT préférer p-name à p-entry-title, et utiliser les valeurs p-entry-title comme un plan de secours s'il n'existe pas de p-name.

FAQ

  • Qu'est-ce que le p-name d'une note?
    • Quelques options, de la plus simple à la plus détaillée.
      • la même que la propriété p-content/e-content.
      • la même que l'élément title sur le permalien de note de page. Au moment de publier une note sur sa propre page de permalien de post, les contenus de la note sont probablement abrégés pour le titre de la page. La même abréviation peut être utilisée pour le p-name.
      • première phrase de la propriété p-content/e-content. Ce peut être mieux pour la syndication et les objectifs de prévisualisation de lien de fournir simplement la première phrase de la note comme le p-name. De la même manière, si seulement une portion du contenu est syndiquée sur d'autres sites, cette portion-la peut être balisée comme le p-summary.
  • ...

Exemples dans la jungle

Les véritables exemples dans la jungle :


Validation

Article principal: validateurs microformats

Testez et validez votre marquage avec :

Rétro-compatibilité

Compatibilité Éditeur

Pour la compatibilité arrière, vous pouvez vouloir utiliser les noms de classes classiques hAtom en plus des propriétés h-entry à venir, par exemple :

<div class="h-entry hentry">
  <h1 class="p-name entry-title">Mon billet de blog génial</h1>
</div>

Compatibilité Parseurs

Les parseurs microformats devraient détecter les propriétés classiques et les parser comme des propriétés microformats2. Si un "h-entry" est trouvé, ne pas chercher un "hentry" sur le même élément.

Le nom de classe racine compatible : hentry
Propriétés : (parsées comme p- plein texte à moins qu'autre chose ne soit spécifié) :

  • entry-title - parser comme p-name
  • entry-summary - parser comme p-summary
  • entry-content - parser comme e-content
  • published - parser comme dt-
  • updated - parser comme dt-
  • author - comprenant la racine compatible vcard en l'absence de h-card
  • category
  • geo - parser comme p-geo h-geo comprenant la racine compatible geo
  • latitude
  • longitude

Historique

Ce travail est basé sur le microformat existant hAtom, et le selfdogfooding complet dans la communauté indie web camp.

Principes de Design

(ébauche à compléter)

Voir aussi