En Greenstone, se utilizan dos archivos de configuración para configurar las diversas características del sitio Greenstone: el archivo de configuración “principal” main.cfg, que se encuentra en el directorio GSDLHOME/etc, y el archivo de configuración “de sitio” gsdlsite.cfg, que se encuentra en el directorio GSDLHOME/cgi-bin. Ambos archivos controlan aspectos específicos de la configuración del sitio y pueden visualizarse desde la página de administración de Greenstone.

El archivo de configuración principal main.cfg sirve para configurar el recepcionista, esto es, la parte de Greenstone que procesa las consultas y muestra las páginas. Se puede controlar todo, desde las lenguas que la interfaz puede utilizar hasta los registros que se llevarán.

Las líneas del archivo de configuración establecen la manera en que su sitio Greenstone se mantendrá, qué funciones ofrecerá, qué eventos se registrarán y qué notificaciones se harán al responsable del mantenimiento. En el Cuadro <tblref table_configuration_options_for_site_maintenance_and_logging> se muestran algunas de las opciones disponibles; las restantes se exponen en las secciones siguientes.

<tblcaption table_configuration_options_for_site_maintenance_and_logging|Opciones de configuración para el mantenimiento del sitio y el registro de utilización (logging)></tblcaption>

El archivo de configuración main.cfg contiene dos tipos de entradas que inciden en la gestión de las diferentes lenguas. Éstas determinan qué idiomas y qué códigos estarán disponibles en la página de preferencias. Las líneas encoding (codificación) especifican los diferentes tipos de codificación de caracteres que pueden seleccionarse. Las líneas language (lengua) especifican qué idiomas se podrán seleccionar para la interfaz de usuario (por supuesto, es preciso que exista una macro de lengua para cada lengua posible).

La línea encoding (codificación) puede contener cuatro valores posibles: shortname (nombre corto), longname (nombre largo), map (correspondencia) y multibyte. El valor shortname es la etiqueta del juego de caracteres estándar y debe especificarse en todas las codificaciones. El valor longname da el nombre de codificación que se especifica en la página de preferencias. En su ausencia, el valor por defecto es el de shortname. El valor map es obligatorio para todas las codificaciones, excepto para UTF-8, que se maneja internamente (y que debería siempre estar activado). El valor multibyte debería aplicarse a todos los juegos de caracteres que necesitan más de un byte por carácter. El archivo main.cfg especifica numerosas codificaciones, la mayoría de las cuales está desactivada, pues están comentadas de manera que la programación nos las toma en consideración. Para activar una codificación, suprima el carácter de comentario “#”.

Cada línea language (idioma) puede contener tres valores posibles: shortname (nombre corto), longname (nombre largo) y default_encoding (codificación por defecto). El valor shortname es el símbolo de idioma de dos letras ISO 639 y es obligatorio. El valor longname da el nombre de la lengua especificada en la página de preferencias. En su ausencia, el valor por defecto es el de shortname. La opción default_encoding sirve para especificar la codificación preferida para esa lengua.

Se pueden definir parámetros de página y argumentos CGI en el archivo de configuración main.cfg. Recuerde que en la Figura <imgref figure_using_the_cgiargsinfoclass_from_pageactioncpp> la mayoría de los argumentos CGI se definen en el seno mismo del código C++ de la biblioteca. Sin embargo, a veces resulta útil definir nuevos argumentos o modificar los argumentos existentes en los archivos de configuración, lo cual evita recompilar la biblioteca.

Para ello, utilice la opción de configuración cgiarg, que puede contener hasta seis argumentos: shortname (nombre corto), longname (nombre largo), multiplechar (caracteres múltiples), argdefault (argumento por defecto), defaultstatus (estado por defecto) y savedarginfo (información de Resguardo ( backup) de argumentos). Estos argumentos corresponden a opciones de argumentos CGI descritos en la Sección receptionist. Por ejemplo, en el archivo main.cfg por defecto, la opción de configuración cgiarg sirve para establecer los valores por defecto de los argumentos CGI existentes a y p con los valores p y home respectivamente.

Los parámetros de página son un caso particular de argumentos CGI que corresponden a los parámetros de los archivos de macros de Greenstone. Por ejemplo, el argumento CGI l corresponde directamente al parámetro l= en los archivos de macros. Se utiliza la opción de configuración pageparam para definir un argumento CGI también como parámetro de página.

El mejor modo de aprender las diferentes opciones de configuración posibles en el archivo de configuración main.cfg es experimentar con éste. Recuerde que si está utilizando la versión Biblioteca Local de Greenstone con Windows, es preciso volver a arrancar el servidor para que toda modificación de los archivos de configuración surta efecto.

<tblcaption table_lines_in_gsdlsitecfg|Líneas del archivo gsdlsite.cfg></tblcaption>

El archivo de configuración del sitio gsdlsite.cfg, que se encuentra en el mismo directorio que el programa library, establece variables utilizadas por el programa de biblioteca y el servidor Web durante la ejecución. En el Cuadro <tblref table_lines_in_gsdlsitecfg> se enumeran las líneas de este archivo cuya explicación aparece en la Sección 5 de la Guía de Instalación de la Biblioteca Digital Greenstone.