[xiph-commits] r3275 - standards
silvia at svn.annodex.net
silvia at svn.annodex.net
Sun Nov 18 12:26:35 PST 2007
Author: silvia
Date: 2007-11-18 12:26:35 -0800 (Sun, 18 Nov 2007)
New Revision: 3275
Added:
standards/cmml_3_1.dtd
Modified:
standards/cmml_3_0.dtd
standards/draft-pfeiffer-cmml-current.xml
Log:
Added the DTD for the new version 3.1 of CMML, including the caption element.
Fixed a typo in the DTD of 3.0.
Added "caption" to the content model of "clip" (damned late-night hacking).
Still need to run the thing through xml2rfc though...
Modified: standards/cmml_3_0.dtd
===================================================================
--- standards/cmml_3_0.dtd 2007-11-18 15:57:44 UTC (rev 3274)
+++ standards/cmml_3_0.dtd 2007-11-18 20:26:35 UTC (rev 3275)
@@ -12,7 +12,7 @@
This DTD module is identified by the PUBLIC and SYSTEM identifiers:
- PUBLIC "-//CSIRO//DTD CMML 2.1//EN"
+ PUBLIC "-//CSIRO//DTD CMML 3.0//EN"
SYSTEM "http://www.annodex.net/DTD/cmml_3_0.dtd"
$Revision: 3.0 $
Added: standards/cmml_3_1.dtd
===================================================================
--- standards/cmml_3_1.dtd (rev 0)
+++ standards/cmml_3_1.dtd 2007-11-18 20:26:35 UTC (rev 3275)
@@ -0,0 +1,407 @@
+<!--
+
+ Continuous Media Markup Language CMML version 3.1 DTD
+ Authoring language for ANNODEX(TM) media.
+
+ Namespace = http://www.annodex.net/cmml
+
+ Copyright (c) 2001-
+ Commonwealth Scientific and Industrial Research Organisation
+ (CSIRO), Australia.
+ All Rights Reserved.
+
+ This DTD module is identified by the PUBLIC and SYSTEM identifiers:
+
+ PUBLIC "-//CSIRO//DTD CMML 3.1//EN"
+ SYSTEM "http://www.annodex.net/DTD/cmml_3_1.dtd"
+
+ $Revision: 3.1 $
+ $Date: 2007/11/19 24:00:00 $
+-->
+
+<!-- **************************** -->
+<!-- Definition of Imported Names -->
+<!-- **************************** -->
+
+<!-- media type, as per [RFC2045] -->
+<!ENTITY % ContentType "CDATA">
+
+<!-- space-separated list of link types -->
+<!ENTITY % LinkTypes "CDATA">
+
+<!-- single or comma-separated list of media descriptors -->
+<!ENTITY % MediaDesc "CDATA">
+
+<!-- used for titles etc. -->
+<!ENTITY % Text "CDATA">
+
+<!-- a Uniform Resource Identifier, see [RFC2396] -->
+<!ENTITY % URI "CDATA">
+
+<!-- a language code, as per [RFC1766] -->
+<!ENTITY % LanguageCode "NMTOKEN">
+
+<!-- timestamps similar to [RFC2326]
+ "smpte-24:" SMPTE time with a 24 fps basis
+ "smpte-24-drop:" SMPTE time with a 24/1.001 fps basis
+ "smpte-25:" SMPTE time with a 25 fps basis
+ "smpte-30:" SMPTE time with a 30 fps basis
+ "smpte-30-drop:" SMPTE time with a 30/1.001 fps basis
+ "smpte-50:" SMPTE time with a 50 fps basis
+ "smpte-60:" SMPTE time with a 60 fps basis
+ "smpte-60-drop:" SMPTE time with a 60/1.001 fps basis
+ "npt:" npt-time
+ "clock:" utc-time
+
+ Playbacktime is specified as a smpte-time
+ or npt-time only.
+
+ UTCtime is specified as in [RFC2326], but
+ without the "clock" identifier
+-->
+<!ENTITY % Timestamp "CDATA">
+<!ENTITY % Playbacktime "CDATA">
+<!ENTITY % UTCtime "CDATA">
+
+
+<!-- ******************************** -->
+<!-- Definition of Generic Attributes -->
+<!-- ******************************** -->
+
+<!-- core attributes common to most displayable elements
+ id document-wide unique id
+ class space separated list of classes
+ title advisory title/amplification
+-->
+<!ENTITY % coreattrs
+ "id ID #IMPLIED
+ class CDATA #IMPLIED
+ title %Text; #IMPLIED"
+ >
+
+<!-- internationalization attributes
+ xml:lang language code (as per XML 1.0 spec)
+ dir direction for weak/neutral text
+-->
+<!ENTITY % i18n
+ "lang %LanguageCode; #IMPLIED
+ dir (ltr|rtl) #IMPLIED"
+ >
+
+<!ENTITY % attrs "%coreattrs; %i18n;">
+
+
+<!-- **************************** -->
+<!-- Document Structure -->
+<!-- **************************** -->
+
+<!-- ROOT ELEMENT: -->
+<!-- cmml tag containing sequence of head and a tags -->
+<!-- =============================================== -->
+<!-- i18n = the default language for the whole document including
+ the id tag of the cmml element -->
+<!-- xmlns = namespace of the cmml tags -->
+<!-- granulerate = the base temporal resolution to be used for the
+ cmml bitstream -->
+
+<!ELEMENT cmml (stream?, head, clip*)>
+<!ATTLIST cmml
+ %i18n;
+ id ID #IMPLIED
+ xmlns %URI; #FIXED 'http://www.annodex.net/cmml'
+ granulerate CDATA #IMPLIED
+ >
+
+
+<!-- **************************** -->
+<!-- Definition of stream element -->
+<!-- **************************** -->
+
+<!-- STREAM tag providing timing information for the ANNODEX file -->
+<!-- (will be stored in the binary headers of the ANX bitstreams) -->
+<!-- ============================================================ -->
+<!-- (has no text attributes and thus no i18n; id tag follows default
+ language specified in cmml tag) -->
+<!-- basetime = base time associated with the first frame of the media
+ document from which subsequent time references (such as
+ in clip tags) will be taken relative to -->
+<!-- utc = a mapping of the first frame to clock time;
+ specifications of utc time offsets into the document as
+ in a URI will be taken relative to this -->
+<!ELEMENT stream (import*)>
+<!ATTLIST stream
+ id ID #IMPLIED
+ basetime %Playbacktime; "0"
+ utc %UTCtime; #IMPLIED
+ >
+
+<!-- IMPORT tag giving descriptions on an input bitstream (empty content) -->
+<!-- ==================================================================== -->
+<!-- The title element is not considered part of the presentation.
+ It should be displayed, for example in a dialog window when
+ accepting input bitstreams.
+ -->
+<!-- i18n = the language of the import tag's and the contained param
+ tags' attribute values -->
+<!-- title = human readable comment on the import bitstream -->
+<!-- granulerate = the base temporal resolution of the bitstream (e.g.
+ its framerate for video or samplerate for audio) -->
+<!-- contenttype = encoding format of the input document (a MIME type and
+ a character encoding separated by semicolon) -->
+<!-- src = URI to the media document -->
+<!-- start = the start time of the media bitstream specified
+ in src -->
+<!-- end = the end time of the media bitstream specified
+ in src -->
+<!ELEMENT import (param*)>
+<!ATTLIST import
+ %i18n;
+ id ID #IMPLIED
+ title %Text; #IMPLIED
+ granulerate CDATA #IMPLIED
+ contenttype %ContentType; #IMPLIED
+ src %URI; #REQUIRED
+ start %Timestamp; "0"
+ end %Timestamp; #IMPLIED
+ >
+
+<!-- PARAM description tags of an input bitstream (empty content) -->
+<!-- (name-value pairs e.g. comments on recording quality or so) -->
+<!-- ============================================================== -->
+<!-- (internationalisation inherited from the parent import tag) -->
+<!-- name = identifies a property name; does not list legal values for this
+ attribute -->
+<!-- value = specifies a property's value; does not list legal values for
+ this attribute -->
+<!ELEMENT param EMPTY>
+<!ATTLIST param
+ id ID #IMPLIED
+ name CDATA #REQUIRED
+ value CDATA #REQUIRED
+ >
+
+
+<!-- **************************** -->
+<!-- Definition of document head -->
+<!-- **************************** -->
+
+<!-- head tag containing description of a specific media document -->
+<!-- ============================================================ -->
+<!-- i18n = the base language of the head's attribute values and text
+ content -->
+<!-- profile = space-separated list of URIs to locate meta tag schemes -->
+
+<!-- content model is %head.misc; combined with a single
+ title and an optional base element in any order -->
+<!ENTITY % head.misc "(style|meta|link)*">
+
+<!ELEMENT head (%head.misc;,
+ ((title, %head.misc;, (base, %head.misc;)?) |
+ (base, %head.misc;, (title, %head.misc;))))>
+<!ATTLIST head
+ %i18n;
+ id ID #IMPLIED
+ profile %URI; #IMPLIED
+ >
+
+<!-- TITLE tag giving descriptive title of the media document -->
+<!-- ========================================================= -->
+<!-- The title element is not considered part of the presentation.
+ It should be displayed, for example as the page header or
+ window title. Exactly one title is required per document.
+ -->
+<!-- i18n = the language of the title text -->
+<!ELEMENT title (#PCDATA)>
+<!ATTLIST title
+ %i18n;
+ id ID #IMPLIED
+ >
+
+<!-- BASE URI of the document (empty content) -->
+<!-- ======================================== -->
+<!-- (internationalisation inherited from the parent head tag) -->
+<!-- href = URI associated with the document; all relative URI references
+ get interpreted relative to this base -->
+<!ELEMENT base EMPTY>
+<!ATTLIST base
+ id ID #IMPLIED
+ href %URI; #REQUIRED
+ >
+
+<!-- META description tags of the document (empty content) -->
+<!-- ===================================================== -->
+<!-- i18n = the language of the meta attributes -->
+<!-- name = identifies a property name; does not list legal values for this
+ attribute -->
+<!-- content = specifies a property's value; does not list legal values for
+ this attribute -->
+<!-- scheme = names a scheme to be used to interpret the property's value
+ (see the profiles tag in the head element for locating these) -->
+<!ELEMENT meta EMPTY>
+<!ATTLIST meta
+ %i18n;
+ id ID #IMPLIED
+ name NMTOKEN #IMPLIED
+ content CDATA #REQUIRED
+ scheme CDATA #IMPLIED
+ >
+
+<!-- LINK tag to specify relationship values (empty content) -->
+<!-- ======================================================= -->
+<!-- Relationship values can be used in principle:
+ a) for document specific toolbars/menus when used
+ with the link element in document head e.g.
+ start, contents, previous, next, index, end, help
+ b) to link to a separate style sheet (rel="stylesheet")
+ As charsets are given in the xml directive of cmml documents,
+ this attribute of html is not required for cmml.
+ -->
+<!-- attrs = the language of the title text; a short description of the
+ relationship through title, and the stylesheet class -->
+<!-- href = reference to a related document -->
+<!-- type = type of the document referenced, e.g. "text/css" -->
+<!-- rel = type of relationship to forward linked document -->
+<!-- rev = type of relationship to reverse linked document -->
+<!-- media = type or medium/media to be rendered on, default "screen" -->
+
+<!ELEMENT link EMPTY>
+<!ATTLIST link
+ %attrs;
+ href %URI; #IMPLIED
+ type %ContentType; #IMPLIED
+ rel %LinkTypes; #IMPLIED
+ rev %LinkTypes; #IMPLIED
+ media %MediaDesc; #IMPLIED
+ >
+
+<!-- STYLE tag to specify presentation styles -->
+<!-- ======================================== -->
+<!-- The content of the "style" element is a style sheet.
+ -->
+<!-- i18n = the language of the style's title attribute -->
+<!-- title = short description of the style -->
+<!-- type = type of the document referenced, e.g. "text/css" -->
+<!-- media = type or medium/media to be rendered on, default "screen" -->
+<!-- xml:space = fixed to preserve whitespace characters in content -->
+<!ELEMENT style (#PCDATA)>
+<!ATTLIST style
+ %i18n;
+ id ID #IMPLIED
+ title %Text; #IMPLIED
+ type %ContentType; #REQUIRED
+ media %MediaDesc; #IMPLIED
+ xml:space (preserve) #FIXED 'preserve'
+ >
+
+
+<!-- ************************** -->
+<!-- Definition of clip tags -->
+<!-- ************************** -->
+
+<!-- Clip tag containing information for a specific fragment -->
+<!-- ======================================================= -->
+<!-- through meta, style, a, img and desc are given in specific order
+ here, their order is acutally random -->
+<!-- attrs = the base language of the clip's attribute values and
+ of its content elements; the stylesheet class attribute;
+ a short title representing the clip (e.g. in tooltips) -->
+<!-- track = defines different sets of clip tags; clip tags of same
+ type cannot overlap temporally-->
+<!-- start = specifies the start time of the clip; specified in
+ time relative to the basetime of the header
+ [NOT INCLUDED IN ANNODEXED DOCUMENT] -->
+<!-- end = specifies the end time of the clip; specified in
+ time relative to the basetime of the header
+ [NOT INCLUDED IN ANNODEXED DOCUMENT] -->
+
+XXX FIX THIS CONTENT MODEL XXX
+<!ELEMENT clip ((meta|style)*, a?, img?, desc?, caption?)>
+<!ATTLIST clip
+ %attrs;
+ track CDATA "default"
+ start %Timestamp; #REQUIRED
+ end %Timestamp; #IMPLIED
+ >
+
+<!-- A tag containing information for a specific clip -->
+<!-- ================================================ -->
+<!-- a tag contains anchor text being a textual description of the link
+ between the current element (the source anchor) and the destination
+ anchor given by the href attribute -->
+<!-- attrs = the base language of the clip's attribute values and
+ of its content elements; the stylesheet class attribute;
+ a short title representing the anchor (e.g. in tooltips) -->
+<!-- href = specifies the location of a Web resource, thus defining a
+ link between the current element (the source anchor) and the
+ destination anchor given by this attribute -->
+<!ELEMENT a (#PCDATA)>
+<!ATTLIST a
+ %attrs;
+ href %URI; #REQUIRED
+ >
+
+<!-- IMG tag to include a representative image for the clip -->
+<!-- ====================================================== -->
+<!-- attrs = the language of the image's attribute values;
+ the stylesheet class attribute; a short title
+ representing the image (e.g. in tooltips) -->
+<!-- src = reference to the image -->
+<!-- alt = alternative text for the image (accessibility) -->
+<!ELEMENT img EMPTY>
+<!ATTLIST img
+ %attrs;
+ src %URI; #REQUIRED
+ alt CDATA #IMPLIED
+ >
+
+<!-- DESC human-readable, textual description of the clip (annotation) -->
+<!-- ================================================================= -->
+<!-- attrs = the base language of the data in the description;
+ the class & style attributes;
+ a short title representing the desc (e.g. in tooltips) -->
+<!ELEMENT desc (#PCDATA)>
+<!ATTLIST desc
+ %attrs;
+ >
+
+<!-- CAPTION container to contain one or more textual content units -->
+<!-- ============================================================== -->
+<!-- attrs = the base language of the data in the description;
+ the class & style attributes;
+ a short title representing the caption (e.g. in tooltips) -->
+<!ELEMENT caption (p*)>
+<!ATTLIST caption
+ %attrs;
+>
+
+<!-- P human readable piece of text (e.g. transcription, caption, sub-title)
+<!-- ======================================================================= -->
+<!-- attrs = the base language of the data in the description;
+ the class & style attributes;
+ a short title representing the p (e.g. in tooltips) -->
+<!ELEMENT p (span*, br*, #PCDATA)>
+<!ATTLIST p
+ %attrs;
+ start %Timestamp; #REQUIRED
+ end %Timestamp; #IMPLIED
+>
+
+<!-- SPAN structuring element for a subpart of a 'p' element
+<!-- ======================================================= -->
+<!-- attrs = the base language of the data in the description;
+ the class & style attributes;
+ a short title representing the span (e.g. in tooltips) -->
+<!ELEMENT span (#PCDATA)>
+<!ATTLIST span
+ %attrs;
+>
+
+<!-- BR denotes an explicit line break
+<!-- ================================= -->
+<!-- attrs = the base language of the data in the description;
+ the class & style attributes;
+ a short title representing the br (e.g. in tooltips) -->
+<!ELEMENT br EMPTY>
+<!ATTLIST br
+ %attrs;
+>
Modified: standards/draft-pfeiffer-cmml-current.xml
===================================================================
--- standards/draft-pfeiffer-cmml-current.xml 2007-11-18 15:57:44 UTC (rev 3274)
+++ standards/draft-pfeiffer-cmml-current.xml 2007-11-18 20:26:35 UTC (rev 3275)
@@ -967,7 +967,7 @@
<figure>
<artwork><![CDATA[
-<!ELEMENT clip ((meta|style)*, a?, img?, desc?)>
+<!ELEMENT clip ((meta|style)*, a?, img?, desc?, caption?)>
<!ATTLIST clip
%attrs;
track CDATA "default"
@@ -1174,7 +1174,7 @@
<t>The "caption" element functions as a logical container for one
or more textual content units represented as logical paragraphs.
- It is created according to the <xref
+ It is created as a simplification of the <xref
target="DFXP">Timed Text standards of W3C</xref>.
It is bound by the start and end time of the clip tag in which it
is contained. The "caption" element is declared as the following:
More information about the commits
mailing list