Конфигурирование вашего Greenstone - сайта

В системе Greenstone имеется два файла конфигурации, которые используются для того, чтобы формировать различные аспекты вашего Greenstone-сайта. "Основной" файл конфигурации main.cfg находится в GSDLHOME/ETC, и файл конфигурации "сайта" gsdlsite.cfg он находится в GSDLHOME/CGI-BIN. Каждый из этих файлов управляет определенными аспектами конфигурации всего сайта. Оба могут быть просмотрены со страницы администрирования Greenstone.

Основной файл конфигурации

Основной файл конфигурации main, cfg используется для конфигурирования регистратора как части Greenstone для поля запросов и для отображения страниц. Вы можете управлять всем, начиная от языков, которые использует интерфейс, и заканчивая хранением данных о регистрации.

Обслуживание сайта и регистрация

Строки в файле конфигурации указывают на то, как должен обслуживаться ваш Greenstone-сайт, какие средства для этого предлагаются, какие регистрируются события и какие сообщения получает создатель коллекции. В Таблице <tblref table_configuration_options_for_site_maintenance_and_logging> подробно представлены некоторые доступные опции; остальные описаны в следующих разделах.

<tblcaption table_configuration_options_for_site_maintenance_and_logging|Языковая поддержка></tblcaption>

Значение Цель
maintainer NULL или E-mail адрес Адрес электронной почты лица, обслуживающего сайт, который используется с целью уведомления. Если NULL, E-mail события заблокированы
MailServer NULL или имя сервера Сервер исходящей почты для этого сайта. ЕслиNULL, то используется mail. домен-обслуживающего сайт лица (например, если обслуживает сайт - help@example.com, то значение по умолчанию - mail.example.com). Если это не разрешено допустимым SMTP-сервером, то E-mail события не будут работать
status enabled или disabled Определяет, должна ли страница "Обслуживание и администрирование" быть доступной
collector enabled или disabled Определяет, доступна ли коллекция конечного пользователя, формирующая средство "коллектора"
logcgiargs true или false Если true, регистрация пользования хранится в usage.txt. Если true, информация о пользователях сайта
usecookies true или false собрана (используя cookies) и записана в usage.txt(это работает только в том случае, если logcgiargs принимает значение true)
LogDateFormat LocalTime или <br/>UTCTime или <br/>Absolute Формат, в котором информация о времени приписана к файлу регистрации. LocalTimeпроизводит формат "четверг 07 декабря 12:34 NZDT 2000 ", UTCTIME - тот же самый формат, но в GMT (среднем времени по Гринвичу), и absolute- целое число, представляющее количество секунд с момента 00:00:00 01/01/1970 GMT
LogEvents AllEvents или <br/>CollectorEvents<br/> или disabled Регистрация некоторых событий в events.txt. AllEvents регистрирует все события Greenstone, CollectorEvents регистрирует только события, связанные с Collector (Коллектором), a disabled не регистрирует никаких событий.
EmailEvents enabled или disabled Отправка электронной почты лицу, обслуживающему коллекцию (если он один - см. его опцию), каждый раз, когда что-то случается
EmailUserEvents enabled или disabled Отправка электронной почты пользователю в ответ на некоторые события - например коллектора, заканчивающего компоновку коллекции
macrofiles список макро имен файлов Определяет, какой макрос является доступным для программного обеспечения интерфейса пользователя Greenstone

Языковая поддержка

Два вида вхождений в файле конфигурации main.cfg затрагивают пути обработки различных языков. Они определяют, какие языки и кодировки являются доступными на странице Preferences page. Строки Encoding определяют различные типы кодировки символов, которые могут быть выбраны. Строки Language определяют, какие языки интерфейса пользователя могут быть выбраны (конечно, для каждого возможного языка должна существовать макрокоманда языка).

