Attachment J3 - Specification 1203.pdf

Version 2.0 June 2022

Specification 1203:2022 Digital Talking-Book Requirements

NLS Spec No. 1203 June 2022

Revision History Revision Issue

Date Change Description

Rev. 1.0 3/15/2007 First release Rev. 1.1 6/30/2011 Remove CD reference

Added new OPF items Added description of nls:toneLevel Update class attributes

Rev. 1.2 12/20/2014 Revised multiple cartridge instructions Added special SMIL elements description Relocated audio compression section to audio files section Reworked and revised document structure

Rev. 1.3

08/31/2018

Added magazine requirements Revised naming convention language Revised quality assurance section Created new section (5 and 6) for requirements for specific production types Added references to NLS Document

QA201801

Rev 2.0 03/16/2022 New LOC and NLS branding Adjusted scope Moved magazine requirements to Appendix C

Table of Contents

1. Scope

2. Reference Documents

2.1 Specifications

2.2 Standards

3. Requirements

3.1 General

3.1.1 Production Identifier

3.1.2 File Names

3.1.2.1 Audio File Names

3.1.2.2 SMIL File Names

3.1.2.3 Headings File Name

3.1.2.4 Checksum File Name

3.1.3 File Limits

3.1.4 XML File Character Encoding

3.2 Audio Files

3.2.1 Source for Compressed Primary Audio Files

3.2.2 Source for Compressed Headings File

3.2.3 Compression

3.2.3.1 Audio Encoder

3.2.3.2 Audio Encoder Parameters

3.2.3.3 Audio File Format

3.2.4 Sound Quality

3.2.5 Time Offset

3.3 SMIL Synchronization File

3.3.1 SMIL Validity

3.3.2 SMIL Metadata

3.3.3 SMIL Structure

3.3.4 SMIL Audio Elements

3.3.4.1 clipBegin and clipEnd Required

3.3.4.2 Clip Timing

3.3.5 Opening Announcements for the DTB

3.3.6 Special SMIL Elements

3.3.6.1 Segments

3.3.6.2 Notes/Footnotes

3.3.6.3 Reader’s Note

3.3.6.4 Sidebars

3.3.7 Tables and Lists

3.3.8 Links

3.3.9 SMIL Granularity

3.3.10 Escapable Structures

3.3.11 Skippable Structures

3.3.11.1 defaultState Values

3.3.12 SMIL File Size

3.4 Navigation Control File (NCX)

3.4.1 NCX Validity

3.4.2 NCX Metadata

3.4.3 docTitle

3.4.4 docAuthor

3.4.5 navMap

3.4.5.1 navPoint Nesting

3.4.5.2 Class Attribute on navPoints

3.4.5.3 pageRef Attribute on navPoints

3.4.5.4 Content Element for navPoints

3.4.5.5 navLabel Content for navPoints

3.4.5.6 navPoint Limits

3.4.6 NavLists

3.4.6.1 class Attribute on navTargets

3.4.6.2 Value Attribute on navTargets

3.4.6.3 Content Element for navTargets

3.4.6.4 navLabel Content for navTargets

3.4.7 Heading Clips

3.4.7.1 clipBegin and clipEnd Required

3.4.7.2 Clip Timing

3.5 Package File (OPF)

3.5.1 OPF Validity

3.5.2 OPF Accuracy

3.5.3 Metadata

3.5.3.1 Dublin Core Metadata Elements and Content

3.5.3.2 Extended (x) Metadata Elements and Content

3.5.4 OPF Manifest

3.5.5 OPF Spine

3.5.6 Tours and Guides

3.6 distInfo Files

3.6.1 distInfo Validity

3.7 Textual Content File

3.7.1 Textual Content File Validity

3.8 Resource File

3.8.1 Resource File Validity

3.9 Checksum File

3.10 Complete DTB

3.10.1 Files and Conformance

3.10.2 Files to Include with Each DTB

4. Delivery Medium

4.1 Conformance with Specification 1206

5. Quality Assurance Provisions

5.1 Responsibility for Inspections

5.2 Quality Assurance Procedures (QAP)

5.3 Reporting of Inspection Results

5.4 Test Equipment and Inspection Facilities

5.5 Responsibility for Compliance

5.6 Parser

5.7 Other Validation Tools

5.8 Production Change Report

5.9 Incoming Inspection

5.10 Producer’s Acceptance Inspection

5.11 Warranty

5.12 DTB Correction

5.13 NLS Testing

5.14 Facility Inspection

5.15 NLS-Supplied Tools, Information, and Materials

A. Book Structure and Class-Attribute Relations B. OPF Element nls:toneLevel

B.1 Description B.2 Practical Example

C. Magazine Requirements C.1 NCX docTitle C.2 NCX docAuthor

C.3 NCX navMap C.4 OPF Dublin Core Metadata Elements and Content

1. Scope

This specification defines the requirements for the set of ANSI/NISO Z39.86-2002 compliant files produced for the National Library Service for the Blind and Print Disabled (NLS), Library of Congress.

2. Reference Documents

The following documents and publications form a part of this specification. In the event of conflict between the documents and publications referenced herein and the content of this specification, the content of this specification shall be considered a superseding requirement.

2.1 Specifications

American National Standards Institute (ANSI)

ANSI/NISO Z39.86-2002

Specifications for the Digital Talking Book

The document cited above is available from:

