Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add module framework (#29). #30

Merged
merged 7 commits into from
Apr 4, 2019
Merged

Add module framework (#29). #30

Changes from 1 commit
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
69907f2
Add module framework (#29).
skynavga Mar 14, 2019
eeb4d4e
Attempt to resolve various comments (#29,#30).
skynavga Mar 16, 2019
e87ac35
Substitute newly define term [public module] (#29,#30).
skynavga Mar 16, 2019
c12c80d
Attempt to address comments (https://github.com/w3c/ttml3/pull/30#pul…
skynavga Mar 23, 2019
37e3b7e
Remove [{public,private} module] definitions (#30).
skynavga Mar 28, 2019
7402d57
Make language in 4.[23] consistent with revised language in 4.1 w.r.t…
skynavga Apr 4, 2019
d8699b2
Address comments https://github.com/w3c/ttml3/issues/29#issuecomment-…
skynavga Apr 4, 2019
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
61 changes: 60 additions & 1 deletion spec/ttml3.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1147,6 +1147,16 @@ attribute of a <loc href="#embedded-content-vocabulary-source"><el>source</el></
content element</loc>.</p>
</def>
</gitem>
<gitem id="terms-external-module">
<label>[external module]</label>
nigelmegitt marked this conversation as resolved.
Show resolved Hide resolved
<def>
<p>A module defined externally to this specification in a separate module defining document. An external module
skynavga marked this conversation as resolved.
Show resolved Hide resolved
is designated at the time of specification as either a W3C defined module, in which case any vocabulary or semantic
behavior it defines is specified in the scope of one or more TTML Namespaces listed in <specref ref="namespace-vocab-table"/>,
skynavga marked this conversation as resolved.
Show resolved Hide resolved
or as a non-W3C defined module, in which case any vocabulary or semantic behavior it defines is specified in the scope
of one or more namespaces not listed in <specref ref="namespace-vocab-table"/>.</p>
</def>
</gitem>
<gitem id="terms-external-source">
<label>[external source]</label>
<def>
Expand Down Expand Up @@ -1194,6 +1204,13 @@ a set of author defined fonts and platform fonts for use during layout and prese
process include the computed values of font related properties, the capabilities of individual fonts, and the text content being presented.</p>
</def>
</gitem>
<gitem id="terms-private-module">
<label>[private module]</label>
<def>
<p>An <loc href="#terms-external-module">external module</loc> that is not listed (registered) in the
<loc href="#terms-module-registry">module registry</loc>.</p>
</def>
</gitem>
<gitem id="terms-font-resource">
<label>[font resource]</label>
<def>
Expand Down Expand Up @@ -1363,6 +1380,13 @@ that effectively represent the content, styling, layout, and timing of a source
an <loc href="#terms-intermediate-synchronic-document">intermediate synchronic document</loc>.</p>
</def>
</gitem>
<gitem id="terms-internal-module">
<label>[internal module]</label>
<def>
<p>A module defined within the body of this specification, specifically, the modules defined by
<specref ref="element-vocab-table"/> and <specref ref="attribute-vocab-table"/>.</p>
</def>
</gitem>
<gitem id="terms-intrinsic-block-content-extent">
<label>[intrinsic block content extent]</label>
<def>
Expand Down Expand Up @@ -1410,6 +1434,22 @@ consist of one or more <loc href="#terms-inline-area">inline areas</loc>.</p>
<p>Any of the element types defined by the <loc href="#element-vocab-type-metadata">Metadata Module</loc>.</p>
</def>
</gitem>
<gitem id="terms-module">
<label>[module]</label>
skynavga marked this conversation as resolved.
Show resolved Hide resolved
<def>
<p>A collection of element types, attributes, features, or the specification(s) of such entities, where the definition of a module
skynavga marked this conversation as resolved.
Show resolved Hide resolved
and the context of a reference to a module determine the nature of the defined or referenced entities. Modules may be defined
<loc href="#terms-internal-module">internally</loc> (within the specification of an edition or version of a TTML defining document)
or <loc href="#terms-external-module">externally</loc> (in one or more separate documents).</p>
</def>
</gitem>
<gitem id="terms-module-registry">
<label>[module registry]</label>
<def>
<p>A formally defined list of <loc href="#terms-module">modules</loc> associated with identifying information,
as specified in the Timed Text Module Registry <bibref ref="ttmlmods"/>.</p>
</def>
</gitem>
<gitem id="terms-nested-profile">
<label>[nested profile]</label>
<def>
Expand Down Expand Up @@ -2500,7 +2540,11 @@ namespace names are listed in <specref ref="namespace-vocab-table"/>.
<head>TTML Content Document Type</head>
<p>The TTML Content Document Type is an <loc href="#terms-abstract-document-type">abstract document type</loc> of a profile
of the Timed Text Markup Language intended to be used for interchange among distribution systems. This document type
is defined in terms of the element and attribute vocabulary specified in <specref ref="vocabulary"/>.</p>
is defined in terms of <loc href="#terms-module">modules</loc> that specify element and attribute vocabulary,
nigelmegitt marked this conversation as resolved.
Show resolved Hide resolved
features, and other semantic behaviors, where such modules take the form of either (or both)
<loc href="#terms-internal-module">internal modules</loc> defined (internally) within this document
or <loc href="#terms-external-module">external modules</loc> defined (externally) with respect to this document,
and where each module is listed in the <loc href="#terms-module-registry">module registry</loc>.</p>
<p>This specification references two types of schemas that may be used to validate a superset/subset
of <loc href="#terms-timed-text-content-document-instance">timed text content document instances</loc>:</p>
<ulist>
Expand Down Expand Up @@ -2537,6 +2581,17 @@ of <loc href="#terms-document-instance">document instance</loc> validity.</p>
<p>A conforming <loc href="#conformance-generic-processor">Generic Processor</loc> is required to support the ingestion and processing
of a <loc href="#terms-timed-text-content-document">timed text content document</loc>.</p>
</note>
<note role="clarification">
<p>A <loc href="#terms-timed-text-content-document">timed text content document</loc> is not prohibited from using
element or attribute vocabulary items defined by a <loc href="#terms-private-module">private module</loc>.
In such case, a <loc href="#terms-content-processor">content processor</loc>
that supports the <loc href="#terms-private-module">private module</loc> may employ one or more schemas associated with the
<loc href="#terms-private-module">private module</loc> in order to augment a validity assessment that would normally be performed using only schemas
associated with publicly registered modules. However, a <loc href="#terms-content-processor">content processor</loc>
that does not support the <loc href="#terms-private-module">private module</loc> will prune unknown element or attribute vocabulary items
according to the validity assessment rules described above, and, therefore, not report any potential invalidity that exists due to the
use of such vocabulary items.</p>
skynavga marked this conversation as resolved.
Show resolved Hide resolved
</note>
</div2> <!-- ttml-content-doctype -->
<div2 id="ttml-intermediate-doctype">
<head>TTML Intermediate Document Type</head>
Expand Down Expand Up @@ -25511,6 +25566,10 @@ Vector Graphics (SVG) 1.1 Second Edition</titleref>, W3C Recommendation, 16
August 2011. (See
<xspecref href="http://www.w3.org/TR/2011/REC-SVG11-20110816/">http://www.w3.org/TR/2011/REC-SVG11-20110816/</xspecref>.)
</bibl>
<bibl id="ttmlmods" key="TTML-MOD-REG">Glenn Adams, Ed.,
<titleref href="https://w3c.github.io/tt-module-registry/">Timed Text Module Registry</titleref>,
Editor's Draft. (See <xspecref href="https://w3c.github.io/tt-module-registry/">https://w3c.github.io/tt-module-registry/</xspecref>.)
</bibl>
<bibl id="ttml1" key="TTML1">Glenn Adams and Pierre-Anthony Lemieux, Eds.,
<titleref href="https://www.w3.org/TR/2018/REC-ttml1-20181108/">Timed Text Markup Language 1 (TTML1) (Third Edition)</titleref>,
W3C Recommendation, 08 November 2018. (See
Expand Down