RSS - Éléments de fil
ID de flux:
Il identifie le flux à l'aide d'un URI universel unique et permanent. Si vous avez un bail à long terme renouvelable sur votre nom de domaine Internet, vous pouvez utiliser l'adresse de votre site Web.
Syntaxe
<id>http://tutorialspoint.com/</id>Obligatoire
Obligatoire.
Titre du flux
Il contient un titre lisible par l'homme pour le flux. Souvent identique au titre du site Web associé. Cette valeur ne doit pas être vide.
Syntaxe
<title>Tutorials and Reference Manuals</title>Obligatoire
Obligatoire.
Date de mise à jour du flux
Il indique la dernière fois que le flux a été modifié de manière significative. Tous les horodatages dans Atom doivent être conformes à la RFC 3339.
Syntaxe
<updated>2007-07-13T18:30:02Z</updated>Obligatoire
Obligatoire.
Auteur du flux
Il nomme un auteur du flux. Un flux peut avoir plusieurs éléments d'auteur. Un flux doit contenir au moins un élément auteur, sauf si tous les éléments d'entrée contiennent au moins un élément auteur.
Un élément author peut avoir des balises <name>, <email> et <uri>.
Syntaxe
<author>
<name>Mohtashim</name>
<email>[email protected]</email>
<uri>http://tutorialspoint.com/</uri>
</author>Obligatoire
Facultatif, mais recommandé.
Lien d'alimentation
Cela identifie une page Web associée. Le type de relation est défini par l' attribut rel . Un flux est limité à une alternative par type et par hreflang . Un flux doit contenir un lien vers le flux lui-même.
Syntaxe
<link>rel="self" href="/feed"</link>Obligatoire
Facultatif, mais recommandé.
Catégorie d'alimentation
Cela spécifie une catégorie à laquelle appartient le flux. Un flux peut avoir plusieurs éléments de catégorie.
Syntaxe
<category>category term="sports"</category>Obligatoire
Optionnel.
Contributeur de flux
Cela nomme un contributeur au flux. Un flux peut avoir plusieurs éléments contributeurs.
Syntaxe
<contributor>
<name>Mohtashim</name>
</contributor>Obligatoire
Optionnel.
Générateur d'alimentation
Cela identifie le logiciel utilisé pour générer le flux, pour le débogage et à d'autres fins. Les attributs uri et version sont facultatifs.
Syntaxe
<generator uri="/myblog.php" version="1.0">Example Toolkit</generator>Obligatoire
Optionnel.
icône Tag
Cela identifie une petite image, qui fournit une identification visuelle emblématique pour le flux. Les icônes doivent être carrées.
Syntaxe
<icon>/icon.jpg</icon>Obligatoire
Optionnel.
étiquette de logo
Cela identifie une image plus grande, qui fournit une identification visuelle pour le flux. Les images doivent être deux fois plus larges que hautes.
Syntaxe
<logo>/logo.jpg</logo>Obligatoire
Optionnel.
Balise de droits
Cela transmet des informations sur les droits, par exemple les droits d'auteur, détenus dans et sur le flux.
Syntaxe
<rights> © 2007 TutorialsPoint.com </rights>Obligatoire
Optionnel.
Balise de sous-titre
Celui-ci contient une description ou un sous-titre lisible par l'homme pour le flux.
Syntaxe
<subtitle>A sub title </subtitle>Éléments <entry>
Un flux Atom peut contenir un ou plusieurs éléments d'entrée. Voici une liste des éléments de flux obligatoires et facultatifs.
ID d'entrée
Cela identifie l'entrée à l'aide d'un URI universel unique et permanent. Deux entrées dans un flux peuvent avoir la même valeur pour id si elles représentent la même entrée à des moments différents.
Syntaxe
<id>http://example.com/blog/1234</id>Obligatoire
Obligatoire.
Titre de l'entrée
Celui-ci contient un titre lisible par l'homme pour l'entrée. Cette valeur ne doit pas être vide.
Syntaxe
<title>Atom 1.0 Tutorial</title>Obligatoire
Obligatoire.
Date de mise à jour de l'entrée
Cela indique la dernière fois que l'entrée a été modifiée de manière significative. Cette valeur n'a pas besoin de changer après qu'une faute de frappe est corrigée, seulement après une modification substantielle. En règle générale, différentes entrées dans un flux auront des horodatages mis à jour différents.
Syntaxe
<updated>2007-07-13T18:30:02-05:00</updated>Obligatoire
Obligatoire.
Auteur de l'entrée
Cela nomme un auteur de l'entrée. Une entrée peut avoir plusieurs auteurs. Une entrée doit contenir au moins un élément author, sauf s'il existe un élément author dans le flux englobant ou s'il existe un élément author dans l'élément source inclus.
Syntaxe
<author>
<name>Mohtashim</name>
</author>Obligatoire
Facultatif, mais recommandé.
Contenu de l'entrée
Celui-ci contient ou renvoie au contenu complet de l'entrée. Le contenu doit être fourni s'il n'y a pas de lien alternatif et doit être fourni s'il n'y a pas de résumé.
Syntaxe
<content> histoire complète ici </content>
Obligatoire
Facultatif, mais recommandé.
Lien d'entrée
Cela identifie une page Web associée. Le type de relation est défini par l' attribut rel . Une entrée est limitée à une alternative par type et hreflang . Une entrée doit contenir un autre lien s'il n'y a pas d'élément de contenu.
Syntaxe
<link rel="alternate" href="/blog/1234"/>Obligatoire
Facultatif, mais recommandé.
Résumé de l'entrée
Cela transmet un bref résumé, un résumé ou un extrait de l'entrée. Un résumé doit être fourni s'il n'y a pas de contenu fourni pour l'entrée, ou si ce contenu n'est pas en ligne.
Syntaxe
<summary>Some text.</summary>Obligatoire
Facultatif, mais recommandé.
Catégorie d'entrée
Cela spécifie une catégorie à laquelle appartient l'entrée. Une entrée peut avoir plusieurs éléments de catégorie.
Syntaxe
<category term="education"/>Obligatoire
Optionnel.
Distributeur d'entrée
Cela nomme un contributeur à l'entrée. Une entrée peut avoir plusieurs éléments contributeurs.
Syntaxe
<contributor>
<name>Mohtashim</name>
</contributor>Obligatoire
Optionnel.
Tag publié
Celui-ci contient l'heure de la création initiale ou de la première disponibilité de l'entrée.
Syntaxe
<published>2007-07-13T09:17:51-08:00</published>Obligatoire
Optionnel.
Source d'entrée
Si une entrée est copiée d'un flux dans un autre flux, les métadonnées du flux source (tous les éléments enfants du flux autres que les éléments d'entrée) doivent être conservées si le flux source contient l'un des éléments enfants auteur, contributeur, droits ou catégorie. et ces éléments enfants ne sont pas présents dans l'entrée source.
Syntaxe
<source>
<id>http://moretutorials.org/</id>
<title>Tutorials and Reference Manuals</title>
<updated>2007-07-13T18:30:02Z</updated>
<rights>© 2007 More Tutorials.</rights>
</source>Obligatoire
Optionnel.
Droits d'entrée
Cela transmet des informations sur les droits, par exemple les droits d'auteur, détenus dans et sur l'entrée.
Syntaxe
<rights type="html">© 2007 TutorialsPoint.com</rights>Obligatoire
Optionnel.
Constructions communes
Catégorie
<category> a un attribut, un terme et deux attributs facultatifs, un schéma et une étiquette .
terme identifie la catégorie.
schéma identifie le schéma de catégorisation via un URI.
label fournit une étiquette lisible par l'homme pour l'affichage.
Contenu
<content> contient, ou des liens vers, le contenu complet de l'entrée.
Dans le cas le plus courant, l' attribut type est soit text , html , xhtml , auquel cas l'élément de contenu est défini de la même manière que les autres constructions de texte.
Sinon, si l' attribut src est présent, il représente l'URI d'où le contenu peut être trouvé. L' attribut type , s'il est présent, est le type de média du contenu.
Sinon, si l' attribut type se termine par + xml ou / xml , un document xml de ce type est contenu en ligne.
Sinon, si l' attribut type commence par du texte , un document échappé de ce type est contenu en ligne.
Sinon, un document codé en base64 du type de support indiqué est contenu en ligne.
Lien
<link> est calqué sur l' élément link de html . Il a un attribut obligatoire, href , et cinq attributs facultatifs: rel , type , hreflang , title et length .
href est l'URI de la ressource référencée (généralement une page Web).
rel contient un seul type de relation de lien. Il peut s'agir d'un URI complet ou de l'une des valeurs prédéfinies suivantes (par défaut = alternative) :
- alternative : une représentation alternative de l'entrée ou du flux, par exemple un lien permanent vers la version html de l'entrée ou la page d'accueil du blog.
- boîtier : une ressource associée, qui est potentiellement de grande taille et peut nécessiter un traitement spécial, par exemple un enregistrement audio ou vidéo.
- associé : un document lié à l'entrée ou au flux.
- self : le Feed lui-même.
- via : La source des informations fournies dans l'entrée.
type indique le type de média de la ressource.
hreflang indique la langue de la ressource référencée.
title indique les informations lisibles par l'homme sur le lien, généralement à des fins d'affichage.
length indique la longueur de la ressource, en octets.
La personne
<auteur> et <contributeur> décrivent une personne, une société ou une entité similaire. Il a un élément obligatoire, un nom et deux éléments facultatifs: uri , email .
<nom> transmet un nom lisible par l'homme à la personne.
<uri> contient une page d'accueil pour la personne.
<email> contient une adresse e-mail pour la personne.
Texte
<title> , <summary> , <content> et <rights> contiennent du texte lisible par l'homme, généralement en petites quantités. L' attribut type détermine comment ces informations sont codées (par défaut = "texte").
Si type = "text" , cet élément contient du texte brut sans aucune entité html échappée.
<title type="text">AT&T bought by SBC!</title>Si type = "html" , cet élément contient une entité html échappée.
<title type="html">AT&amp;T bought <b>by SBC</b>!</title>Si type = "xhtml" , cet élément contient du xhtml en ligne, enveloppé dans un élément div.
<title type="xhtml">
<div xmlns="http://www.w3.org/1999/xhtml">
AT&T bought <b>by SBC</b>!
</div>
</title>Exemple de flux Atom 1.0
L'exemple montre comment écrire un flux à l'aide d'Atom 1.0.
<?xml version="1.0" encoding="utf-8"?>
<feed xmlns="http://www.w3.org/2005/Atom">
<title>Example Feed</title>
<subtitle>Insert witty or insightful remark here</subtitle>
<link href="http://example.org/"/>
<updated>2003-12-13T18:30:02Z</updated>
<author>
<name>Mohtashim</name>
<email>[email protected]</email>
</author>
<id>urn:uuid:60a76c80-d399-11d9-b93C-0003939e0af6</id>
<entry>
<title>Tutorial on Atom</title>
<link href="http://example.org/2003/12/13/atom03"/>
<id>urn:uuid:1225c695-cfb8-4ebb-aaaa-80da344efa6a</id>
<updated>2003-12-13T18:30:02Z</updated>
<summary>Some text.</summary>
</entry>
</feed>Extension de fichier Atom1.0:
Une extension de fichier spécifique pour un document Atom 1.0 n'est pas requise. Mais .xml est recommandé.