American National Standards Institute, Inc.

25 West 43rd St.

4th Floor New York, NY 10036 Tel: (212) 642-4900 Fax: (212) 398-0023 http://www.daisy.org/z3986/specifications/Z39-86-2002.html

National Library Service for the Blind and Print Disabled

NLS Specification 1201 Narration Requirements

NLS Specification 1202 Digital Talking-Book Mastering

NLS Specification 1205 Protected Digital Talking Book

NLS Specification 1206 Uploading Digital Talking Books and Magazines

NLS Specification 1208 Preparation of Audio Files from Commercial Audiobooks

NLS Document QA201401 Instructions for Bilingual Books

NLS Document QA201801 Instructions for Applying Navigation Markers

The documents cited above are available from:

National Library Service for the Blind & Physically Handicapped Library of Congress 1291 Taylor Street, NW Washington, DC 20542 http://www.loc.gov/nls/specs/

European Telecommunications Standards Institute

Extended Adaptive Multi-rate-Wideband (AMR-WB+) codec; Transcoding functions ETSI TS 126 290 release 6 / 3GPP TS 26.290 release 10

The document cited above is available from:

www.3gpp.org/ftp/Specs/html-info/26290.htm

Transparent End-to-End Packet Switched Streaming Service; 3GPP file format (3GP) ETSI TS 126 244 release 7 / 3GPP TS 26.244 release 10

The document cited above is available from:

www.3gpp.org/ftp/Specs/html-info/26244.htm

Internet Engineering Task Force Network Working Group

The MD5 Message-Digest Algorithm (RFC 1321, April 1992)

The document cited above is available from:

www.ietf.org/rfc/rfc1321.txt

Tags for the Identification of Language (RFC 1766, March 1995)

The document cited above is available from:

http://tools.ietf.org/html/rfc1766

International Standards Organization

ISO 8601 Numeric Representation of Date and Time

The document cited above is available from:

http://www.iso.org/iso/home/standards/iso8601.htm

Codes for the Representation of Names of Languages — Part 1: Alpha-2 code (ISO 639-1:2002)

The document cited above is available from:

http://www.iso.org/iso/home/standards/language_codes.htm

2.2 Standards

American National Standards Institute (ANSI)

ANSI/ASQ Z1.4-2008

Sampling Procedures and Tables for Inspection by Attributes

The document cited above is available from:

American Society for Quality Quality Press

611 East Wisconsin Ave.

P.O. Box 3005 Milwaukee, WI 53201-3005 www.asq.org/quality-press/index.html

3. Requirements

3.1 General

The DTB must be compliant with ANSI/NISO Z39.86-2002 with the exception that audio files shall be encoded with AMR-WB+ as required by this document.

3.1.1 Production Identifier

The production identifier shall be appropriate to the type of production and shall be supplied/approved by NLS. The production identifier shall be used for the file names and for the content of the dc:Identifier element of the OPF, see section 3.5.3.1 for the dc:Identifier requirements.

3.1.2 File Names

All alphabetic characters shall be in lower case.

The file names of the DTB shall be the production identifier followed by the appropriate file extension required by ANSI/NISO Z39.86-2002 or as specified below.

3.1.2.1 Audio File Names

All audio files, with the exception of the headings file and resource audio file, shall have a sequence indicator consisting of a hyphen and four digits appended to the production identifier in the file name (including any leading zeroes needed to meet the four-digit requirement). The range of sequence indicators shall begin with -0001 and the sequence shall be continuous. The sequence indicator shall equal the sequence indicator of the corresponding master (primary) WAV file.

3.1.2.2 SMIL File Names

When a DTB contains more than one SMIL file those files shall have a sequence indicator consisting of a hyphen and four digits appended to the production identifier in the file name (including any leading zeroes needed to meet the four-digit requirement).

The range of sequence indicators shall begin with -0001 and the sequence shall be continuous.

3.1.2.3 Headings File Name

The file name of the headings file shall be the production identifier concatenated with the suffix “hdgs”.

3.1.2.4 Checksum File Name

The name of the file containing MD5 checksums shall be the production identifier concatenated with the suffix “dtb.md5”.

3.1.3 File Limits

The complete DTB shall contain no more than 250 files.

3.1.4 XML File Character Encoding

The character set encoding of all XML files shall be UTF-8. All XML files shall include an XML declaration with the encoding attribute equaling “UTF-8” Non-ASCII characters in all <metadata> element content shall be represented as numeric character references or as UTF-8 multi-byte sequences.

3.2 Audio Files

3.2.1 Source for Compressed Primary Audio Files

The source for each compressed audio file shall be identical to the primary WAV audio file.

3.2.2 Source for Compressed Headings File

The source for the compressed headings file shall be identical to the headings WAV file.

3.2.3 Compression

All DTB audio files shall be compressed with an audio encoder conforming to the following requirements, and shall be encoded monaurally at a constant bitrate.

3.2.3.1 Audio Encoder

The encoder used to compress the audio files for the DTB shall be fully compliant with the standard for Extended Adaptive Multi-Rate-Wideband (AMR-WB+), ETSI TS 126 290 release 6.

3.2.3.2 Audio Encoder Parameters

The encoder parameters shall generate AMR-WB+ with a frame type of 23 and an ISF index of 8, as described in Section 8.1 of the above standard.

3.2.3.3 Audio File Format

