BIBLIOTECA DIGITAL GREENSTONE GUÍA DEL PROGRAMADORChapter 4 CONFIGURACIÓN DEL SITIO GREENSTONEContentsEn 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. 4.1 Archivo de configuración principalEl 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. Mantenimiento del sitio y registro de utilización (logging)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 20 se muestran algunas de las opciones disponibles; las restantes se exponen en las secciones siguientes.
Table 20
Opciones de configuración para el mantenimiento del sitio y el registro de utilización (logging)
Selección de lenguasEl 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. Parámetros de página y argumentos CGISe pueden definir parámetros de página y argumentos CGI en el archivo de configuración main.cfg. Recuerde que en la Figura 40 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 3.8. 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. 4.2 Archivo de configuración de sitio
Table 21
Líneas del archivo gsdlsite.cfg
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 21 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. |
Copyright © 2002 2003 2004 2005 2006 2007 by the New Zealand Digital Library Project at the University of Waikato, New Zealand.
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.”