RSS - Elementi del feed
ID feed:
Identifica il feed utilizzando un URI universalmente unico e permanente. Se hai un contratto di locazione a lungo termine e rinnovabile per il tuo nome di dominio Internet, puoi sentirti libero di utilizzare l'indirizzo del tuo sito web.
Sintassi
<id>http://tutorialspoint.com/</id>necessario
Necessario.
Titolo del feed
Contiene un titolo leggibile dall'uomo per il feed. Spesso uguale al titolo del sito Web associato. Questo valore non deve essere vuoto.
Sintassi
<title>Tutorials and Reference Manuals</title>necessario
Necessario.
Data di aggiornamento del feed
Indica l'ultima volta che il Feed è stato modificato in modo significativo. Tutti i timestamp in Atom devono essere conformi a RFC 3339.
Sintassi
<updated>2007-07-13T18:30:02Z</updated>necessario
Necessario.
Autore del feed
Nomina un autore del feed. Un feed può avere più elementi dell'autore. Un feed deve contenere almeno un elemento autore, a meno che tutti gli elementi della voce non contengano almeno un elemento autore.
Un elemento autore può avere tag <name>, <email> e <uri>.
Sintassi
<author>
<name>Mohtashim</name>
<email>[email protected]</email>
<uri>http://tutorialspoint.com/</uri>
</author>necessario
Facoltativo, ma consigliato.
Collegamento feed
Ciò identifica una pagina Web correlata. Il tipo di relazione è definito dall'attributo rel . Un feed è limitato a un'alternativa per tipo e hreflang . Un feed dovrebbe contenere un collegamento al feed stesso.
Sintassi
<link>rel="self" href="/feed"</link>necessario
Facoltativo, ma consigliato.
Categoria feed
Specifica una categoria a cui appartiene il feed. Un feed può avere più elementi di categoria.
Sintassi
<category>category term="sports"</category>necessario
Opzionale.
Collaboratore del feed
Questo nomina un collaboratore del feed. Un feed può avere più elementi contributori.
Sintassi
<contributor>
<name>Mohtashim</name>
</contributor>necessario
Opzionale.
Generatore di mangime
Identifica il software utilizzato per generare il feed, per il debug e altri scopi. Entrambi gli attributi uri e version sono opzionali.
Sintassi
<generator uri="/myblog.php" version="1.0">Example Toolkit</generator>necessario
Opzionale.
icona Tag
Questo identifica una piccola immagine, che fornisce un'identificazione visiva iconica per il feed. Le icone dovrebbero essere quadrate.
Sintassi
<icon>/icon.jpg</icon>necessario
Opzionale.
Tag logo
Ciò identifica un'immagine più grande, che fornisce l'identificazione visiva per il feed. Le immagini dovrebbero essere larghe il doppio di quanto sono alte.
Sintassi
<logo>/logo.jpg</logo>necessario
Opzionale.
Tag dei diritti
Questo trasmette informazioni sui diritti, ad esempio i diritti d'autore, detenuti nel e sul Feed.
Sintassi
<rights> © 2007 TutorialsPoint.com </rights>necessario
Opzionale.
tag sottotitoli
Contiene una descrizione o un sottotitolo leggibile per il feed.
Sintassi
<subtitle>A sub title </subtitle><entry> Elementi
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.
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> completa la storia qui </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 qualsiasi 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 relativo 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.