Libraries for the Blind and Print Disabled

This is an old revision of the document!

Introduction

In most cases, books and magazines should be formatted correctly for use with Gutenberg if NLS guidelines for book and magazine metadata are followed. However, in some cases it may be necessary to reformat older book and/or magazine Unique Identifiers (UIDs) So that they can be used with Gutenberg. Locations that require attention and formatting guidelines have been included in the sections below. ¹⁾

Note:

Procedures below are explained using Gutenberg and KLAS. Procedures may differ slightly depending on the software/combination used.
while fixing the UID can often enable a book to be duplicated onto cartridges using Gutenberg, additional checks/changes will be necessary when submitting for distribution on BARD.

Formatting and Fixing UIDs

In order to ensure successful recognition by Gutenberg and KLAS, Correctly formatted UIDs must appear in 10 specific locations in the component files of books/magazines.

Formatting UIDs

Formatting guidelines and examples are included in each of the sub-sections below.

Book UIDs

Example of correctly formatted book UID:

 us-nls-ll1a-dbc#####

Component	Explanation
us-	US prefix
nls-	NLS prefix
ll1a-	library ID ²⁾
dbc#####	DBC number ³⁾

Magazine UIDs

Example of correctly formatted magazine UID (single month):

 us-nls-ll1a-SER_TTT9-YYYY_MM

Example of correctly formatted magazine UID (multiple months):

 us-nls-ll1a-SER_TTT9-YYYY_MM_MM

Component	Explanation
us-	US prefix
nls-	NLS prefix
ll1a-	library ID ⁴⁾
SER_	Serial prefix
TTT9-	Serial ID
YYYY_	4-digit year
MM	2-digit month

UID Locations

The ten locations and their associated file extensions have been listed in the table below. Each location will need to be changed manually by opening the files in a text editor (such as Ted Notepad, or Vim) and pasting/entering in the correctly formatted UID. It is also possible to automate/partially automate the process, and a C program ( libxml) is used for changing UIDs at MBTBL.

File extension	Location
.ncx	“dtb:uid”
.opf	“dc:Identifier”
.opf	.ao file name
.pncx	“dtb:uid”
.ppf	“dc:Identifier”
.ppf	.ao file name
.smil	“dtb:uid”
.ao	file name needs to match UID
	“Book” uid
	“odrld:uid”

¹⁾

The procedures and suggestions in this wiki are primarily based on information from Colorado Talking Book Library and Keystone Systems.

²⁾ , ⁴⁾

‘ll’ will be the first two letters of your library ID.

³⁾

A prefix other than ‘dbc’ could also be possible for in-house-developed book numbers