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