hatom-fr

2009-01-03T13:32:26Z

Varc4Torco: domcdomctrbo

olopasge
<h1> hAtom 0.1 </h1>
{{TOC-right}}

hAtom est un microformat pour le contenu qui peut Ãªtre syndiquÃ©, initialement conÃ§u pour les billets de blog mais pas exclusivement. hAtom est basÃ© sur un sous-ensemble du format de syndication [http://www.atomenabled.org/ Atom]. hAtom est l'un des nombreux [[microformats-fr|microformats]] standards ouverts.

== SpÃ©cification Brouillon ==

;Editeur/Auteur
:[http://blogmatrix.blogmatrix.com/ David Janes] ([http://www.blogmatrix.com BlogMatrix, Inc.])
;Contributeurs
:[http://members.optusnet.com.au/benjamincarlyle/benjamin/blog/ Benjamin Carlyle]
:[http://tantek.com/ Tantek Ãelik] ([http://technorati.com Technorati, Inc.])

(Traduction en cours par [[Christophe Ducamp]])

=== Copyright ===
{{MicroFormatCopyrightStatement2005-fr}}

* [[User:Tantek|Tantek]] : Je sors toutes mes contributions Ã cette spÃ©cification dans le domaine public et j'encourage les autres auteurs Ã faire ainsi.
** 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 ===
{{MicroFormatPatentStatement-fr}}

== Introduction ==
hAtom est un [[microformat-fr|microformat]] pour identifier l'information sÃ©mantique dans les billets de blog et pratiquement n'importe quel autre endroit [http://www.atomenabled.org/ Atom] peut Ãªtre utilisÃ©, comme les articles d'actualitÃ©s. Le contenu hAtom est facilement ajoutÃ© Ã la plupart des blogs par de simples modifications aux dÃ©finitions du gabarit du blog.

{{rfc-2119-intro-fr}}

== Principes de Design XHTML SÃ©mantique ==
{{semantic-xhtml-design-principles-fr}}

== Format ==
=== En GÃ©nÃ©ral ===
Le [http://atomenabled.org/developers/syndication/#person Format de Syndication Atom] fournit la base conceptuelle pour ce microformat, avec les mises en garde suivantes :

* Atom fournit beaucoup plus de fonctionnalitÃ©s qu'il n'en faut pour un microformat "billet blog", aussi nous avons pris le nombre minimal d'Ã©lÃ©ments requis.
* le modÃ¨le "logique" de hAtom est celui d'Atom. S'il y a un conflit, Atom devrait Ãªtre pris comme correct.
* le modÃ¨le "physique" de hAtom -- la vÃ©ritable Ã©criture des Ã©lÃ©ments -- est bien plus variÃ© que ce que fournit Atom, du fait de la variÃ©tÃ© des maniÃ¨res dont sont effectivement produits les weblogs dans la jungle. Le microformat hAtom fournit un certain nombre de rÃ¨gles pour "ponter le fossÃ©"

=== SchÃ©ma ===
Les Ã©lÃ©ments du schÃ©ma sont basÃ©s sur la nomenclature Atom et suivent le modÃ¨le de prÃ©fixer un identifiant unique (dans ce cas, '<code>h</code>') sur la plupart des Ã©lÃ©ments conteneurs -- le Fil ou l'EntrÃ©e. Les parties de ce microformat sont basÃ©es sur l'analyse de beaucoup de weblogs, de bulletin board et de billets mÃ©dia et peuvent Ãªtre lus sur [[blog-post-brainstorming-fr#El.C3.A9ments_D.C3.A9couverts|blog-post-brainstorming#ElÃ©ments dÃ©couverts]].

Le schÃ©ma hAtom comprend les points suivants :

* hfeed ('''<code>hfeed</code>'''). optionnel.
** '''<code>feed category</code>'''. optionnel. mots-clÃ© ou phrases, en utilisant '''[[rel-tag-fr|rel-tag]]'''.
** hentry ('''<code>hentry</code>''').
*** '''<code>entry-title</code>'''. requis. texte.
*** '''<code>entry-content</code>'''. optionnel (voir desription champ). texte. [*]
*** '''<code>entry-summary</code>'''. optionnel. texte.
*** '''<code>updated</code>'''. requis en utilisant le [[datetime-design-pattern-fr|datetime-design-pattern]]. [*]
*** '''<code>published</code>'''. optionnel en utilisant le [[datetime-design-pattern-fr|datetime-design-pattern]].
*** '''<code>author</code>'''. requis en utilisant '''[[hcard-fr|hCard]]'''. [*]
*** '''<code>bookmark</code>''' (permalink). optionnel en utilisant '''[[rel-bookmark-fr|rel-bookmark]]'''.
*** tags. optionnel. mots-clÃ©s ou phrases, utilise '''[[rel-tag-fr|rel-tag]]'''.

[*] Quelques Ã©lÃ©ments requis ont des valeurs par dÃ©faut si elles manquent, voir en-dessous.

=== DÃ©tails Champ et ElÃ©ment ===

===== Fil =====
* un Ã©lÃ©ment Fil est identifiÃ© par le nom de classe <code>hfeed</code>
* un Ã©lÃ©ment Fil reprÃ©sente le concept d'un [http://www.atomenabled.org/developers/syndication/atom-format-spec.php#rfc.section.4.1.1 fil Atom]
* l'Ã©lÃ©ment Fil est optionnel et s'il manque, il est supposÃ© Ãªtre la page
* les documents hAtom {{may-fr}} avoir plusieurs Ã©lÃ©ments Fil.

===== Fil CatÃ©gorie =====
* un Ã©lÃ©ment Fil CatÃ©gorie est identifiÃ© par [[rel-tag-fr|rel-tag]]
* un Fil PEUT avoir un Fil CatÃ©gorie
* un Ã©lÃ©ment Fil CatÃ©gorie reprÃ©sente le concept d'une [http://www.atomenabled.org/developers/syndication/atom-format-spec.php#rfc.section.4.2.2 catÃ©gorie Atom] dans un [http://www.atomenabled.org/developers/syndication/#optionalFeedElements fil]
* les Ã©lÃ©ments CatÃ©gorie Fil DOIVENT apparaitre Ã l'intÃ©rieur d'un Ã©lÃ©ment Fil mais pas Ã l'intÃ©rieur d'un Ã©lÃ©ment EntrÃ©e
* le [[rel-tag-fr|rel-tag]] <code>href</code> encode le <code>category:term</code> atom ; le lien texte dÃ©finit la <code>category:label</code> atom.

===== EntrÃ©e =====
* un Ã©lement EntrÃ©e est identifiÃ© par le nom de classe <code>hentry</code>
* un Ã©lement EntrÃ©e reprÃ©sente le concept d'une [http://www.atomenabled.org/developers/syndication/atom-format-spec.php#rfc.section.4.1.2 entrÃ©e Atom]
* tout contenu microformat Ã l'intÃ©rieur d'un Ã©lÃ©ment <code><blockquote></code> ou <code><q></code> dans l'EntrÃ©e ne devrait pas Ãªtre considÃ©rÃ© comme partie de l'EntrÃ©e.
: ''Ceci permet la citation d'autres donnÃ©es microformatÃ©es sans se soucier de corrompre le modÃ¨le''

===== CatÃ©gorie EntrÃ©e =====
* un Ã©lÃ©ment CatÃ©gorie EntrÃ©e est identifiÃ© par [[rel-tag-fr|rel-tag]]
* une EntrÃ©e PEUT avoir une CatÃ©gorie EntrÃ©e
* un Ã©lÃ©ment CatÃ©gorie EntrÃ©e reprÃ©sente le concept d'une [http://www.atomenabled.org/developers/syndication/atom-format-spec.php#rfc.section.4.2.2 catÃ©gorie Atom] Ã l'intÃ©rieur d'une [http://www.atomenabled.org/developers/syndication/#optionalEntryElements entrÃ©e]
* le [[rel-tag-fr|rel-tag]] <code>href</code> encode le <code>category:term</code> atom ; le lien texte dÃ©finit la <code>category:label</code> atom

===== EntrÃ©e Titre =====
* un Ã©lÃ©ment EntrÃ©e Titre ('entry-title') est identifiÃ© par le nom de classe <code>entry-title</code>
* une EntrÃ©e DEVRAIT avoir une EntrÃ©e Titre
* un Ã©lÃ©ment 'Entry Title' reprÃ©sente le concept d'une [http://www.atomenabled.org/developers/syndication/atom-format-spec.php#rfc.section.4.2.14 entrÃ©e titre Atom]
* si 'Entry Title' manque, utilisez
** le premier Ã©lÃ©ment <code><h#></code> dans l'EntrÃ©e, ou
** le <code><title></code> de la page, s'il n'y a pas d'Ã©lÃ©ment Feed enclos, ou
** supposez que ce soit la chaÃ®ne vide

===== EntrÃ©e Contenu =====
* un Ã©lÃ©ment "Entry Content" est identifiÃ© par le nom de classe <code>entry-content</code>
* une EntrÃ©e DEVRAIT ({{should-fr}}) avoir une EntrÃ©e Contenu
* un Ã©lÃ©ment "Entry Content" reprÃ©sente le concept d'un [http://www.atomenabled.org/developers/syndication/atom-format-spec.php#atomContent contenu Atom]
* une EntrÃ©e PEUT ({{may-fr}}) avoir 0 or plus Ã©lÃ©ments "Entry Content". L'"Entry Content" logique d'une EntrÃ©e est la concatÃ©nation, par ordre d'apparition, de toutes les EntrÃ©es de Contenus dans l'EntrÃ©e.
: ''Beaucoup de weblogs dÃ©coupent le contenu en plusieurs sections avec un lien "En savoir plus" et des trucs javascript. Ceci est aussi requis dans les cas oÃ¹ les 'entry-title' sont codÃ©s dans la ligne et sont considÃ©rÃ©s comme partie du contenu.''
* si 'Entry-Content' manque, supposez que c'est la chaÃ®ne vide.

===== EntrÃ©e RÃ©sumÃ© =====
* un Ã©lÃ©ment EntrÃ©e RÃ©sumÃ© est identifiÃ© par le nom de classe <code>entry-summary</code>
* un Ã©lÃ©ment 'Entry Summary' reprÃ©sente le concept d'un [http://www.atomenabled.org/developers/syndication/atom-format-spec.php#rfc.section.4.2.13 summary Atom]
* une EntrÃ©e PEUT ({{may-fr}}) avoir 0 ou plus d'Ã©lÃ©ments 'Entry Summary'. L'"Entry Summary" logique d'une EntrÃ©e est la concatÃ©nation par ordre d'apparition, de tous les 'Entry Summary' dans l'EntrÃ©e.

===== EntrÃ©e Permalien =====
* un Ã©lÃ©ment 'EntrÃ©e Permalien' est identifiÃ© par [[rel-bookmark-fr|rel-bookmark]]
* une EntrÃ©e DEVRAIT ({{should-fr}}) avoir une 'EntrÃ©e Permalien'
* un Ã©lÃ©ment 'EntrÃ©e Permalien' reprÃ©sente le concept d'un [http://www.atomenabled.org/developers/syndication/atom-format-spec.php#rfc.section.4.2.7 lien Atom dans une entrÃ©e]
* si 'EntrÃ©e Permalien' manque, utilisez l'URI de la page ; si l'EntrÃ©e n'a pas d'attribut "id", ajoutez cela comme un fragment vers l'URI de la page pour distinguer les entrÃ©es individuelles

===== EntrÃ©e Mise Ã jour =====
* un Ã©lÃ©ment 'EntrÃ©e Mise Ã jour' est identifiÃ© par le nom de classe <code>updated</code>
* un Ã©lÃ©ment 'EntrÃ©e Mise Ã jour' reprÃ©sente le concept de [http://www.atomenabled.org/developers/syndication/atom-format-spec.php#rfc.section.4.2.15 Atom updated]
* une EntrÃ©e DEVRAIT ({{should-fr}}) avoir un Ã©lÃ©ment 'EntrÃ©e Mise Ã jour'
* utiliser le [[datetime-design-pattern-fr|datetime-design-pattern]] pour encoder la date et l'heure de mise Ã jour
* s'il n'existe pas d'Ã©lÃ©ment 'EntrÃ©e Mise Ã jour',
** utilisez l'Ã©lÃ©ment 'EntrÃ©e PubliÃ©e' si prÃ©sent
** autrement la page est invalide hAtom

===== EntrÃ©e PubliÃ©e =====
* un Ã©lÃ©ment 'EntrÃ©e PubliÃ©e' est identifiÃ© par le nom de classe <code>published</code>
* un Ã©lÃ©ment 'EntrÃ©e PubliÃ©e' reprÃ©sente le concept de [http://www.atomenabled.org/developers/syndication/atom-format-spec.php#rfc.section.4.2.9 Atom published]
* utilisez le [[datetime-design-pattern-fr|datetime-design-pattern]] pour encoder la date et l'heure de publication

===== EntrÃ©e Auteur =====
* un Ã©lÃ©ment 'EntrÃ©e Auteur' est reprÃ©sentÃ© par le nom de classe <code>author</code>
* un Ã©lÃ©ment 'EntrÃ©e Auteur' reprÃ©sente le concept d'un [http://www.atomenabled.org/developers/syndication/atom-format-spec.php#rfc.section.4.2.1 Atom author]
* un Ã©lÃ©ment 'EntrÃ©e Auteur' DOIT ({{must-fr}}) Ãªtre encodÃ© dans une [[hcard-fr|hCard]]
* un Ã©lÃ©ment 'EntrÃ©e Auteur' DEVRAIT ({{should-fr}}) Ãªtre encodÃ© dans un Ã©lÃ©ment <code><address></code>
* une EntrÃ©e DEVRAIT avoir au moins un Ã©lÃ©ment 'EntrÃ©e Auteur'
* une EntrÃ©e PEUT avoir plus qu'un Ã©lÃ©ment 'EntrÃ©e Auteur'
* si l'EntrÃ©e Auteur manque
** trouvez le(s) Ã©lÃ©ment(s) <code><address></code> [[algorithm-nearest-in-parent-fr|Plus Proche En Parent]] avec le nom de classe <code>author</code> et qui soit/soient une [[hcard-fr|hCard]] valide.
** autrement l'entrÃ©e est hAtom invalide

=== Profil XMDP ===
<pre>
<dl class="profile">
<dt>class</dt>
<dd><p>
<a rel="help" href="http://www.w3.org/TR/html401/struct/global.html#adef-class">
HTML4 definition of the 'class' attribute.</a>
This meta data profile defines some 'class' attribute values (class names)
and their meanings as suggested by a
<a href="http://www.w3.org/TR/WD-htmllink-970328#profile">
draft of "Hypertext Links in HTML"</a>.
<dl>
<dt>hfeed</dt>
<dd>
The concept of atom:feed from
<a href="http://www.atomenabled.org/developers/syndication/atom-format-spec.php">The Atom Syndication Format</a>,
constrained and modified as per the <a href="http://microformats.org/wiki/hatom">hAtom microformat spec</a>.
</dd>
<dt>hentry</dt>
<dd>
The concept of atom:entry from
<a href="http://www.atomenabled.org/developers/syndication/atom-format-spec.php">The Atom Syndication Format</a>,
constrained and modified as per the <a href="http://microformats.org/wiki/hatom">hAtom microformat spec</a>.
</dd>
<dt>entry-title</dt>
<dd>
The concept of atom:title inside of an atom:entry from
<a href="http://www.atomenabled.org/developers/syndication/atom-format-spec.php">The Atom Syndication Format</a>,
constrained and modified as per the <a href="http://microformats.org/wiki/hatom">hAtom microformat spec</a>.
</dd>
<dt>entry-content</dt>
<dd>
The concept of atom:content from
<a href="http://www.atomenabled.org/developers/syndication/atom-format-spec.php">The Atom Syndication Format</a>,
constrained and modified as per the <a href="http://microformats.org/wiki/hatom">hAtom microformat spec</a>.
</dd>
<dt>entry-summary</dt>
<dd>
The concept of atom:summary from
<a href="http://www.atomenabled.org/developers/syndication/atom-format-spec.php">The Atom Syndication Format</a>,
constrained and modified as per the <a href="http://microformats.org/wiki/hatom">hAtom microformat spec</a>.
</dd>
<dt>bookmark</dt>
<dd>
The concept of atom:link (without any "rel") with an atom:entry from
<a href="http://www.atomenabled.org/developers/syndication/atom-format-spec.php">The Atom Syndication Format</a>,
constrained and modified as per the <a href="http://microformats.org/wiki/hatom">hAtom microformat spec</a>.
</dd>
<dt>published</dt>
<dd>
The concept of atom:published from
<a href="http://www.atomenabled.org/developers/syndication/atom-format-spec.php">The Atom Syndication Format</a>,
constrained and modified as per the <a href="http://microformats.org/wiki/hatom">hAtom microformat spec</a>.
</dd>
<dt>updated</dt>
<dd>
The concept of atom:updated from
<a href="http://www.atomenabled.org/developers/syndication/atom-format-spec.php">The Atom Syndication Format</a>,
constrained and modified as per the <a href="http://microformats.org/wiki/hatom">hAtom microformat spec</a>.
</dd>
<dt>author</dt>
<dd>
The concept of atom:author from
<a href="http://www.atomenabled.org/developers/syndication/atom-format-spec.php">The Atom Syndication Format</a>,
constrained and modified as per the <a href="http://microformats.org/wiki/hatom">hAtom microformat spec</a>.
</dd>
</dl>
</dd>
</dl>
</pre>

== Exemples ==
Voir [[hatom-examples-fr|exemples hatom]].

== Exemples dans la jungle ==
Cette section est '''informative'''.
Voir [[hatom-examples-in-wild-fr|hAtom-exemples dans la jungle]]

== ImplÃ©mentations ==
Cette section est '''informative'''.

Les implÃ©mentations qui suivent ont Ã©tÃ© dÃ©veloppÃ©es et elles gÃ©nÃ¨rent ou parsent les liens hAtom. Si vous avez une implÃ©mentation hAtom, sentez-vous libre de l'ajouter en haut de cette liste. Une fois que la liste sera devenue trop grosse, nous produirons une page wiki sÃ©parÃ©e.



* [http://spinn3r.com/opensource.php Spinn3r Open Source] - implementÃ© dans [http://spinn3r.com Spinn3r] et partie du [http://code.tailrank.com/feedparser FeedParser] et notre annonce de [http://blog.spinn3r.com/2008/01/announcing-spin.html hAtom dans Spinn3r 2.1]
* [http://dichotomize.com/uf/hatom/creator.html hAtom Creator] modifiÃ© Ã partir des autres crÃ©ateur par BenWest.
** semble Ãªtre cassÃ© en date du 14 Oct 2007. renvoie une erreur 404, comme son rÃ©pertoire parent. le site renvoie vers la page d'accueil par dÃ©faut de l'installation Apache.
* [http://www.fberriman.com fberriman.com] utilise hAtom 0.1 pour les billets de blog (boucle wordpress) et hCard -- par [[User:Phae|Frances Berriman]]
* Le [http://tools.blogmatrix.com/extract/ Parseur Microformat Presque Universel] peut extraire le contenu hAtom Ã partir de pages web. ([http://tools.blogmatrix.com/extract/?uri=http%3A%2F%2Fblog.davidjanes.com&microformat=hatom&submit=Submit example])
* le script [http://www.trinityanne.com/tools/greasemonkey/microformat-action.user.js microformat-action] [[greasemonkey-fr|Greasemonkey]] dÃ©tecte le contenu hAtom sur les pages web et appellera le [http://tools.blogmatrix.com/extract/ Parseur Microformat Presque Universel]
* [http://rbach.priv.at/hAtom2Atom/ hAtom2Atom.xsl] transforme hAtom en Atom (comme le suggÃ¨re le nom.)
* Il existe dÃ©sormais un [http://www.lukearno.com/projects/hatom2atom/ proxy hatom2atom] qui utilise hAtom2Atom.xsl.
* [http://placenamehere.com/article/185/SubscribingTohAtomFeedsWithNetNewsWire Subscribe To hAtom] est un script qui fournit aux utilisateurs de [http://ranchero.com/netnewswire/ NetNewsWire 2.x] la capacitÃ© de s'abonner Ã des documents hAtom comme ils le feraient avec n'importe quel autre fil. par [[User:ChrisCasciano|Chris Casciano]].
* [http://boxtheweb.mihopa.net/code/apis/#outlineclasses Outline Classes] - a GPLisÃ© son code PHP pour lire hAtom
* [http://boxtheweb.4x2.net/ BoxtheWeb] - supporte l'abonnement Ã hAtom sous un format fil



== RÃ©fÃ©rences ==
=== RÃ©fÃ©rences Normatives ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [http://www.ietf.org/rfc/rfc4287 RFC4287 : Le Format de Syndication Atom]
* [[hcard-parsing-fr|parsage hcard]]
* [[rfc-2119-fr|RFC 2119]]
* [[iso-8601-fr|ISO8601]]

=== RÃ©fÃ©rences Informatives ===
* [http://www.atomenabled.org/ Atom]

==== SpÃ©cifications Qui utilisent hAtom ====

==== Travail Similaire ====
* [http://rdfs.org/sioc/ Semantically-Interlinked Online Communities (SIOC) RDF Ontology]

== 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. Il existe un document sÃ©parÃ© oÃ¹ nous conservons nos brainstorms et autres explorations en rapport avec hAtom :

* [[blog-post-brainstorming-fr|blog-post Brainstorming]]

=== Version 0.1 ===
La version 0.1 est sortie le 28 fÃ©vrier 2006.

== Discussions ==
* voir [http://www.technorati.com/cosmos/referer.html les blogs discutant de cette page].

=== Q&R ===
* Si vous avez quelque question Ã propos de hAtom, regardez les [[hatom-faq-fr|FAQ hAtom]], et si vous ne trouvez pas de rÃ©ponses, ajoutez vos questions !

=== ProblÃ©matiques ===
* SVP ajoutez toutes les problÃ©matiques de la spÃ©cification au document sÃ©parÃ© [[hatom-issues-fr|problÃ©matiques hAtom]].

==Voir aussi ==
{{hatom-related-pages-fr}}
* [[rel-enclosure-fr|rel-enclosure]] - comment rÃ©fÃ©rencer sÃ©mantiquement les piÃ¨ces jointes (par ex. les podcasts) dans hAtom
* [[blog-post-brainstorming-fr|blog-post-brainstorming]]
* [[blog-post-formats-fr|blog-post-formats]]
* [[blog-post-examples-fr|blog-post-exemples]]
* [[blog-description-format-fr|blog-description-format]] - comment dÃ©crire un blog (Ã l'opposÃ© des entrÃ©es individuelles, ce qui n'est pas ce que nous sommes en train de faire ici)

Microformats Wiki - User contributions [en]

hatom-fr