Costrutti comuni
Categoria
<categoria> ha un attributo obbligatorio, un termine e due attributi opzionali, schema ed etichetta .
termine identifica la categoria.
schema identifica lo schema di categorizzazione tramite un URI.
label fornisce un'etichetta leggibile dall'uomo per la visualizzazione.
Soddisfare
<content> contiene o collega al contenuto completo della voce.
Nel caso più comune, l' attributo type è text , html , xhtml , nel qual caso l'elemento di contenuto è definito in modo identico ad altri costrutti di testo, che sono descritti qui.
Altrimenti, se l' attributo src è presente, rappresenta l'URI di dove è possibile trovare il contenuto. L' attributo type , se presente, è il tipo di media del contenuto.
Altrimenti, se l' attributo type termina con + xml o / xml , un documento xml di questo tipo è contenuto inline.
Altrimenti, se l' attributo type inizia con il testo , un documento con escape di questo tipo è contenuto inline.
Altrimenti, un documento con codifica base64 del tipo di supporto indicato è contenuto inline.
Link
<link> è modellato dopo l' elemento link di html . Ha un attributo obbligatorio, href e cinque attributi opzionali: rel , type , hreflang , title e length .
href è l'URI della risorsa di riferimento (in genere una pagina Web).
rel contiene un singolo tipo di relazione di collegamento. Può essere un URI completo o uno dei seguenti valori predefiniti (impostazione predefinita = alternativa) :
- alternativo : una rappresentazione alternativa della voce o del feed, ad esempio un permalink alla versione html della voce o la prima pagina del weblog.
- allegato : una risorsa correlata, che è potenzialmente di grandi dimensioni e potrebbe richiedere una gestione speciale, ad esempio una registrazione audio o video.
- correlato : un documento correlato alla voce o al feed.
- self : il Feed stesso.
- via : la fonte delle informazioni fornite nella voce.
tipo indica il tipo di supporto della risorsa.
hreflang indica la lingua della risorsa di riferimento.
il titolo indica le informazioni leggibili dall'uomo sul collegamento, in genere a scopo di visualizzazione.
length indica la lunghezza della risorsa, in byte.
Persona
<author> e <contributor> descrivono una persona, un'azienda o un'entità simile. Ha un elemento obbligatorio, un nome e due elementi opzionali: uri , email .
<name> trasmette un nome leggibile dall'uomo per la persona.
<uri> contiene una home page per la persona.
<email> contiene un indirizzo email per la persona.
Testo
<title> , <summary> , <content> e <rights> contengono testo leggibile dall'uomo, di solito in piccole quantità. L' attributo type determina come queste informazioni vengono codificate (default = "text").
Se type = "text" , allora questo elemento contiene testo normale senza codice HTML con escape di entità.
<title type="text">AT&T bought by SBC!</title>
Se type = "html" , questo elemento contiene HTML con escape di entità.
<title type="html">
AT&amp;T bought <b>by SBC</b>!
</title>
Se type = "xhtml" , questo elemento contiene xhtml inline, racchiuso in un elemento div.
<title type="xhtml">
<div xmlns="http://www.w3.org/1999/xhtml">
AT&T bought <b>by SBC</b>!
</div>
</title>
Controllare le specifiche complete per atom 1.0 RFC4287 .
Atom 1.0 Feed di esempio
L'esempio mostra come scrivere un feed utilizzando 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>
Estensione file Atom1.0
Non è richiesta un'estensione di file specifica per un documento Atom 1.0. Ma .xml è consigliato.