h-entry

(Difference between revisions)

Jump to: navigation, search
(Voir aussi: [fr: typo])
([fr: sync with original - h-feed-fr to be veified - translation to be reviewed])
Line 4: Line 4:
* <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: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>
* <span class="h-card vcard"><span class="p-name fn">[[User:ChristopheDucamp|Christophe Ducamp]]</span> (<span class="p-role role">Traducteur</span>)</span>
 +
 +
 +
{{cc0-owfa-license-fr}}
----
----
<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.  
<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 souvent utilisé avec du contenu destiné à être distribué en simultané, 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]].
+
h-entry est la mise à jour [[microformats2-fr|microformats2]] du "hentry" de [[hatom-fr|hAtom]]. Pour une mise à jour de "hfeed, voir [[h-feed-fr|h-feed]].
== Exemple ==
== Exemple ==
Line 46: Line 49:
* '''<code>u-url</code>''' - URL permalien de la note
* '''<code>u-url</code>''' - URL permalien de la note
* '''<code>u-uid</code>''' - ID unique 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-location</code>''' - endroit à partir duquel a été posté l'entrée, optionnellement embarqué dans [[h-card-fr|h-card]], [[h-adr-fr|h-adr]] ou [[h-geo-fr|h-geo]]
-
* '''<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 :  
Les propriétés suivantes expérimentales sont utilisées dans la jungle mais ne font pas encore partie de la spécification :  
Line 72: Line 73:
(ébauche à compléter)
(é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>.
+
This section is a stub.
 +
=== p-location ===
 +
'''<code>p-location</code>''' a été réutilisé à partir de [[h-event-fr|h-event]].
-
== FAQ ==
 
 +
== FAQ ==
 +
=== p-name d'une note ===
<div class="discussion">
<div class="discussion">
* '''Qu'est-ce que le <code>p-name</code> d'une [http://indiewebcamp.com/note-fr note]?'''
* '''Qu'est-ce que le <code>p-name</code> d'une [http://indiewebcamp.com/note-fr note]?'''
Line 84: Line 88:
* ...
* ...
</div>
</div>
 +
 +
=== venue an entry was posted from ===
 +
<div class="discussion">
 +
* '''Comment indiquez-vous un endroit nommé quand une entrée à été postée à partir d'un ? comme un restaurant ou un parc.'''
 +
** Utilisez un microformat embarqué [[h-card-fr|h-card]] sur une valeur de propriété <code>p-location</code>.
 +
</div>
 +
=== address an entry was posted from ===
 +
<div class="discussion">
 +
* '''Comment indiquez-vous l'adresse où une entrée a été postée à partir de ? comme un restaurant ou parc. ? '''
 +
** Si l'adresse fait simplement partie d'un endroit nommé, voir au-dessus, utilisez une [[h-card-fr|h-card]]
 +
** Sinon utilisez un microformat embarqué [[h-adr-fr|h-adr]] sur une valeur de propriété <code>p-location</code>.
 +
</div>
 +
=== lat long d'une entrée postée ===
 +
<div class="discussion">
 +
* '''Comment indiquez-vous les latitude et longitude de l'endroit où une entrée à été postée ?'''
 +
** Si l'endroit a un nom en plus des latitude et longitude, voir au-dessus, utilisez une [[h-card-fr|h-card]]
 +
** Autrement s'il y a une adresse en plus des latitude et longitude, voir au-dessus, utilisez une [[h-adr-fr]]
 +
** Autrement, utilisez un microformat embarqué [[h-geo-fr|h-geo]] sur une valeur de propriété <code>p-location</code>.
 +
</div>
 +
== Exemples dans la jungle ==
== Exemples dans la jungle ==
Line 89: Line 113:
* ... ajoutez ici les usages de h-entry que vous voyez dans la jungle  
* ... ajoutez ici les usages de h-entry que vous voyez dans la jungle  
 +
* App.net enrichit les pages de profils et pages de permaliens avec h-entry en date du 2013-08-06 ([https://alpha.app.net/voidfiles exemple])
* 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
* 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])
* Brett Comnes enrichit ses posts avec h-entry et h-card ([http://bret.io/2013/06/29/getting-started-with-bower/ exemple])
Line 107: Line 132:
* [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].
* [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].
 +
== Validation ==
 +
* '''[http://indiewebify.waterpigs.co.uk/validate-h-entry/ validateur h-entry indiewebify.me]''' parse le marquage [[h-entry-fr|h-entry]], trouve les erreurs communes et fournit des suggestions des choses à ajouter, avec des exemples de code.
{{h-spec-section-validating-fr}}
{{h-spec-section-validating-fr}}
Line 121: Line 148:
=== Compatibilité Parseurs ===
=== 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.
+
Les parseurs microformats DEVRAIENT détecter les propriétés classiques seulement si un nom de classe racine est trouvé 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/>
Le nom de classe racine compatible : <code id="hentry">hentry</code><br/>
Line 133: Line 163:
* <code>author</code> - comprenant la racine compatible <code>vcard</code> en l'absence de <code>h-card</code>
* <code>author</code> - comprenant la racine compatible <code>vcard</code> en l'absence de <code>h-card</code>
* <code>category</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>
+
=== FAQ Compat ===
-
* <code>longitude</code>
+
==== Que devient rel-bookmark ====
 +
Aussi posé sous : ''Pourquoi utiliser un h-entry u-url u-uid pour les permaliens quand j'ai [[rel-bookmark-fr|rel=bookmark]] ?''
 +
 
 +
R : tl;dr: utilisez <code>class="u-url u-uid"</code> au lieu de <code>rel=bookmark</code> pour les permaliens des posts parce que c'est plus simple (moins d'attributs) et parce que cela fonctionne mieux sur les contextes (page permalien, posts récents sur la page d'accueil, collection de posts sur les pages d'archives).
 +
 
 +
rel=bookmark était l'ancienne méthode [[h-atom-fr|hAtom]] pour marquer les permaliens. Depuis deux facteurs ont contribué à réduire l'usage de rel dans les microformats :
 +
* rel en étant typiquement* figuré dans le [[HTML5]] - le rendant par conséquent inapproprié à l'usage dans les microformats qui sont agrégés, par ex. une collection de posts sur une page d'accueil ou dans des archives mensuelles.
 +
* il est plus facile de toujours utiliser les noms de classes pour les propriétés. Quand les formats utilisent deux (ou plus !) attributs dans le HTML pour spécifier les propriétés, la confusion génère une qualité de la data moindre (du marquage et par conséquent du truc qui est marqué). Par conséquent, selon le [[principle-fr|principe]] microformats de [[simplicity-fr|simplicité]], dans les  [[microformats2-fr|microformats2]] nous n'utilisons uniquemnet que des noms de classes pour les propriétés.
 +
 
 +
<nowiki>*</nowiki> même si rel=bookmark en particulier est un élément-article / section figuré dans le  HTML5[http://www.whatwg.org/specs/web-apps/current-work/multipage/links.html#link-type-bookmark], c'est un détail dont les auteurs en général ne vont pas se souvenir, et par conséquent, ce n'est pas bien de dépendre de lui pour tout type de format.
 +
 
== Historique ==
== Historique ==

Revision as of 10:51, 5 January 2014

Cette page a démarré sur h-entry



Per CC0, to the extent possible under law, the editors have waived all copyright and related or neighboring rights to this work. In addition, as of 2019-10-20, the editors have made this specification available under the Open Web Foundation Agreement Version 1.0.


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 distribué en simultané, 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 du "hentry" de hAtom. Pour une mise à jour de "hfeed, voir h-feed.

Contents

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 :


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

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)

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

This section is a stub.

p-location

p-location a été réutilisé à partir de h-event.


FAQ

p-name d'une note

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

venue an entry was posted from

  • Comment indiquez-vous un endroit nommé quand une entrée à été postée à partir d'un ? comme un restaurant ou un parc.
    • Utilisez un microformat embarqué h-card sur une valeur de propriété p-location.

address an entry was posted from

  • Comment indiquez-vous l'adresse où une entrée a été postée à partir de ? comme un restaurant ou parc. ?
    • Si l'adresse fait simplement partie d'un endroit nommé, voir au-dessus, utilisez une h-card
    • Sinon utilisez un microformat embarqué h-adr sur une valeur de propriété p-location.

lat long d'une entrée postée

  • Comment indiquez-vous les latitude et longitude de l'endroit où une entrée à été postée ?
    • Si l'endroit a un nom en plus des latitude et longitude, voir au-dessus, utilisez une h-card
    • Autrement s'il y a une adresse en plus des latitude et longitude, voir au-dessus, utilisez une h-adr-fr
    • Autrement, utilisez un microformat embarqué h-geo sur une valeur de propriété p-location.


Exemples dans la jungle

Les véritables exemples dans la jungle :

Validation

Validation

Article principal: validators-fr

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 seulement si un nom de classe racine est trouvé 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é) :

FAQ Compat

Que devient rel-bookmark

Aussi posé sous : Pourquoi utiliser un h-entry u-url u-uid pour les permaliens quand j'ai rel=bookmark ?

R : tl;dr: utilisez class="u-url u-uid" au lieu de rel=bookmark pour les permaliens des posts parce que c'est plus simple (moins d'attributs) et parce que cela fonctionne mieux sur les contextes (page permalien, posts récents sur la page d'accueil, collection de posts sur les pages d'archives).

rel=bookmark était l'ancienne méthode hAtom pour marquer les permaliens. Depuis deux facteurs ont contribué à réduire l'usage de rel dans les microformats :

* même si rel=bookmark en particulier est un élément-article / section figuré dans le HTML5[1], c'est un détail dont les auteurs en général ne vont pas se souvenir, et par conséquent, ce n'est pas bien de dépendre de lui pour tout type de format.


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

Categories

h-entry was last modified: Wednesday, December 31st, 1969

Views