The 3GP file format shall be used to store the compressed AMR-WB+ frames. The 3GP files shall be fully compliant with ETSI TS 126 244 release 7 with the following restrictions:

• Checksum Keyword The 3GP file shall contain a User Data (udta) box within the Movie (moov) box. The “udta” box shall contain a Keyword sub-box that shall contain the keyword “md5sum.cccccccccccccccccccccccccccccccc,” where cccccccccccccccccccccccccccccccc is the ASCII hexadecimal representation of the 16 byte MD5 checksum of the entire source WAV file.

• Sample-Size Box Format The Sample-Size box (stsz) contained within the Sample Table (stbl) box of the sound track’s Media Information (minf) box shall contain only the elements “sample_size” and “sample_count.” “sample_size” shall be the size of, and “sample_count” the number of, AMR-WB+ superframes contained within the track.

3.2.4 Sound Quality

Compressed audio files shall be of acceptable subjective sound quality when compared to the WAV files.

3.2.5 Time Offset

It is anticipated that there will be a time offset of 50 to 80 milliseconds (ms) between the uncompressed and compressed/decompressed audio files. The timing references for all clipBegin and clipEnd attributes on audio elements in the SMIL, NCX, Distinfo and resource files, are to be relative to the WAV file. In determining the correct times for the start and end of audio clips, producers should assume that the time offset will be compensated for by the player, but these times can have an uncertainty of plus or minus 30 milliseconds when played.

3.3 SMIL Synchronization File

The SMIL file(s) shall conform to the normative requirements of section 7 of ANSI/NISO Z39.86-2002.

3.3.1 SMIL Validity

The SMIL file(s) shall be well-formed and valid to the DTB-specific SMIL document type definition (DTD) of Appendix 2 of ANSI/NISO Z39.86-2002.

3.3.2 SMIL Metadata

SMIL metadata shall conform to the requirements of section 7.5 of ANSI/NISO Z39.86-2002, and the element “dtb:generator” shall be completed by the producer. If the SMIL contains elements containing customTest attributes, a customAttribute element with those customTest must be present in the SMIL head.

3.3.3 SMIL Structure

At a minimum, one <par> (see ANSI/NISO Z39.86-2002, section 7.3 for definition) shall be included for each structural element in the source material for which an NCX entry has been created.

3.3.4 SMIL Audio Elements

All navigable SMIL elements shall have an audio element. All audio elements shall point to the compressed primary audio file(s) containing the main content of the source material.

3.3.4.1 clipBegin and clipEnd Required

In all SMIL audio elements, both clipBegin and clipEnd must be present and valued.

3.3.4.2 Clip Timing

The clipBegin time for each audio fragment shall be placed between 80 and 120 ms before the beginning of narration of that fragment. The clipEnd time for each audio fragment shall be placed between 150 to 300 ms following the end of the narration of that fragment. Clip times shall be placed within the silence between narration, adhering to the clip timing requirements for SMIL audio elements of both the preceding and succeeding narration (see section 3.2.5).

3.3.5 Opening Announcements for the DTB

The opening announcements shall be referenced by the first SMIL file such that they are the first audio encountered in normal playback.

3.3.6 Special SMIL Elements

Application of special SMIL elements in DTB production shall follow the instructions found in NLS Document QA201801 Instructions for Applying Navigation Markers.

3.3.6.1 Segments

Segments shall be represented by <par>s or <seq>s in the SMIL file(s).

3.3.6.2 Notes/Footnotes

Notes shall be represented in the SMIL file(s) as a <par> or <seq> with both class and customTest attributes having a value of “note.”

3.3.6.3 Reader’s Note

Reader’s notes shall be represented in the SMIL file(s) as a <par> or <seq> with both class and customTest attributes having a value of “prodnote.”

3.3.6.4 Sidebars

Sidebars shall be represented in a SMIL file as a <par> or <seq> with both class and customTest attributes having a value of “sidebar.”

3.3.7 Tables and Lists

If NLS requires tables and/or lists to allow special navigation modes, the SMIL file(s) shall conform to the normative requirements of section 7.4.2 of ANSI/NISO Z39.86-2002.

3.3.8 Links

If NLS requires links, the SMIL file(s) shall conform to the normative requirements of section

7.4.5 of ANSI/NISO Z39.86-2002.

3.3.9 SMIL Granularity

If a textual content file is required by NLS, SMIL file(s) shall have a level of granularity matching that of the textual content file as recommended by section 7.2 of ANSI/NISO Z39.86-2002.

3.3.10 Escapable Structures

If NLS requires any structures to be escapable, the SMIL file(s) shall conform to the normative requirements of section 7.4.1 of ANSI/NISO Z39.86-2002.

3.3.11 Skippable Structures

If NLS requires any structures to be skippable, the SMIL file(s) shall conform to the normative requirements of section 7.4.3 of ANSI/NISO Z39.86-2002.

3.3.11.1 defaultState Values

Unless otherwise specified by NLS, the value of defaultState shall be set to “true” for all skippable structures. The value of the defaultState for a given customTest element must be the same in all SMIL files for a DTB.

3.3.12 SMIL File Size

SMIL files exceeding 100 kilobytes (where kilobytes equal 210 bytes) must be divided into multiple SMIL files. All SMIL files, with the exception of the last, shall have as many elements as can be contained given the size limit above. The number of SMIL files shall not exceed 50. A producer shall contact NLS before proceeding with source material that would exceed these limitations.

