source: trunk/gsdl-documentation/manuals/xml-source/es/Install_es.xml@ 14099

<?xml version="1.0" encoding="UTF-8"?>
<Manual id="Install" lang="es">
<Heading>
<Text id="1">BIBLIOTECA DIGITAL GREENSTONE</Text>
</Heading>
<Title>
<Text id="2">GUÍA DE INSTALACIÓN</Text>
</Title>
<Author>
<Text id="3">Ian H. Witten y Stefan Boddie</Text>
</Author>
<Affiliation>
<Text id="4">Departamento de Informática <br/>Universidad de Waikato, Nueva Zelanda</Text>
</Affiliation>
<SupplementaryText>
<Text id="manual_index">De regreso al index</Text>
<Text id="top_index">De regreso al top index</Text>
</SupplementaryText>
<Text id="5">Greenstone es un conjunto de programas y aplicaciones de software especialmente diseñados para la creación y difusión de colecciones documentales digitales, el cual le ofrece una nueva forma de organizar la información y publicarla en Internet o CD-ROM. Greenstone ha sido elaborado como parte del proyecto de Biblioteca Digital de Nueva Zelanda de la Universidad de Waikato y actualmente es desarrollado y distribuido en colaboración con la UNESCO y la ONG Human Info. Es un software de código abierto disponible en <i>http://greenstone.org</i> bajo los términos y condiciones de la Licencia Pública General de GNU .</Text>
<Comment>
<Text id="6">Queremos estar seguros que este software trabaje bien para usted. Por favor comuníquenos cualquier problema que tenga con él a la siguiente dirección:[email protected]</Text>
</Comment>
<Version>
<Text id="7">Greenstone gsdl-2.50</Text>
</Version>
<Date>
<Text id="8">Marzo de 2004</Text>
</Date>
<Section id="about_this_manual">
<Title>
<Text id="9">Acerca de este manual</Text>
</Title>
<Content>
<Text id="10">En este documento se explica cómo instalar Greenstone para que usted pueda utilizarlo en su propia computadora. Se indica también cómo obtener otros programas asociados disponibles gratuitamente: el servidor Web Apache y Perl. Hemos procurado que el procedimiento de instalación sea lo más sencillo posible.</Text>
<Text id="11">El programa funciona en diferentes plataformas y con distintas configuraciones. Por consiguiente, son muchos los factores que inciden (o pueden incidir) en el procedimiento de instalación. En la Sección <CrossRef target="Chapter" ref="versions_of_greenstone"/> se mencionan algunos puntos que tendrá usted que examinar antes de instalar Greenstone. En la <CrossRef target="Chapter" ref="installation_procedure"/> se detalla el procedimiento de instalación para todas las distintas versiones; sólo es necesario que lea usted la parte correspondiente a su sistema operativo. La Sección <CrossRef target="Chapter" ref="greenstone_collections"/> trata de las colecciones de demostración de la biblioteca digital que están incluidas en la distribución. En la Sección <CrossRef target="Chapter" ref="setting_up_webserver"/> se explica cómo instalar servidores Web comunes, Apache y PWS/IIS de Microsoft, para que funcionen con Greenstone. En la Sección <CrossRef target="Chapter" ref="configuring_your_site"/> se mencionan varias opciones de configuración de Greenstone y en la Sección <CrossRef target="Chapter" ref="personalizing"/> se muestra cómo crear una página principal personalizada para la instalación de su biblioteca digital. Por último, en el Apéndice <CrossRef target="Chapter" ref="appendix_associated_software"/> se enumeran los programas asociados y se indica cómo obtenerlos.</Text>
</Content>
</Section>
<Section id="companion_documents">
<Title>
<Text id="12">Conjunto de documentos</Text>
</Title>
<Content>
<Text id="13">La serie completa de documentos comprende cinco volúmenes:</Text>
<BulletList>
<Bullet>
<Text id="14">La Guía de Instalación de la Biblioteca Digital Greenstone (<i>el presente documento</i>)</Text>
</Bullet>
<Bullet>
<Text id="15">La Guía del Usuario de la Biblioteca Digital Greenstone</Text>
</Bullet>
<Bullet>
<Text id="16">La Guía del Programador de la Biblioteca Digital Greenstone</Text>
</Bullet>
<Bullet>
<Text id="17">La Biblioteca Digital Greenstone: del Papel a la Colección</Text>
</Bullet>
<Bullet>
<Text id="18">La Biblioteca Digital Greenstone: uso del Organizador</Text>
</Bullet>
</BulletList>
</Content>
</Section>
<Section id="copyright">
<Title>
<Text id="copyright-title">Copyright</Text>
</Title>
<Content>
<Text id="right-text-1">Copyright 2002 2003 2004 2005 2006 2007 by the <Link url="http://www.nzdl.org">New Zealand Digital Library Project</Link> at <Link url="http://www.waikato.ac.nz">the University of Waikato</Link>, New Zealand.</Text>
<Text id="right-text-2">Permission is granted to copy, distribute and/or modify this document under the terms of the <Link url="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation License</Link>, 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 <Link url="http://greenstonewiki.cs.waikato.ac.nz/wiki/gsdoc/GNUFDL.html">“GNU Free Documentation License.”</Link></Text>
</Content>
</Section>
<Section id="acknowledgements">
<Title>
<Text id="19">Agradecimientos</Text>
</Title>
<Content>
<Text id="20">El programa Greenstone es fruto de la colaboración de muchas personas. Rodger McNab y Stefan Boddie son los principales arquitectos y programadores. También han contribuido David Bainbridge, George Buchanan, Hong Chen, Michael Dewsnip, Katherine Don, Elke Duncker, Carl Gutwin, Geoff Holmes, Dana McKay, John McPherson, Craig Nevill-Manning, Dynal Patel, Gordon Paynter, Bernhard Pfahringer, Todd Reed, Bill Rogers, John Thompson y Stuart Yeates. Otros miembros del proyecto Biblioteca Digital de Nueva Zelanda que proporcionaron asesoría y valiosas ideas para la concepción del sistema son: Mark Apperley, Sally Jo Cunningham, Matt Jones, Steve Jones, Te Taka Keegan, Michel Loots, Malika Mahoui, Gary Marsden, Dave Nichols y Lloyd Smith. También queremos dar las gracias a todos aquellos que contribuyeron a los paquetes de programas con licencias GNU incluidos en esta distribución: MG, GDBM, PDFTOHTML, PERL, WGET, WVWARE y XLHTML.</Text>
</Content>
</Section>
<Chapter id="versions_of_greenstone">
<Title>
<Text id="21">VERSIONES DE GREENSTONE</Text>
</Title>
<Content>
<Text id="22">El programa Greenstone funciona en diferentes plataformas y con distintas configuraciones, como se resume en la Figura <CrossRef target="Figure" ref="different_options"/>.</Text>
<Figure id="different_options">
<Title>
<Text id="23">Las distintas opciones para las versiones Windows y Unix de Greenstone</Text>
</Title>
<File width="642" height="295" url="images/Install_Fig_1.png"/>
</Figure>
<Text id="24">Hay muchos factores que inciden (o pueden incidir) en el procedimiento de instalación. Antes de proseguir la lectura, deténgase en los siguientes puntos:</Text>
<BulletList>
<Bullet>
<Text id="25">¿Está usted utilizando Windows o Unix?</Text>
</Bullet>
<Bullet>
<Text id="26">Si es Windows, ¿está usted utilizando Windows 3.1/3.11 o una versión más reciente? Aunque se pueden visualizar las colecciones en las máquinas que funcionan con las versiones 3.1 ó 3.11, y dar servicio a otras computadoras en la misma red, no puede usted crear nuevas colecciones. El programa Greenstone completo funciona con 95/98/Me y NT/2000.</Text>
</Bullet>
<Bullet>
<Text id="27">Si es Unix, ¿está usted utilizando Linux u otra versión de Unix? Para Linux, se proporciona una versión binaria del sistema completo que es fácil de instalar. Para otros tipos de Unix tendrá usted que instalar el código fuente y compilarlo. Para ello, puede ser preciso instalar en su computadora programas suplementarios.</Text>
</Bullet>
<Bullet>
<Text id="28">Si es Windows NT/2000 o Unix, ¿puede usted iniciar la sesión como “administrador” del sistema o <i>root</i> ? Esto puede ser necesario para configurar adecuadamente un servidor Web para Greenstone.</Text>
</Bullet>
<Bullet>
<Text id="29">¿Quiere usted el código fuente? Si está usted utilizando Windows o Linux, puede usted instalar solamente los binarios. Pero es posible que quiera usted también el código fuente: éste viene en la distribución de Greenstone.</Text>
</Bullet>
<Bullet>
<Text id="30">¿Quiere usted crear nuevas colecciones de biblioteca digital? En tal caso, es necesario que tenga Perl, disponible gratuitamente para Windows y Unix.</Text>
</Bullet>
<Bullet>
<Text id="31">¿Su computadora maneja un servidor Web? Greenstone viene con un servidor Web Windows. No obstante, si ya está usted utilizando un servidor Web, es muy posible que quiera conservarlo. Para Unix, es necesario utilizar un servidor Web.</Text>
</Bullet>
<Bullet>
<Text id="32">¿Sabe usted como volver a configurar su servidor Web? Si usted no utiliza el servidor Web de Greenstone, tendrá que modificar ligeramente la configuración del suyo para que reconozca el programa Greenstone.</Text>
</Bullet>
</BulletList>
</Content>
</Chapter>
<Chapter id="installation_procedure">
<Title>
<Text id="33">EL PROCEDIMIENTO DE INSTALACIÓN</Text>
</Title>
<Content>
<Text id="34">Existen sendas versiones de Greenstone disponibles para Windows y Unix, como binarios y en forma de código fuente. La interfaz de usuario de Greenstone utiliza cualquiera de los dos navegadores Web siguientes: Netscape Navigator o Internet Explorer (versión 4.0 o superior en ambos casos). En caso de que no tenga usted todavía un navegador Web, puede usted instalar una de las versiones Windows de Netscape que vienen en el CD-ROM.</Text>
<Section id="windows">
<Title>
<Text id="35">Windows</Text>
</Title>
<Content>
<Text id="36">Si es usted un usuario de Unix, pase directamente a la Sección <CrossRef target="Section" ref="unix"/>. Para los usuarios de Windows, si sólo desea una instalación sencilla siga el siguiente procedimiento de “instalación simple”. El sistema Greenstone ocupa unos 40 Mb de espacio de memoria en el disco duro.</Text>
<Text id="37">Si no escoge usted la instalación por defecto, tendrá que decidir si quiere instalar el código binario o el código fuente. En caso de duda, escoja el código binario. El procedimiento de instalación es el mismo para ambos. En las secciones siguientes encontrará usted más información sobre las opciones ofrecidas.</Text>
<Text id="38">Una vez terminada la instalación, pase directamente a la Sección <CrossRef target="Section" ref="how_to_find_greenstone"/>.</Text>
<Subsection id="simple_installation">
<Title>
<Text id="39">Instalación simple</Text>
</Title>
<Content>
<Text id="40">Para instalar la versión Windows a partir del CD-ROM, inserte el disco en el lector (por ejemplo, <i>D:</i>). Si al cabo de unos 20 segundos el procedimiento de instalación no comienza automáticamente, pulse en el menú <i>Inicio</i>, seleccione <i>Ejecutar</i> y teclee <i>D:\Windows\Setup.exe</i>, donde “ <i>D</i> ” es la letra que designa su lector de CD-ROM. Para Windows 3.1, seleccione <i>Ejecutar</i> en el “Administrador de archivos” y teclee <i>D:\Windows\Setup.exe</i>.</Text>
<Text id="41">Para proceder a la instalación más simple, basta con aceptar el parámetro por defecto en cada etapa, pulsando el botón <i>Next</i> (siguiente). ¡Eso es todo! Greenstone queda instalado en el directorio <i>C:\Program Files\gsdl</i>.</Text>
<Text id="42">Una vez concluida la instalación, para arrancar su sistema Greenstone pulse el botón <i>Inicio</i>, abra el menú <i>Programas</i> y seleccione <i>Biblioteca Digital Greenstone (Greenstone Digital Library)</i>. Esto hace aparecer un cuadro de diálogo: haga clic en <i>Entrar en la biblioteca (Enter Library)</i>. Esto activa automáticamente el navegador Internet y carga la página principal de la Biblioteca Digital Greenstone, cuyo aspecto debe ser parecido al del ejemplo de la Figura <CrossRef target="Figure" ref="your_greenstone_home_page"/>. Se entra en la colección de demostración de Greenstone pulsando en su icono.</Text>
<Figure id="your_greenstone_home_page">
<Title>
<Text id="43">Su página principal Greenstone</Text>
</Title>
<File width="642" height="527" url="images/Install_Fig_2.png"/>
</Figure>
</Content>
</Subsection>
<Subsection id="windows_binaries">
<Title>
<Text id="44">Binarios Windows</Text>
</Title>
<Content>
<Text id="45">En el CD-ROM hay dos programas binarios Windows distintos: la <i>Biblioteca Local</i> y la <i>Biblioteca Web</i>. La instalación descrita más arriba selecciona la versión <i>Biblioteca Local</i>. Le recomendamos encarecidamente que utilice esta versión. La Biblioteca Web, que es más difícil de instalar, sólo es necesaria si usted utiliza ya un servidor Web y quiero usarlo para Greenstone . A pesar de su modesto nombre, la Biblioteca Local ofrece una capacidad completa y autónoma de servidor Web.</Text>
<Text id="46"><b>La Biblioteca Local.</b> Este programa permite, a cualquier computadora equipada con Windows,  distribuir colecciones Greenstone previamente creadas. La colección de demostración de Greenstone se instalará automáticamente; se pueden instalar también las demás colecciones que figuran en el CD-ROM (véase la Sección <CrossRef target="Chapter" ref="greenstone_collections"/>). El programa de Biblioteca Local es el mismo utilizado en los CD-ROM producidos por el sistema Greenstone.</Text>
<Text id="47">La Biblioteca Local está destinada a utilizarse en computadoras autónomas o en computadoras que aún no están equipadas con un servidor Web. Contiene un pequeño servidor Web incorporado para que otras computadoras en la misma red puedan también acceder a la biblioteca. (Sin embargo, este servidor Web tiene una capacidad de configuración limitada.)</Text>
<Text id="48">El programa de Biblioteca Local detecta automáticamente si su computadora tiene un programa de red instalado o si está conectada a una red. Funciona correctamente en cualquier combinación de estas condiciones. No obstante, pueden plantearse eventualmente dos problemas. Greenstone puede:</Text>
<BulletList>
<Bullet>
<Text id="49">provocar una operación no deseada de marcado telefónico;</Text>
</Bullet>
<Bullet>
<Text id="50">no funcionar debido a la presencia de un programa de red instalado incorrectamente.</Text>
</Bullet>
</BulletList>
<Text id="51">Se suministra una versión limitada de la Biblioteca Local que se puede utilizar en tales situaciones. La versión limitada sólo funciona con Netscape (pero no con Internet Explorer). Cuando se activa la versión de la Biblioteca Local de Greenstone, en el cuadro de diálogo aparece un botón que permite seleccionar la versión limitada. Se deberá siempre utilizar la versión estándar, a menos que se planteen los problemas antes mencionados.</Text>
<Text id="52"><b>Biblioteca Web.</b> Este programa permite que cualquier computadora con un servidor Web existente distribuya colecciones Greenstone previamente creadas. Como en el caso de la Biblioteca Local, la colección de demostración de Greenstone se instalará automáticamente. Se pueden instalar también las demás colecciones que figuran en el CD-ROM (véase la Sección <CrossRef target="Chapter" ref="greenstone_collections"/>).</Text>
<Text id="53">La Biblioteca Web difiere de la Biblioteca Local porque está destinada a computadoras que ya disponen de un programa de servidor Web.</Text>
<Text id="54">Para activar la Biblioteca Web, se requiere también</Text>
<BulletList>
<Bullet>
<Text id="55">Un programa de servidor Web, como por ejemplo Apache (véase el Apéndice <CrossRef target="Chapter" ref="appendix_associated_software"/>).</Text>
</Bullet>
</BulletList>
<Text id="56"><b>El Colector.</b> Este componente, que viene tanto en la Biblioteca Local como en la Biblioteca Web, permite crear colecciones que contengan el material elegido por usted. Para activarlo, se requiere también Perl. Recomendamos ActivePerl (véase el Apéndice). (No se podrá utilizar el Colector con un sistema Windows 3.1 ó 3.11.)</Text>
</Content>
</Subsection>
<Subsection id="windows_webserver_configuration">
<Title>
<Text id="57">Configuración del servidor Web de Windows (en las versiones de Biblioteca Web únicamente)</Text>
</Title>
<Content>
<Text id="58">Una ventaja de la versión de la Biblioteca Local de Greenstone es que está lista para funcionar y no requiere ninguna configuración especial. Para la versión Biblioteca Web, en cambio, tendrá usted que hacer algunos ajustes a su instalación del servidor Web.</Text>
<Text id="59">Si ya dispone usted de un servidor Web, habrá que hacer algunos pequeños cambios en su configuración para que la instalación de Greenstone funcione correctamente. El guión (<i>script</i>) de instalación explica cuáles son esos cambios para el servidor Web Apache (véase la Sección <CrossRef target="Section" ref="pws_and_iis_webservers"/> para las instrucciones relativas a la configuración de los servidores Web PWS e IIS). Es posible que necesite la ayuda de un administrador de sistema para volver a configurar un servidor Web ya instalado. Esta persona entenderá seguramente las instrucciones del guión de instalación, que pueden imprimirse.</Text>
<Text id="60">Si no dispone usted todavía de un servidor Web, tendrá que instalar uno (véase el Apéndice <CrossRef target="Chapter" ref="appendix_associated_software"/> para la información relativa al servidor Web Apache) y luego tendrá que configurarlo adecuadamente. En la Sección <CrossRef target="Chapter" ref="setting_up_webserver"/> se explica detalladamente qué partes de la instalación de un servidor Web afectan a Greenstone y cómo deben modificarse. Esto supone incluir una media docena de líneas en un archivo de configuración.</Text>
</Content>
</Subsection>
<Subsection id="windows_source">
<Title>
<Text id="61">Fuente Windows</Text>
</Title>
<Content>
<Text id="62">El código fuente de Greenstone ocupa 50 Mb en el disco, aunque para compilarlo se necesitarán unos 90 Mb. Para compilar la fuente en Windows se necesita</Text>
<BulletList>
<Bullet>
<Text id="63">El compilador Microsoft Visual C++. (Estamos resolviendo actualmente algunos problemas menores en la compilación de Greenstone con varios puertos Windows de GNU GCC.)</Text>
</Bullet>
</BulletList>
<Text id="64">(No se necesita el GDBM, el administrador de la base de datos de GNU, porque viene incluido en la distribución de Greenstone.)</Text>
<Text id="65">Es poco probable que logre usted compilar Greenstone en una computadora que funcione con un sistema Windows 3.1 ó 3.11.</Text>
<Text id="66">En caso de que usted vuelva a compilar Greenstone y desee utilizar la versión nuevamente compilada para crear discos CD-ROM, debe tomar nota de que el código producido por las versiones recientes del compilador Visual C++ no funciona con Windows 3.1 ó 3.11, no habiendo en cambio problema alguno con sistemas Windows ulteriores (95, 98, Me, NT, 2000). Si desea que sus CD-ROM puedan leerse en máquinas con sistemas Windows antiguos, se necesitará otra versión del compilador. Además, Greenstone utiliza STL (<i>Standard Template Library</i>), la biblioteca estándar de plantillas para C++, y aunque esos compiladores vienen a veces con STL, la versión proporcionada no siempre funciona correctamente. Por consiguiente, para volver a compilar Greenstone de tal modo que produzca discos CD-ROM que funcionen con versiones antiguas de Windows, se necesita:</Text>
<BulletList>
<Bullet>
<Text id="67">el compilador Microsoft Visual C++, versión 4.0 ó 4.2.</Text>
</Bullet>
<Bullet>
<Text id="68">una versión externa de STL, la biblioteca estándar de plantillas para C++. STL viene incluida en el sistema Greenstone para poder utilizarla con esas versiones del compilador.</Text>
</Bullet>
</BulletList>
<Text id="69">Cabe señalar que el procedimiento de instalación de Windows no propone compilar Greenstone si se escoge instalar el código fuente. Para obtener instrucciones sobre la compilación de Greenstone relativas a su plataforma y su compilador, véase el documento <i>Install</i> que aparece en el directorio principal de Greenstone (<i>C:\Program Files\gsdl</i> por defecto) durante el procedimiento de instalación.</Text>
</Content>
</Subsection>
</Content>
</Section>
<Section id="unix">
<Title>
<Text id="70">Unix</Text>
</Title>
<Content>
<Text id="71">Esta sección está destinada a los usuarios de Unix. (Los usuarios de Windows pueden pasar directamente a la Sección <CrossRef target="Section" ref="how_to_find_greenstone"/>.) Tiene usted que escoger entre instalar el código binario o el código fuente. El código binario ocupa unos 50 Mb en el disco duro; el código fuente necesita unos 160 Mb para compilar.</Text>
<Subsection id="unix_binaries">
<Title>
<Text id="72">Binarios Unix</Text>
</Title>
<Content>
<Text id="73">El código binario requiere una distribución Linux basada en Intel x86 que incluye un soporte binario ELF. Las distribuciones que cumplen estos requisitos son:</Text>
<BulletList>
<Bullet>
<Text id="74">RedHat 5.1</Text>
</Bullet>
<Bullet>
<Text id="75">SuSE Linux 6.1</Text>
</Bullet>
<Bullet>
<Text id="76">Debian 2.1</Text>
</Bullet>
<Bullet>
<Text id="77">Slackware 4.0</Text>
</Bullet>
</BulletList>
<Text id="78">Deben funcionar también las versiones más recientes de estos productos.</Text>
<Text id="79">Se necesitará un servidor Web: recomendamos Apache. Le recomendamos también encarecidamente que instale su servidor Web <i>antes</i> de instalar Greenstone, esto facilitará considerablemente la respuesta a las preguntas que se formulan durante el procedimiento de instalación de Greenstone. Si desea crear nuevas colecciones de biblioteca digital, necesitará también Perl si éste no se encuentra ya en su sistema. Para comprobarlo, abra una ventana de terminal, teclee <i>perl -v</i>, y vea si aparece un mensaje en que se especifica, entre otras cosas, el número de la versión. En la mayoría de las versiones de Linux, Perl viene instalado por defecto. En el Apéndice <CrossRef target="Chapter" ref="appendix_associated_software"/> se proporciona información sobre cómo obtener Apache y Perl.</Text>
</Content>
</Subsection>
<Subsection id="unix_source">
<Title>
<Text id="80">Fuente Unix</Text>
</Title>
<Content>
<Text id="81">El código fuente para Unix es el mismo que para Windows. Se ha compilado y probado en Linux, Solaris y Macintosh OS/X; debería resultar sencillo adaptarlo a otras variantes de Unix.</Text>
<Text id="82">Para compilar el código fuente de Greenstone en Unix, se necesita</Text>
<BulletList>
<Bullet>
<Text id="83">el compilador de GNU C++, GCC</Text>
</Bullet>
<Bullet>
<Text id="84">el administrador de la base de datos GNU, GDBM.</Text>
</Bullet>
</BulletList>
<Text id="85">Para activar el programa Greenstone, se necesita también un servidor Web y el programa Perl, como se indica más arriba en <i>Binarios Unix</i>.</Text>
</Content>
</Subsection>
<Subsection id="unix_installation">
<Title>
<Text id="86">Instalación en Unix</Text>
</Title>
<Content>
<Text id="87">Para instalar la versión destinada a Unix a partir del CD-ROM, inserte el disco en el lector y teclee</Text>
<Table class="hidden">
<Title/>
<TableContent>
<tr>
<th width="151">
<CodeLine>mount /cdrom</CodeLine>
</th>
<th width="246">
<Text id="88">monta el dispositivo de CD-ROM (este comando puede diferir de un sistema a otro; por ejemplo, en OS/X se teclea <i>cd</i> en el directorio <i>/Volumes</i> y luego se pasa al subdirectorio correspondiente al CD-ROM)</Text>
</th>
</tr>
<tr>
<th width="151">
<CodeLine>cd /cdrom</CodeLine>
</th>
<th width="246">
<Text id="89">cambia de directorio y pasa al directorio principal del CD-ROM</Text>
</th>
</tr>
<tr>
<th width="151">
<CodeLine>cd Unix</CodeLine>
</th>
<th width="246">
<Text id="90">cambia de directorio y pasa adonde se encuentra el guión de instalación para Unix</Text>
</th>
</tr>
<tr>
<th width="151">
<CodeLine>sh Install.sh</CodeLine>
</th>
<th width="246">
<Text id="91">inicia el proceso de instalación (se utiliza un <i>sh</i> explícito porque muchas instalaciones prohiben la ejecución de programas directamente a partir del CD-ROM)</Text>
</th>
</tr>
</TableContent>
</Table>
<Text id="92">Este último comando inicia un diálogo interactivo en que se le pregunta a usted la información necesaria para instalar Greenstone en su sistema, proporcionando datos precisos sobre las operaciones efectuadas.</Text>
<Text id="93">El procedimiento de instalación comienza preguntándole en qué directorio quiere usted instalar Greenstone. El primer archivo que se instala allí es el programa de “desinstalación” que despeja toda instalación parcial, en caso de que se topara usted con problemas o terminara la instalación prematuramente. A continuación, usted escoge si quiere instalar los binarios o el código fuente. Luego se formulan algunas preguntas sobre la instalación de su servidor Web. Es necesario tener un directorio de CGI ejecutable válido (que en los sistemas Unix suele llamarse “<i>cgi-bin</i> ”); puede usted crear uno o utilizar el existente. En caso de crear uno nuevo, será necesario que introduzca esta información en el archivo de configuración de su servidor Web. En cualquier caso, es necesario introducir la dirección Web del directorio CGI. El diálogo de instalación lo guiará a través de todas estas opciones. Es importante establecer correctamente los permisos de archivo en determinados directorios, y se le invita a proporcionar la información necesaria. Por último, se le invita a escoger una clave de acceso para el usuario “administrador” <i>admin</i>.</Text>
<Text id="94">Todo el programa Greenstone se instala por defecto en el directorio <i>/usr/local/gsdl</i> si es el usuario <i>root</i> quien efectúa la instalación, y de otro modo en el directorio <i>~/gsdl</i> (en que “~” es el directorio principal del usuario).</Text>
<Text id="95">La instalación de los binarios tarda apenas unos minutos, tiempo suficiente para que usted responda a las preguntas correspondientes. Si usted instala el código fuente, el guión de instalación lo compilará, lo cual lleva entre diez minutos y una hora, según la velocidad de su procesador.</Text>
<Text id="96">Para desinstalar el programa, teclee</Text>
<CodeLine>cd ~/gsdl</CodeLine>
<Text id="97">o bien /usr/local/gsdl si quien instaló Greenstone fue el usuario <i>root</i></Text>
<CodeLine>sh Uni nstall.sh</CodeLine>
<Text id="98">Durante el procedimiento de instalación se le preguntará si quiere usted instalar alguna colección Greenstone. La colección de demostración Greenstone se instala automáticamente; las demás colecciones que figuran en el CD-ROM se describen en la Sección <CrossRef target="Chapter" ref="greenstone_collections"/>.</Text>
</Content>
</Subsection>
<Subsection id="unix_webserver_configuration">
<Title>
<Text id="99">Configuración del servidor Web para Unix</Text>
</Title>
<Content>
<Text id="100">Si ya dispone usted de un servidor Web, tendrá que hacerle algunos pequeños cambios en su configuración para poder instalar Greenstone. El guión de instalación explica en qué consisten. Es probable que necesite la ayuda del administrador del sistema para volver a configurar el servidor Web; esta persona comprenderá seguramente las instrucciones que figuran en el guión de instalación y que pueden imprimirse. Para su conveniencia, la información imprimible del guión de instalación está escrita en un archivo llamado <i>INSTALL_RECORD</i> situado en el directorio en que usted instaló Greenstone.</Text>
<Text id="101">Si no dispone usted todavía de un servidor Web, tendrá que instalar uno. En el Apéndice <CrossRef target="Chapter" ref="appendix_associated_software"/> se proporciona información sobre Apache. Después tendrá que configurarlo adecuadamente. En la Sección <CrossRef target="Chapter" ref="setting_up_webserver"/> se explica detalladamente qué partes de la instalación de un servidor Web Apache afectan a Greenstone y cómo hay que modificarlas. Ello supone incluir una media docena de líneas en un archivo de configuración.</Text>
<Text id="102">No es necesario que sea usted el usuario “<i>root</i> ” de Unix para ejecutar el procedimiento de instalación antes expuesto. Sin embargo, tratándose de la configuración de un servidor Apache, será preciso disponer de privilegios de “<i>root</i> ”, todo depende de cómo se instale Apache. Si instala Apache usted mismo, puede hacerlo como un usuario carente de privilegios de “<i>root</i> ”. Si resulta necesario eludir un administrador de sistema poco dispuesto a cooperar, es posible instalar en su computadora un segundo servidor Web Apache, aun si ya existe uno.</Text>
</Content>
</Subsection>
</Content>
</Section>
<Section id="how_to_find_greenstone">
<Title>
<Text id="103">Cómo encontrar Greenstone</Text>
</Title>
<Content>
<Subsection id="local_library_windows_only">
<Title>
<Text id="104">Biblioteca Local (sólo con Windows)</Text>
</Title>
<Content>
<Text id="105">Si está utilizando la Biblioteca Local, ejecute simplemente el programa Greenstone a partir del menú de <i>Inicio</i>. Esto activa automáticamente su navegador Internet y carga la página principal de la Biblioteca Digital Greenstone. A partir de esta página se podrá tener acceso a la colección de demostración de Greenstone. </Text>
</Content>
</Subsection>
<Subsection id="web_library_windows_and_unix">
<Title>
<Text id="106">Biblioteca Web (Windows y Unix)</Text>
</Title>
<Content>
<Text id="107">Si está utilizando la Biblioteca Web, una vez instalado el programa y configurado el servidor Web, utilice esta URL para entrar en su sistema Greenstone:</Text>
<Text id="108"><i>http://localhost/gsdl/cgi-bin/library</i></Text>
<Text id="109">A partir de esta página se podrá tener acceso a la colección de demostración de Greenstone.</Text>
</Content>
</Subsection>
<Subsection id="the_collector">
<Title>
<Text id="110">El Colector</Text>
</Title>
<Content>
<Text id="111">En la página principal de la biblioteca digital figura un enlace hacia el Colector.</Text>
</Content>
</Subsection>
<Subsection id="administration">
<Title>
<Text id="112">Administración</Text>
</Title>
<Content>
<Text id="113">En la página principal de la biblioteca digital figura un enlace hacia las páginas de Administración. El usuario “administrador” se llama <i>admin</i>, con una clave de acceso que usted escogió durante el proceso de instalación. El administrador está autorizado a añadir nuevos usuarios y a crear colecciones.</Text>
</Content>
</Subsection>
</Content>
</Section>
<Section id="section_la_interfaz_de_bibliotecario_de_greenstone_(gli)">
<Title>
<Text id="114">La Interfaz de Bibliotecario de Greenstone (GLI)</Text>
</Title>
<Content>
<Text id="115">La Interfaz de Bibliotecario de Greenstone (GLI por sus siglas en inglés) es una herramienta gráfica que le ayuda a construir bibliotecas digitales dándole acceso a todas las funciones de Greenstone por medio de una interfaz fácil de usar con la que sólo tiene que apuntar y hacer click.</Text>
<Text id="116">GLI se instala automáticamente con todas las versiones de Greenstone en el subdirectorio <i>gli</i> del directorio principal de la biblioteca digital (<i>C:\Program Files\gsdl\gli</i> por omisión). Recuerde que la interfaz corre en conjunto con los programas de Greenstone y no funcionará adecuadamente a menos que se encuentre en un subdirectorio de Greenstone. Si usted ya bajó alguna de las versiones de Greenstone, entonces éste será el caso.</Text>
<Text id="117">Para poder usar la GLI su computadora deberá contar con el Ambiente de Ejecución Java. Si todavía no lo tiene, el programa de instalación se ofrecerá a instalar la versión que esté incluida en el CD-ROM. En el caso de UNIX también deberá asegurarse de que Perl esté instalado (en el caso de Windows Perl ya viene incluido en el software Greenstone). Por favor infórmenos sobre cualquier problema que tenga al correr o usar la Interfaz de Bibliotecario a la siguiente dirección: <u>[email protected]</u>.</Text>
<Subsection id="running_under_windows">
<Title>
<Text id="118">Ejecución bajo Windows</Text>
</Title>
<Content>
<Text id="119">Para correr la GLI bajo Windows explore la carpeta <i>gli</i> que se encuentra en su instalación de Greenstone (por ejemplo usando el Explorador de Windows) y haga doble click en el archivo <i>gli.bat</i>. Este archivo verificará que Greenstone, el Ambiente de Ejecución Java y Perl están instalados e iniciará la Interfaz de Bibliotecario.</Text>
</Content>
</Subsection>
<Subsection id="running_under_unix">
<Title>
<Text id="120">Ejecución bajo UNIX</Text>
</Title>
<Content>
<Text id="121">Para correr la GLI bajo UNIX cambie al directorio <i>gli</i> que se encuentra en su instalación de Greenstone y ejecute el guión <i>gli.sh</i>. Este guión verificará que Greenstone, el Ambiente de Ejecución Java y Perl estén instalados y en su ruta de búsqueda e iniciará la Interfaz de Bibliotecario.</Text>
</Content>
</Subsection>
<Subsection id="getting_help">
<Title>
<Text id="122">Cómo obtener ayuda</Text>
</Title>
<Content>
<Text id="123">La Interfaz de Bibliotecario de Greenstone cuenta con una extensa variedad de opciones de ayuda en línea. Usted puede obtenerla haciendo click en el botón <i>Ayuda</i> que se encuentra en la parte superior derecha de la pantalla. Esto abrirá una sección relacionada con lo que usted esté haciendo, es decir, con el panel GLI en el que usted se encuentre en ese momento. Una vez abierta haga click en la parte del texto de ayuda sobre la que usted quiera saber más. Úsela. ¡Se la recomendamos!</Text>
</Content>
</Subsection>
<Subsection id="compiling_gli">
<Title>
<Text id="124">Compilando la Interfaz de Bibliotecario de Greenstone</Text>
</Title>
<Content>
<Text id="125">Si usted bajó la versión con el código fuente de Greenstone, entonces tendrá con usted el código fuente Java de la Interfaz de Bibliotecario. Para compilarlo su computadora necesitará contar con una versión adecuada del Kit de Desarrollo de Software Java. En el Apéndice <CrossRef target="Chapter" ref="appendix_associated_software"/> usted encontrará mayor información sobre la forma de obtenerla. Para compilar el código fuente ejecute los archivos <i>makegli.bat</i> (Windows) o <i>makegli.sh</i> (UNIX). Una vez que haya hecho esto usted podrá correr la GLI tal como se describe arriba.</Text>
</Content>
</Subsection>
</Content>
</Section>
<Section id="testing_and_troubleshooting">
<Title>
<Text id="126">Pruebas y solución de problemas</Text>
</Title>
<Content>
<Text id="127">Para probar Greenstone, dirija su navegador Web hacia la página principal de Greenstone y explore la colección de demostración y cualquier otra colección que haya usted instalado. No se preocupe, no va a romper nada. Pulse libremente: se puede hacer clic en la mayoría de las imágenes que aparecen en la pantalla. Si se mantiene el cursor quieto sobre una imagen, en la mayoría de los navegadores aparece un mensaje en que se explica lo que sucederá si se hace clic. ¡Experimente y verá! Elija palabras comunes como “<i>the</i> ” (el) y “<i>and</i> ” (y) para ejercitarse en la búsqueda y no tema, que nada se va a romper. Para más información, véase la <i>Guía del Usuario de la Biblioteca Digital Greenstone</i>.</Text>
<Subsection id="troubleshooting">
<Title>
<Text id="128">Solución de problemas</Text>
</Title>
<Content>
<Table id="table_troubleshooting">
<Title/>
<TableContent>
<tr>
<th width="132"/>
<th width="151">
<Text id="129">Problema</Text>
</th>
<th width="246">
<Text id="130">Solución posible</Text>
</th>
</tr>
<tr>
<th width="132">
<Text id="131">Biblioteca local (sólo con Windows)</Text>
</th>
<th width="151">
<Text id="132">Cuando arranco el programa Greenstone mi computadora me invita a conectarme a mi proveedor de servicio Internet. </Text>
</th>
<th width="246">
<Text id="133">Pulse el botón <i>Cancelar</i> en el cuadro de diálogo. Esto suele resolver el problema.</Text>
</th>
</tr>
<tr>
<th width="132"/>
<th width="151">
<Text id="134">Cuando arranco el programa Greenstone mi computadora me <i>sigue invitando</i> a conectarme a mi proveedor de servicio Internet.</Text>
</th>
<th width="246">
<Text id="135">Escoja la “versión limitada” cuando active Greenstone. Esta versión sólo funciona con Netscape.</Text>
</th>
</tr>
<tr>
<th width="132"/>
<th width="151">
<Text id="136">Cuando dirijo mi navegador hacia la Biblioteca Digital, no puede encontrar esa página.</Text>
</th>
<th width="246">
<Text id="137">Verifique su configuración de Internet Proxy y desconecte los proxies (utilice <i>Edit preferences</i> en Netscape o <i>Internet options</i> en Explorer).</Text>
</th>
</tr>
<tr>
<th width="132"/>
<th width="151">
<Text id="138">¡El Colector parece estar funcionando muy lentamente!</Text>
</th>
<th width="246">
<Text id="139">¿Está usted utilizando Netscape con Windows 2000? En ese caso, intente utilizar más bien Internet Explorer. Parece haber cierta incompatibilidad entre Netscape y Windows 2000.</Text>
</th>
</tr>
<tr>
<th width="132">
<Text id="142">Biblioteca Web (Windows y Unix)</Text>
</th>
<th width="151">
<Text id="143">Cuando arranco Apache, se cierra de inmediato.</Text>
</th>
<th width="246">
<Text id="144">Añada en el archivo de configuración de Apache una directiva <i>ServerName localhost</i> (véase Sección <CrossRef target="Section" ref="apache_web_server"/>).</Text>
</th>
</tr>
<tr>
<th width="132">Â </th>
<th width="151">
<Text id="145">Cuando dirijo mi navegador a la biblioteca digital, aparece un archivo binario.</Text>
</th>
<th width="246">
<Text id="146">Verifique la directiva <i>ScriptAlias</i> en el archivo de configuración de Apache y cerciórese de que aparece antes de la directiva <i>Alias</i> (véase Secciones 4.2 y 4.3).</Text>
</th>
</tr>
<tr>
<th width="132">Â </th>
<th width="151">
<Text id="147">Logro llegar a la página principal de Greenstone (Figura <CrossRef target="Figure" ref="your_greenstone_home_page"/>), pero el icono de la colección de demostración no aparece.</Text>
</th>
<th width="246">
<Text id="148">Abra el programa <i>library</i> (en el directorio <i>cgi-bin</i>) a partir del indicador de DOS (o del “shell”) para obtener información sobre depuración que le ayudará a localizar el problema.</Text>
</th>
</tr>
<tr>
<th width="132">
<Text id="149">Ambas versiones</Text>
</th>
<th width="151">
<Text id="150">Cuando dirijo mi navegador hacia la Biblioteca Digital, no puede encontrar esa página.</Text>
</th>
<th width="246">
<Text id="151">Intente utilizar 127.0.0.1 en lugar de <i>localhost</i>. Este número IP reservado se define como un “bucle de retroceso” hacia su computadora local.</Text>
</th>
</tr>
<tr>
<th width="132"/>
<th width="151">
<Text id="152">Mi navegador se queja de que no puede encontrar <i>main.cfg</i>.</Text>
</th>
<th width="246">
<Text id="153">Verifique que los archivos de Greenstone existen y que son legibles por todos. Si está usando la biblioteca Web, intente activar el programa <i>library</i> a partir de la línea de comandos. Si funciona bien, el problema es con los permisos de archivo (véase la Sección <CrossRef target="Section" ref="file_permissions"/>). En caso contrario, es probable que la variable <i>gsdlhome</i> esté configurada incorrectamente en el archivo de configuración <i>gsdlsite.cfg</i> (véase la Sección <CrossRef target="Section" ref="gsdlsite_configuration_file"/>).</Text>
</th>
</tr>
<tr>
<th width="132"/>
<th width="151">
<Text id="154">Tengo problemas con la utilización del Colector.</Text>
</th>
<th width="246">
<Text id="155">Lea la Guía del Usuario de la Biblioteca Digital Greenstone, Sección <CrossRef external="User" lang="es" target="Chapter" ref="making_greenstone_collections"/>.</Text>
</th>
</tr>
<tr>
<th width="132"/>
<th width="151">
<Text id="156">He añadido un nuevo usuario, pero no parece poder iniciar la sesión.</Text>
</th>
<th width="246">
<Text id="157">Verifique que el directorio <i>C:\Program Files\gsdl\etc</i> y todo su contenido son modificables (véase Sección <CrossRef target="Section" ref="file_permissions"/>).</Text>
</th>
</tr>
</TableContent>
</Table>
</Content>
</Subsection>
</Content>
</Section>
<Section id="learn_more">
<Title>
<Text id="158">Para obtener más información</Text>
</Title>
<Content>
<Text id="159">Para obtener más información sobre los entresijos de su instalación Greenstone, consulte la <i>Guía del Programador de la Biblioteca Digital Greenstone</i>, que comprende, entre otras cosas, los detalles sobre la estructura de los directorios que se ha creado e información sobre cómo configurar su sitio Greenstone.</Text>
</Content>
</Section>
</Content>
</Chapter>
<Chapter id="greenstone_collections">
<Title>
<Text id="160">COLECCIONES GREENSTONE</Text>
</Title>
<Content>
<Text id="161">El CD-ROM incluye varias colecciones Greenstone de muestra. Si usted tiene acceso a Internet también podrá bajar muchas otras desde el sitio Web del Proyecto de Biblioteca Digital de Nueva Zelanda (<i>nzdl.org</i>), ya sea armadas previamente o sin armar.</Text>
<Text id="162">La colección de muestra Greenstone es un pequeño subconjunto de la Biblioteca para el Desarrollo Humano (HDL por sus siglas en inglés), una colección perfectamente acabada que muestra la forma en que se puede lograr una amplia capacidad de exploración y búsqueda (siempre que se cuente con los metadatos adecuados). Esta colección se incluye automáticamente al momento de instalar el software.</Text>
<Text id="163">Greenstone también incluye otros ejemplos de colecciones documentadas cuyas páginas informativas describen la forma en que están construidas, demostrando las diferentes capacidades de Greenstone. Un cuadro de diálogo le preguntará si quiere incluirlas junto con su instalación. La cantidad aproximada de espacio de disco que se necesita para cada una se muestra a continuación.</Text>
<Table class="hidden" id="table_collections">
<Title/>
<TableContent>
<tr>
<th width="60">
<Text id="164"><i>demo</i></Text>
</th>
<th width="182">
<Text id="165">Colección de muestra Greenstone <br/>(7 Mb)</Text>
</th>
<th width="294">
<Text id="166">Un pequeño subconjunto de la Biblioteca para el Desarrollo Humano (HDL por sus siglas en inglés). Si se clona esta colección las funciones completas sólo estarán disponibles si sus nuevos archivos proporcionan la información de metadatos apropiada.</Text>
</th>
</tr>
<tr>
<th width="60">
<Text id="167"><i>dls-e</i></Text>
</th>
<th width="182">
<Text id="168">Subconjunto de la Biblioteca para el Desarrollo <br/>(150 Mb)</Text>
</th>
<th width="294">
<Text id="169">Al igual que la Colección de muestra Greenstone, ésta es un subconjunto de la Biblioteca para el Desarrollo Humano, sólo que mucho mayor. Contiene 250 publicaciones entre libros, informes y revistas relacionadas con diferentes áreas del saber humano (la HDL contiene un total de 1,230 publicaciones). Tiene la misma estructura que la Colección de muestra Greenstone y es bastante compleja, por lo que si apenas está empezando a familiarizarse con su uso quizá sea mejor que se fije primero en alguna otra (p. ej. la <i>demostración en MSWord y PDF</i>, los <i>Archivos Greenstone</i> o la <i>colección de Imágenes Sencillas</i>).</Text>
</th>
</tr>
<tr>
<th width="60">
<Text id="170"><i>wrdpdf-e</i></Text>
</th>
<th width="182">
<Text id="171">Demostración en MSWord y PDF <br/>(4 Mb)</Text>
</th>
<th width="294">
<Text id="172">Esta colección contiene unos cuantos documentos en formatos PDF, MSWord, RTF y PostScript, y muestra la capacidad de construir colecciones a partir de diferentes tipos de documentos. El archivo de configuración de la colección es sumamente sencillo.</Text>
</th>
</tr>
<tr>
<th width="60">
<Text id="173"><i>gsarch-e</i></Text>
</th>
<th width="182">
<Text id="174">Colección de Archivos Greenstone <br/>(5 Mb)</Text>
</th>
<th width="294">
<Text id="175">Una colección de mensajes de correo electrónico hecha a partir de los archivos de las listas de correo de Greenstone. Utiliza el plugin <i>Email</i> que descompone y analiza los archivos en formatos de correo electrónico. El archivo de configuración de la colección es sumamente sencillo.</Text>
</th>
</tr>
<tr>
<th width="60">
<Text id="176"><i>cltbib-e</i></Text>
</th>
<th width="182">
<Text id="177">Colección bibliográfica <br/>(7 Mb)</Text>
</th>
<th width="294">
<Text id="178">Con aproximadamente 4,000 entradas bibliográficas, esta colección incorpora una interfase de búsqueda basada en formas que permite la búsqueda por campos. Es bastante compleja.</Text>
</th>
</tr>
<tr>
<th width="60">
<Text id="179"><i>cltext-e</i></Text>
</th>
<th width="182">
<Text id="180">Suplemento bibliográfico <br/>(1 Mb)</Text>
</th>
<th width="294">
<Text id="181">Esta pequeña colección de 10 entradas bibliográficas ilustra el programa “supercolección” de Greenstone, el cual busca en varias colecciones al mismo tiempo. Opera junto con la colección <i>Bibliográfica</i> y su archivo de configuración es casi idéntico.</Text>
</th>
</tr>
<tr>
<th width="60">
<Text id="182"><i>MARC-e</i></Text>
</th>
<th width="182">
<Text id="183">Colección de muestra MARC <br/>(1 Mb)</Text>
</th>
<th width="294">
<Text id="184">Basada en algunos registros MARC de la Biblioteca del Congreso, ésta es una colección sencilla, aunque no permite la búsqueda basada en formas.</Text>
</th>
</tr>
<tr>
<th width="60">
<Text id="185"><i>oai-e</i></Text>
</th>
<th width="182">
<Text id="186">Colección de muestra OAI <br/>(18 Mb)</Text>
</th>
<th width="294">
<Text id="187">Por medio del Protocolo de Archivo Abierto y la función <i>Import-From</i>, ésta recupera metadatos de un archivo y construye una colección a partir de los registros. En este caso se trata de imágenes, por lo que se utilizan tanto el plugin OAI como el plugin <i>ImagePlug</i>.</Text>
</th>
</tr>
<tr>
<th width="60">
<Text id="188"><i>image-e</i></Text>
</th>
<th width="182">
<Text id="189">Colección de imágenes sencillas <br/>(1 Mb)</Text>
</th>
<th width="294">
<Text id="190">Esta colección de imágenes es sumamente básica y no contiene texto ni metadatos explícitos, lo que más bien la hace poco práctica. El archivo de configuración es lo más simple que se puede encontrar.</Text>
</th>
</tr>
<tr>
<th width="60">
<Text id="191"><i>authen-e</i></Text>
</th>
<th width="182">
<Text id="192">Demostración de formateo y autenticación <br/>(8 Mb)</Text>
</th>
<th width="294">
<Text id="193">Con el mismo material que la colección de muestra Greenstone original, ésta muestra dos funciones independientes: el formateo de documentos que no sean estándar y el acceso controlado a los documentos por medio de la autenticación de los usuarios.</Text>
</th>
</tr>
<tr>
<th width="60">
<Text id="194"><i>garish</i></Text>
</th>
<th width="182">
<Text id="195">Versión Garish de la colección de muestra <br/>(8 Mb)</Text>
</th>
<th width="294">
<Text id="196">Esta colección también contiene el mismo material que la colección de muestra Greenstone, sólo que su apariencia ha sido alterada para mostrar la forma en que las páginas generadas pueden configurarse de manera diferente. Se basa en un archivo de macros no estándar que se proporciona junto con Greenstone.</Text>
</th>
</tr>
<tr>
<th width="60">
<Text id="197"><i>Isis-e</i></Text>
</th>
<th width="182">
<Text id="198">Colección de muestra CDS/ISIS (1 Mb)</Text>
</th>
<th width="294">
<Text id="199">Esta colección está construida a partir de una base de datos CDS/ISIS de cerca de 150 referencias bibliográficas. Usa el plugin ISISPlug, el cual lee archivos estándar ISIS (.mst y .fdt) y los convierte a metadatos de Greenstone.</Text>
</th>
</tr>
</TableContent>
</Table>
</Content>
</Chapter>
<Chapter id="setting_up_webserver">
<Title>
<Text id="200">Instalación del servidor Web</Text>
</Title>
<Content>
<Text id="201">En esta sección explicaremos cómo instalar su servidor Web para que funcione con Greenstone. Cabe señalar que estas explicaciones son innecesarias cuando se utiliza la Biblioteca Local Windows, ya que este programa está concebido para funcionar de entrada sin servidor Web.</Text>
<Text id="202">Nos referiremos al servidor Web Apache, que se puede conseguir libremente para Windows y Unix (véase el Apéndice <CrossRef target="Chapter" ref="appendix_associated_software"/> para más detalles), el Personal Web Server (PWS) y el servidor Web Internet Information Services (IIS) de Microsoft. El PWS es el servidor Microsoft estándar para Windows 95/98; el IIS es el de las versiones 2000 y XP de Windows; Windows NT puede utilizar cualquiera de los dos. Las explicaciones relativas a Apache se aplican igualmente a la biblioteca Web Windows y a las versiones de Unix (aunque utilizamos la terminología y los nombres de las rutas de acceso propios de Windows); la sección relativa a PWS/IIS sólo se aplica a la biblioteca Web Windows.</Text>
<Text id="203">Una vez instalado el servidor Web, el siguiente paso es instalar Greenstone. Supondremos que durante el procedimiento de instalación usted ha escogido la opción por defecto en cada fase pulsando el botón <i>Next</i> (siguiente). El resultado es la creación del directorio <i>C:\Program Files\gsdl</i>, donde se instala el binario de la biblioteca Web, junto con algunos archivos auxiliares.</Text>
<Text id="204">Todos los servidores Web utilizan la URL especial “localhost” que representa la computadora en que está funcionando el servidor Web. Así, cuando se instala un servidor Web, se puede acceder a los documentos HTML tecleando la URL <i>http://localhost</i> en un navegador. Si su computadora tiene instalado un nombre de dominio, éste se utiliza en lugar del <i>localhost</i> para poder identificar su computadora desde sitios remotos. En la computadora de la Biblioteca Digital de Nueva Zelanda, por ejemplo, las URL <i>http://nzdl.org</i> y <i>http://localhost</i> son equivalentes. Si usted teclea <i>http://nzdl.org</i> en su computadora obtendrá el servidor Web de la Biblioteca Digital de Nueva Zelanda, mientras que si teclea <i>http://localhost</i> obtendrá el servidor Web de su propia computadora.</Text>
<Section id="apache_web_server">
<Title>
<Text id="205">El servidor Web Apache</Text>
</Title>
<Content>
<Text id="206">El servidor Web Apache suele instalarse en <i>C:\Program Files\Apache Group\Apache</i> y se configura de tal modo que el directorio <i>cgi-bin</i> esté en el subdirectorio <i>\cgi-bin</i> y la raíz de documentos es el subdirectorio <i>\htdocs</i>. Se vuelve a configurar modificando el archivo de configuración en <i>C:\Program Files\Apache Group\Apache\conf\httpd.conf</i>. Se trata de un archivo de texto: es muy fácil leerlo para ver cómo se ha efectuado la configuración.</Text>
<Text id="207">Según cómo esté configurado el programa de conexión en red de su computadora, podrá ser necesario añadir la siguiente línea en su archivo de configuración <i>httpd.conf</i> de Apache:</Text>
<CodeLine>ServerName  localhost</CodeLine>
<Text id="208">Si esta línea no figura, el sistema intenta encontrar el nombre de su servidor. Sin embargo, en algunas versiones de Windows hay algunos errores que impiden esta operación. En tal caso, Apache se cierra inmediatamente después de arrancarlo. Aparece un mensaje de error, pero éste se borra de inmediato y es muy probable que usted no lo alcance a leer.</Text>
<Subsection id="setting_up_cgi-bin_directory">
<Title>
<Text id="209">Instalación del directorio <i>cgi-bin</i> de Greenstone</Text>
</Title>
<Content>
<Text id="210"><i>cgi-bin</i> es un directorio desde el cual el servidor Web trata documentos como programas ejecutables. La directiva <i>ScriptAlias</i> de Apache se utiliza para crear un directorio <i>cgi-bin</i>. Cabe señalar que esta directiva puede hacer de cualquier directorio un directorio CGI ejecutable, ¡sin que se llame forzosamente “cgi-bin”! A la inversa, un directorio llamado “cgi-bin” no tiene nada especial si no se le ha aplicado la directiva <i>ScriptAlias</i>.</Text>
<Text id="211">Una vez instalado, Apache tiene un directorio cgi-bin en C:\Program Files\Apache Group\Apache\cgi-bin. Esto significa que si se le presenta la URL <i>http://localhost/cgi-bin/hello</i>, el servidor Web intentará ejecutar un archivo llamado hello en el directorio antes mencionado.</Text>
<Text id="212">Hay un programa Greenstone, llamado “<i>library.exe</i> ”, que tiene que ser ejecutado por el servidor Web y que a su vez lee un archivo llamado el archivo de configuración de sitio de Greenstone, o “<i>gsdlsite.cfg</i> ”, que debe estar situado en el mismo directorio.</Text>
<Text id="213">La mejor manera de obtener este resultado es utilizar la directiva <i>ScriptAlias</i> de Apache para crear un nuevo directorio <i>cgi-bin</i>. Este es el pasaje del archivo de configuración <i>httpd.conf</i> de Apache que añade <i>C:\Program Files\gsdl\cgi-bin</i> como un directorio <i>cgi-bin</i> suplementario:</Text>
<CodeLine>ScriptAlias /gsdl/cgi-bin/ “C:/Program Files/gsdl/cgi-bin”</CodeLine>
<CodeLine>&lt;Directory C:/Program Files/gsdl/cgi-bin&gt;</CodeLine>
<CodeLine>Â  Options None</CodeLine>
<CodeLine>Â  AllowOverride None</CodeLine>
<CodeLine>&lt;/Directory&gt;</CodeLine>
<Text id="214">(Curiosamente, los archivos de configuración de Apache utilizan barras oblicuas hacia adelante en lugar de las barras oblicuas hacia atrás que se suelen utilizar en Windows.)</Text>
<Text id="215">Esto significa que el servidor Web buscará en el directorio <i>C:\Program Files\gsdl\cgi-bin</i> cualquier URL que tenga la forma <i>http://localhost/gsdl/cgi-bin</i>... y la ejecutará. Por ejemplo, si se le presenta la URL <i>http://localhost/gsdl/cgi-bin/hello</i>, el servidor Web intentará recuperar el archivo <i>C:\Program Files\gsdl\cgi-bin\hello</i> y ejecutarlo. Sin embargo, la URL <i>http://localhost/cgi-bin/hello</i> busca en el directorio <i>cgi-bin</i> normal de Apache el archivo <i>C:\Program Files\Apache Group\Apache\cgi-bin\hello</i> y lo ejecuta, tal como lo hizo antes.</Text>
</Content>
</Subsection>
<Subsection id="document_root_directory">
<Title>
<Text id="216">El directorio raíz de los documentos</Text>
</Title>
<Content>
<Text id="217">El directorio raíz de los documentos es la raíz de la estructura de directorios de su servidor Web. Una vez instalado, Apache dispone como raíz de documentos de <i>C:\Program Files\Apache Group\Apache\htdocs</i>. Esto significa que si se le presenta la URL <i>http://localhost/hello.html</i>, el servidor Web intentará recuperar un archivo llamado <i>hello.html</i> desde dentro del directorio antes mencionado.</Text>
<Text id="218">Greenstone contiene varios archivos que el servidor Web tiene que leer. La manera más sencilla de proceder es utilizando la directiva <i>Alias</i>, que es como <i>ScriptAlias</i> salvo que se aplica a las páginas Web ordinarias, no a los guiones CGI. Inserte las siguientes líneas en su archivo de configuración Apache, después de la directiva <i>ScriptAlias</i>, a fin de añadir <i>C:\Program Files\gsdl</i> como lugar suplementario donde buscar documentos.</Text>
<CodeLine>Alias /gsdl/  “C:/Program Files/gsdl/”</CodeLine>
<CodeLine>&lt;Directory C:/Program Files/gsdl&gt;</CodeLine>
<CodeLine>Â  Options Indexes MultiViews FollowSymLinks</CodeLine>
<CodeLine>Â  AllowOverride None</CodeLine>
<CodeLine>Â  Order allow, deny</CodeLine>
<CodeLine>Â  Allow from all</CodeLine>
<CodeLine>&lt;/Directory&gt;</CodeLine>
<Text id="219">Esto significa que cualquier URL que se ajuste al primer argumento de la directiva <i>Alias</i> (gsdl) se busca como archivo en el lugar correspondiente al segundo argumento. Dicho de otro modo, las URL con la forma <i>http://localhost/gsdl/...</i> se buscarán como archivos en el directorio <i>C:\Program Files\gsdl</i>. Por ejemplo, si se le presenta la URL <i>http://localhost/gsdl/hello.html</i>, el servidor Web intentará recuperar el archivo <i>C:\Program Files\gsdl\hello.html</i>. Sin embargo, la URL <i>http://localhost/hello.html</i> busca el archivo <i>C:\Program Files\Apache Group\Apache\htdocs\hello.html</i> en el directorio <i>htdocs</i> normal, tal como lo hizo antes.</Text>
<Text id="220">Asegúrese de añadir la directiva <i>Alias</i> después de la directiva <i>ScriptAlias</i>. Si se le da la instrucción a Apache de añadir el alias <i>/gsdl</i> antes de <i>/gsdl/cgi-bin</i> se haría corresponder la URL <i>/gsdl/cgi-bin/library</i> con la directiva <i>Alias</i> y no con la directiva <i>ScriptAlias</i>, lo cual se interpretaría como una solicitud de un documento y no como el resultado de la ejecución de un programa. La consecuencia sería que se “visualizaría” el archivo del programa binario como una página en el servidor Web, en vez de ejecutarlo.</Text>
</Content>
</Subsection>
<Subsection id="security">
<Title>
<Text id="221">Seguridad</Text>
</Title>
<Content>
<Text id="222">Debe usted saber que si la versión de biblioteca Web de Greenstone se instala como se indica más arriba, cualquier persona podrá descargar cualquier archivo en la estructura de directorios <i>gsdl</i>. Esto comprende los archivos de índice y los documentos fuente de cualquiera de las colecciones que haya usted creado, la base de datos del usuario, los registros de utilización, etc.</Text>
<Text id="223">Para evitar esto, puede usted reforzar fácilmente las medidas de seguridad modificando la configuración de su servidor Web. En el caso del servidor Web Apache, sustituya las líneas en el archivo de configuración indicadas en el apartado anterior por las siguientes:</Text>
<CodeLine>Alias /gsdl/  “C:/Program Files/gsdl/”</CodeLine>
<CodeLine>&lt;Directory C:/Program Files/gsdl&gt;</CodeLine>
<CodeLine>Â  Order allow, deny</CodeLine>
<CodeLine>Â  Deny from all</CodeLine>
<CodeLine>  &lt;FilesMatch “\.(gif|jpe?g|png|css|mov|mpeg|ps|pdf|doc|rtf|jar|class)$”&gt;</CodeLine>
<CodeLine>Â Â Â Â  Order allow, deny</CodeLine>
<CodeLine>Â Â Â Â  Allow from all</CodeLine>
<CodeLine>Â  &lt;/FilesMatch&gt;</CodeLine>
<CodeLine>&lt;/Directory&gt;</CodeLine>
<Text id="224">Esto significa que sólo se podrán descargar los archivos cuyas extensiones se ajustan a la expresión regular indicada en la línea <i>FilesMatch</i>.</Text>
</Content>
</Subsection>
</Content>
</Section>
<Section id="pws_and_iis_webservers">
<Title>
<Text id="225">Los servidores Web PWS e IIS</Text>
</Title>
<Content>
<Text id="226">Aunque ni el PWS ni el IIS están instalados por defecto en los actuales sistemas Windows, éstos se pueden instalar fácilmente usando el icono “Agregar o quitar programas” del panel de control. Si no están ya en su CD-ROM de Windows, tendrá que descargarlos del sitio Web de Microsoft (<i>www.microsoft.com</i>).</Text>
<Text id="227">El procedimiento de instalación de Greenstone es idéntico para el PWS y el IIS. Abra el Administrador Personal de Web y sigas las instrucciones siguientes:</Text>
<NumberedList>
<NumberedItem>
<Text id="228">Seleccione <i>Avanzadas</i> para llegar a la pantalla <i>Opciones avanzadas</i></Text>
</NumberedItem>
<NumberedItem>
<Text id="229">Seleccione <i>Inicio</i> y pulse <i>Añadir</i>Rellene los campos del modo siguiente:</Text>
<Text id="230">Campo <i>Directorio</i> :                                               <i>C:\Program Files\gsdl</i></Text>
<Text id="231">Campo <i>Alias</i> :                                                        <i>gsdl</i></Text>
<Text id="232">Permisos de acceso:Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â <i>Read</i></Text>
<Text id="233">Permisos de aplicaciones:Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â <i>None</i></Text>
<Text id="234">Pulse <i>OK</i></Text>
<Text id="235">Esto hace que los archivos Greenstone sean accesibles para el servidor Web.</Text>
</NumberedItem>
<NumberedItem>
<Text id="236">Regrese a <i>Opciones avanzadas</i>, seleccione <i>gsdl</i> y pulse <i>Añadir</i>Rellene los campos del modo siguiente:</Text>
<Text id="237">Campo Directorio:Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â  C:\Program Files\gsdl\cgi-bin</Text>
<Text id="238">Campo Alias:Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â  cgi-bin</Text>
<Text id="239">Permisos de acceso:Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â  None</Text>
<Text id="240">Permisos de aplicaciones:Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â  Execute</Text>
<Text id="241">Pulse OK</Text>
<Text id="242">Esto permite que el servidor Web ejecute el programa de Greenstone <i>library.exe</i></Text>
</NumberedItem>
<NumberedItem>
<Text id="243">Vaya a la URL http://localhost/cgi-bin/library.exe.</Text>
<Text id="244">Nota: con el PWS y el IIS se debe especificar la extensión de archivo <i>.exe</i></Text>
</NumberedItem>
</NumberedList>
</Content>
</Section>
</Content>
</Chapter>
<Chapter id="configuring_your_site">
<Title>
<Text id="245">CONFIGURACIÓN DE SU SITIO</Text>
</Title>
<Content>
<Text id="246">Para que Greenstone funcione correctamente, se deben instalar adecuadamente los permisos de acceso para determinados archivos. Asimismo, cada sitio Greenstone tiene un archivo de configuración asociado. El procedimiento de instalación crea una configuración genérica basada en las opciones de instalación escogidas por usted; no obstante, su contenido puede personalizarse para hacer frente a distintas situaciones. En esta sección se explican ambas cosas.</Text>
<Section id="file_permissions">
<Title>
<Text id="247">Permisos de archivo</Text>
</Title>
<Content>
<Text id="248">Esta sección no atañe a los usuarios de Windows 95/98, ya que esos sistemas no identifican a los propietarios de los archivos.</Text>
<Text id="249">En Windows NT, 2000 y en los sistemas Unix, los guiones CGI no funcionan como usuarios normales, ya que no se puede identificar a los usuarios en la Web. En cambio, se ejecutan en nombre del usuario que arrancó el programa del servidor Web (en los sistemas Windows), o de un usuario especial (que en los sistemas Unix suele llamarse <i>nobody</i>). Debido a esto, todos los archivos y directorios dentro de <i>C:\Program Files\gsdl</i> deben ser legibles por todos (o al menos legibles por el usuario de guiones CGI, que puede ser “ <i>nobody</i> ”). Para comprobar si los permisos de archivo están configurados correctamente, ejecute el programa <i>library.exe</i> a partir de la línea de comando. Si los archivos están en los lugares correctos pero los permisos están mal configurados, el programa arrancará desde la línea de comando –esto es, cuando <i>usted</i> la ejecuta- pero no desde un navegador –esto es, cuando el usuario “ <i>nobody</i> ” la ejecuta. Otra prueba es iniciar la sesión como otro usuario para ver si los permisos de archivo corresponden específicamente a su cuenta de usuario original.</Text>
<Text id="250">Para funcionar desde un navegador Web, todos los directorios de Greenstone deben ser legibles por todos. Asimismo, el directorio <i>C:\Program Files\gsdl\etc</i> y todo su contenido deben ser <i>modificables</i> por cualquier persona. Éste es el directorio en el que el programa de biblioteca escribe el registro de uso, los registros de error y de inicialización y varias bases de datos del usuario. Si no desea usted que cualquier persona pueda modificar este directorio, puede establecer permisos para que el usuario de CGI sólo pueda modificar los archivos <i>errout.txt, initout.txt, key.db, users.db, history.db</i> y <i>usage.txt</i>.</Text>
<Text id="251">Si los permisos de archivo no están configurados correctamente para <i>C:\Program Files\gsdl\etc</i>, es posible que no funcione la autenticación de usuario y el historial de búsqueda, y que no se genere un registro de uso ( <i>usage.txt</i>).</Text>
</Content>
</Section>
<Section id="gsdlsite_configuration_file">
<Title>
<Text id="252">El archivo de configuración <i>gsdlsite.cfg</i></Text>
</Title>
<Content>
<Text id="253">El procedimiento de instalación crea un archivo de configuración de sitio genérico de Greenstone basado en las opciones de instalación que usted ha escogido. Para nuestra instalación este archivo es <i>C:\Program Files\gsdl\cgi-bin\gsdlsite.cfg</i> y su contenido es el siguiente:</Text>
<CodeLine># Site configuration file por Greenstone.</CodeLine>
<CodeLine># Lines begining with</CodeLine>
<CodeLine># are comments.</CodeLine>
<CodeLine># This file should be placed in the same directory as your library</CodeLine>
<CodeLine># executable file. It should be edited to suit your site.</CodeLine>
<CodeLine># points to the GSDLHOME directory</CodeLine>
<CodeLine>gsdlhome      “C:/Program Files/gsdl”</CodeLine>
<CodeLine># this is the http address of GSDLHOME</CodeLine>
<CodeLine># if your webservers DocumentRoot is set to $GSDLHOME</CodeLine>
<CodeLine># then httpprefix can be commented out</CodeLine>
<CodeLine>httpprefix    /gsdl</CodeLine>
<CodeLine># this is the http address of the directory which</CodeLine>
<CodeLine># contains the image for the interface.</CodeLine>
<CodeLine>httpimg       /gsdl/images</CodeLine>
<CodeLine># should contain the http address of this cgi script. This</CodeLine>
<CodeLine># is not needed if the http server sets the environment variable</CodeLine>
<CodeLine># SCRIPT_NAME</CodeLine>
<CodeLine>#gwcgi        /cgi-bin/library</CodeLine>
<CodeLine># maxrequests is the most requests a fastcgi process</CodeLine>
<CodeLine># will serve before it exits. This can be set to a</CodeLine>
<CodeLine># low figure (like 1) while debugging and then set</CodeLine>
<CodeLine># to a high figure (like 10000) when everything is</CodeLine>
<CodeLine># working well.</CodeLine>
<CodeLine>#maxrequests 10000</CodeLine>
<Text id="254">Puede usted personalizar su instalación modificando este archivo, aunque es muy probable que no tenga que hacerlo.</Text>
<Text id="255">La línea <i>gsdlhome</i> señala simplemente hacia el directorio <i>C:\Program Files\gsdl</i>.</Text>
<Text id="256"><i>httpprefix</i> es la dirección Web del directorio en que Greenstone está instalado. Explicamos antes cómo crear un alias de tal modo que las URL con la forma <i>http://localhost/gsdl/...</i> se busquen en el directorio <i>C:\Program Files\gsdl</i>. Añadiendo una línea <i>httpprefix /gsdl</i> en el archivo de configuración <i>gsdlsite.cfg</i> se establece la misma convención para el programa Greenstone.</Text>
<Text id="257"><i>httpimg</i> es la dirección Web del directorio <i>C:\Program Files\gsdl|images</i>, que contiene todas las imágenes en formato GIF utilizadas en la interfaz. En cualquier instalación estándar de Greenstone éste será siempre <i>httpprefix/images</i>, y no se toca la línea correspondiente en el archivo antes indicado.</Text>
<Text id="258"><i>gwcgi</i> es la dirección Web del programa CGI de la biblioteca. La mayoría de los servidores Web (incluido Apache) no la necesitan y debe permanecer marcado como comentario, por lo tanto inactiva. No se debe quitar la marca de comentario a menos de estar seguro de que es necesario, pues eso puede traer problemas.</Text>
<Text id="259"><i>maxrequests</i> sólo es utilizado por las versiones de Greenstone que se compilaron con la opción “fast-cgi”. La distribución binaria estándar no comprende esta opción porque no todos los servidores Web están configurados para admitirla. La opción “fast-cgi” acelera las ejecuciones de los guiones CGI manteniendo en memoria el ejecutable principal entre dos utilizaciones del programa, en vez de cargarlo a partir del disco cada vez que el programa Greenstone solicita una página Web. Se debe conseguir un equilibrio con la cantidad de memoria utilizada, que puede aumentar mientras más tiempo permanezca el programa en memoria. Una vez generadas las páginas <i>maxrequests</i>, el programa CGI se cierra, liberando así el espacio de memoria ocupado. Para responder a la siguiente solicitud de página Web, el programa CGI se lee de nuevo a partir del disco duro y se inicia un nuevo ciclo de solicitudes de página. La mayoría de las instalaciones utilizan el protocolo CGI estándar, lo que significa que el parámetro <i>maxrequests</i> puede ser ignorado sin problema.</Text>
</Content>
</Section>
</Content>
</Chapter>
<Chapter id="personalizing">
<Title>
<Text id="260">PERSONALIZACIÓN DE SU INSTALACIÓN</Text>
</Title>
<Content>
<Text id="261">Es probable que lo primero que usted quiera hacer una vez que Greenstone esté instalado y en funcionamiento es personalizar la página principal. El archivo que genera la página principal de Greenstone se llama  <i>home.dm</i> y está situado en el subdirectorio de <i>macros</i> del directorio en el que usted instaló Greenstone. (El directorio por defecto para los sistemas Windows es <i>C:\Program Files\gsdl</i>.) Se trata de un archivo de texto sin formato que tendrá usted que modificar para crear una nueva página principal. En vez de modificarla, le recomendamos que cree un nuevo archivo, por ejemplo <i>yourhome.dm</i>. Éste será semejante a <i>home.dm</i>, <i/> pero definirá el “ <i>package home</i> ” –que es la parte que efectúa el trabajo efectivo- de un modo distinto.</Text>
<Text id="262">Al crear una página principal diferente, hay que poder vincularla a las páginas de la biblioteca digital para que usted pueda efectuar búsquedas y consultar las colecciones en su sistema. La solución adoptada por Greenstone es utilizar “macros”. Por esa razón, el archivo de la página principal tiene por sufijo “ <i>.dm</i> ” y no “ <i>.html</i> ”: es un archivo “macro” y no un archivo HTML ordinario. Pero no se preocupe: el archivo macro sólo contiene básicamente el HTML, acompañado de unos cuantos ensalmos mágicos que se explican más abajo. El lenguaje macro es una función potente y sólo se describe una pequeña parte de ella más abajo. Véase la <i>Guía del Programador de la Biblioteca Digital Greenstone</i> para obtener más información al respecto.</Text>
<Section id="example">
<Title>
<Text id="263">Ejemplo</Text>
</Title>
<Content>
<Figure id="your_own_greenstone_home_page">
<Title>
<Text id="264">Su propia página principal Greenstone</Text>
</Title>
<File width="630" height="412" url="images/Install_Fig_3.png"/>
</Figure>
<Text id="265">En la Figura <CrossRef target="Figure" ref="your_own_greenstone_home_page"/> se muestra un ejemplo de una nueva página principal de la biblioteca digital. Cada uno de los enlaces “ <i>Presione aquí</i> ” lo lleva a la función de Greenstone apropiada. Esta página se produjo mediante un archivo llamado <i>yourhome.dm</i> que se muestra en la Figura <CrossRef target="Figure" ref="yourhome_dm"/>.</Text>
<Figure id="yourhome_dm">
<Title>
<Text id="266"><i>yourhome.dm</i>Â utilizado para crear la Figura <CrossRef target="Figure" ref="your_own_greenstone_home_page"/></Text>
</Title>
<CodeLine>package home</CodeLine>
<CodeLine>_content_ {</CodeLine>
<CodeLine>&lt;h2&gt;Su propia página principal para Greenstone&lt;/h2&gt;</CodeLine>
<CodeLine>&lt;ul&gt;</CodeLine>
<CodeLine>&lt;table&gt;</CodeLine>
<CodeLine>&lt;tr valign=top&gt;&lt;td&gt;Página de búsqueda para la colección demo&lt;br&gt;&lt;/td&gt;</CodeLine>
<CodeLine>    &lt;td&gt;&lt;a href="_httpquery_&amp;c=demo"&gt;Presione aquí&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;</CodeLine>
<CodeLine>&lt;tr&gt;&lt;td&gt;Página «sobre» para la colección demo&lt;/td&gt;</CodeLine>
<CodeLine>    &lt;td&gt;&lt;a href="_httppageabout_&amp;c=demo"&gt;Presione aquí&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;</CodeLine>
<CodeLine>&lt;tr&gt;&lt;td&gt;Página de preferencias para la colección demo&lt;/td&gt;</CodeLine>
<CodeLine>    &lt;td&gt;&lt;a href="_httppagepref_&amp;c=demo"&gt;Presione aquí&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;</CodeLine>
<CodeLine>&lt;tr&gt;&lt;td&gt;Página principal&lt;/td&gt;</CodeLine>
<CodeLine>    &lt;td&gt;&lt;a href="_httppagehome_"&gt;Presione aquí&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;</CodeLine>
<CodeLine>&lt;tr&gt;&lt;td&gt;Página de ayuda&lt;/td&gt;</CodeLine>
<CodeLine>    &lt;td&gt;&lt;a href="_httppagehelp_"&gt;Presione aquí&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;</CodeLine>
<CodeLine>&lt;tr&gt;&lt;td&gt;Página de administración&lt;/td&gt;</CodeLine>
<CodeLine>    &lt;td&gt;&lt;a href="_httppagestatus_"&gt;Presione aquí&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;</CodeLine>
<CodeLine>&lt;tr&gt;&lt;td&gt;El Colector&lt;/td&gt;</CodeLine>
<CodeLine>    &lt;td&gt;&lt;a href="_httppagecollector_"&gt;Presione aquí&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;</CodeLine>
<CodeLine>&lt;/table&gt;</CodeLine>
<CodeLine>&lt;/ul&gt;</CodeLine>
<CodeLine>}</CodeLine>
<CodeLine># if you hate the squirly green bar down the left-hand side of the page,</CodeLine>
<CodeLine># uncomment these lines:</CodeLine>
<CodeLine># _header_ {</CodeLine>
<CodeLine># }</CodeLine>
</Figure>
<Text id="267">Puede usted utilizar la Figura <CrossRef target="Figure" ref="yourhome_dm"/> como plantilla para crear su propia página principal de Greenstone personalizada. Básicamente, define una macro llamado <i>content</i>. Entre llaves hay un HTML ordinario. Puede usted insertar texto suplementario, así como cualquiera de los comandos de formato HTML, para introducir el contenido que usted quiera ver en la página. El texto es HTML normal; si lo desea, puede incluir hypervínculos y utilizar todas las demás funciones que ofrece HTML.</Text>
<Text id="268">Para vincular su nueva página principal con otras páginas de la biblioteca digital, debe usted hacer uso de un conjuro mágico adecuado. En este lenguaje macro, los conjuros mágicos son palabras flanqueadas por signos de subrayado, como se puede ver en la Figura <CrossRef target="Figure" ref="yourhome_dm"/>. Por ejemplo, <i>_httppagehome_</i> lo lleva a la página principal, <i>_httppagehelp_</i> a la página de ayuda, y así sucesivamente. En algunos casos es necesario incluir un nombre de colección. Por ejemplo, <i>_httpquery_&amp;c=demo</i> especifica la página de búsqueda de la colección de demostración; para otras colecciones se debe reemplazar <i>demo</i> por el nombre de la colección correspondiente.</Text>
<Text id="269">La definición de la macro llamada <i>_content_</i> es HTML simple. Cualquier código HTML estándar puede colocarse dentro de una definición de macro. Sin embargo, los caracteres especiales ‘{‘, ‘}’, ‘\’ y ‘_’ deben ser precedidos de una barra inversa para evitar que sean procesados por el intérprete del lenguaje macro.</Text>
<Text id="270">Obsérvese que la definición de la macro <i>_content_</i> no contiene ningún encabezado o pie de página HTML. Si desea usted cambiar el encabezado o el pie de su página principal, debe definir macros <i>_header_</i> y/o <i>_footer_</i>, añadiéndolas a su archivo <i>yourhome.dm</i> de la siguiente forma:</Text>
<CodeLine>_macroname_ {</CodeLine>
<CodeLine>...</CodeLine>
<CodeLine>}</CodeLine>
<Text id="271">Por ejemplo, la barra verde ondulada que aparece en el lado izquierdo de las páginas de Greenstone está definida en la macro <i>_header_</i> y al anular esta macro se la hará desaparecer, como se indica al final de la Figura <CrossRef target="Figure" ref="yourhome_dm"/>.</Text>
</Content>
</Section>
<Section id="how_to_make_it_work">
<Title>
<Text id="272">Cómo hacer que funcione</Text>
</Title>
<Content>
<Text id="273">Hay que indicar a Greenstone que se ha creado una nueva página principal <i>yourhome.dm</i>. El sistema lee en los archivos macro especificados en el archivo de configuración principal <i>main.cfg</i> y, por lo tanto, si usted crea uno nuevo debe incluirlo allí. Los conflictos de nombres se manejan con el siguiente criterio: la definición más reciente tiene prioridad sobre las demás.</Text>
<Text id="274">Por consiguiente, para que el programa Greenstone de biblioteca digital utilice la página principal de la Figura <CrossRef target="Figure" ref="your_own_greenstone_home_page"/> en vez de la instalada por defecto, primero ponga el archivo <i>yourhome.dm</i> de la Figura <CrossRef target="Figure" ref="yourhome_dm"/> en el directorio de <i>macros</i>. Luego modifique el archivo de configuración <i>main.cfg</i> para reemplazar <i>home.dm</i> por <i>yourhome.dm</i> en la lista de archivos macro que se cargan al inicio.</Text>
</Content>
</Section>
<Section id="redirecting_a_url_to_greenstone">
<Title>
<Text id="275">Reenviar una URL a Greenstone</Text>
</Title>
<Content>
<Text id="276">Es posible que desee usted reenviar una URL más apropiada a su programa CGI de Greenstone. Por ejemplo, en nuestro sistema la URL <i>http://nzdl.org</i> (que es la abreviatura de <i>http://nzdl.org/index.html</i>) se reenvía a <i>http://nzdl.org/cgi-bin/library</i>. El servidor Web Apache efectúa esto mediante la directiva <i>Redirect</i>. Como las demás directivas, ésta va al archivo de configuración <i>C:\Program Files\Apache Group\Apache\conf\httpd.conf</i>. Para reenviar la URLhttp://www.servidor.comahttp://www.servidor.com/cgi-bin/library, añada la línea siguiente en <i>httpd.conf</i> :</Text>
<CodeLine>Redirect /index.html http://www.servidor.com/cgi-bin/library</CodeLine>
<Text id="277">Así llegará usted a su sistema de biblioteca digital directamente desde la URL <i>http://www.servidor.com</i>. En cambio, si usted deseara reenviar una URL como <i>http://www.servidor.com/greenstone</i> a <i>http://www.servidor.com/cgi-bin/library,</i> introduzca en el archivo <i>httpd.conf</i> la línea siguiente:</Text>
<CodeLine>Redirect /greenstone http://www.servidor.com/cgi-bin/library</CodeLine>
<Text id="278">Si su computadora carece de nombre de dominio (como el “www.servidor.com” mencionado más arriba), basta con reemplazar <i>www.servidor.com</i> por <i>localhost</i> en las líneas que figuran más arriba. Mientras el navegador esté funcionando en la misma máquina que el servidor Web –lo cual es seguramente el caso si su computadora no tiene un nombre de dominio- esto tiene el mismo efecto que los reenvíos antes mencionados.</Text>
<Text id="279">En lugar de introducir las directivas de reenvío en el archivo <i>httpd.conf</i>,  puede usted ponerlas en un archivo llamado <i>.htaccess</i> dentro del directorio raíz de los documentos de su servidor. De hecho, esta solución tiene dos ventajas. En primer lugar, las modificaciones efectuadas en el archivo <i>.htaccess</i> surten efecto de inmediato, mientras que es necesario volver a arrancar el servidor Web Apache para ver los efectos de los cambios en el archivo <i>httpd.conf</i>. En segundo lugar, en los sistemas Unix suele ser necesario iniciar la sesión como el usuario “ <i>root</i> ” para poder modificar el archivo <i>httpd.conf</i>, mientras que no lo es para modificar el archivo <i>.htaccess</i>.</Text>
</Content>
</Section>
</Content>
</Chapter>
<Chapter id="appendix_associated_software">
<Title>
<Text id="280">APÉNDICE: PROGRAMAS ASOCIADOS</Text>
</Title>
<Content>
<Text id="281">A continuación se explica cómo conseguir los paquetes de programas mencionados en este documento.</Text>
<Section id="apache_webserver">
<Title>
<Text id="282">Servidor Web Apache</Text>
</Title>
<Content>
<Text id="283">Para hacer funcionar cualquier versión de Greenstone aparte de la versión de Biblioteca Local de Windows, se necesita un servidor Web externo. Muchas instalaciones, en particular las más voluminosas, tendrán ya un servidor Web. Si usted utiliza Linux, Apache puede encontrarse en su disco de instalación pero puede no haber sido seleccionado durante el procedimiento de instalación. El servidor Web Apache de <i>www.apache.org</i> es libre y fácil de instalar.</Text>
</Content>
</Section>
<Section id="perl">
<Title>
<Text id="284">Perl</Text>
</Title>
<Content>
<Text id="285">Para crear colecciones con Greenstone se necesita el lenguaje Perl, versión 5 o superior. Para Windows, recomendamos ActivePerl de <i>www.activestate.com</i>. La mayoría de los sistemas Unix ya tienen Perl instalado, pero si no es el caso, los códigos fuente y los binarios de una amplia gama de plataformas Unix pueden descargarse libremente en <i>www.perl.com</i>.</Text>
</Content>
</Section>
<Section id="gcc">
<Title>
<Text id="286">GCC</Text>
</Title>
<Content>
<Text id="287">La versión Unix de Greenstone se compila con el compilador C++ de GNU, GCC. Greenstone hace un amplio uso de la biblioteca estándar de plantillas C++ (hemos observado que está rota en algunas antiguas versiones de GCC, sírvase avisarnos si tiene usted problemas con STL). Cabe señalar que esta versión de Greenstone no compila con la versión 3.0 de GCC.</Text>
</Content>
</Section>
<Section id="gdbm">
<Title>
<Text id="288">GDBM</Text>
</Title>
<Content>
<Text id="289">Todas las versiones de Greenstone utilizan el Administrador de Base de Datos GNU, GDBM (GNU Database Manager). Viene con todas las versiones Windows de Greenstone y se instala automáticamente durante el procedimiento de instalación. Los sistemas Linux ya tienen GDBM, por lo que no lo proporcionamos para Linux. La mayoría de los demás sistemas Unix lo tienen, pero si es necesario puede usted descargarlo en la URL <i>www.gnu.org</i>.</Text>
</Content>
</Section>
<Section id="java_runtime_environment">
<Title>
<Text id="290">Ambiente de Ejecución Java</Text>
</Title>
<Content>
<Text id="291">Para poder usar la Interfaz de Bibliotecario de Greenstone es necesario contar con una versión adecuada del Ambiente de Ejecución Java (JRE por sus siglas en inglés). Si todavía no lo tiene, el CD-ROM incluye una versión apropiada, o también puede bajar la versión más reciente desde <u>http://java.sun.com/j2se/downloads.html</u>. Se requiere la versión 1.4.0 o superior.</Text>
</Content>
</Section>
<Section id="java_compiler">
<Title>
<Text id="292">Compilador Java</Text>
</Title>
<Content>
<Text id="293">Para compilar el código fuente de la Interfaz de Bibliotecario de Greenstone primero deberá instalar un Kit de Desarrollo de Software Java (SDK por sus siglas en inglés). Usted puede bajar el Kit de Desarrollo de Software J2SE desde <u>http://java.sun.com/j2se/downloads.html</u>. Se requiere la versión 1.4.0 o superior.</Text>
</Content>
</Section>
</Content>
</Chapter>
</Manual>