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, qui sont décrites ici.
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.
- connexe : un document lié à l'entrée ou au flux.
- self : Le flux 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>Vérifiez la spécification complète de l'atome 1.0 RFC4287 .
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é.