RSS - Elementi di ingresso
Un Atom Feed può contenere uno o più elementi di ingresso. Di seguito è riportato un elenco degli elementi Feed obbligatori e facoltativi.
ID voce
Questo identifica la voce utilizzando un URI universalmente unico e permanente. Due voci in un feed possono avere lo stesso valore per id se rappresentano la stessa voce in momenti diversi nel tempo.
Sintassi
<id>http://example.com/blog/1234</id>necessario
Necessario.
Titolo della voce
Contiene un titolo leggibile dall'uomo per la voce. Questo valore non deve essere vuoto.
Sintassi
<title>Atom 1.0 Tutorial</title>necessario
Necessario.
Data di aggiornamento della voce
Indica l'ultima volta che la voce è stata modificata in modo significativo. Questo valore non deve cambiare dopo che un errore di battitura è stato corretto, solo dopo una modifica sostanziale. In genere, voci diverse in un feed avranno timestamp aggiornati diversi.
Sintassi
<updated>2007-07-13T18:30:02-05:00</updated>necessario
Necessario.
Autore della voce
Questo nomina un autore della voce. Una voce può avere più autori. Una voce deve contenere almeno un elemento autore, a meno che non vi sia un elemento autore nel feed allegato o un elemento autore nell'elemento sorgente incluso.
Sintassi
<author>
<name>Mohtashim</name>
</author>necessario
Facoltativo, ma consigliato.
Contenuto della voce
Contiene o si collega al contenuto completo della voce. Il contenuto deve essere fornito se non è presente un collegamento alternativo e deve essere fornito se non è presente un riepilogo.
Sintassi
<content>complete story here</content>necessario
Facoltativo, ma consigliato.
Link di ingresso
Ciò identifica una pagina Web correlata. Il tipo di relazione è definito dall'attributo rel . Una voce è limitata a una voce alternativa per tipo e hreflang . Una voce deve contenere un collegamento alternativo se non è presente alcun elemento di contenuto.
Sintassi
<link rel="alternate" href="/blog/1234"/>necessario
Facoltativo, ma consigliato.
Riepilogo della voce
Questo trasmette un breve riassunto, un abstract o un estratto della voce. È necessario fornire un riepilogo se non è presente alcun contenuto per la voce o se il contenuto non è in linea.
Sintassi
<summary>Some text.</summary>necessario
Facoltativo, ma consigliato.
Categoria di ingresso
Specifica una categoria a cui appartiene la voce. Una voce può avere più elementi di categoria.
Sintassi
<category term="education"/>necessario
Opzionale.
Ingresso ontributor
Questo nomina un contributore alla voce. Una voce può avere più elementi contributori.
Sintassi
<contributor>
<name>Mohtashim</name>
</contributor>necessario
Opzionale.
Tag pubblicato
Contiene l'ora della creazione iniziale o della prima disponibilità della voce.
Sintassi
<published>2007-07-13T09:17:51-08:00</published>necessario
Opzionale.
Fonte di ingresso
Se una voce viene copiata da un feed in un altro feed, i metadati del feed di origine (tutti gli elementi secondari del feed diversi dagli elementi della voce) devono essere conservati se il feed di origine contiene uno degli elementi secondari autore, collaboratore, diritti o categoria e quegli elementi figlio non sono presenti nella voce di origine.
Sintassi:
<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>necessario
Opzionale.
Diritti di ingresso
Questo trasmette informazioni sui diritti, ad esempio i diritti d'autore, detenuti in e sopra l'iscrizione.
Sintassi
<rights type="html">© 2007 TutorialsPoint.com</rights>necessario
Opzionale.
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.
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 (predefinito = alternativo) :
- 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.
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" , 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>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.