3.4 Navigation Control File (NCX)

The NCX file shall conform to the normative requirements of section 8 of ANSI/NISO Z39.86-2002.

3.4.1 NCX Validity

The NCX file shall be well-formed and valid to the NCX DTD of Appendix 3 of ANSI/NISO Z39.86-2002.

Non-ASCII characters in all <text> elements shall be represented as numeric character references or as UTF-8 multi-byte sequences.

3.4.2 NCX Metadata

NCX metadata shall conform to the requirements of section 8.4.1 of ANSI/NISO Z39.86-2002, and the element “dtb:generator” shall be completed by the producer.

3.4.3 docTitle

The docTitle shall contain an audio element pointing to an audio clip of the source material’s title and a text element containing the source material’s title. The audio clip shall be contained in the compressed audio headings file.

3.4.4 docAuthor

The docAuthor shall contain an audio element pointing to an audio clip of the source material’s creator(s)’s name (if applicable), preceded by the appropriate phrase (e.g., “by,” “edited by,” “compiled by,”) and a text element containing the source material’s creator(s)’s name preceded by the appropriate phrase, as above. The audio clip shall be contained in the compressed audio headings file.

3.4.5 navMap

The navMap shall contain the navPoints that represent the divisions of the source material.

Application of hierarchical navigation elements in DTB production shall follow the instructions found in NLS Document QA201801 Instructions for Applying Navigation Markers. Final authority regarding proper application of navigation rests with the NLS Content Quality Assurance Section.

3.4.5.1 navPoint Nesting

When multiple levels of structures are included in the NCX, those levels must be reflected in properly nested navPoints.

3.4.5.2 Class Attribute on navPoints

Each navPoint shall have a class attribute drawn exactly from Appendix A, Table 1, corresponding as closely as possible to the type of structure marked by the navPoint.

When appropriate to the source material a resource file may be used to create accessible navigation using a term not listed in appendix A. Application of resource files shall follow the instructions found in NLS Document QA201801 Instructions for Applying Navigation Markers. Resource files may be used upon approval from NLS Content Quality Assurance Section.

3.4.5.3 pageRef Attribute on navPoints

Each navPoint beginning on a page whose number is included in a navList of page numbers shall contain a pageRef attribute.

3.4.5.4 Content Element for navPoints

Each navPoint shall have a content element pointing to the SMIL element marking the heading within the compressed primary audio file.

3.4.5.5 navLabel Content for navPoints

Each navLabel within a navPoint shall contain both text and audio elements.

The content of the text element shall contain the heading marked by its parent navPoint.

The content shall match the heading found in the body of the source material, rather than the table of contents. Line breaks and font information shall not appear in the text element.

The audio element shall contain a pointer to the audio narration of the text element as defined above. This audio clip shall be contained in the compressed headings file.

3.4.5.6 navPoint Limits

The total number of navPoints for a DTB shall not exceed 5,000. If the total number of navPoints will exceed 1,000, contact NLS to ensure the total number of navPoints is appropriate.

3.4.6 NavLists

If the source material requires that any of the structures listed below be made navigable a navList is required for each, conforming to the normative requirements of section 8 of ANSI/NISO Z39.86-2002.

• note reference (noteref)

• page number (pagenum)

• line number (linenum)

Each navList element shall have a class attribute describing the structures it contains; the class attribute shall be the DTBook element name included in parentheses in the list above.

navLists are not required for other structures and are forbidden for segments.

Application of non-hierarchical navigation elements in DTB production shall follow the instruction found in NLS Document QA201801 Instructions for Applying Navigation Markers.

Final authority regarding proper application of navigation rests with the NLS Content Quality Assurance Section.

3.4.6.1 class Attribute on navTargets

Each navTarget shall have a class attribute of noteref, pagenum, or linenum corresponding to the type of structure represented by the navTarget. All navTarget elements with the same class attribute shall be siblings and shall have a parent navList element with the same class attribute.

3.4.6.2 Value Attribute on navTargets

Each navTarget whose navLabel text element consists of a non-Arabic number, such as a Roman numeral, shall include a value attribute. The value attribute shall contain an Arabic integer corresponding to the navLabel's text element value. navTargets for page ranges (e.g., 25-26) shall have a value attribute equal to the first page number of the range. Note references and line numbers shall be repeated as necessary. Gaps in the sequence of values are acceptable, for example if only explanatory notes are read.

3.4.6.3 Content Element for navTargets

Each navTarget shall have a content element pointing to the SMIL element marking the note reference, page number, or line number narration within the compressed primary audio file (see sections 3.3.4 and 3.3.6).

3.4.6.4 navLabel Content for navTargets

Each navLabel within a navTarget shall contain both text and audio elements.

The text element shall contain the identifier “note,” “page,” or “line” and the appropriate reference text or number. The text for special page numbers shall match the source material. The text for note references shall match the source material as closely as possible. In cases where note references are indicated only by a symbol, the text element shall contain an asterisk.

The audio element shall contain a pointer to an audio clip as follows:

a. For note references (noterefs), the audio clip shall contain the identifier (e.g., “note” or “footnote”) followed by the reference text or number. If the reference is a symbol, the audio clip shall contain only the identifier.

