PRÁCTICO • Greenstone
Construyendo Bibliotecas Digitales con Greenstone
EL COLECCIONISTA
El paquete Greenstone te ayuda a construir tu propia biblioteca
digital. POR CHI-YU HUANG
P
ublicar documentos en la web es
sencillo, pero los bibliotecarios,
documentalistas y otros expertos
necesitan sistemas más sofisticados para
organizar la información en colecciones
digitales. Una opción es construir una red de
notas e índices estáticos, aunque esta alter-
nativa es demasiado poco flexible,
requiriendo un incremento del trabajo y
actualizaciones constantes. Otras colecciones
digitales hacen uso de scripts caseros y otras
herramientas propias, pero estas herramien-
tas vuelven a necesitar un trabajo
considerable y un mantenimiento continuo.
Una opción para los usuarios de software
libre que quieren construir colecciones digi-
tales de una manera rápida y flexible es
Greenstone. Greenstone es un conjunto de
herramientas que pueden ser usadas para la
construcción de nuestras propias bibliotecas
digitales. Este software no sólo indexa nues-
tros documentos, sino que además
proporciona un interfaz para la definición y
organización de los metadatos. La herra-
mienta Greenstone proporciona a los
documentalistas y gestores de colecciones
cierta ventaja en la tarea de crear librerías
digitales elegantes y altamente estructuradas.
En este artículo introduciremos el soft-
ware para la generación de colecciones
digitales Greenstone, y describiremos cómo
instalarlo y configurarlo. Adicionalmente
mostraremos cómo construir una biblioteca
digital haciendo uso de un DVD que hemos
creado a partir de un montón de artículos
de Linux Magazine descargados de Internet
y clasificados por número.
Qué es Greenstone
Greenstone es un programa de biblioteca
digital desarrollado en la Universidad de
34 Número 20
Waikato en Nueva Zelanda [1]. El
paquete Greenstone proporciona una
nueva forma de organizar, preservar y
publicar información en Internet o en un
CD/DVD. No se necesita de ningún soft-
ware adicional para acceder a una
colección de documentos Greenstone.
Valdría con cualquier navegador web.
Una biblioteca Greenstone puede ges-
tionar gran cantidad de tipos diferentes
de formatos de documentos, incluidos
HTML, PostScript, PDF y MS-Word. De
hecho, Greenstone no está limitado a
documentos de texto, sino que además
puede gestionar documentos de imagen,
audio y vídeo.
Esta herramienta consigue la indexa-
ción de todo el texto almacenado,
permitiendo a los usuarios la búsqueda
en el contenido de los documentos o en
los metadatos almacenados, tales como
el título y autor. Greenstone es además
altamente configurable, permitiendo a
los usuarios el diseño de la apariencia y
del comportamiento de la colección, así
como del interfaz web.
La aplicación soporta múltiples len-
guajes, incluidos el Árabe, Chino, Inglés,
Francés, Maorí y Español entre otros.
Puedes encontrar ejemplos de bibliote-
cas digitales desarrolladas con
Greenstone en [2] y [3].
Preparación
Greensone requiere de un servidor web
y, naturalmente, Apache es el recomen-
dado. Supondremos que el servidor web
Apache ya está instalado y nos centrare-
mos en cómo configurarlo para que
funcione con la herramienta. Además,
Apache está disponible para la mayoría
WWW.LINUX-MAGAZINE.ES
de las distribuciones Linux, y en todo
caso se puede descargar de [5].
Otro de los requisitos de Greenstone es
Perl. Para comprobar que Perl ya está insta-
lado en nuestro sistema podemos abrir un
terminal y escribir perl -v para ver si aparece
un mensaje donde se indica la versión del
intérprete. Como en el caso anterior, la
mayoría de las distribuciones Linux vienen
con una versión de Perl disponible.
Nuestra aplicación se ejecuta en la mayo-
ría de los Sistemas Operativos además de
Linux, existiendo una versión para Solaris,
Mac OS/X y Windows. De hecho, se podrá
ejecutar en casi cualquier variante de Unix.
Naturalmente para compilar Greenstone
desde su código fuente en Unix, necesitare-
mos del compilador C/C++ de GNU
(GCC) y, eso sí, del Gestor de Bases de
Datos de GNU (GDBM).
Instalación
Lo primero que hay que hacer para instalar
Greenstone es descomprimir el fichero tar:
$ tar xzvf gsdl-2.62-unix.tar.gz
La última versión tiene un instalador que
nos guía pasa a paso por el proceso de insta-
lación. Para ejecutar este instalador:
$ cd gsdl-2.62-unix
$ ./setupLinux.bin
El programa es instalado en /usr/local/gsdl
por defecto, pero esto requiere de privile-
gios de administrador. De todas maneras es
posible configurar la instalación para que
ésta se produzca en el directorio home del
usuario. Existen tres opciones diferentes de
instalación:

• Biblioteca Web (Web Library)
• Código Fuente (Source Code)
• Personalizada (Custom)
Si seleccionamos la segunda opción, Código
Fuente, el instalador copiará todos los fiche-
ros necesarios en los directorios de destino.
De esta manera podremos compilar el
código fuente con:
$ ./configure
$ make && make install
El tiempo de compilación es variable,
dependiendo de las características de la
máquina. Si estamos usando una máquina
Linux sobre un PC Intel x86 y es la primera
vez que usamos Greenstone, se recomienda
seleccionar la primera opción: Web Library,
que es la que instalará los binarios ya pre-
compilados. Esta opción sólo tardará unos
minutos. Al final de la instalación, seremos
consultados por una contraseña de admi-
nistración.
Montando el Servidor Web
Suponiendo que estamos usando el servi-
dor Apache y que éste ya está en
funcionamiento, seguramente necesitare-
mos los privilegios de administrador (root)
para realizar los cambios que vienen a con-
tinuación. Como es costumbre, si no
disponemos de dichos privilegios debere-
mos hablar educadamente con el
administrador del sistema para que nos
eche una mano. Otra opción sería instalar y
ejecutar Apache como un usuario normal.
El servidor web debe poder ejecutar el
programa de biblioteca, que corresponde
con la aplicación web de biblioteca de
Greenstone. Usaremos la directiva
ScriptAlias de Apache para configurar un
directorio cgi-bin para nuestra aplicación.
Esto lo haremos añadiendo las siguientes
directivas al fichero de configuración de
Apache, httpd.conf:
ScriptAlias /gsdl/cgi-bin U
“/home/myuser/local/gsdl/cgi-bin”
<Directory U
“/home/myuser/local/gsdl/cgi-bin”>
Options None
AllowOverride None
</Directory>
Necesitaremos además configurar el direc-
torio de Greenstone para que sea accesible
por web, añadiendo la siguiente directiva
Alias tras la directiva ScriptAlias de nuestro
fichero de configuración:
Alias /gsdl U
“/home/myuser/local/gsdl”
<Directory U
“/home/myuser/local/gsdl”>
Options Indexes
MultiVires U
FollowSymLinks
AllowOverride None
Order allow, deny
Allow from all
</Directory>
Hay que fijarse en la referencia a
/home/myuser/local/gsdl en las directivas
anteriores. Es necesario cambiar este
camino por el directorio donde tengamos
instalado el programa Greenstone.
Una vez reiniciado el servidor Apache,
podemos acceder a Greenstone a través
de nuestro navegador web y yendo a la
dirección mostrada [6]. Podemos omitir
el puerto de la URL si nuestro servidor
web está funcionando en el puerto por
defecto 80. Por otro lado, si estamos eje-
cutando Apache como un usuario no
privilegiado y hemos modificado el
puerto de acceso, deberemos especifi-
carlo en la URL.
La Estructura de Greenstone
La estructura de directorio de Greenstone
es mostrada en la Figura 1. Cuando cons-
truimos una nueva colección ésta es
creada en una nueva carpeta, llamada
collection_name, en el directorio de colec-
ciones de Greenstone
/home/myuser/local/gsdl/collect. Cada
colección contiene la misma estructura
directorio y subdirectorios (ver Figura 1).
En el directorio import es donde debe-
mos localizar nuestro material original. El
directorio archive contiene los resultados
del proceso de importación. El directorio
building es un directorio temporal usado
durante el proceso de construcción de la
colección. Su contenido es movido al
directorio index una vez ha concluido el
proceso. El directorio etc contiene la infor-
mación de configuración de la colección,
localizada principalmente en el fichero
collect.cfg. El directorio images contiene
las imágenes específicas de la colección.
En el directorio perllib podemos encontrar
los diferentes programas Perl específicos
de la colección. Para obtener más infor-
mación de la estructura de directorios del
sistema Greenstone es necesario consul-
tar la Guía de Usuario [8].
WWW.LINUX-MAGAZINE.ES
Greenstone • PRÁCTICO
Figura 1: Estructura de una instalación
Greenstone.
Construyendo con GLI
Para poder empezar a ver cómo funciona
realmente Greenstone, mostraremos cómo
construir una colección de biblioteca digital
haciendo uso de los archivos en DVD des-
cargados de Linux Magazine. Hay que notar
que esta colección es sólo para uso perso-
nal. Como norma general es importante
asegurarnos de cumplir los requisitos de la
licencia para cualquier material que publi-
quemos en formato biblioteca digital.
Nos aseguramos de que el DVD está
introducido en la unidad y que está mon-
tado. Necesitamos conocer dónde está el
directorio de montaje. Por ejemplo, en
Ubuntu el DVD se monta en /media/cdrom.
Ahora podemos construir la colección
usando el Interfaz de Biblioteca de Greens-
tone (Greenstone Librarian Interface – GLI).
La GLI es una aplicación gráfica incluida en
la distribución Greenstone que nos permite
construir y adaptar nuestras colecciones de
manera sencilla mediante el uso del ratón.
GLI es una aplicación Java que necesita del
Java Runtime Environment 1.4 de Sun. Para
ejecutar GLI tenemos que escribir:
cd /home/myuser/local/gli
./gli.sh
Cuando ejecutamos GLI por primera vez
seremos consultados por la URL de nuestra
biblioteca Greenstone, que como ya hemos
comentado se encuentra localizada en [6].
GLI nos proporciona un entorno de tipo
walkthrough para la construcción de
Número 20 35
PRÁCTICO • Greenstone
Figura 2: El interfaz de bibliotecario de Greenstone (GLI).
nuestras colecciones digitales. En este
procedimiento los pasos básicos son:
• Reunión de documentación (en los
paneles Download y Gather)
• Asignación de metadatos (panel Enrich)
• Diseño de las estructuras de indexación
y navegación
• Construcción de la colección
Para crear una nueva colección elegimos
New en el menú File. Introducimos el nom-
bre de la colección (sugerimos “Linux
Magazine”) y una descripción antes de pul-
sar OK. Cuando nos pregunte por el tipo de
metadatos a usar es conveniente seleccio-
nar el conjunto de metadatos de Dublin
Core. Podemos seleccionar documentos (o
directorios completos de documentos)
desde el panel de trabajo (Workspace,
situado a la izquierda) y arrastrarlos hasta el
panel de colecciones (Collection, a la dere-
cha). El comportamiento de GLI es similar
al de los gestores de ficheros usuales, permi-
tiendo la copia y eliminación de ficheros de
nuestra colección (Figura 2).
Greenstone es capaz de extraer de
manera automática la útil metainformación
de los ficheros de documentos durante el
proceso de construcción. Esta característica
es realmente interesante cuando el docu-
mento contiene metadatos del tipo título,
autor, temática o palabras clave. Puesto que
los documentos de nuestro DVD no contie-
nen este tipo de metadatos, GLI no podrá
extraer nada demasiado útil de manera
automática. Podemos, por otro lado, añadir
la metainformación de manera manual en
el panel destinado a esta tarea, Enrich. Los
metadatos pueden ser tratados a nivel de
carpetas o ficheros. La metainformación
36 Número 20
Figura 3: Las herramientas de diseño están disponibles desde el
panel de Diseño.
asignada a una carpeta es heredara por
todos los ficheros incluidos en ésta.
Una vez copiados los documentos (o
directorios) al área de colección, podríamos
necesitar cambiar los permisos de los fiche-
ros para lograr la correcta construcción de
ésta:
cd /home/myuser/local/gsdl/collect/U
limuxmag/import
chmod -R +w *
Ahora estamos listos para la construcción de
la colección. Para este ejemplo, hemos
copiado sólo los artículos de los números de
1 al 4. De esta manera lograremos disminuir
el tiempo del proceso de construcción. Si
deseamos trabajar con el archivo completo
deberemos arrastrar todos los directorios,
pero habrá que estar preparados a esperar un
poco hasta que se complete todo el proceso
de construcción.
Para construir la colección sólo hay que ir
al panel Create y pulsar sobre el botón Build
Collection. Una vez esté finalizado, nuestra
colección estará disponible para su acceso.
Para poder verla en nuestro navegador web,
deberemos pulsar sobre el botón Preview
Collection. Como ya se ha comentado, en el
caso de que existan metadatos, éstos serán
extraídos automáticamente durante el pro-
ceso de construcción. En este caso hemos
tenido que realizar algunos arreglillos de
manera manual. Desde el panel Enrich
hemos añadido el número de la publicación
de Linux Magazine en el campo dc.Descrip-
tion a nivel de carpeta. Haciendo esto hemos
logrado que todos los artículos de una misma
publicación queden agrupados cuando se
establezca una clasificación de navegación.
WWW.LINUX-MAGAZINE.ES
Hay que destacar que no existe un campo
para ‘número de publicación’ en el con-
junto de metadatos establecidos por Dublin
Core. Es por eso por lo que hemos usado el
campo dc.Description para almacenar dicha
información. Adicionalmente, a nivel de
fichero, hemos añadido la entrada para
título en el campo dc.Title (en sustitución
del poco útil valor encontrado automática-
mente). Hemos añadido la sección de Linux
Magazine (ej: Noticias Kernel, Práctico,
Desarrollo) al campo de metadatos
dc.Resource Identifier. El prefijo dc viene de
Dublin Core, que corresponde con el están-
dar de metadatos adoptado por Greenstone.
En Greenstone los documentos y las
especificaciones de metadatos son importa-
dos por módulos software denominados
plugins. Éstos permiten que la aplicación
soporte diferentes formatos de documentos.
Podemos añadir o eliminar plugins depen-
diendo de los documentos que tengamos en
nuestra colección (los únicos obligatorios
son GAPlug, ArcPlug y RecPlug). Puesto que
el archivo de documento de Linux Maga-
zine está compuesto principalmente por
documentos PDF y HTML, los plugins más
importantes para esta colección serían
PDFPlug y HTMLPlug.
Indexado
Greenstone permite la búsqueda de texto,
por todo el cuerpo del documento de la
colección, desde una ventana de navega-
ción web. Podemos buscar por cualquier
combinación de palabras o frases. Por
defecto, las colecciones Greenstone vienen
con tres índices de consultas: texto, título y
fuente. Podemos cambiar los índices asigna-
dos a nuestra colección desde la sección

