This is an old revision of the document!
In most cases, books and magazines should be formatted for use with Gutenberg if NLS guidelines for metadata are followed during resource creation. 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 and KLAS. Locations that require attention and formatting guidelines have been included in the sections below. 1) 2) 3)
In order to enable recognition by Gutenberg and KLAS, formatted UIDs must be added to/appear in component files (.opf, .ppf, etc.) in 10 specific locations.
The ten locations and their associated file extensions have been listed in the table below. Each location can be changed manually by opening the files in a text editor (such as Ted Notepad, or Vim) and pasting/entering in the formatted UID. Automation/partially automation of the process is possible, and a program written in C ( libxml) is used for changing UIDs at MBTBL.
File extension | Location |
---|---|
.ncx | dtb:uid |
.opf | dc:Identifier |
.ao file name | |
.pncx | dtb:uid |
.ppf | dc:Identifier |
.ao file name | |
.smil | dtb:uid |
.ao | File name (needs to match UID) |
Book uid | |
odrld:uid |
Formatting examples are included in each of the sub-sections below.
Example of formatted book UID:
us-nls-ll1a-dbc#####
PLEASE NOTE:
1) Example of formatted magazine UID (monthly) 6):
us-nls-ll1a-SER_TTT9-YYYY_MM
2) Example of formatted magazine UID (bi-monthly) 7):
us-nls-ll1a-SER_TTT9-YYYY_MM_MM
Component | Explanation |
---|---|
us- | US prefix |
nls- | NLS prefix |
ll1a- | library ID 8) |
SER_ | Serial prefix |
TTT9- | Serial ID |
YYYY_ | 4-digit year |
MM | 2-digit month |
After fixing the UID, simply adding the book or magazine to the Local Books directory on Gutenberg should result in an E-Document being auto-generated. The KLAS Batch Manager can be used to Synchronize Gutenberg Edocs, resulting in near-instantaneous updates. However, if use of the Batch Manger is not desirable/possible, E-Document generation can also be confirmed by viewing the E-Document tab in the Catalog or Serials module 24 – 48 hours after uploading the book file to Gutenberg.
In some cases, an E-Document may not be generated automatically. While this can be caused by UID formatting errors, it can also occur even if the UID has been formatted correctly. In these cases, it may be necessary to manually create an E-Document and its associated E-Package. For more information on the process, please refer to Generating E-Documents in KLAS below.
In the event that an E-Document is not generated after a book file has been uploaded to the Local Books directory on the Gutenberg workstation, it may be necessary to create one manually. The procedures for creating E-Documents (and associated E-Packages) are explained in the sections below.
PLEASE NOTE:
In order to create an E-Document, an E-package must be created.
1. Open KLAS, and click the E-Package tab for the desired book or magazine.
2. Add a new record.
3. Fill in the values for each item:
Field | Data |
---|---|
Type | NLS Audio / Audio Files from National Library Service |
Description | Local Copy of NLS Audio |
Security | Staff only/Only staff persons can view the package documents |
Source | NLS RSync/RSync from the NLS Catalog to a local storage device |
Status | Available/The documents are available for use |
Usage | Unlimited/No limit to how many items are ‘OUT’ at one time |
Price | 0.0 |
After an E-Package has been created, it will be possible to create an E-document. For magazines, separate E-Documents will need to be created for each issue. 9)
1. Click the E-Document tab for the desired book or magazine.
2. In the Package Info section, choose the following values:
Field | Data |
---|---|
Package | NLS Audio/Local Copy of NLS Audio |
Status | Available/The documents are available for use |
3. Then, enter the data for the desired resource type (book, or magazine) to complete the E-Document.
Field | Data |
---|---|
Short Desc. | Local Copy of NLS Audio |
Description | NLS Audio compressed file |
Seq | ## |
File Type | Zip/application/zip |
Click Meaning | Circ/count the click as circulation |
Date Added | (Auto-generated) |
Host | Gutenberg |
Path | / |
Filename | .zip filename 10) |
URL | (leave blank)11) |
File Size | (leave blank)12) |
Playing Time | (leave blank)13) |
Field | Data |
---|---|
Issue Name | YYYY_MM |
Short Desc. | YYYY_MM |
Description | NLS Audio compressed file |
Seq | ## |
File Type | Zip/application/zip |
Click Meaning | Circ/count the click as circulation |
Date Added | (Auto-generated) |
Host | Gutenberg |
Path | / |
Filename | .zip filename14) |
URL | (leave blank)15) |
File Size | (leave blank)16) |
Playing Time | (leave blank)17) |