ЦИФРОВАЯ БИБЛИОТЕКА GREENSTONE РУКОВОДСТВО

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

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

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

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

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

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

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

	Значение	Цель
maintainer	NULL или E-mail адрес	Адрес электронной почты лица, обслуживающего сайт, который используется с целью уведомления. Если NULL, E-mail события заблокированы
MailServer	NULL или имя сервера	Сервер исходящей почты для этого сайта. ЕслиNULL, то используется mail. домен-обслуживающего сайт лица (например, если обслуживает сайт - [email protected], то значение по умолчанию - 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 или UTCTime или Absolute	Формат, в котором информация о времени приписана к файлу регистрации. LocalTimeпроизводит формат "четверг 07 декабря 12:34 NZDT 2000 ", UTCTIME - тот же самый формат, но в GMT (среднем времени по Гринвичу), и absolute- целое число, представляющее количество секунд с момента 00:00:00 01/01/1970 GMT
LogEvents	AllEvents или CollectorEvents или 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. Вернемся к рисунку 40, из которого видно, что большинство CGI -аргументов определено непосредственно в пределах программы библиотеки C++. Однако, иногда полезно определить новые аргументы или отредактировать существующие во время процесса конфигурации, таким образом избегая потребности перетранслировать библиотеку.

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

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

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

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

Table 21 Линии в gsdlsite.cfg

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

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

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled “GNU Free Documentation License.”