Version 1.0 - May 16, 2002.
dictionary is configured through the use of a
Microsoft
Windows-like .ini file. Only 2 lines in the
dictionary.pl code file require modification.
The following modifications are the only required changes to the
dictionary.pl script:
- The first line in the file must indicate the location of the perl
interpreter. Normally, this is something like
#!/usr/bin/perl, but may be
different on your HTTP server.
- Next is the line declaring
the ini file location as a local variable named
$IniFileName. It should be set to the absolute
path to where you will locate the dictionary.ini file.
No other changes are required to the dictionary.pl
script. All other configuration items are set either through the
dictionary.ini configuration file, the style sheet (dictionary.css),
or through the client's
dictionary setup screen from the browser.
INI File
[dictd]
- server
- The names and/or IP-addresses of known DICT
servers.
Default = dict.org
This is a Multiline parameter, and must be defined ala UNIX here
document syntax:
server=<<LIST
dict.org
local.lan.server
LIST
The first server in the list is used as the default server until the
configuration is changed on-line with the Setup document.
Any string may be used in place of LIST. However, what
follows the ``<<'' and what appears at the end of the
text MUST match exactly, including any trailing whitespace.
- port
- Specifies the port number of
the DICT server.
Default = 2628.
-
timeout
-
dictionary timeout, in seconds. This timeout is used to unblock a
blocking-call to Net::Dict.
Default = 120
[html]
- title
- The browser page title (top of each page).
Default = Dictionary.
- application
- The application name (second line of title).
Default = dictionary
- cgidir
- The server-based cgi directory.
Default = cgi-bin
- server
- The name or IP-address of the HTTP server upon which the
directory.pl script resides.
Default = none.
- stylesheet
-
names of stylesheets used to generate the
dictionary document.
Default = dictionary.css
and colorscheme.css.
This is a Multiline parameter, and must be defined ala UNIX ``here
document'' syntax:
Any string may be used in place of LIST. However,
what follows the ``<<'' and what appears at the end of the
text MUST match exactly, including any trailing whitespace.
[htmlfoot]
- message
- The beginning of the maintainer message to include, in small
print, at the bottom of each dictionary query window.
- mailto
- The e-mail address of the person maintaining this application.
- maintainer
- The name of the person maintaining this application.
- trailer
- The remainder of the maintainer message to include, in small
print, at the bottom of each dictionary query window.
- copyright
- The body of the message to include, in small print, at the
bottom of each dictionary query window.
[debug]
- debug
- The debug level - a non-zero value will result in debugging
information being generated, and sent to the browser.
Sample ini file
[dictd]
server=<<LIST
dict.org
LIST
port=2628
timeout=120
[html]
title=Dictionary
cgidir=cgi-bin
server=FreeBSD.ewdesigns.lan
stylesheet=<<LIST
document.css
colorscheme.css
LIST
[htmlfoot]
mailto=Jay@EWDesigns.lan
message=Direct all inquiries to:
maintainer=Jay Wheeler
trailer=at EarthWalk Software.
copyright=Copyright © 2001. EarthWalk Software.
[debug]
debug=0
