One document matched: draft-snell-atompub-link-extensions-03.xml


<?xml version='1.0'?>
 <!DOCTYPE rfc SYSTEM "rfc2629.dtd" [
    <!ENTITY rfc2616 PUBLIC '' 
      'http://xml.resource.org/public/rfc/bibxml/reference.RFC.2616.xml'> 
    <!ENTITY rfc1864 PUBLIC '' 
      'http://xml.resource.org/public/rfc/bibxml/reference.RFC.1864.xml'> 
    <!ENTITY rfc2119 PUBLIC '' 
      'http://xml.resource.org/public/rfc/bibxml/reference.RFC.2119.xml'> 
    <!ENTITY rfc4287 PUBLIC '' 
      'http://xml.resource.org/public/rfc/bibxml/reference.RFC.4287.xml'> 
    <!ENTITY rfc3339 PUBLIC '' 
      'http://xml.resource.org/public/rfc/bibxml/reference.RFC.3339.xml'>  
    <!ENTITY xmlnames PUBLIC ''
      'http://xml.resource.org/public/rfc/bibxml4/reference.W3C.REC-xml-names-19990114.xml'> 
]>
<?rfc compact="yes" ?>
<?rfc toc="yes" ?>
<?rfc symrefs="yes" ?>
<?rfc sortrefs="yes"?>
<?rfc iprnotified="no" ?>
<?rfc strict="yes" ?>
<rfc category="info" ipr="trust200811" updates="4287" docName="draft-snell-atompub-link-extensions-03.txt"> 
<front> 
<title abbrev="Atom Link Extensions">Atom Link Extensions</title> 
<author initials="J.M." surname="Snell" fullname="James M Snell"> 
<organization></organization> 
<address> 
<postal> 
<street></street> 
<city></city> <region></region> <code></code> 
<country></country> 
</postal> 
<phone></phone> 
<email>jasnell@us.ibm.com</email> 
<uri>http://ibm.com</uri> 
</address> 
</author> 
<date month="May" year="2010" /> 
<area>General</area> 
<keyword>I-D</keyword> 
<keyword>Internet-Draft</keyword> 
<keyword>XML</keyword> 
<keyword>Extensible Markup Language</keyword> 
<keyword>Atom</keyword> 
<keyword>RSS</keyword> 
<keyword>Syndication</keyword> 
<abstract><t>This specification adds additional attributes to the Atom 
Syndication Format link and content elements that may be used to express 
additional metadata about linked resources.</t></abstract> 
</front> 
<middle> 
<section title="Introduction"> 
 
<t>This specification adds additional attribute to the Atom Syndication Format
<xref target="RFC4287" /> link and content elements that may be used to express
additional metadata about linked resources.</t>
 
</section> 
 
<section title="Notational Conventions"> 
 
<t>The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", 
"SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be 
interpreted as described in BCP 14, <xref target="RFC2119" /></t> 
 
<t>This specification uses XML Namespaces <xref target="W3C.REC-xml-names-19990114"/> 
to uniquely identify XML element names.  It uses the following namespace prefix 
for the indicated namespace URI;</t> 
 
<figure><artwork><![CDATA[ 
 "atom": "http://www.w3.org/2005/Atom" 
]]></artwork></figure> 
 
</section> 
 
<section title="The 'md5' attribute">

<t>The 'md5' Attribute specifies a MD5 digest <xref target="RFC1864" />
of the resource identified by the atom:link/@href or atom:content/@src attributes.
The value is represented as a sequence of 32 hexadecimal digits.  
The 'md5' attribute MAY appear as a child of the atom:link and atom:content 
elements.</t>

<figure><artwork><![CDATA[ 
  md5 = attribute md5 { md5-digest }
  md5-digest   = <hex of 128 bit MD5 digest as per RFC 1864>
]]></artwork></figure>

<t>An example MD5 digest of an enclosed MP3 file:</t>

<figure><artwork><![CDATA[
  <atom:link rel="enclosure"
    href="http://example.org/media/myfile.mp3"
    md5="9e107d9d372bb6826bd81d3542a419d6" />
]]></artwork></figure>

<t>The MD5 digest is computed based on the content of the entity-body as specified
by Section 14.15 of <xref target="RFC2616" />.</t>
          
</section>
 
<section title="The 'etag' attribute">

<t>The 'etag' Attribute specifies an Entity Tag <xref target="RFC2616"/> for the
resource identified by the atom:link or atom:content element.  The
'etag' attribute MAY appear as a child of the atom:link and atom:
content elements.</t>

<figure><artwork><![CDATA[
  etag = attribute le:etag { entity-tag }

  entity-tag = [ weak ] opaque-tag
  weak       = "W/"
  opaque-tag = quoted-string
]]></artwork></figure>

<t>An example Entity Tag for an enclosed MP3 file:</t>

<figure><artwork><![CDATA[
  <atom:link rel="enclosure"
     href="http://example.org/media/myfile.mp3"
     etag="W/xyzzy" />
]]></artwork></figure>

</section>

<section title="The 'modified' attribute">

<t>The 'modified' Attribute specifies the date and time when the
resource identified by the atom:link or atom:content element was last
modified. The value MUST conform to the "date-time" production defined by 
<xref target="RFC3339" />. An uppercase "T" character MUST be used to separate 
date and time, and an uppercase "Z" character MUST be present in the absence 
of a numeric time zone offset. The 'modified' attribute MAY appear 
as a child of the atom:link and atom:content elements.</t>

<figure><artwork><![CDATA[
  modified = attribute modified { xsd:dateTime }
]]></artwork></figure>

<t>An example last-modified attribute for an enclosed MP3 file:</t>

<figure><artwork><![CDATA[
  <atom:link rel="enclosure"
    href="http://example.org/media/myfile.mp3"
    modified="2010-12-12T12:12:12Z" />
]]></artwork></figure>

</section>
  
<section title="Security Considerations"> 
  <t>TBD</t> 
</section> 
 
<section title="IANA Considerations"> 
  
<t>No IANA actions are required by this document.</t> 
  
</section> 
 
</middle> 
 
<back> 
<references title="Normative References"> 
  &rfc1864;
  &rfc2119;
  &rfc2616;
  &rfc3339;
  &rfc4287;
  &xmlnames;
</references> 
</back> 
</rfc>

PAFTECH AB 2003-20262026-04-24 02:39:18