b. For page numbers (pagenums), the audio clip shall contain the identifier “page” followed by the page number. For special page numbers, the audio clip shall contain the identifier followed by the number as it appears in the source material (e.g., “page roman four” for iv, “page A one” for A-1).

c. For line numbers (linenums), the audio clip shall contain the identifier “line” followed by the line number.

The audio clip shall be contained in the compressed headings file.

3.4.7 Heading Clips

The audio element source (src) attribute of the docTitle, docAuthor, and navLabels shall point to the collection of audio heading clips in the compressed headings file.

3.4.7.1 clipBegin and clipEnd Required

In all audio elements, both clipBegin and clipEnd must be present and valued.

3.4.7.2 Clip Timing

The clipBegin time for each audio clip shall be between 80 and 120 ms before the beginning of narration in that clip. The clipEnd time for each audio fragment shall be placed between 150 to 300 ms following the end of the narration of that fragment. Clip times shall be placed within the silence between narration, adhering to the clip timing requirements for SMIL audio elements of both the preceding and succeeding narration (see section 3.2.5).

3.5 Package File (OPF)

The OPF file shall conform to the normative requirements of section 3 of ANSI/NISO Z39.86-2002.

3.5.1 OPF Validity

The OPF file shall be well-formed and valid to the Open eBook Forum (OEBF) Publication Structure 1.0.1 package DTD referenced by section 3 of ANSI/NISO Z39.86-2002.

3.5.2 OPF Accuracy

The producer is responsible for the accuracy and correctness of all the dc:metadata and x-metadata. Accuracy shall be measured against the source material. An inaccuracy in an initial OPF provided by NLS does not relieve the producer of responsibility for correctness. The producer shall contact NLS if the content provided is inaccurate.

3.5.3 Metadata

3.5.3.1 Dublin Core Metadata Elements and Content

The following Dublin Core metadata elements are required and shall have content according to the requirements below:

a. dc:Title — The content of dc:Title shall be the title of the source material.

b. dc:Creator — The content of dc:Creator shall be the name(s) of the primary author, editor, etc. (when appropriate). Names shall be formatted Last name, First name.

Note:

For multiple creators this element shall be repeated as needed.

c. dc:Subject — The content of the dc:Subject shall be the topic of the source material

Note:

For multiple subjects this element shall be repeated as needed.

d. dc:Description — The content of dc:Description shall be the annotation.

e. dc:Publisher — The content of dc:Publisher shall be “National Library Service for the Blind and Physically Handicapped, Library of Congress” (Must be rendered exactly to assure proper NLS DTB playback.)

f. dc:Date — The content of dc:Date shall be the date of publication of the DTB. The content shall be the year and month of dtb:revisionDate in the format “YYYY-MM”.

g. dc:Format — The content of dc:Format shall be “ANSI/NISO Z39.86-2002”.

h. dc:Identifier — The element shall have an id attribute set to “uid” and a scheme attribute set to “dtb”. The content shall consist of the lowercase character string “us-nls-x,” where “x” represents the production identifier (see section 3.1.1 above).

i. dc:Language — The content of dc:Language shall be the RFC 1766 and ISO 639-1 compliant language code and optional country code sub-tag.

Note:

Language code is not case sensitive.

For multiple languages this element shall be repeated as needed.

j. dc:Rights — The content of dc:Rights shall be “Further reproduction or distribution in other than an accessible format is prohibited”

3.5.3.2 Extended (x) Metadata Elements and Content

The following Extended Metadata elements are required and shall have content according to the requirements below:

a. dtb:sourceDate — The content of dtb:sourceDate shall be the date of the publication of the source material in the year format “YYYY”.

b. dtb:sourcePublisher — The content of dtb:sourcePublisher shall be the name of the publisher of the source material.

c. dtb:sourceRights — The content of dtb:sourceRights shall be the copyright year and holder of the copyright.

d. dtb:multimediaType – The content of dtb:multimediaType shall be “audioNCX”.

e. dtb:narrator — The content of dtb:narrator shall be the name of the narrator. Names shall be formatted Last name, First name.

Note:

For multiple narrators this element shall be repeated as needed.

For narrator names that are unknown use “Narrators(s) Unknown”

f. dtb:producer — The content of dtb:producer shall be the name of the organization that produced the DTB.

g. dtb:producedDate – The content of dtb:produceDate shall be the date of the first build of the DTB submitted to NLS in the format “YYYY-MM-DD” and shall not be changed upon subsequent builds submitted to NLS.

h. dtb:revision – The content of dtb:revision shall be a non-negative integer. For the first build submitted to NLS, the revision shall be “0,” and the revision shall be incremented for each subsequent build submitted to NLS.

i. dtb:revisionDate – The content of dtb:revisionDate shall be the date of the most recent revision of the DTB in the format “YYYY-MM-DD” When dtb:revision contains “0” dtb:revisionDate shall equal the content of dtb:produceDate.

j. dtb:revisionDescription – The content of dtb:revisionDescription shall be a text string describing the reason for each revision, listed in order;

“dtb:revisionDescription” shall be present and valued for all revisions greater than “0.”

k. dtb:totalTime — Shall contain the total playing time of the DTB, i.e., the sum of the durations of all the audio elements of the SMIL files governing the playback of the DTB. For <seq>s and <par>s whose <customTest> elements have been set to defaultState=“false,” audio referenced by these SMIL nodes shall be counted toward “dtb:totalTime” as if the defaultState had been set to “true.” This time value shall be accurate to within plus or minus 1 second of the actual time.

