DevWiki de Yosko

Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
====== Flux RSS & Atom ======

Quelques informations de spécification sur les flux RSS et Atom

===== RSS 2.0 =====

Exemple avec le minimum requis :

<code xml>
<?xml version="1.0" encoding="UTF-8" ?>
<rss version="2.0">
<channel>
  <title>Titre du flux</title>
  <description>Voici une courte description du flux</description>
  <link>http://www.example.com/</link>
  <item>
    <title>Titre de l'élément</title>
  </item>
</channel>
</rss>
</code>

__**Note :**__ les colonnes "Requis" et "Multiple" sont à revérifier dans la doc pour RSS.

Informations de flux (dans <channel>) :

^ Noeud       ^ Description ^ Requis ^ Multiple ^ Règles ^
^ title       |             |  Oui   |          |  |
^ link        |             |  Oui   |          |  |
^ description |             |  Oui   |          |  |
^ language    |             |        |          |  |
^ copyright   |             |        |          |  |
^ managingEditor |             |        |          |  |
^ webMaster   |             |        |          |  |
^ generator   |             |        |          |  |
^ pubDate     |             |        |          |  |
^ lastBuildDate |             |        |          |  |
^ category    |             |        |          |  |
^ docs        |             |        |          |  |
^ cloud       |             |        |          |  |
^ ttl         |             |        |          |  |
^ image       |             |        |          |  |
^ rating      |             |        |          |  |
^ textInput   |             |        |          |  |
^ skipHours   |             |        |          |  |
^ skipDays    |             |        |          |  |
^ item        |             |  Oui   |  Oui     | voir tableau ci-dessous |

Informations d'élément de flux (dans <item>) :

^ Noeud       ^ Description ^ Requis ^ Multiple ^ Règles ^
^ title       |             | optionnel |          | requis si pas de "description" |
^ description |             | optionnel |          | requis si pas de "title" |
^ link        |             | optionnel |          |  |
^ author      |             | optionnel |          | "should" be an email |
^ category    |             | optionnel |          |  |
^ comments    | URL page de commentaires | optionnel |          |  |
^ enclosure   | podcasts    | optionnel |          | attributs requis : url, length, type |
^ guid        |             | optionnel |          | unique. peut être un lien. si isPermalink="true", alors ??? |
^ pubDate     |             | optionnel |          | format de date RSS |
^ source      | indique le flux source | optionnel |          |  |

Sources :
  * [[http://cyber.law.harvard.edu/rss/rss.html|Site d'Harvard : topo sur le RSS]]
  * [[http://cyber.law.harvard.edu/rss/encodingDescriptions.html|Site d'Harvard : infos sur l'encodage de "description"]]

===== Atom =====

Exemple avec le minimum requis :

<code xml>
<?xml version="1.0" encoding="utf-8"?>
<feed xmlns="http://www.w3.org/2005/Atom">
  <id>urn:uuid:60a76c80-d399-11d9-b91C-0003939e0af6</id>
  <title>Titre du flux</title>
  <updated>2013-09-06T16:14:00Z</updated>
  <entry>
    <id>urn:uuid:1225c695-cfb8-4ebb-aaaa-80da344efa6a</id>
    <title>Atom-Powered Robots Run Amok</title>
    <updated>2003-12-13T18:30:02Z</updated>
    <link rel="alternate" type="text/html" href="http://www.example.com/article-path"/>
    <summary>Résumé de l'article</summary>
    <author>
      <name>John Doe</name>
      <email>johndoe@example.com</email>
    </author>
  </entry>
</feed>
</code>

Informations de flux (dans <feed>) :

^ Noeud       ^ Description ^ Requis ^ Multiple ^ Règles ^
^ id          |             |  Oui   |          |  |
^ title       |             |  Oui   |          |  |
^ updated     |             |  Oui   |          |  |
^ author      |             |        |          | requis si certains éléments n'en comporte pas |
^ link[rel="self"] |             |        |          | recommandé |
^ link[rel="alternate"] |             |        |          |  |
^ link        |             |        |  Oui     |  |
^ subtitle    |             |        |          |  |
^ rights      |             |        |          |  |
^ category    |             |        |  Oui     |  |
^ generator   |             |        |          |  |
^ icon        |             |        |          |  |
^ logo        |             |        |          |  |
^ contributor |             |        |  Oui     | même forme que "author" |
^ entry       |             |  Oui   |  Oui     | voir tableau ci-dessous |

Informations d'élément de flux (dans <entry>) :

^ Noeud       ^ Description ^ Requis ^ Multiple ^ Règles ^
^ id          |             |  Oui   |          |  |
^ title       |             |  Oui   |          |  |
^ updated     |             |  Oui   |          |  |
^ link[rel="alternate"] |             |        |          | requis si pas de "content". unique pour un couple d'attributs type & hreflang |
^ link        |             |        |  Oui     |  |
^ summary     |             |        |          | requis si <content src="..."> ou content de type média (base64) |
^ author      |             |        |          | requis ici si absent des infos générale du flux|
^ contributor |             |        |  Oui     | même forme que "author" |
^ category    |             |        |  Oui     |  |
^ content     |             |        |          |  |
^ published   |             |        |          |  |
^ rights      |             |        |          |  |
^ source      | indique le flux source |        |          |  |

Informations d'une personne (dans les <author> et les <contributor>) :

^ Noeud       ^ Description ^ Requis ^ Multiple ^ Règles ^
^ name        |             |  Oui   |          |  |
^ uri         |             |        |          |  |
^ email       |             |        |          |  |

Sources :
  * [[https://www.ietf.org/rfc/rfc4287.txt|Documentation d'Atom]]

===== Correspondance RSS/Atom =====

Correspondance entre les champs d'un flux Atom et ceux d'un flux Rss.

Informations de flux :

^ Atom           ^ Requis ^ Rss            ^ Requis ^ Remarque ^
| title          |  Oui   | title          |  Oui   |  |
| entry          |  Oui   | item           |  Oui   |  |
| id             |  Oui   |                |        |  |
| updated        |  Oui   | pubDate, lastBuildDate  |  |  |
| link           |        | link           |  Oui   |  |
| subtitle       |        | description    |  Oui   |  |
| author, contributor |        | managingEditor, webMaster |        |  |
| right          |        | copyright      |        |  |
| generator      |        | generator      |        |  |
| category       |        | category       |        |  |
| icon, logo     |        | image          |        |  |
|                |        | language       |        |  |
|                |        | docs           |        |  |
|                |        | cloud          |        |  |
|                |        | ttl            |        |  |
|                |        | rating         |        |  |
|                |        | textInput      |        |  |
|                |        | skipHours      |        |  |
|                |        | skipDays       |        |  |

Informations d'élément de flux :

^ RSS           ^ Requis ^ Atom            ^ Requis ^ Remarque ^
|                |        | id             | Oui    |  |
| title          |        | title          | Oui    |  |
| description    |        | summary        |        |  |
|                |        | content        |        |  |
| link           |        | link           |        | Atom : Multiple |
|                |        | link[rel=“alternate”]  |        |  |
| author         |        | author         |        |  |
| category       |        | category       |        | Atom : Multiple |
| pubDate        |        | published      |        |  |
| pubDate        |        | updated        | Oui    |  |
| source         |        | source         |        |  |
| giud           |        |                |        |  |
| comments       |        |                |        |  |
| enclosure      |        |                |        |  |
|                |        | contributors   |        | Atom : Multiple |
|                |        | rights         |        |  |