From: http://www.ietf.org/internet-drafts/draft-snell-atompub-inline-00.txt Title: The Atom Link "inline" Extension Reference: draft-snell-atompub-inline-00.txt Date: August 22, 2010 HTML: http://tools.ietf.org/id/draft-snell-atompub-inline-00.html Data Tracker: https://datatracker.ietf.org/doc/draft-snell-atompub-inline/ Tracker Listing: http://ietfreport.isoc.org/idref/draft-snell-atompub-inline/ Tools: http://tools.ietf.org/html/draft-snell-atompub-inline-00 (HTML) Announced: http://www.ietf.org/mail-archive/web/i-d-announce/current/msg32763.html See also: Mailing List Archive for atom-syntax http://www.imc.org/atom-syntax/ Mailing List Archive for atom-protocol http://www.imc.org/atom-protocol/ http://xml.coverpages.org/atom.html Atom Publishing Format and Protocol http://xml.coverpages.org/AtomSpecs.html Atom Specifications =============================================================================== Network Working Group J. Snell Internet-Draft August 22, 2010 Updates: 4287 (if approved) Intended status: Informational Expires: February 23, 2011 The Atom Link "inline" Extension draft-snell-atompub-inline-00.txt Abstract This specification adds a mechanism to the Atom Syndication Format which publishers of Atom Feed and Entry documents can use to embed representations of linked resources into a child element of the atom: link element. Status of this Memo This Internet-Draft is submitted to IETF in full conformance with the provisions of BCP 78 and BCP 79. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF). Note that other groups may also distribute working documents as Internet-Drafts. The list of current Internet- Drafts is at http://datatracker.ietf.org/drafts/current/. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress." This Internet-Draft will expire on February 23, 2011. Copyright Notice Copyright (c) 2010 IETF Trust and the persons identified as the document authors. All rights reserved. This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License. Snell Expires February 23, 2011 [Page 1] Internet-Draft Atom inline August 2010 Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3 2. Notational Conventions . . . . . . . . . . . . . . . . . . . . 3 3. The 'atom:inline' element . . . . . . . . . . . . . . . . . . . 3 4. Security Considerations . . . . . . . . . . . . . . . . . . . . 4 5. IANA Considerations . . . . . . . . . . . . . . . . . . . . . . 5 6. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . 5 7. Normative References . . . . . . . . . . . . . . . . . . . . . 5 Author's Address . . . . . . . . . . . . . . . . . . . . . . . . . 6 Snell Expires February 23, 2011 [Page 2] Internet-Draft Atom inline August 2010 1. Introduction TBD 2. Notational Conventions 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, [RFC2119] This specification uses XML Namespaces [W3C.REC-xml-names-19990114] to uniquely identify XML element names. It uses the following namespace prefix for the indicated namespace URI; "atom": "http://www.w3.org/2005/Atom" 3. The 'atom:inline' element The atom:inline element MAY be used as the child of an atom:link element to embed representations of the resource referenced by the containing atom:link. inline = element atom:inline { atomCommonAttributes, attribute type { atomMediaType }?, (text|anyElement)* } The atom:inline element MAY contain a type attribute whose value specifies the MIME media type of the representation contained by the element. If the type attribute is not provided, Atom Processors MUST behave as though the type attribute were present with a value equal to that specified by the containing atom:link elements type attribute. The value of the type attribute MUST NOT be a composite type as specified by Section 4.2.6 of [MIMEREG]. An atom:link element MAY contain any number of atom:inline elements, but MUST NOT contain more than one with the same type attribute value. If the value of the type attribute begins with "text/" (case insensitive), the content of atom:inline MUST NOT contain child elements. If the value of the type attribute is an XML media type [RFC3023] or ends with "+xml" or "/xml" (case insensitive), the content of the Snell Expires February 23, 2011 [Page 3] Internet-Draft Atom inline August 2010 atom:inline element MAY include child elements and SHOULD be suitable for handling as the indicated media type. This would normally mean that the atom:inline element would contain a single child element that would serve as the root element of the XML document of the indicated type. For all other values of the type attribute, the content of atom: inline MUST be a valid Base64 encoding, as described in [RFC3548], section 3. When decoded, it SHOULD be suitable for handling as the indicated media type. In this case, the characters in the Base64 encoding MAY be preceded and followed in the atom:inline element by white space, and lines are separated by a single newline (U+000A) character. ... ... This is an example ew0KICAiaWQiOiJodHRwOi8vZXhhbXBsZS5vcm cvZm9vIiwNCiAgInRpdGxlIjoiZm9vIg0KfQ== ... ... The atom:inline element MAY have an xml:base attribute [W3C.REC-xmlbase-20010627]. When xml:base is used, it serves the function described in section 5.1.1 of [RFC3986], establishing the base URI (or IRI) for resolving any relative references found within the effective scope of the xml:base attribute. The atom:inline element MAY have an xml:lang attribute, whose content indicates the natural language for the element and its descendents. Requirements regarding the content and interpretation of xml:lang are specified in XML 1.0 [W3C.REC-xml-20040204], Section 2.12. 4. Security Considerations TBD Snell Expires February 23, 2011 [Page 4] Internet-Draft Atom inline August 2010 5. IANA Considerations TBD 6. Acknowledgements The author gratefully acknowledges the feedback from the members of the Atom Publishing Format and Protocol working group during the development of this specification. 7. Normative References [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997. [RFC3023] Murata, M., St. Laurent, S., and D. Kohn, "XML Media Types", RFC 3023, January 2001. [RFC3548] Josefsson, S., "The Base16, Base32, and Base64 Data Encodings", RFC 3548, July 2003. [RFC3986] Berners-Lee, T., Fielding, R., and L. Masinter, "Uniform Resource Identifier (URI): Generic Syntax", STD 66, RFC 3986, January 2005. [RFC4287] Nottingham, M., Ed. and R. Sayre, Ed., "The Atom Syndication Format", RFC 4287, December 2005. [W3C.REC-xml-20040204] Maler, E., Paoli, J., Yergeau, F., Bray, T., and C. Sperberg-McQueen, "Extensible Markup Language (XML) 1.0 (Third Edition)", World Wide Web Consortium FirstEdition REC-xml-20040204, February 2004, . [W3C.REC-xml-names-19990114] Hollander, D., Bray, T., and A. Layman, "Namespaces in XML", World Wide Web Consortium FirstEdition REC-xml- names-19990114, January 1999, . [W3C.REC-xmlbase-20010627] Marsh, J., "XML Base", World Wide Web Consortium FirstEdition REC-xmlbase-20010627, June 2001, . Snell Expires February 23, 2011 [Page 5] Internet-Draft Atom inline August 2010 Author's Address James M Snell Phone: Email: jasnell@us.ibm.com URI: http://ibm.com Snell Expires February 23, 2011 [Page 6]