l. dtb:audioFormat — The content of dtb:audioFormat shall be “3gpp”

m. nls:recordingAgency — The content of nls:recordingAgency shall be the name of the organization that made the original recording from which the DTB was created.

n. nls:toneLevel — Shall only be used with prior written approval by NLS. Final authority for judging the correct value of nls:toneLevel shall rest with the NLS Content Quality Assurance Section. (see Appendix B).

See NLS Specification 420 for OPF elements related to cartridge label information.

3.5.4 OPF Manifest

The manifest shall conform to the normative requirements of section 3.3 of ANSI/NISO Z39.86- 2002. The MIME media type for 3GP files must be “audio/3gpp”.

3.5.5 OPF Spine

The spine shall conform to the normative requirements of section 3.4 of ANSI/NISO Z39.86- 2002.

3.5.6 Tours and Guides

No tours or guides shall be included.

3.6 distInfo Files

If distInfo files are required, they shall conform to the normative requirements of section 11 of

ANSI/NISO Z39.86-2002.

3.6.1 distInfo Validity

The distInfo file shall be well-formed and valid to the Distribution Information DTD of Appendix 6 of ANSI/NISO Z39.86-2002.

3.7 Textual Content File

If a textual content file is required by NLS, it shall conform to the normative requirements of section 4 of

ANSI/NISO Z39.86-2002.

3.7.1 Textual Content File Validity

The textual content file shall be well-formed and valid to the DTBook DTD of Appendix 1 of

ANSI/NISO Z39.86-2002.

3.8 Resource File

Upon approval from NLS Content Quality Assurance Section, when a resource file is included in a DTB it shall conform to the normative requirements of section 10 of ANSI/NISO Z39.86-2002 and section 3.3 of NLS Document QA201801.

3.8.1 Resource File Validity

The resource file shall be well-formed and valid to the Resource DTD of Appendix 5 of

ANSI/NISO Z39.86-2002.

3.9 Checksum File

