Delete Original Languages

Removes `daptm:originalLangs` and `#originalLangs-root` too.
w3c · Dec 19, 2023 · 1693603 · 1693603
1 parent 74e4017
commit 1693603
Show file tree

Hide file tree

Showing 12 changed files with 219 additions and 328 deletions.
diff --git a/examples/intro-original-language-with-dub-language-and-adaptation.xml b/examples/intro-original-language-with-dub-language-and-adaptation.xml
@@ -2,11 +2,11 @@
     xmlns:ttm="http://www.w3.org/ns/ttml#metadata"
     xmlns:ttp="http://www.w3.org/ns/ttml#parameter"
     xmlns:daptm="http://www.w3.org/ns/ttml/profile/dapt#metadata"
-    xml:lang="en"
     ttp:contentProfiles="http://www.w3.org/ns/ttml/profile/dapt1.0/content"
+    xml:lang="en"
+    daptm:langSrc="fr"
     daptm:workflowType="dubbing"
-    daptm:scriptType="preRecording"
-    daptm:originalLangs="fr">
+    daptm:scriptType="preRecording">
   <head>
     <metadata>
       <ttm:agent type="character" xml:id="character_1">

diff --git a/examples/intro-original-language-with-dub-language.xml b/examples/intro-original-language-with-dub-language.xml
@@ -2,11 +2,11 @@
     xmlns:ttm="http://www.w3.org/ns/ttml#metadata"
     xmlns:ttp="http://www.w3.org/ns/ttml#parameter"
     xmlns:daptm="http://www.w3.org/ns/ttml/profile/dapt#metadata"
-    xml:lang="en"
     ttp:contentProfiles="http://www.w3.org/ns/ttml/profile/dapt1.0/content"
+    xml:lang="en"
+    daptm:langSrc="fr"
     daptm:workflowType="dubbing"
-    daptm:scriptType="translatedTranscript"
-    daptm:originalLangs="fr">
+    daptm:scriptType="translatedTranscript">
   <head>
     <metadata>
       <ttm:agent type="character" xml:id="character_1">

diff --git a/examples/intro-original-language.xml b/examples/intro-original-language.xml
@@ -2,11 +2,11 @@
     xmlns:ttm="http://www.w3.org/ns/ttml#metadata"
     xmlns:ttp="http://www.w3.org/ns/ttml#parameter"
     xmlns:daptm="http://www.w3.org/ns/ttml/profile/dapt#metadata"
-    xml:lang="fr" daptm:langSrc="fr"
     ttp:contentProfiles="http://www.w3.org/ns/ttml/profile/dapt1.0/content"
+    xml:lang="fr"
+    daptm:langSrc="fr"
     daptm:workflowType="dubbing"
-    daptm:scriptType="originalTranscript"
-    daptm:originalLangs="fr">
+    daptm:scriptType="originalTranscript">
   <head>
     <metadata>
       <ttm:agent type="character" xml:id="character_1">

diff --git a/examples/intro-script-with-gain.xml b/examples/intro-script-with-gain.xml
@@ -2,7 +2,7 @@
   daptm:workflowType="audioDescription"
   daptm:scriptType="asRecorded"
   xml:lang="en"
-  daptm:originalLangs="en">
+  daptm:langSrc="">
   ...
     <div begin="25s" end="28s">
       <p>

diff --git a/examples/intro-times-and-text.xml b/examples/intro-times-and-text.xml
@@ -3,10 +3,10 @@
   xmlns:daptm="http://www.w3.org/ns/ttml/profile/dapt#metadata"
   xmlns:xml="http://www.w3.org/XML/1998/namespace"
   ttp:contentProfiles="http://www.w3.org/ns/ttml/profile/dapt1.0/content"
-  daptm:workflowType="audioDescription"
-  daptm:scriptType="preRecording"
   xml:lang="en"
-  daptm:originalLangs="en">
+  daptm:langSrc=""
+  daptm:workflowType="audioDescription"
+  daptm:scriptType="preRecording">
   <body>
     <div begin="10s" end="13s">
       <p>

