NCSTRL Documentation

Making the content of documents available from your Dienst server

This section of the Dienst installation instructions discusses adding the content of documents in multiple formats to your document database and Dienst server.

The auto configuration script created a document database and defined a set of document formats. (You may add custom document formats if you wish.) This document describes how to put the content of documents in these formats in your database. Once you finish your initial Dienst installation, you should add new documents to your database using the library management package.

Document Format Types: Paged and Non-Paged

Dienst supports a multi-formatted document collection. A multi-formatted document is one that consists of many files, each one being a different representation of the document. Plain ASCII, PostScript and TIFF are examples of possible formats for a document. Document formats are either non-paged or paged.
Non-paged formats
Non-paged document formats are those where there is a single file that represents the entire document. Two common non-paged fomats are PostScript and plain ASCII text. Users will not be able to view specific pages of a document in a non-paged format, but they will be able to download a single file that represents the entire document.

To make a non-paged format available on your Dienst server, place the file corresonding to the format in the directory for the repective document in your document database. The name of the file should correspond to the name scheme defined for the format.

Paged formats
Paged document formats are those where the document is represented by a set of files, each one corresponding to a single page of the document. A common paged format is bitmapped image (TIFFs or GIFs). The Dienst user interface allows users to view specific pages of paged formats of documents.

To make a paged format available on your Dienst server, create the sub-directory for the format in the directory for the respective document. The name of the sub-directory should correspond to the name scheme defined for the format. Then place the individual page files in this sub-directory, using the proper name scheme.

Your server will automatically recognize the files that correspond to the formats, after you create the document database files.

A Note on compressed file usage in Dienst

The files that represent your document formats may be stored in compressed or uncompressed form. Dienst assumes that compressed files are identified by a suffix unique for each compression scheme. You define compression suffixes and the corresponding command for decompressing files identified by that suffix using the compression_schemes setting when you configure your server. Make sure that any compressed files that you put in your document database have a suffix (e.g. Z or gz) that corresponds to one of your defined compressions schemes.

Up to Main Information Menu


NCSTRL Documentation
Any comments or questions?
Contact us at help@ncstrl.org.