Skip to content

Commit

Permalink
duration includes (diagrams updated)
Browse files Browse the repository at this point in the history
  • Loading branch information
iherman committed Apr 16, 2019
1 parent 05ecd3e commit de18263
Show file tree
Hide file tree
Showing 7 changed files with 101 additions and 23 deletions.
2 changes: 1 addition & 1 deletion experiments/audiobook/flatland-canonical.json
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@
],
"dateModified": "2018-06-14T19:32:18Z",
"datePublished": "2008-10-12",
"globalDuration": "15153",
"duration": "PT15153S",
"license": "https://creativecommons.org/publicdomain/zero/1.0/",

"resources": [
Expand Down
2 changes: 1 addition & 1 deletion experiments/audiobook/flatland.json
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@
"inLanguage": "en",
"dateModified": "2018-06-14T19:32:18Z",
"datePublished": "2008-10-12",
"globalDuration": "15153",
"duration": "PT15153S",
"license": "https://creativecommons.org/publicdomain/zero/1.0/",

"resources": [
Expand Down
Binary file modified images/clean_up_data.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion images/clean_up_data.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
116 changes: 97 additions & 19 deletions index.html
Original file line number Diff line number Diff line change
Expand Up @@ -557,6 +557,14 @@ <h4>Quick Reference</h4>
<a href="#accessibility">Accessibility</a>
</td>
</tr>
<tr>
<td>
<code>accessibility-report</code>
</td>
<td>
<a href="#accessibility-report">Accessibility Report</a>
</td>
</tr>
<tr>
<td>
<code>accessibilitySummary</code>
Expand Down Expand Up @@ -599,58 +607,59 @@ <h4>Quick Reference</h4>
</tr>
<tr>
<td>
<code>creator</code>
<code>cover</code>
</td>
<td>
<a href="#creators">Creators</a>
<a href="#cover">Cover</a>
</td>
</tr>
<tr>
<td>
<code>dateModified</code>
<code>creator</code>
</td>
<td>
<a href="#last-modification-date">Last Modification Date</a>
<a href="#creators">Creators</a>
</td>
</tr>
<tr>
<td>
<code>datePublished</code>
<code>dateModified</code>
</td>
<td>
<a href="#publication-date">Publication Date</a>
<a href="#last-modification-date">Last Modification Date</a>
</td>
</tr>
<tr>
<td>
<code>editor</code>
<code>datePublished</code>
</td>
<td>
<a href="#creators">Creators</a>
<a href="#publication-date">Publication Date</a>
</td>
</tr>
<tr>
<td>
<code>https://www.w3.org/ns/wp#accessibility-report</code>
<code>datePublished</code>
</td>
<td>
<a href="#accessibility-report">Accessibility Report</a>
<a href="#publication-date">Publication Date</a>
</td>
</tr>
<tr>
<td>
<code>https://www.w3.org/ns/wp#cover</code>
<code>duration</code>
</td>
<td>
<a href="#cover">Cover</a>
<a href="#duration">Duration</a>
</td>
</tr>

<tr>
<td>
<code>https://www.w3.org/ns/wp#pagelist</code>
<code>editor</code>
</td>
<td>
<a href="#page-list">Pagelist</a>
<a href="#creators">Creators</a>
</td>
</tr>
<tr>
Expand Down Expand Up @@ -709,6 +718,14 @@ <h4>Quick Reference</h4>
<a href="#pub-title">Title</a>
</td>
</tr>
<tr>
<td>
<code>pagelist</code>
</td>
<td>
<a href="#page-list">Pagelist</a>
</td>
</tr>
<tr>
<td>
<code>penciler</code>
Expand Down Expand Up @@ -775,6 +792,8 @@ <h4>Quick Reference</h4>
</tr>
</tbody>
</table>


</section>

<section id="properties-value-categories">
Expand Down Expand Up @@ -1513,6 +1532,65 @@ <h5>Creators</h5>
</pre>
</section>

<section id="duration">
<h5>Duration</h5>

<p>
The <dfn>global duration</dfn> indicates the overall length of a <em>time-based</em> <a>digital publication</a> (e.g., an audiobook, a book consisting of a series of video clips, etc.). It is expressed as a "Duration" value as defined by&nbsp;[[!iso8601]].
</p>

<table class="zebra">
<thead>
<tr>
<th>Term</th>
<th>Description</th>
<th>Required Value</th>
<th>Value Category</th>
<th>[[!schema.org]] Mapping</th>
</tr>
</thead>
<tbody>
<tr>
<td>
<code data-dfn-for="PublicationManifest">
<dfn>duration</dfn>
</code>
</td>
<td>Overall duration of a time-based publication.</td>
<td>Duration value as defined by&nbsp;[[!iso8601]]</td>
<td>
<a href="#value-literal">Literal</a>
</td>
<td>
<a href="https://schema.org/duration"><code>duration</code></a> (<a
href="https://schema.org/Property">Property</a>) </td>
</tr>
</tbody>
</table>

<pre class="idl">
partial dictionary PublicationManifest {
DOMString duration;
};</pre>

<pre class="example" title="Global duration provided in the manifest (in seconds)">
{
"@context" : ["https://schema.org", "https://www.w3.org/ns/wp-context"],
"type" : "Audiobook",
"id" : "https://example.org/flatland-a-romance-of-many-dimensions/",
"url" : "https://w3c.github.io/wpub/experiments/audiobook/",
"name" : "Flatland: A Romance of Many Dimensions",
&#8230;
"duration" : "PT15153S",
&#8230;
}
</pre>

<p class=note>
The <a href="https://en.wikipedia.org/wiki/ISO_8601#Durations">relevant Wikiepedia page</a> gives a concise description of the ISO duration syntax.
</p>
</section>

<section id="language-and-dir">
<h5>Language and Base Direction</h5>

Expand Down Expand Up @@ -3142,16 +3220,16 @@ <h4>Post-Processing the Canonical Manifest</h4>
<var>P["url"]</var> set. If not, remove <var>P</var> from
<var>manifest[term]</var> array and issue a warning. If yes, check whether
<var>P["url"]</var> is a valid URL&#160;[[!url]] and, if not, issue a warning. </li>
<li>For every object <var>P</var> of type <a>LinkedResource</a>, if the value of <var>P["length"]</var> is set, check whether this value is a valid number.
If the check fails, issue a warning.</li>
<li>Check whether the value of <var>manifest["name"]</var> is not empty. If it is,
generate a value (see the <a href="#generate_title">separate note for details</a>)
and issue a warning. </li>
<li>Check whether <var>manifest["datePublished"]</var> is a valid date or date-time,
per&#160;[[iso8601]]. If the check fails, issue a warning. </li>
per&#160;[[!iso8601]]. If the check fails, issue a warning. </li>
<li>Check whether <var>manifest["dateModified"]</var> is a valid date or date-time,
per&#160;[[iso8601]]. If the check fails, issue a warning. </li>
<li>For every object <var>P</var> of type <a>LinkedResource</a>, if the value of <var>P["length"]</var> is set,
check whether this value is a valid number.
If the check fails, issue a warning.</li>
per&#160;[[!iso8601]]. If the check fails, issue a warning. </li>
<li>Check whether <var>manifest["duration"]</var> is a valid duration value, per&nbsp;[[!iso8601]]. If the check fails, issue a warning.</li>
</ol>
</li>
<li>Extension point: process any proprietary, <a>profile</a> specific, and/or other supported
Expand Down
Binary file modified snapshot/images/clean_up_data.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion snapshot/images/clean_up_data.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit de18263

Please sign in to comment.