diff --git a/examples/intro-top-level.xml b/examples/intro-top-level.xml
@@ -1,11 +1,11 @@
 <tt xmlns="http://www.w3.org/ns/ttml" 
     xmlns:ttp="http://www.w3.org/ns/ttml#parameter"
     xmlns:daptm="http://www.w3.org/ns/ttml/profile/dapt#metadata"
-    xml:lang="en" 
     ttp:contentProfiles="http://www.w3.org/ns/ttml/profile/dapt1.0/content"
+    xml:lang="en"
+    daptm:langSrc="en"
     daptm:workflowType="dubbing"
-    daptm:scriptType="originalTranscript"
-    daptm:originalLangs="en">
+    daptm:scriptType="originalTranscript">
   <head>
     <metadata>
       <!-- Additional metadata may be placed here -->

diff --git a/examples/sourceMediaIdentifier.xml b/examples/sourceMediaIdentifier.xml
@@ -5,8 +5,7 @@
     xml:lang="en" 
     ttp:contentProfiles="http://www.w3.org/ns/ttml/profile/dapt1.0/content"
     daptm:workflowType="dubbing"
-    daptm:scriptType="originalTranscript"
-    daptm:originalLangs="en">
+    daptm:scriptType="originalTranscript">
   <head>
     <metadata>
       <ebuttm:sourceMediaIdentifier>https://example.org/programme.mov</ebuttm:sourceMediaIdentifier>

