Atom Publishing Protocol.docx
《Atom Publishing Protocol.docx》由会员分享,可在线阅读,更多相关《Atom Publishing Protocol.docx(53页珍藏版)》请在冰豆网上搜索。
AtomPublishingProtocol
NetworkWorkingGroupM.Nottingham,Ed.
RequestforComments:
4287R.Sayre,Ed.
Category:
StandardsTrackDecember2005
TheAtomSyndicationFormat
StatusofThisMemo
ThisdocumentspecifiesanInternetstandardstrackprotocolforthe
Internetcommunity,andrequestsdiscussionandsuggestionsfor
improvements.Pleaserefertothecurrenteditionofthe"Internet
OfficialProtocolStandards"(STD1)forthestandardizationstate
andstatusofthisprotocol.Distributionofthismemoisunlimited.
CopyrightNotice
Copyright(C)TheInternetSociety(2005).
Abstract
ThisdocumentspecifiesAtom,anXML-basedWebcontentandmetadata
syndicationformat.
TableofContents
1.Introduction....................................................3
1.1.Examples...................................................3
1.2.NamespaceandVersion......................................5
1.3.NotationalConventions.....................................5
2.AtomDocuments..................................................6
3.CommonAtomConstructs..........................................7
3.1.TextConstructs............................................7
3.1.1.The"type"Attribute................................8
3.2.PersonConstructs.........................................10
3.2.1.The"atom:
name"Element............................10
3.2.2.The"atom:
uri"Element.............................10
3.2.3.The"atom:
email"Element...........................10
3.3.DateConstructs...........................................10
4.AtomElementDefinitions.......................................11
4.1.ContainerElements........................................11
4.1.1.The"atom:
feed"Element............................11
4.1.2.The"atom:
entry"Element...........................13
4.1.3.The"atom:
content"Element.........................14
4.2.MetadataElements.........................................17
4.2.1.The"atom:
author"Element..........................17
4.2.2.The"atom:
category"Element........................18
4.2.3.The"atom:
contributor"Element.....................18
4.2.4.The"atom:
generator"Element.......................18
4.2.5.The"atom:
icon"Element............................19
4.2.6.The"atom:
id"Element..............................19
4.2.7.The"atom:
link"Element............................21
4.2.8.The"atom:
logo"Element............................23
4.2.9.The"atom:
published"Element.......................23
4.2.10.The"atom:
rights"Element.........................24
4.2.11.The"atom:
source"Element.........................24
4.2.12.The"atom:
subtitle"Element.......................25
4.2.13.The"atom:
summary"Element........................25
4.2.14.The"atom:
title"Element..........................25
4.2.15.The"atom:
updated"Element........................25
5.SecuringAtomDocuments........................................26
5.1.DigitalSignatures........................................26
5.2.Encryption................................................27
5.3.SigningandEncrypting....................................28
6.ExtendingAtom.................................................28
6.1.ExtensionsfromNon-AtomVocabularies.....................28
6.2.ExtensionstotheAtomVocabulary.........................28
6.3.ProcessingForeignMarkup.................................28
6.4.ExtensionElements........................................29
6.4.1.SimpleExtensionElements..........................29
6.4.2.StructuredExtensionElements......................29
7.IANAConsiderations............................................30
7.1.RegistryofLinkRelations................................31
8.SecurityConsiderations........................................31
8.1.HTMLandXHTMLContent....................................31
8.2.URIs......................................................31
8.3.IRIs......................................................31
8.4.Spoofing..................................................31
8.5.EncryptionandSigning....................................32
9.References.....................................................32
9.1.NormativeReferences......................................32
9.2.InformativeReferences....................................34
AppendixA.Contributors..........................................35
AppendixB.RELAXNGCompactSchema...............................35
1.Introduction
AtomisanXML-baseddocumentformatthatdescribeslistsofrelated
informationknownas"feeds".Feedsarecomposedofanumberof
items,knownas"entries",eachwithanextensiblesetofattached
metadata.Forexample,eachentryhasatitle.
TheprimaryusecasethatAtomaddressesisthesyndicationofWeb
contentsuchasweblogsandnewsheadlinestoWebsitesaswellas
directlytouseragents.
1.1.Examples
Abrief,single-entryAtomFeedDocument:
xmlversion="1.0"encoding="utf-8"?
>
//www.w3.org/2005/Atom">
ExampleFeed
//example.org/"/>
2003-12-13T18:
30:
02Z
JohnDoe
urn:
uuid:
60a76c80-d399-11d9-b93C-0003939e0af6
Atom-PoweredRobotsRunAmok
//example.org/2003/12/13/atom03"/>
urn:
uuid:
1225c695-cfb8-4ebb-aaaa-80da344efa6a
2003-12-13T18:
30:
02Z
Sometext.
Amoreextensive,single-entryAtomFeedDocument:
xmlversion="1.0"encoding="utf-8"?
>
//www.w3.org/2005/Atom">
diveintomark
A<em>lot</em>ofeffort
wentintomakingthiseffortless
2005-07-31T12:
29:
29Z
tag:
example.org,2003:
3
hreflang="en"href="http:
//example.org/"/>
href="http:
//example.org/feed.atom"/>
Copyright(c)2003,MarkPilgrim
ExampleToolkit
Atomdraft-07snapshot
href="http:
//example.org/2005/04/02/atom"/>
href="http:
//example.org/audio/ph34r_my_podcast.mp3"/>
tag:
example.org,2003:
3.2397
2005-07-31T12:
29:
29Z
2003-12-13T08:
29:
29-04:
00
MarkPilgrim
http:
//example.org/
f8dy@
SamRuby
JoeGregorio
lang="en"
xml:
base="http:
//diveintomark.org/">
//www.w3.org/1999/xhtml">
[Update:
TheAtomdraftisfinished.]
Forconvenience,thisdataformatmaybereferredtoas"Atom1.0".
Thisspecificationuses"Atom"internally.
placessomerequirementsonAtomProcessors.
ofnamespaceprefixisarbitraryandnotsemanticallysignificant.
toanAttributeInformationItem.
completeschemaappearsinAppendixB.
scopedtothoseconformancetargets.
DocumentsandAtomEntryDocuments.
feedelement.
entryelement.
bevalid(inthesenseusedbyXML).