An XML file shall be created containing a checksum for each file comprising the DTB as specified in section 3.10 except for the MD5 file itself. All the files listed in the checksum file shall be present in the single ZIP container file used for transmission of the DTB as described in NLS Specification 1206. The checksum shall be calculated using the MD5 algorithm as described in the reference cited in Section 2.1 and shall be in the form of 32 hexadecimal digits. The checksums shall be generated from the source files prior to their packaging and transmission. This checksum file does not form part of the DTB and thus shall not be listed in the DTB manifest. The checksums contained in the checksum file must be identical to the checksums calculated from the source files and to those calculated from the corresponding files extracted from the ZIP container file. The format of the XML file is described by the following DTD, which shall be placed at the beginning of each checksum file.

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE diskcheck [ <!ELEMENT diskcheck (book, file+)> <!ATTLIST diskcheck version CDATA #FIXED "1.0" <!ELEMENT book (#PCDATA)> <!ELEMENT file (filename, checksum)> <!ATTLIST file type CDATA #IMPLIED content CDATA #IMPLIED <!ELEMENT filename (#PCDATA)> <!ELEMENT checksum (#PCDATA)> <!ATTLIST checksum type CDATA #REQUIRED

The contents of <book> element shall match the UID as found in the content of the OPF dc:Identifier.

The <filename> element shall contain the name of the file for which the checksum is calculated.

The “type” attribute on the <checksum> element shall contain the value “MD5.”

3.10 Complete DTB

3.10.1 Files and Conformance

The complete DTB, consisting of all required files, shall conform to the normative requirements of ANSI/NISO Z39.86-2002 and all applicable requirements of this specification.

3.10.2 Files to Include with Each DTB

All document type definitions (DTDs) and entity files referenced by any DTB files or by any DTDs shall be included with the DTB and shall be listed in the Package File manifest.

An XML checksum file is to be generated in accordance with section 3.9 and shall be included with the DTB.

4. Delivery Medium

4.1 Conformance with Specification 1206

The DTB shall be delivered following all applicable requirements of NLS Specification 1206.

5. Quality Assurance Provisions

5.1 Responsibility for Inspections

The producer is responsible for the inspection of all files for compliance with the requirements of this specification. NLS reserves the right to perform inspections when deemed necessary to ensure that products conform to the prescribed requirements.

5.2 Quality Assurance Procedures (QAP)

The producers shall prepare written documentation that describes the quality-assurance procedures used to achieve the requirements of the specification. The producer shall submit this documentation to the NLS Content Quality Assurance Section at the beginning of each new contract or at any time required by NLS. NLS reserves the right to require the producer to improve quality-assurance procedures. These shall be provided at no cost to NLS.

5.3 Reporting of Inspection Results

The producer shall maintain complete records (in English) of all inspection results for the duration of the contract, including the warranty period. NLS reserves the right to request copies, for review, of any documentation related to this specification. These shall be provided at no cost to NLS.

5.4 Test Equipment and Inspection Facilities

The producer shall ensure that test and inspection facilities of sufficient accuracy, quality, and quantity are established and maintained to permit performance of required inspections. Test equipment shall be calibrated annually. NLS reserves the right to request copies, for review, of any documentation related to this specification. These shall be provided at no cost to NLS.

5.5 Responsibility for Compliance

The requirements set forth in this specification shall become a part of the producer’s overall inspection system or quality program. The absence of any inspection requirements in the specification shall not relieve the producer of the responsibility of assuring that all products submitted to NLS comply with all requirements. Sampling in quality conformance does not authorize the submission of known defective material, either indicated or actual, nor does it commit NLS to the acceptance of defective material.

Should NLS determine that a significant fault or faults are found in production materials, within the warranty period, then correction of the fault or faults and inspections or controls for prevention shall be instituted without additional charge to NLS.

5.6 Parser

The parser used to validate the OPF, NCX, SMIL, distInfo, resource, and textual content files shall be a validating XML parser compliant with the applicable standard referenced by ANSI/NISO Z39.86-2002.

The XML parser to be used and its version shall be identified; if requested, a copy shall be submitted.

5.7 Other Validation Tools

Any other software or tools used to validate DTB content shall be capable of detecting deviations from the requirements of ANSI/NISO Z39.86-2002 and NLS Specifications 1202, 1208, 1205, and 1206.

5.8 Production Change Report

A production change report shall be issued by the producer to notify NLS QAS of any changes to materials, manufacturing/production process, or software used to produce DTBs.

5.9 Incoming Inspection

Incoming inspection shall be performed by the producer on source materials provided by NLS including the audio source files, the OPF metadata, and textual content file validity.

5.10 Producer’s Acceptance Inspection

Acceptance inspection shall be performed by the producer on 100% of every DTB. All files, and the content of those files, shall be examined for compliance with the requirements of specification.

5.11 Warranty

The producer shall agree to unconditionally warrant that the audio recording conforms to the requirements set forth in this specification for a period of two (2) years from the date the DTB is approved by the NLS Content Quality Assurance Section.

5.12 DTB Correction

Should NLS determine that a noncompliance with the specifications exists on a DTB during the warranty period; then correction of the noncompliance and production inspections or controls for prevention shall be instituted at no cost to NLS.

5.13 NLS Testing

The right is reserved by the NLS, Library of Congress, to inspect any process or tests being performed.

The library representative shall have the authority, without advance notice, to select at random a sample at any time during the course of the contract for testing to the specified requirements. The right is reserved by NLS to reject any DTB that does not meet specifications.

5.14 Facility Inspection

NLS reserves the right to inspect plant facilities or recording processes at any reasonable time. An NLS representative shall have the authority, without advance notice, to select at random a sample of the DTB productions at any time during the course of the contract for testing to the specified requirements.

5.15 NLS-Supplied Tools, Information, and Materials

NLS shall in some cases provide tools, information, and materials to assist in the production of DTBs.

Use of these items does not release the producer from their obligation to produce DTBs that meet the specifications. NLS reserves the right to update or discontinue supplied items at any time.

Appendices A. Book Structure and Class-Attribute Relations

In the table below, book structures with the item “preliminary” will be rendered by the NLS hardware player as “front matter” and book structures with the item “concluding” will be rendered as “back matter” by the NLS player. Book structures that have a blank item field will be rendered by the NLS hardware player as described in the Class Attribute column (e.g., the book structure “sonnet” will be rendered as “poem”).

Care must be taken to avoid the use of a preliminary item when the book structure is at the end of the book or a concluding item when the book structure is at the beginning of a book.

Upon approval from NLS Content Quality Assurance Section a resource file may be used when creating navigation with a term not found in the table below. See the NLS Document QA201801 Instructions for Applying Navigation Markers for requirements when applying resource files in a DTB.

Final authority regarding proper use of class attributes rests with the NLS Content Quality Assurance Section.

Book Structure Description Class Attribute Item

Acknowledgments acknowledgments before main book content acknowledgements preliminary acknowledgments after main book content acknowledgements/c concluding

Act act in a play act Activity activity in a craft book, for example activity Address speech speech Afterword afterword concluding Alphabetical Division division within index, glossary, etc. alphadiv

Annotation Library of Congress annotation only annotation preliminary Answers collection of answers answers concluding Appendices collection of appendices appendices concluding Appendix single appendix appendix concluding Article magazine article article

Author’s note author’s note before main book content authnote preliminary author’s note after main book content authnote/c concluding

Back matter material after main body of the book not adequately described by any other category in this table concluitem concluding

Biographical notes collection of biographical notes bionotes concluding

Biography biography of author, editor, illustrator, contributor, etc. (Not to be confused with “About the Author…” in the opening announcements.)

biography concluding

Bibliography bibliography concluding Book portion of a large work, entitled “book” book

Captions collection of captions to photos, illustrations, maps, etc. captions

Cast of characters cast of characters before main book content cast preliminary cast of characters after main book content cast/c concluding

Chapter chapter

Chronology chronology before main book content chronology preliminary chronology after main book content chronology/c concluding

Closing announcements closing announcements of a DTB close concluding

Conclusion conclusion concluding Contents table of contents contents preliminary Day as a diary or journal entry day Discography discography concluding Dramatis personae cast of characters cast preliminary Entry entry in a diary or journal entry Epilogue epilogue concluding Essay essay Exercise exercise, as in a “how-to” book exercise Fable fable

Family tree family tree before main book content tree preliminary family tree after main book content tree/c concluding

Filmography filmography concluding Foreword foreword preliminary

Front matter material before main body of the book not adequately described by any other category in this table prelimitem preliminary

Further reading readings concluding

Genealogy genealogy before main book content tree preliminary genealogy after main book content tree/c concluding

Glossary glossary before main book content glossary/p preliminary glossary after main book content glossary concluding

Illustrations collection of illustration captions captions Index index concluding Ingredients list of ingredients within a recipe ingredients Introduction introduction preliminary Lesson lesson in a “how-to” book lesson Letter correspondence letter Maps collection of map captions captions Materials list of supplies, as in a craft book materials Month as a diary or journal entry month Notes collection of end notes, author’s notes, etc. notes concluding Novelette novelette

Novella novella Part part Photographs collection of photograph captions captions Play play Poem poem Postscript postscript concluding Prayer prayer Preface preface preliminary Prelude prelude preliminary Project project Prologue prologue preliminary Proverb as in the Bible or a book of proverbs proverb Psalm as in the Bible psalm Questions collection of questions questions Questions and Answers collection of questions and answers qanda

Recipe recipe

Recommended reading recommended reading before main book content readings/p preliminary recommended reading after main book content readings concluding

References collection of references before main book content references/p preliminary collection of references after main book content references concluding

Resources collection of resources before main book content resources/p preliminary collection of resources after main book content resources concluding

Scene in a play scene Section section Selection selection Selected references references concluding Sources sources concluding Song song Sonnet poem Speech speech Stanza stanza

Steps collection of steps, as in a recipe or set of instructions steps

Story story Subsection subsection Suggested reading readings concluding Summary summary concluding Supplement supplement concluding Supplies supplies Synopsis synopsis preliminary

Table of contents contents preliminary Tale tale Testament testament

Time line time line before main book content timeline preliminary time line after main book content timeline/c concluding

Title/Author title and author (first audio encountered in normal playback) title/author preliminary

Unit unit Verse in Bible or poem verse

Vocabulary vocabulary before main book content vocabulary preliminary vocabulary after main book content vocabulary/c concluding

Volume volume Week as a diary or journal entry week

Year as a diary or journal entry year

Table 1 — Class Attributes

B. OPF Element nls:toneLevel

B.1 Description

The digital talking-book player provided by NLS to patrons annunciates with a beep the crossing of specific navigational level boundaries when in rewind or fast-forward mode. By default, the navigation level (beep level) used for this function is the highest level, with navPoints having the class attribute equal to “chapter.” If there are no levels with a class attribute having this value, the topmost level is used.

In some circumstances it may be necessary to explicitly set the beep level. This can be accomplished by defining and setting the “nls:toneLevel” element in the OPF file.

Figure 1 shows a typical NCX file with the nested structure of navPoints located within the navMap element. navPoints in blue font represent level 1, green font level 2, and red font level 3. The default behavior of the player would be to annunciate the crossing of level 2 navPoints, as this level is the highest with navPoints having a class attribute equal to “chapter.”

Figure 1 – Typical NCX navPoint Structure

If it would be more appropriate in this book to have the player indicate the “story” navigation points, then add the x-metatdata element:

<meta name="nls:toneLevel" content="3"/>

B.2 Practical Example

One example where nls:toneLevel could be used to improve the user experience would be DB68777, the “Scourby Bible.” In this DTB the navPoint with class attribute “Chapters” is located at level 3. When reading the “Scourby Bible” with a standard NLS player, the default behavior will result in every chapter of every book of the Bible being announced by “beep” when navigating by book structure. Making use of nls:toneLevel set to level 2 would allow the user to navigate by books of the Bible, skipping the individual chapters. This change will result in a much less time-consuming method of navigation.

C. Magazine Requirements

A DTB magazine created for NLS must be compliant with the requirements of this specification (above) and the following magazine specific requirements and exceptions:

C.1 NCX docTitle

The docTitle shall contain an audio element pointing to an audio clip of the magazine title and the issue date, and a text element containing the magazine title and issue date. The audio clip shall be contained in the compressed audio headings.

C.2 NCX docAuthor

The docAuthor element is not required for magazines.

C.3 NCX navMap

C.3.1 Title and Issue Date

The DTB shall include a navPoint for the beginning of the magazine. Its navLabel shall contain the title and issue date of the magazine. The class attribute shall be “title/author”.

C.3.2 Table of Contents

The DTB shall include a navPoint for the table of contents. If no heading is found in the print magazine for the table of contents, the navLabel “Contents” shall be inserted. The class attribute shall be “contents”.

C.3.3 Ending Announcement

The contractor shall include a navPoint for the ending announcements, with the navLabel content being "End of (magazine title and issue date)". The class attribute shall be “close”.

C.3.4 Absence of Print Headings

For divisions in the magazine that are to be made navigable via the NCX but which lack a heading in the print edition, the producer shall contact NLS for guidance on how to proceed.

C.4 OPF Dublin Core Metadata Elements and Content

All Dublin Core metadata elements required in section 3.5.2 are required for magazine DTB production with the following modifications and/or exceptions.

a. dc:Identifier – The content of the dc:Identifier element shall consist of the character string “us-nls-dm-x” where “x” represents the production identifier for the magazine, including the magazine name and issue date, as supplied by NLS.

b. dc:Title – The content of the dc:Title element shall be title and issue date as they appear on the cover of the print magazine, except that the date is to be placed within parentheses.

c. dc:Creator — The dc:Creator element is not required.

d. dc:Description – The dc:Description element is not required.

e. dc:Subject — The dc:Subject element is not required.