[Inso Home Page] [Home] [Collection] [Book] [Expand] [Collapse] [Search Forms] [Previous Section with Hits] [Next Section with Hits] [Clear Search] [Preferences] [Print] [Help]

 inside  Expand Search


 3. Overview of DynaWeb Configuration Files   [Table of Contents]    How DynaWeb Views Collections and Books

DynaWeb Publishers Guide

[-] 3. Overview of DynaWeb Configuration Files
[-] What Are Configuration Files?

What Are Configuration Files?

DynaWeb configuration files control the behavior and layout of DynaWeb's responses. The actual content (as retrieved from DynaText books and collections) is generated by the sgml2html engine, and converted into HTML with the assistance of DynaWeb's stylesheet. Once the processing is finished and the response is generated internally, the configuration files process the response data and package it into an HTML document that a web browser then displays.

DynaWeb uses a scripting language called Tcl (the Tool Command Language) to interpret its configuration files and to manipulate the behavior of the server module. Tcl is also used to format the outgoing data when a response is generated. Inso has expanded the Tcl Command Set to allow the retrieval of server- and response-specific information, as well as client-user information provided by the browser.

Knowledgeable users can modify DynaWeb's configuration files to change the layout of DynaWeb's browsing interface or to add functionality.

It is recommended that publishers who are interested in modifying the interface or functionality of DynaWeb read the Programmers Guide to Customizing DynaWeb before attempting any modfications.

The main configuration files for DynaWeb are located in the /data/config directory below the server module's installation directory.

The configuration files can be identified by their extension, .dwc. There are currently twenty configuration files. Each one serves a different purpose and is responsible for handling a certain portion of the server module's response. The following table lists the .dwc files and provides a short explanation of their function and interdependencies.

Configuration File

Explanation Of Responsibilities

dynaweb.dwc

Sets the default behavior for the plugin and identifies all of the other configuration files.

collects.dwc

Lists the names and locations of available DynaText collections, as well as nested configuration files.

preproc.dwc
procdef.dwc
prefs.dwc
pubpref.dwc
urlutil.dwc

Parses the URL request and set up state information and global variables for use by the other configuration files.

collview.dwc
bookview.dwc

Controls the layout at the different levels and then passes on the content generation to the appropriate *toc.dwc and *text.dwc, depending on the current view.

collbbar.dwc
bookbbar.dwc

Requests to display button bars are passed to these three configuration files.

bbarutil.dwc

Referenced for help in constructing the button bar.

colltoc.dwc
booktoc.dwc

Delegates requests for the TOC to the appropriate configuration file (either colltoc.dwc or booktoc.dwc).

tocutil.dwc

Helps build TOCs.

colltext.dwc
booktext.dwc

Handles requests for content.

bookutil.dwc
bookscpt.dwc

Helps in chunking the contents of a book and displaying the results of a search.

bookqrs.dwc

Handles the display of any search forms that accompany a specific book.


 3. Overview of DynaWeb Configuration Files   [Table of Contents]    How DynaWeb Views Collections and Books