OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

dita message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: MIME type for DITA - RFC, redux


Hello, Jamie. I'd like to request a new look at the subject topic, originated here:
http://lists.oasis-open.org/archives/dita/200806/msg00008.html.

Whatever previous email I had with you has been lost with my retirement from IBM, although I don't recall that much progress had been made as of that time. A search on the dita list does not bring up any response shared here either, so let's try again. Requoting from that message,

The OASIS DITA Technical Committee today approved the following MIME Type RFC for carrying forward to IANA:

(See attached file: DITAMIMETypeRFC.txt)

Please let the Technical Committee know if we should supply anything else in support of the RFC process.

--
Don Day,
Chair, OASIS DITA Technical Committee
                  The 'application/dita+xml' Media Type


Status of this Memo

   This memo provides information for the Internet community.  It does
   not specify an Internet standard of any kind.  Distribution of this
   memo is unlimited.


Copyright Notice

   Copyright (C) The Internet Society (2008).  All Rights Reserved.


Abstract

   This document defines the 'application/dita+xml' MIME media type
   for objects conforming to DITA markup vocabularies.


1. Introduction

   The Darwin Information Typing Architecture (DITA) is an OASIS
   standard that provides a XML-based architecture for content objects
   and for collection objects with references to content objects.

   Because of their granularity, DITA content objects are well-suited
   for transfer over the Internet and intranets.  Because DITA defines
   special processing rules for collection and content objects
   including fallback processing and placeholder-based transclusion,
   adopters benefit if these objects can be routed to DITA-aware
   processors.

   This document registers a new MIME media type for use with DITA
   content and collection objects defined by the OASIS DITA Standard.
   It does not define the DITA standard, which is maintained at OASIS.

   The DITA MIME type follows the standard convention established for
   XML media types by [XMLMIME].

   This document was prepared by the DITA OASIS Technical Committee.
   Please provide comments to the Technical Committee using
   <http://www.oasis-open.org/committees/comments/index.php?wg_abbrev=dita>

   Archives of comments to the Technical Committee are provided at
   <http://lists.oasis-open.org/archives/dita-comment/>


2. Registration of MIME media type application/dita+xml

   Type name:               application
   Subtype name:            dita+xml
   Required parameters:     none
   Optional parameters:

      charset
         The parameter for the "application/xml" media type
         standardized by [XMLMIME].

      format
         The identifier for the base vocabulary of the object.

      type
         The identifier for the specialized vocabulary of the root
         element of the object.

      title
         A distinguishing name or heading for the object consisting of
         text with no embedded markup.  The text of the full title
         in an object may be ellided to a meaningful fragment.

      The format, type, and title parameters correspond to the format
      and type attributes of the DITA map and to the title element of
      the DITA map and topic.  (See [DITVOCAB].)

      While the parameters are optional, the use of the charset and
      format parameters is strongly encouraged.  Knowledge of the
      character set and base vocabulary will be essential for correct
      processing of DITA objects in most applications.

   Encoding considerations:
      Because of its XML representation, DITA has the same encoding 
      considerations as XML.  (See [XMLMIME].)

   Security considerations:
      By virtue of being XML, DITA has the same fundamental security
      considerations as XML.  (See [XMLMIME].)

	  In addition, specialized DITA vocabularies could have semantics
      and processing expectations that (if acted on) posed security
      issues.  The base DITA vocabularies and core specialized
      vocabularies, however, do not pose such issues, and DITA
      processors are not required to recognize specialized semantics.

   Interoperability considerations:
      DITA specifies an architecture for extending a general
      vocabulary with a specialized vocabulary, a set of base
      vocabularies (identifiable with the format parameter), and a set
      of core vocabularies specialized according to the rules of the
      architecture. (See [DITARCH].)

      A new vocabulary that follows the rules of the DITA architecture
      in specializing from a DITA base or specialized vocabulary
      conforms to the DITA standard.

      DITA objects are instances of conformant DITA
      vocabularies. Because such objects can be generalized to less
      specialized vocabularies (including the base vocabulary), a DITA
      object is processable by any DITA-aware processor that, at a
      minimum, understands the base vocabulary.

   Published specification:
      DITA is defined by an OASIS specification maintained by the DITA
      OASIS Technical Committee (<http://www.oasis-open.org/committees/dita>).

   Applications that use this media type:
      This type is being registered to allow for deployment of DITA on
      the Internet as well as on intranets as a first-class XML
      application so DITA objects can be routed efficiently to
      DITA-aware processors.

      Content management systems and other systems may also use the
      DITA media type to allow management and identification of DITA
      objects without the need to open and process each object.

   Additional information:

      Magic number(s):
         As XML documents, DITA objects have no initial byte sequence.

         A DITA object has a root element with a DITAArchVersion
         attribute in the
         <http://dita.oasis-open.org/architecture/2005/DITAArchVersion>
         namespace or has a <dita> root element that contains a list
         of DITA objects that have the DITAArchVersion attribute and
         specialize the topic base vocabulary.

      File extension(s):
         Typical file extensions include ".dita" (for content objects
         of vocabularies specialized from the base DITA topic
         vocabulary), ".ditamap" (for collection objects of the
         vocabularies specialized from the base DITA map vocabulary),
         and ".ditaval" (for objects of the DITA conditional values
         vocabulary).

         The ".xml" extension is used sometimes in place of the
         ".dita" extension but the latter is preferred.

      Macintosh file type code(s):
         TEXT as with other XML documents.

   Persons & email addresses to contact for further information:
      Jamie Clark (OASIS staff liason) <jamie.clark@oasis-open.org>

   Intended usage:                COMMON
   Restrictions on usage:         NONE
   Author / Change controller:    OASIS DITA Technical Committee


3. References

   [DITARCH]   Priestley, M., Anderson, R. and Hackos, J., "OASIS DITA
               Version 1.1 Language Specification," 1 August 2007.
               Available at
               <http://docs.oasis-open.org/dita/v1.1/archspec/archspec.html>

   [DITVOCAB]  Priestley, M., Anderson, R. and Hackos, J., "OASIS DITA
               Version 1.1 Architectural Specification," 1 August 2007. 
               Available at
               <http://docs.oasis-open.org/dita/v1.1/langspec/ditaref-type.html>

   [URI]       Berners-Lee, T., Fielding, R. and L. Masinter, "Uniform
               Resource Identifier (URI): Generic Syntax", RFC 3986,
               January 2005.

   [XMLMIME]   Murata, M., St.Laurent, S. and D. Kohn, "XML Media
               Types", RFC 3023, January 2001.


4. Full Copyright Statement

   Copyright (C) The Internet Society (2008).  All Rights Reserved.

   This document and translations of it may be copied and furnished to
   others, and derivative works that comment on or otherwise explain it
   or assist in its implementation may be prepared, copied, published
   and distributed, in whole or in part, without restriction of any
   kind, provided that the above copyright notice and this paragraph are
   included on all such copies and derivative works.  However, this
   document itself may not be modified in any way, such as by removing
   the copyright notice or references to the Internet Society or other
   Internet organizations, except as needed for the purpose of
   developing Internet standards in which case the procedures for
   copyrights defined in the Internet Standards process must be
   followed, or as required to translate it into languages other than
   English.

   The limited permissions granted above are perpetual and will not be
   revoked by the Internet Society or its successors or assigns.

   This document and the information contained herein is provided on an
   "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING
   TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING
   BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION
   HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF
   MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]