diff --git a/figures/class-diagram.svg b/figures/class-diagram.svg
diff --git a/figures/sources/class-diagram.puml b/figures/sources/class-diagram.puml
@@ -16,7 +16,7 @@ Class DAPTScript as "**DAPT Script**" [[#dapt-script]] {
     Workflow Type [[[#workflow-type]]]
     Script Type [[[#script-type]]]
     Default Language [[[#default-language]]]
-    {field} (optional) Original Languages [[[#original-languages]]]
+    {field} (optional) Text Language Source [[[#text-language-source]]]
 }
 
 together {

diff --git a/index.html b/index.html
@@ -348,9 +348,11 @@ <h4>Basic document structure</h4>
           <li>The <code>daptm:workflowType</code> attribute indicates the type of workflow.</li>
           <li>The <code>daptm:scriptType</code> attribute indicates the type of <a>transcript</a> or <a>script</a>
           but in this empty example, it is not relevant, since only the structure of the document is shown.</li>
-          <li>The <code>daptm:originalLangs</code> attribute indicates the language(s) used
-            in the original content, while the <code>xml:lang</code> indicates the default language 
-            in this script, which in this case is the same.</li>
+          <li>The <a><code>daptm:langSrc</code></a> attribute indicates the default text language source,
+            for example the original language of the content,
+            while the <code>xml:lang</code> indicates the default language 
+            in this script, which in this case is the same.
+            Both of these attributes are inherited and can be overridden within the content of the document.</li>
         </ul>
         <p>The structure is applicable to all types of <a>DAPT scripts</a>, dubbing or <a>audio description</a>.</p>
         <pre class="example"
@@ -368,7 +370,11 @@ <h4>Basic document structure</h4>
         <p>The following examples will demonstrate different uses in dubbing and audio description workflows.</p>
 
         <h4>Audio Description Examples</h4>
-        <p>When descriptions are added this becomes a <a>Pre-Recording Script</a>:</p>
+        <p>When descriptions are added this becomes a <a>Pre-Recording Script</a>.
+          Note that in this case, to reflect that most of the audio description content
+          transcribes the video image where there is no inherent language,
+          the <a>Text Language Source</a>, represented by the <a><code>daptm:langSrc</code></a> attribute,
+          is set to the empty string at the top level of the document:</p>
         <pre class="example"
           data-include="examples/intro-times-and-text.xml"
           data-include-format="text">
@@ -429,7 +435,7 @@ <h4>Dubbing Examples</h4>
 
         <p>After translating the text, the document is modified. It includes translation text, and
         in this case the original text is preserved. The main document's <a>default language</a> is changed to indicate
-        that the focus is on the translated language, but the <a>Original languages list</a> remains the same.
+        that the focus is on the translated language.
         The combination of the <code>xml:lang</code> and <a><code>daptm:langSrc</code></a> attributes are used
         to mark the text as being original or translated:</p>
         <pre class="example"
@@ -513,7 +519,7 @@ <h3>DAPT Script</h3>
           that corresponds to a document processed within an authoring workflow or processed by a client,
           and conforms to the constraints of this specification.
           It has properties and objects defined in the following sections:
-          <a>Workflow Type</a>, <a>Script Type</a>, <a>Default Language</a>, <a>Original Languages</a>, <a>Script Events</a>
+          <a>Workflow Type</a>, <a>Script Type</a>, <a>Default Language</a>, <a>Text Language Source</a>, <a>Script Events</a>
           and, for <a>Dubbing Scripts</a>, <a>Characters</a>.</p>
         <p>A <dfn>DAPT Document</dfn> is a TTML <a>Document Instance</a> representing a <a>DAPT Script</a>.
           A <a>DAPT Document</a> has the structure and constraints defined in the following sections.</p>
@@ -536,7 +542,7 @@ <h4>Workflow Type</h4>
           <h4>Default Language</h4>
           <p>The <dfn>Default Language</dfn> is a mandatory property of a <a>DAPT Script</a>
             which represents the default language for the <a>Text</a> content of <a>Script Events</a>.
-            This language may be one of the <a>Original Languages</a> or a <a>Translation</a> language.
+            This language may be one of the original languages or a <a>Translation</a> language.
             When it represents a <a>Translation</a> language, it may be the final language
             for which a dubbing or audio description <a>script</a> is being prepared,
             called the <dfn>Target Recording Language</dfn> or it may be an intermediate, or pivot, language
@@ -564,82 +570,6 @@ <h4>Default Language</h4>
             implying that they are in the <a>Original</a> language.</aside>
         </section>
 
-        <section>
-          <h4>Original Languages</h4>
-          <p>
-            The <dfn data-lt="Original languages list">Original Languages</dfn>,
-            also referred to as "Original languages list",
-            is an optional property of a <a>DAPT Script</a>
-            which represents the languages used in the original content,
-            in other words,
-            the set of languages associated with <a>Text</a> objects in the <a>Original Language Transcript</a>.
-          </p>
-          <p class="note">
-            <a>Text</a> marked as <a>Original</a> can be in a 
-            language not in the <a>Original Languages</a>;
-            this could occur if the original languages list omits languages used for
-            a small proportion of content, for example.
-          </p>
-          <p class="note">
-            The <a>Original Languages</a> are not expected to change after transcription, for example
-            during translation.
-          </p>
-          <p class="note">
-            The <a>Original Languages</a> are generally expected to represent the main languages used in the programme audio.
-            For example this allows the <a>Original Language Transcript</a> to be used as the basis for hard of hearing
-            subtitles. If a programme has significant dialogue in more than one language, for example Danish and Swedish,
-            all those languages used are expected to be included in the
-            <a>Original Languages</a>.
-          </p>
-          <p>The <a>Original Languages</a> are represented in a <a>DAPT Document</a> by the following structure and constraints:</p>
-          <ul>
-            <li>the <dfn><code>daptm:originalLangs</code></dfn> attribute
-              SHOULD be present on the <code>&lt;tt&gt;</code> element
-              and if present its value MUST NOT be empty.</li>
-            <li>the value of the attribute MUST be a set of space separated language identifiers,
-              each being a language tag as defined by [[BCP47]].</li>
-          </ul>
-          <!-- BCP47's syntax does not permit white space within each language tag -->
-          <div class="exampleInner">
-            <pre class="language-abnf">
-daptm:originalLangs
-  : languageIdentifier (&lt;lwsp&gt; languageIdentifier )*
-
-languageIdentifier  \\ BCP47 language tag
-
-&lt;lwsp&gt;
-  : &lt;whitespace&gt;+
-
-&lt;whitespace&gt;
-  : ( &quot; &quot; | &quot;\t&quot; | &quot;\n&quot; | &quot;\r&quot; )
-            </pre>
-          </div>
-          <aside class="example">
-            <p>A video contains dialogue in Danish and Swedish.
-              Two <a>Original Language Transcripts</a> are prepared,
-              one transcribing the dialogue, as a precursor to hard of hearing subtitles or dubbing,
-              the other transcribing the image, for audio description.</p>
-            <p>The dialogue transcript has its <a>Original languages list</a> set to Danish and Swedish,
-              by setting <code>daptm:originalLangs="da sv"</code> on the <code>&lt;tt&gt;</code> element.
-              The <a>Text</a> objects are each marked up with an appropriate language using <code>xml:lang</code>
-              and <a>Text Language Source</a> using <a><code>daptm:langSrc</code></a> reflecting the language of that part of the dialogue.
-              During the video, a character speaks briefly in Arabic;
-              on that <a>Text</a>, the <a>Text Language Source</a> and language are both set to Arabic,
-              indicating that Arabic is the original language, even though it is not in the document's
-              <a>Original languages list</a>.</p>
-            <p>The video image transcript is being prepared for a Danish audience initially,
-              and has its <a>Original Languages</a> set to Danish only
-              by setting <code>daptm:originalLangs="da"</code> on the <code>&lt;tt&gt;</code> element.
-              The <a>Text</a> objects are each marked up with an appropriate language using <code>xml:lang</code>,
-              and, if representing in-image text, a <a>Text Language Source</a> set to
-              the language of that in-image text using <a><code>daptm:langSrc</code></a>.
-              During the video, a Swedish newspaper headline is visible.
-              This is transcribed with both the language and <a>Text Language Source</a> set to Swedish.
-              Any <a>Text</a> objects representing parts of the scene that have no inherent language
-              have their language set to Danish and omit the <a>Text Language Source</a>.
-            </p>
-          </aside>
-        </section>
 
         <section>
           <h4>Script Type</h4>
@@ -721,10 +651,10 @@ <h4>Script Type</h4>
                 set to the source language from which they were translated.</aside>
 
                 <aside class="note">The <a>Original</a> <a>Text</a> objects in Audio Description <a>Script Events</a>
-                  do not have a <a>Text Language Source</a> property
-                  if they represent visual elements of the scene that do not have an inherent language,
-                  but are required to have a <a>Text Language Source</a> if they do represent
-                  visual elements with an inherent language, such as in-image text.
+                  have an empty <a>Text Language Source</a> property
+                  if they represent visual elements of the scene that do not have an inherent language.
+                  Otherwise if they do represent visual elements with an inherent language, such as in-image text,
+                  they are required to have a <a>Text Language Source</a> that specifies a language.
                   If audio description <a>scripts</a> are translated,
                   their translations would be marked as <a>Translation</a>
                   and those translation <a>Text</a> objects would indicate
@@ -981,13 +911,6 @@ <h4>Text</h4>
           <p>The source language of <a>Translation</a> <a>Text</a> objects and, where applicable,
             <a>Original</a> <a>Text</a> objects
             is indicated using the <a>Text Language Source</a> property.</p>
-          <aside class="note">A <a>Text</a> object can have a <a>Text Language Source</a> property indicating
-            a language that is not present in the document's <a>Original Languages</a>.
-            For example a <a>transcript</a> of a short piece of dialogue
-            spoken in a different language to the majority of the dialogue would be annotated
-            with both a different <code>xml:lang</code> value and as being <a>Original</a>,
-            but that language might not occur frequently enough
-            to justify including in the <a>Original Languages</a>.</aside>
           <p>A <a>Text</a> object may be styled.</p>
           <p>Zero or more <a>Mixing Instruction</a> objects used to modify the programme audio during the <a>Text</a> MAY be present.
           </p>
@@ -1089,7 +1012,7 @@ <h4>Text Language Source</h4>
             <li>The value MUST be an empty string or a language identifier as defined by [[BCP47]].</li>
             <li>The default value is the empty string.</li>
             <li>It <em>applies</em> to <code>&lt;p&gt;</code> and <code>&lt;span&gt;</code> elements.</li>
-            <li>It MAY be specified on the following elements: <code>&lt;tt&gt;</code>, <code>&lt;body&gt;</code>, <code>&lt;div&gt;</code>, <code>&lt;p&gt;</code> and <code>&lt;span&gt;</code>.</li>
+            <li>It MAY be specified on the following elements: <code>&lt;tt&gt;</code>, <code>&lt;p&gt;</code> and <code>&lt;span&gt;</code>.</li>
             <li>If it is present on an element,
               the computed value is the specified value.
             </li>
@@ -1129,8 +1052,7 @@ <h4>Text Language Source</h4>
             <table class="simple">
               <caption>Table enumerating example values of <code>xml:lang</code> and
                 <code>daptm:langSrc</code> for different <a>Original</a> transcript sources and
-                their inherent languages in a document whose <a>Original languages list</a> is
-                English, Arabic, and whose <a>Default Language</a> is English.
+                their inherent languages.
               </caption>
               <thead>
                 <tr>
@@ -2740,14 +2662,6 @@ <h4>Disposition of Features and Extensions</h4>
               This is the profile expression of <a href="#on-screen"></a>.
             </td>
           </tr>
-
-          <tr>
-            <td><a href="#originallangs-root"><code>#originallLangs-root</code></a></td>
-            <td><span class="permitted label">permitted</span></td>
-            <td>
-              This is the profile expression of <a href="#original-languages"></a>.
-            </td>
-          </tr>
           <tr>
             <td><a href="#profile-root"><code>#profile-root</code></a></td>
             <td><span class="prohibited label">prohibited</span></td>
@@ -2908,17 +2822,6 @@ <h3>#onScreen</h3>
           <a><code>daptm:onScreen</code></a> attribute on the <code>&lt;div&gt;</code> element.</p>
       </section>
 
-      <section>
-        <h3>#originalLangs-root</h3>
-        <p>A <a>transformation processor</a> supports the <code>#originalLangs-root</code> extension if
-          it recognizes and is capable of transforming values of the
-          <a><code>daptm:originalLangs</code></a> attribute on the <code>&lt;tt&gt;</code> element.</p>
-
-        <p>A <a>presentation processor</a> supports the <code>#originalLangs-root</code> extension if
-          it implements presentation semantic support of the
-          <a><code>daptm:originalLangs</code></a> attribute on the <code>&lt;tt&gt;</code> element.</p>
-      </section>
-
       <section>
         <h3>#profile-root</h3>
         <p>A <a>transformation processor</a> supports the <code>#profile-root</code> extension if

diff --git a/profiles/dapt-content-profile.xml b/profiles/dapt-content-profile.xml
@@ -91,7 +91,6 @@
     <!-- optional (voluntary) extension support -->
     <extension value="optional">#agent</extension>
     <extension value="optional">#onScreen</extension>
-    <extension value="optional">#originallLangs-root</extension>
     <extension value="optional">#textLanguageSource</extension>
     <!-- prohibited extension support -->
     <extension value="prohibited">#profile-root</extension>

diff --git a/profiles/dapt-processor-profile.xml b/profiles/dapt-processor-profile.xml
@@ -85,7 +85,6 @@
     <extension value="required">#agent</extension>
     <extension value="required">#contentProfiles-root</extension>
     <extension value="required">#onScreen</extension>
-    <extension value="required">#originallLangs-root</extension>
     <extension value="required">#scriptType-root</extension>
     <extension value="required">#serialization</extension>
     <extension value="required">#textLanguageSource</extension>