Строка Encoding может содержать четыре возможных значения: shortname, longname, map и multibyte. Shortname - стандартная метка набора символов, и должна быть определна для всего кодирования. Longname дает имя кодирования, которое отображено на странице выбора предпочтений -Preferences page. Если это значение отсутствует, то по умолчанию используется shortname. Значение тар принудительно для всех кодировок, кроме utf8, которая обработана внутренне (и всегда должна быть допустима). Значение multibyte должно быть установлено для всех наборов символов, которые требуют больше, чем один байт на символ. Файл main.cfg определяет множество кодировок, большинство из которых было прокомментировано. Чтобы допустить использование кодировок, удалите символ комментария "#".

Каждая строка Language может содержать три возможных значения, shortname, longname, и default_encoding. Shortname - двухбуквенное обозначение языка в соответствии с требованиями ISO 639. Longname -название, которое используется для языка на странице выбора предпочтений - Preferences page. При отсутствии этого значения, по умолчанию используется shortname. Опция default_encoding используется, чтобы определить предпочтительную кодировку для выбранного языка.

Параметры страниц и CGI-аргументов

Параметры страницы и CGI-аргументов могут быть определены внутри файла конфигурации main.cfg. Вернемся к рисунку ## , из которого видно, что большинство CGI -аргументов определено непосредственно в пределах программы библиотеки C++. Однако, иногда полезно определить новые аргументы или отредактировать существующие во время процесса конфигурации, таким образом избегая потребности перетранслировать библиотеку.

Чтобы сделать это, вы должны использовать опцию конфигурации cgiarg. Cgiarg может использовать до шести параметров; shortname, longname, multiplechar, argdefault, defaultstatus и savedarginfo. Эти параметры соответствуют вариантам CGI-аргумента, описанным в Разделе receptionist. Например, в значении по умолчанию main.cfg опция конфигурации cgiarg используется, чтобы установить значения по умолчанию существующих а и р CGI-аргументов дляр и home соответственно.

Параметры страницы - частные случаи CGI-аргументов, которые соответствуют параметрам в файлах макрокоманды Greenstone. Например, CGI-аргумент /непосредственно соответствует параметру / = в макрофайлах. Чтобы определить CGI-аргумент, который также может быть параметром страницы, используйте опцию конфигурации pageparam.

Лучший способ узнать о различных вариантах конфигурации, возможных в файле конфигурации main-cfg, состоит в том, чтобы экспериментировать непосредственно с этим файлом. Обратите внимание на то, что если вы используете локальную Windows-версию библиотеки Greenstone, то прежде чем любые изменения файлов конфигурации вступят в силу, вам необходимо будет перезапустить сервер.

Файл конфигурации сайта

<tblcaption table_lines_in_gsdlsitecfg|Линии в gsdlsite.cfg></tblcaption>

Линия Функция
gsdlhome Путь в директорию GSDLHOME.
httpprefix Веб адрес GSDLHOME. Вам не нужна эта линия, если корневой документ на вашем веб серевере установлен как GSDLHOME.
httpimage Веб адрес содержит графику для интерфейса пользователя. Если кореневой документ веб сервера установлен как GSDLHOME, то это будет /images.
gwcgi Веб адрес этого cgi скрипта (обычно имеет окончание library. Это не требуется, если ваш веб сервер устанавливает переменную SCRIPT_NAME.
maxrequests (Применяется только, если использован fast-cgi.) Должно произойти определённое число запросов fast-cgi, до того, как он выйдет. Это должно быть малое число для регулирования библиотеки, и, в других случаях - крупное.

Файл конфигурации сайта gsdlsite.cfg устанавливает переменные, которые используются программным обеспечением библиотеки и веб-сервером во время выполнения и постоянно находится в том же самом каталоге, что и библиотечная программа. Таблица <tblref table_lines_in_gsdlsitecfg> описывает строки в этом файле; подробнее они рассматриваются в Разделе 5 документации - Цифровая библиотека Greenstone: Руководство по установке.