source: trunk/gsdl/etc/main.cfg@ 1868

Last change on this file since 1868 was 1868, checked in by sjboddie, 23 years ago

Made a bunch of changes to the building code to support lots of new
languages and encodings. It's still kind of a mess but should be fixed
up over the weekend.

  • Property svn:keywords set to Author Date Id Revision
File size: 8.3 KB
Line 
1# This is the main configuration file for configuring
2# your Greenstone receptionist (i.e. the bit responsible
3# for the way things are displayed).
4
5# Email address of the webmaster of this Greenstone installation
6# If maintainer is set to "NULL" EmailEvents and EmailUserEvents
7# will be disabled.
8maintainer NULL
9
10# Outgoing (SMTP) mail server for this Greenstone installation.
11# This will default to mail.maintainer-domain if it's not set
12# (i.e. if maintainer is [email protected] then MailServer
13# will default to mail.cs.waikato.ac.nz). If MailServer doesn't
14# resolve to a valid SMTP server then the EmailEvents and
15# EmailUserEvents options (see below) won't be functional. Likewise,
16# turning off EmailEvents and EmailUserEvents will remove any
17# reliance on MailServer.
18MailServer NULL
19
20# Set status to "disabled" if you don't want the Maintenance and
21# Administration facility to be available.
22status enabled
23
24# Set collector to "disabled" if you don't want the "collector"
25# end-user collection building facility to be available.
26collector enabled
27
28# Set logcgiargs to true to keep a log of usage information in
29# $GSDLHOME/etc/usage.txt.
30logcgiargs true
31
32# Set usecookies to true to use cookies to identify users (cookie
33# information will be written to the usage log if logcgiargs is
34# true).
35usecookies true
36
37# LogDateFormat sets the format that timestamps will be stored in the usage
38# log (i.e. if logcgiargs is enabled). It takes the following values:
39LocalTime: (the default) The local time and date in the form
40 "Thu Dec 07 23:47:00 NZDT 2000".
41UTCTime: Coordinated universal time (GMT) in the same format as LocalTime.
42Absolute: Integer value representing the number of seconds since
43 00:00:00 1/1/1970 GMT
44LogDateFormat LocalTime
45
46# Log any events that Greenstone deems important in
47# $GSDLHOME/etc/events.txt.
48# The only events that are currently implemented come from the
49# collector (e.g. someone just built/deleted the following collection)
50# LogEvents may take values of:
51# AllEvents: All important events
52# CollectorEvents: Just those events originating from the collector
53# (e.g. someone just built a collection)
54# Disabled: Don't log events
55LogEvents Disabled
56
57# Email the maintainer whenever any event occurs. EmailEvents
58# takes the same values as LogEvents.
59# Note that perl must be installed for EmailEvents or
60# EmailUserEvents to work.
61EmailEvents Disabled
62
63# In some cases it may be appropriate to email the user about a
64# certain event (e.g. notification from the collector that a collection
65# was built successfully)
66EmailUserEvents false
67
68
69# The list of display macro files used by this receptionist
70macrofiles tip.dm style.dm base.dm query.dm help.dm pref.dm \
71 about.dm document.dm status.dm authen.dm \
72 users.dm html.dm extlink.dm delhistory.dm \
73 gsdl.dm english.dm chinese.dm french.dm german.dm maori.dm \
74 english2.dm french2.dm arabic.dm spanish.dm dutch.dm \
75 port.dm home.dm collect.dm
76
77
78# Define the interface languages and encodings supported by this receptionist
79
80# An "Encoding" line defines an encoding to be used by the receptionist
81# options are:
82# shortname -- Identifier for the given encoding. The shortname option is
83# mandatory and must be unique for each "Encoding" line.
84# longname -- The display name of the given encoding. If longname isn't set
85# it will default to using shortname instead.
86# type -- The type of encoding. Note that for most encodings this
87# value is the directory name under which the map file for
88# this encoding resides in the Greenstone unicode/MAPPINGS
89# directory (e.g. 'WINDOWS', 'ISO_8859' etc.). It may also
90# take the values 'CJK' and 'UTF8'.
91# mapfile -- The name of the map file for use when converting between
92# utf8 and the given encoding. The mapfile option is mandatory
93# for all encoding types with the exception of UTF8. If type
94# is CJK, mapfile is the abbreviated name of the encoding as
95# used by the binary mapping files (.ump files). i.e. if the
96# encoding uses the map files gbku.ump and ugbk.ump, mapfile
97# will be set to "gbk".
98# label -- The standard label to which you must set the value of
99# "charset" within http headers or html meta tags to get a web
100# browser to use the given encoding. The label option is
101# mandatory.
102Encoding shortname=utf8 "longname=Unicode (UTF-8)" type=UTF8 label=UTF-8
103Encoding shortname=iso1 "longname=Western (ISO-8859-1)" type=ISO_8859 mapfile=1.TXT label=ISO-8859-1
104Encoding shortname=w1251 "longname=Cyrillic (Windows-1251)" type=WINDOWS mapfile=1251.TXT label=windows-1251
105Encoding shortname=w1256 "longname=Arabic (Windows-1256)" type=WINDOWS mapfile=1256.TXT label=windows-1256
106Encoding shortname=w1256 "longname=Central European (Windows-1250)" type=WINDOWS mapfile=1250.TXT label=windows-1250
107Encoding shortname=gb "longname=Chinese Simplified (GBK)" type=CJK label=GBK mapfile=gbk
108Encoding shortname=sjis "longname=Japanese (Shift-JIS)" type=CJK label=shift_jis mapfile=sjis
109Encoding shortname=koi8r "longname=Cyrillic (KOI8-R)" type=CYRILLIC mapfile=koi8_r.txt label=koi8-r
110
111# The following encoding is not currently supported
112# Encoding shortname=eucjp "longname=Japanese (EUC)" type=CJK label=euc-jp mapfile=jis
113
114
115# A "Language" line defines an interface language to be used by the
116# interface. Note that it is possible to display only a subset of the
117# specified languages on the preferences page for a given collection by
118# using the "PreferenceLanguages" format option in your collect.cfg
119# configuration file.
120# options are:
121# shortname -- ISO 639 two letter language symbol. The shortname
122 option is mandatory.
123# longname -- The display name for the given language. If longname
124 isn't set it will default to using shortname instead.
125# default_encoding -- The encoding to use by default when using the given
126# interface language. This should be set to the
127# "shortname" of a valid "Encoding" line
128Language shortname=en longname=English default_encoding=iso1
129Language shortname=fr longname=French default_encoding=iso1
130Language shortname=zh longname=Chinese default_encoding=gb
131Language shortname=de longname=German default_encoding=iso1
132Language shortname=es longname=Spanish default_encoding=iso1
133Language shortname=mi longname=Maori default_encoding=iso1
134Language shortname=ar longname=Arabic default_encoding=w1256
135Language shortname=pt longname=Portuguese default_encoding=iso1
136Language shortname=nl longname=Dutch default_encoding=iso1
137
138
139# Define any additional page parameters to be used by the above macro files
140# (the current default page parameters are c (collection) and l (language)
141
142# Define v (version -- text or graphic) page parameter and give it a default
143# value of 0 (0 = text version off)
144pageparam v 0
145
146# Set the precedence given to the page parameters. This effects which macro
147# will be selected for display when there are multiple versions of the same
148# macro with different page parameters.
149# e.g. Given a macroprecedence of "c,v,l" and the following macro definitions:
150# _content_ []
151# _content_ [l=en]
152# _content_ [c=demo]
153# _content_ [v=1]
154# _content_ [l=fr,v=1,c=hdl]
155# If the corresponding cgi arguments were set to l=en&v=1&c=hdl then the
156# _content_[v=1] macro would be selected for display. It would be selected
157# ahead of the _content_[l=en] macro because "v" has a higher precedence
158# than "l". The _content_[l=fr,v=1,c=hdl] macro would not be selected
159# because one of the page parameters is completely wrong ("l").
160macroprecedence c,v,l
161
162
163# Define any additional cgi arguments. Most cgi arguments are built into
164# Greenstone but it's possible to define them here (or set defaults for
165# existing built-in cgi arguments).
166
167# define the "v" cgi argument (to correspond to the "v" page parameter defined
168# above).
169cgiarg shortname=v longname=version multiplechar=false argdefault=0 \
170 defaultstatus=weak savedarginfo=must
171
172# set a default value for the built-in "a" cgi argument
173cgiarg shortname=a argdefault=p
174
175# set a default value for the built-in "p" cgi argument
176cgiarg shortname=p argdefault=home
177
Note: See TracBrowser for help on using the repository browser.