Introduction to Atom
Check the syntax of Atom or RSS feeds
Atom is the name of an XML-based Web content and metadata syndication format, and an application-level protocol for publishing and editing Web resources belonging to periodically updated websites.
All Atom feeds must be well-formed XML documents, and are identified with the application/atom+xml media type.
This document focuses on The Atom Syndication Format produced by the IETF AtomPub Working Group. In the event that this document differs from the Internet Draft, the Internet Draft is to be considered authoritative.
<?xml version="1.0" encoding="utf-8"?> <feed xmlns="http://www.w3.org/2005/Atom"> <title>Example Feed</title> <link href="http://example.org/"/> <updated>2003-12-13T18:30:02Z</updated> <author> <name>John Doe</name> </author> <id>urn:uuid:60a76c80-d399-11d9-b93C-0003939e0af6</id> <entry> <title>Atom-Powered Robots Run Amok</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>Elements of <feed>
A Feed consists of some metadata, followed by any number of entries.Required feed elements
Here's a list of the required feed elements, each with a brief description, and an example.
<id>http://example.com/</id>Recommended feed elements
Atom makes a number of additional requirements and recommendations for feed elements that you should to be aware of. They are as follows:| Element | Description |
|---|---|
| author | Names one author of the feed. A feed may have multiple author elements. A feed must contain at least one author element unless all of the entry elements contain at least one author element. More info here. <author> <name>John Doe</name> <email>JohnDoe@example.com</email> <uri>http://example.com/~johndoe</uri> </author> |
| link | Identifies a related Web page. The type of relation is defined by the rel attribute. A feed is limited to one alternate per type and hreflang. A feed should contain a link back to the feed itself. More info here. <link rel="self" href="/feed" /> |
Optional feed elements
Here's a list of optional feed elements.
<category term="sports"/>Elements of <entry>
An example of an entry would be a single post on a weblog.Required Elements of <entry>
Here's a list of the required feed elements, each with a brief description, and an example.
<id>http://example.com/blog/1234</id>Recommended elements of <entry>
Atom makes a number of additional requirements and recommendations for entry elements that you should to be aware of. They are as follows:| Element | Description |
|---|---|
| author | Names one author of the entry. An entry may have multiple authors. An entry must contain at least one author element unless there is an author element in the enclosing feed, or there is an author element in the enclosed source element. More info here. <author> <name>John Doe</name> </author> |
| content | Contains or links to the complete content of the entry. Content must be provided if there is no alternate link, and should be provided if there is no summary. More info here. <content>complete story here</content> |
| link | Identifies a related Web page. The type of relation is defined by the rel attribute. An entry is limited to one alternate per type and hreflang. An entry must contain an alternate link if there is no content element. More info here. <link rel="alternate" href="/blog/1234"/> |
| summary | Conveys a short summary, abstract, or excerpt of the entry. Summary should be provided if there either is no content provided for the entry, or that content is not inline (i.e., contains a src attribute), or if the content is encoded in base64. More info here. <summary>Some text.</summary> |
Optional elements of <entry>
Here's a list of optional feed elements.
<category term="technology"/>Common Constructs
Category
<category> has one required attribute, term, and two optional attributes, scheme and label.
scheme identifies the categorization scheme via a URI.
label provides a human-readable label for display
<content> either contains, or links to, the complete content of the entry.
In the most common case, the type attribute is either text, html, xhtml, in which case the content element is defined identically to other text constructs, which are described here.
Otherwise, if the src attribute is present, it represents the URI of where the content can be found. The type attribute, if present, is the media type of the content.
Otherwise, if the type attribute ends in +xml or /xml, then an xml document of this type is contained inline.
Otherwise, if the type attribute starts with text, then an escaped document of this type is contained inline.
Otherwise, a base64 encoded document of the indicated media type is contained inline.
<link> is patterned after html's link element. It has one required attribute, href, and five optional attributes: rel, type, hreflang, title, and length.
href is the URI of the referenced resource (typically a Web page)
rel contains a single link relationship type. It can be a full URI (see extensibility), or one of the following predefined values (default=alternate):
type indicates the media type of the resource.
hreflang indicates the language of the referenced resource.
title human readable information about the link, typically for display purposes.
length the length of the resource, in bytes.
<author> and <contributor> describe a person, corporation, or similar entity. It has one required element, name, and two optional elements: uri, email.
<name> conveys a human-readable name for the person.
<uri> contains a home page for the person.
<email> contains an email address for the person.
<title>, <summary>, <content>, and <rights> contain human-readable text, usually in small quantities. The type attribute determines how this information is encoded (default="text")
If type="text", then this element contains plain text with no entity escaped html.
<title type="text">AT&T bought by SBC!</title>If type="html", then this element contains entity escaped html.
<title type="html"> AT&amp;T bought <b>by SBC</b>! </title>If type="xhtml", then this element contains inline xhtml, wrapped in a div element.
<title type="xhtml"> <div xmlns="http://www.w3.org/1999/xhtml"> AT&T bought <b>by SBC</b>! </div> </title>Extending Atom
The atom content element is designed to support the direct inclusion of other XML vocabularies.
Any fully qualified URI may be used a value for the rel attribute of link elements.
Elements from other namespaces may be included pretty much anywhere. This means that most RSS 1.0 and RSS 2.0 modules may be used in Atom.
Схожі новини
Takaichi visits Australia to bolster economic, defense ties
We’ll take it: a TikToker rallies pledges to buy Spirit Airlines after its abrupt weekend collapse