Índices de Búsquedas del panel de diseño
(Figura 4). También es posible eliminar el
índice de fuente de nuestra colección Linux
Magazine, puesto que hace referencia sólo
al nombre del fichero del documento, y en
este ejemplo no es un parámetro de bús-
queda útil. Además hemos añadido el
campo de metadatos dc.Title como un ele-
mento para el índice de título.
La Figura 5 muestra el interfaz de búsque-
das para la búsqueda por títulos. Greenstone
permite al usuario indicar términos de con-
sultas más complejos. El interfaz de
búsqueda avanzada puede ser adaptado
desde la opción de Preferencias, localizada
en la esquina derecha de nuestra página de la
colección.
Clasificaciones de Navegación
Greenstone permite a los usuarios navegar
por los documentos de la colección. La
estructura de la navegación es generada de
manera automática a partir de los metadatos
asociados a cada documento de la colección.
Podemos establecer los clasificadores de
navegación desde la opción de mismo nom-
bre situada en el panel de diseño (Figura 6).
Todos los clasificadores generan una estruc-
tura jerárquica que es usada para mostrar un
índice de navegación. El nivel más bajo en
dicha jerarquía corresponde normalmente a
los documentos, pero podría estar consti-
tuida por secciones para algunos
clasificadores. Existen varios tipos de clasifi-
cadores disponibles; para ver los detalles es
mejor consultar la Guía de Desarrollo de Gre-
enstone [7].
Para nuestra colección de Linux Magazine,
hemos usado los clasificadores AZList y
AZCompactList para establecer la estructura
Figura 4: Define los ajustes del índice en la sección de Índices de
Búsquedas del panel de Diseño.
de navegación. El clasificador AZList mues-
tra los términos clasificados en orden
alfabético, mientras que el clasificador
AZCompactList agrupa los términos que apa-
recen repetidos en la jerarquía bajo un nuevo
nodo, mostrado con un icono similar a una
estantería. Los parámetros de clasificación (y
sus opciones asociadas) de nuestra colección
Linux Magazine son:
• Para la navegación por título: AZList
-metadata dc.Title
• Para la navegación por número de
publicación: AZCompactList -metadata
dc.Description -buttoname issue
• Para navegar por las secciones de Linux
Magazine: AZCompactList -metadata
dc.Resource Identifier -mingroup 1 -but-
tonname section
Al establecer la opción mingroup a 1 indica-
mos que el nodo de estantería debe ser
creado al nivel más alto, aún cuando exista
un solo ítem en el grupo. Desde el interfaz
web de Greenstone podemos seleccionar una
de las clasificaciones de navegación (por
ejemplo: títulos, autor y práctico) pulsando
sobre el icono correspondiente.
Podemos configurar el icono de cada clasi-
ficación de navegación. Si no estamos
conforme con los valores establecidos por
defecto, podremos crear nuestros propios
iconos. En nuestro ejemplo hemos creado
nuevos iconos para las opciones de navega-
ción de secciones y publicaciones. Es posible
asociar estos iconos con sus respectivas clasi-
ficaciones añadiéndolos en la opción nombre
del botón (buttonname, Figura 6). Mostrare-
mos después cómo crear estos iconos de
estilo similar a los de Greenstone.
Figura 5: El interfaz para la búsqueda de títulos usando nuestra muy
útil colección de ejemplo.
WWW.LINUX-MAGAZINE.ES
Greenstone • PRÁCTICO
Características de Formato
Las páginas web de la biblioteca Greens-
tone son generadas dinámicamente bajo
demanda. Los comandos de formato se
usan para poder cambiar la apariencia de
dichas páginas, en especial en cómo son
mostrados los documentos en la navega-
ción y en la lista de resultado de
búsquedas.
Para poder manipular los comandos de
formateo es necesario elegir las Caracterís-
ticas de Formato (Format Features) del
panel de Diseño. Podemos hacer uso de
etiquetas HTML, valores de metadatos
(encerrados entre corchetes), algunos
comandos propios de formateo de cadenas
(ej: highlight, numleafdocs) y expresiones
condicionales (cómo {If} o {Or}). El lis-
tado completo se encuentra en [7].
Podemos adaptar la estética de cada una
de las clasificaciones de navegación. Por
ejemplo, para el clasificador de navegación
de Título, seleccionemos CL1:AList -meta-
data dc.Title desde la sección de Selección
de Características (Choose Feature), y VList
(determina el formato de la lista vertical de
resultados de la búsqueda) del compo-
nente elegido. Nosotros hemos adaptado la
apariencia usando para ello las siguientes
sentencias de formato:
<td valign=top>U
[link][icon][/link]</td>
<td>[srclink][srcicon]U
[/stclink]</td>
<td>[highlight]{Or}U
{[dc.Title],[ex.Title],U
Untitled}[/highlight]
<br>[dc.Description]</td>
Número 20 37
PRÁCTICO • Greenstone
Figura 6: Configurando las clasificaciones de navegación desde el
panel de Diseño.
Esta sentencia de formato nos mos-
trará un icono que enlaza a la
versión Greenstone del documento,
un icono que enlaza al documento
original, el titulo y los detalles de
publicación para cada documento en
la lista de navegación A-Z de títulos
(Figura 7).
Con el clasificador de navegación
por publicaciones (usando
CL2:AZCompactList -metadata dc.
Description en Choose Feature y VList
en el componente seleccionado),
hemos realizado el formateado con
las siguientes sentencias:
<td valign=top>U
[link][icon][/link]</td>
<td>{If}{[numleafdocs],U
<b>[Title]([numleafdoc])</b>,U
[srclink][srcicon][/srclink]
<td>[highlight]{Or}U
{[dc.Title],[ex.Title],U
Untitle}[/highlight]U
</td>}</td>
Con esto lograremos que los docu-
mentos queden agrupados bajo sus
respectivas publicaciones, y mostra-
remos el número total de
documentos para cada publicación.
De manera similar, las opciones
para el clasificador de navegación de
secciones (seleccionamos
CL3:AZCompactList -metadata
dc-Resource Identifier en Choose Fea-
ture y VList para nuestro
componente) son las que mostramos
un poco más abajo. Aquí se ha aña-
dido una opción adicional:
38 Número 20
Figura 7: Navegando por títulos en Greenstone.
<br>[dc.Description].
<td valign=top>U
[link][icon][/link]</td>
<td>{If}{[numleafdocs],U
<b>[Title]([numleafdoc])</b>,U
[srclink][srcicon][/srclink]
<td>[highlight]{Or}U
{[dc.Title],[ex.Title],U
Untitle}[/highlight]<br>U
[dc.Description]</td>}</td>
Cada una de las opciones y configuración
anteriores pueden establecerse fácilmente
desde la sección Format Features del panel
de diseño de GLI. Las opciones de formatos
pueden cambiarse sin necesidad de volver a
reconstruir la colección.
Sencilla Adaptación de la
Colección
Añadir un nuevo icono a nuestra colección
es sencillo. Podemos indicar los iconos aso-
ciados a las páginas ‘acerca de…‘ y la
principal desde la sección general del panel
de diseño. Además, Greenstone propor-
ciona ciertas facilidades para la creación de
imágenes de colección e iconos de clasifica-
dores de estilo similar a los usados por este
programa. Podemos ir a la página http://
www.greensotne.org/make-images.html
para crear nuevas imágenes e iconos. Estos
gráficos deben ser alojados en la carpeta de
imágenes de la instalación de Greenstone
(consultar la Figura 2). La página web
explica cómo configurar Greenstone para
usar las nuevas imágenes creadas.
Es posible reconstruir nuestra colección
en cualquier momento. Los comandos de
formato pueden ser modificador sin necesi-
dad de reconstruir la colección. Podremos
WWW.LINUX-MAGAZINE.ES
ver cualquier cambio efectuado simple-
mente refrescando la página web o
pulsando sobre el botón de Vista Previa de
la Colección (Preview Collection) en el panel
de creación. Para más opciones de adapta-
ción y operación hay que consultar la Guía
de Usuario de Greenstone [8].
Sumario
Greenstone se revela como una herramienta
extremadamente útil en aplicaciones de
ordenación, búsqueda y organización de un
número grande de documentos electróni-
cos. Una vez construida y adaptada la
biblioteca digital, ésta estará accesible desde
cualquier navegador web. ■
Recursos
[1] El Proyecto de la Librería Digital de
Nueva Zelanda: http://www.nzdl.org
[2] Poyectos de DL Consulting: http://
www.dlconsulting.co.nz/cgi-bin/index.
cgi?a=p&p=projects
[3] Ejemplos de Greenstone en Acción:
http://www.greenstone.org/cgi-bin/
library?a=p&p=examples
[4] Descarga del Software Greenstone:
http://prdownloads.sourceforge.net/
greenstone/gsdl-2.62-unix.tar.gz
[5] Apache: http://www.apache.org
[6] Apunta tu navegador a la URL: http://
localhost:9090/gsdl/cgi-bin/library
[7] Adaptando tu Librería Greenstone:
http://www.greenstone.org/cgi-bin/
library?a=p&p=faqcustomize#customi
zeformat
[8] Documentación de Greenstone:
http:///www.greenstone.org/cgi-bin/
library?a=p&p=docs