Version 4 — Mars 2007 — NicolasR
hAtom est un microformat pour réaliser des pages directement syndicables, au départ mais pas exclusivement pour des blogs. hAtom est construit sur la base d’Atom le format de syndication ; chaque élément d’ hAtom a une définition existante dans Atom.
Cette traduction du microformat est une traduction française du brouillon en cours ; merci de faire vos remarques sur le site mère http://microformats.org/wiki/hatom.
Spécifications du Brouillon de travail
Éditeur David Janes, BlogMatrix.
Auteurs David Janes
Contributeurs Benjamin Carlyle
Copyright Cette spécification bénéficie d’un dépôt de copyright par ses auteurs. Cependant, les auteurs souhaitent soumettre cette spécification sous forme d’un standard avec une licence libre comme celles de GMPG, IETF, et/ou W3C. Tout ceux qui souhaitent contibuer doivent en lire les principes, polices et licences (par exemple celle de GMPG ) et en accepter les termes, y compris soumettre toutes ses contributions sous les licences nécessaires (exemple CC-by 1.0 et plus), avant de participer.
Brevets Cette spécification est sous le coup d’un brevet d’usage gratuit, cf les Polices de Brevet du W3C, de l’IETF RFC3667 & RFC3668.
Principes-design-Sémantique-xhtml
Format
- En Général :
Le Format de Syndication Atom fournit les bases conceptuelles de ce microformat, avec les particularités suivantes :
Les éléments du Schéma sont basés sur la nomenclature d’Atom et suivent les spécifications des microformats avec en préfixe un identifiant unique (dans ce cas, atom
) pour l’élément contenant le plus externe — le Feed ou l’Entrée. Les parties de ce microformat sont fondées sur l’analyse de nombreux blogs, Bulletins et flux de media qui peuvent être lus. Notez le renommage d’ ’EntryGroup’ en ’Feed’ pour être plus en phase avec la terminologie d’Atom.
Concept | Identifiant Atom | hAtom Microformat Usage |
---|---|---|
Feed | atom:feed |
Ajouter class="feed" |
Entrée | atom:entry |
Ajouter class="entry" ; si nécessaire, définir aussi id="identifiant-unique" en Entrée. |
Titre de l’entrée | atom:title |
Ajouter class="title" , alternant avec <h#> . |
Contenu de l’Entrée | atom:content |
Ajouter class="content" à tous les blocs appropriés. Des blocs de contenu à multiples entrées sont logiquement considérés comme équivalents à un seul concaténé atom:content . |
Sommaire de l’Entrée | atom:summary |
Ajouter class="summary" à tous les blocs appropriés. Des blocs de sommaire à multiples entrées sont logiquement considérés comme équivalents à un seul concaténé atom:summary . |
Entrée Lienpermanent | atom:link |
Ajouter rel="bookmark" . |
Entrée Publié | atom:published |
Utiliser <abbr class="published" title="YYYYMMYYThh:mm:ss±ZZ:ZZ"> ...</abbr> , suivant le datetime-design-pattern. |
Entrée Mise à jour | atom:updated |
Utiliser <abbr class="updated" title="YYYYMMYYThh:mm:ss±ZZ:ZZ"> ...</abbr> , suivant le datetime-design-pattern. |
Entrée Auteur | atom:author |
Ajouter class="author" aux blocs appropriés. En utilisant plutôt <address class="author"> ...</address> . L’ajout d’une hCard est vivement recommandée. |
Entrée Contributeur | atom:contibutor |
Ajouter class="contributor" aux blocs appropriés . En utilisant plutôt <address class="contributor"> ...</address> . L’ajout d’une hCard est vivement recommandée. |
Concept | Imbriqué Dans | hAtom Opaque | Cardinalité | Cardinalité Logique |
---|---|---|---|---|
Feed | HTML document | Non | 1-N | 1-N |
Entrée | Feed | Non | 0-N | 0-N |
Titre de l’Entrée | Entrée Entrée Lien Permanent |
Non | 0-N | 0-1 |
Entrée Contenu | Entrée | Oui | 0-N | 0-1 |
Entrée Sommaire | Entrée | Oui | 0-N | 0-1 |
Entrée Lien Permanent | Entrée Entrée Titre Entrée Publié |
Non | 0-N | 1 |
Entrée Publié | Entrée Entrée Lien Permanent |
Non | 0-N | 0-1 |
Entrée Mise à jour | Entrée Entrée Lien Permanent |
Non | 0-N | 1 |
Entrée Auteur | Entrée | Oui | 0-N | 1-N |
Entrée Contibuteur | Entrée | Oui | 0-N | 0-N |
« hAtom Opaque » spécifie si un programme lecteur d’hAtom doit « regarder à l’intérieur » de l’élément à la recherche d’autre contenu hAtom. S’il y a des multiples règles appliquées au même élément le OU ou les deux seront utilisées. ( i.e. le « Oui » gagne toujours)
: ’’hAtom Opaque a été conçu pour rendre les règles de lecture moins ambigües. En particulier, il permet à des éléments hAtom « quotés » (à partir d’un autre blog, par exemple) d’être ignorés. Il permet également à des éléments ’conçus pour’ hAtom d’être redistribués par ce même hAtom, et de prévenir un accident lié à une autre information de microformat au sein d’un conteneur hAtom."
Combien de fois un élément d’un type donné peut-être déclaré dans son élément parent.
- Cardinalité Logique
À partir d’un modèle logique, le nombre de fois ou un élément pet apparaître.
:« Cela dépend directement des règles, voir au-dessus. Par exemple, une Entrée Lien Permanent peut apparaître six fois, mais chaque une d’entre elles doit avoir la même valeur ; une Entrée Contenu peut apparaître trois fois, mais ces trois sont concaténés pour faire un seul élément logique. »
- Règles & Définitions
Voir la section Règles d’imbrication (plus loin) pour ces éléments.
- Feed
class="feed"
- Entrée
class="entry"
- Entrée Titre
class="title"
<h#>
class="title"
est l’Entrée Titre : « la signification de la validation hAtom est que l’on espère qu’il soit où on l’attend (pas à l’intérieur d’une Entrée Contenu, par exemple). »<h#> apparaissant est l'Entrée Titre.
-**Ou alors, l'Entrée Titre est une chaîne vide : "Atom n'autorise pas une entrée à ne pas avoir de titre."
-{{Entrée Contenu}}
-*Elle est identifiée par <code>class="content"
- Entrée Sommaire
class="summary"
- Entrée Lien Permanent
rel="bookmark"
: ceci est une rupture de la terminologie Atom sur ce point car cette Entrée nécessiterait un micorformat par elle-même.atom:link
(ou rss:link
) utilisé dans les fils de syndicationMise au point
- Entrée Publié
class="published"
<abbr>
en utilisant datetime-design-pattern ;Mise au point
- Entrée Mis à Jour
class="updated"
<abbr>
en utilisant le datetime-design-pattern ; Mise au point
- Entrée Auteur
class="author"
<address>
- Entrée Contibuteur
class="contributor"
<address>
<pre>
<dl class="profile">
<dt>classe</dt>
<dd><p>
<a rel="help" href="http://www.w3.org/TR/html401/struct/global.html#adef-class">
Définition HTML4 de l'attribut 'class' .</a>
Ce profil de méta données définie quelques valeurs d'attributs 'class' (noms de classes)
et leur signification comme suggéré sur
<a href="http://www.w3.org/TR/WD-htmllink-970328#profile">
le document de travail des "Liens [->HyperTextes] en HTML"</a>.
<dl>
<dt>feed</dt>
<dd>
Le concept de atom:feed, à partir de
<a href="http://www.atomenabled.org/developers/syndication/atom-format-spec.php">Le Format de Syndication Atom</a>,
utilisé et adapté par les <a href="http://microformats.org/wiki/hatom">spécifications du microformat hAtom</a>.
</dd>
<dt>Entrée</dt>
<dd>
Le concept de l' atom:entry du
<a href="http://www.atomenabled.org/developers/syndication/atom-format-spec.php">Format de Syndication Atom</a>,
utilisé et adapté par les <a href="http://microformats.org/wiki/hatom">spécifications du microformat hAtom</a>.
</dd>
<dt>contenu</dt>
<dd>
Le concept de l' atom:content du
<a href="http://www.atomenabled.org/developers/syndication/atom-format-spec.php">Format de Syndication Atom</a>,
utilisé et adapté par les <a href="http://microformats.org/wiki/hatom">spécifications du microformat hAtom</a>.
</dd>
<dt>sommaire</dt>
<dd>
Le concept de l' atom:summary du
<a href="http://www.atomenabled.org/developers/syndication/atom-format-spec.php">Format de Syndication Atom</a>,
utilisé et adapté par les <a href="http://microformats.org/wiki/hatom">spécifications du microformat hAtom</a>.
</dd>
<dt>signet</dt>
<dd>
Le concept de l' atom:link (sans aucun "rel") avec une atom:entry du
<a href="http://www.atomenabled.org/developers/syndication/atom-format-spec.php">Format de Syndication Atom</a>,
utilisé et adapté par les <a href="http://microformats.org/wiki/hatom">spécifications du microformat hAtom</a>.
</dd>
<dt>publié</dt>
<dd>
Le concept de l' atom:published du
<a href="http://www.atomenabled.org/developers/syndication/atom-format-spec.php">Format de Syndication Atom</a>,
utilisé et adapté par les <a href="http://microformats.org/wiki/hatom">spécifications du microformat hAtom</a>.
</dd>
<dt>mis à jour</dt>
<dd>
Le concept de l'atom:updated du
<a href="http://www.atomenabled.org/developers/syndication/atom-format-spec.php">Format de Syndication Atom</a>,
utilisé et adapté par les <a href="http://microformats.org/wiki/hatom">spécifications du microformat hAtom</a>.
</dd>
<dt>auteur</dt>
<dd>
Le concept de l'atom:author du
<a href="http://www.atomenabled.org/developers/syndication/atom-format-spec.php">Format de Syndication Atom</a>,
utilisé et adapté par les <a href="http://microformats.org/wiki/hatom">spécifications du microformat hAtom</a>.
</dd>
</dl>
</dd>
</dl>
</pre>