source: documentation/trunk/manuals/xml-source/pt-br/Install_pt-br.xml@ 18753

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE Manual [
     <!ENTITY nbsp "&#160;">
     <!ENTITY rarr "&#8594;">
     <!ENTITY mdash "&#8212;">  
     <!ENTITY copy "&#169;">   
]>
<Manual id="Install" lang="en">
<Heading>
<Text id="1">BIBLIOTECA DIGITAL GREENSTONE</Text>
</Heading>
<Title>
<Text id="2">GUIA DE INSTALAÇÃO</Text>
</Title>
<Author>
<Text id="3">Ian H. Witten e Stefan Boddie</Text>
</Author>
<Affiliation>
<Text id="4">Departmento de Ciências da Computação <br/>Universidade de Waikato, Nova Zelândia</Text>
</Affiliation>
<SupplementaryText>
<Text id="manual_index">De volta ao índice do manual</Text>
<Text id="top_index">De volta ao Índice Inicial</Text>
</SupplementaryText>
<Text id="5">O Greenstone é um pacote de software para construir e distribuir coleções de bibliotecas digitais. Ele provê uma nova forma  de organizar a informação e publicá-la na internet ou CD-ROM. O Greenstone é produzido pelo Projeto de Biblioteca Digital da Nova Zelândia, na Universidade de Waikato, e desenvolvido e distribuído em cooperação com a UNESCO e da ONG Human Info. É um software de código aberto, disponível em  <i>http://greenstone.org</i> sob os termos da Licença Pública Geral do Gnu. </Text>
<Comment>
<Text id="6">Queremos garantir que este software funcione corretamente para você. Por favor reporte qualquer problema a <i>[email protected]</i></Text>
</Comment>
<Version>
<Text id="7">Greenstone gsdl-2.50</Text>
</Version>
<Date>
<Text id="8">Março de 2004.</Text>
</Date>
<Section id="about_this_manual">
<Title>
<Text id="9">Sobre este manual</Text>
</Title>
<Content>
<Text id="10">Este documento explica como instalar o software Greenstone para uso pessoal. O documento também descreve como obter software livre associado - como o servidor web Apache e o Perl.  Esta documentação foi escrita com o objetivo de tornar o procedimento de instalação o mais simples possível.</Text>
<Text id="11">O software pode ser executado em diferentes plataformas, e com diferentes configurações. ConseqÌentemente existem várias questões que afetam (ou podem afetar) o processo de instalação. A seção <CrossRef target="Chapter" ref="versions_of_greenstone"/> menciona algumas questões que você terá que considerar antes de instalar o Greenstone. A seção <CrossRef target="Chapter" ref="installation_procedure"/> detalha o processo de instalação para todas as diferentes versões; você somente terá que verificar  a parte relacionada ao seu sistema operacional. A seção <CrossRef target="Chapter" ref="greenstone_collections"/> descreve as coleções de demonstração de bibliotecas digitais  que estão inclusas na distribuição. A seção <CrossRef target="Chapter" ref="setting_up_webserver"/> explica como configurar os servidores web mais comuns, como o Apache e Microsoft PWS/IIS, para trabalhar com o Greenstone. A seção <CrossRef target="Chapter" ref="configuring_your_site"/> descreve várias opções de configuração do Greenstone, e a seção <CrossRef target="Chapter" ref="personalizing"/> mostra como personalizar a página web da sua instalação de biblioteca digital. Finalmente, o Apêndice <CrossRef target="Chapter" ref="appendix_associated_software"/> lista os softwares associados e como obtê-los. </Text>
</Content>
</Section>
<Section id="companion_documents">
<Title>
<Text id="12">Documentos Relacionados</Text>
</Title>
<Content>
<Text id="13">O conjunto completo da documentação do Greenstone inclui cinco volumes:</Text>
<BulletList>
<Bullet>
<Text id="14">Guia de Instalação da Biblioteca Digital Greenstone <i>(este documento)</i></Text>
</Bullet>
<Bullet>
<Text id="15">Guia do Usuário da Biblioteca Digital Greenstone</Text>
</Bullet>
<Bullet>
<Text id="16">Guia do Desenvolvedor da Biblioteca Digital Greenstone</Text>
</Bullet>
<Bullet>
<Text id="17">A Biblioteca Digital Greenstone: do Papel à Coleção</Text>
</Bullet>
<Bullet>
<Text id="18">Biblioteca Digital Greenstone: Utilizando o Organizador</Text>
</Bullet>
</BulletList>
</Content>
</Section>
<Section id="copyright">
<Title>
<Text id="copyright-title">Copyright</Text>
</Title>
<Content>
<Text id="right-text-1">Copyright &copy; 2002 2003 2004 2005 2006 2007  por <Link url="http://www.nzdl.org">Projeto Biblioteca Digital da Nova Zelândia </Link> at <Link url="http://www.waikato.ac.nz">Universidade de Waikato</Link>, Nova Zelândia.</Text>
<Text id="right-text-2">A permissão é cedida para cópia, distribuição e/ou modificação deste documento dentro dos termos da <Link url="http://www.gnu.org/licenses/fdl.html">Licença gratuita de Documentação GNU </Link>, Versão 1.2 ou posterior publicada pela Fundação de Software Livre; sem seções invariantes, sem textos de Capa. A cópia da licença está incluída na seção entitulada <Link url="http://greenstonewiki.cs.waikato.ac.nz/wiki/gsdoc/GNUFDL.html">“Licença gratuita de Documentação GNU.”</Link>  </Text>
</Content>
</Section>
<Section id="acknowledgements">
<Title>
<Text id="19">Agradecimentos</Text>
</Title>
<Content>
<Text id="20">O software Greenstone é o resultado do esforço de colaboração entre várias pessoas. Rodger McNab e Stefan Boddie são os principais arquitetos e implementadores. Várias contribuições foram feitas por 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, e Stuart Yeates. Outros membros do projeto da Biblioteca Digital da Nova Zelândia ajudaram com conselhos e inspiração para o desenvolvimento do sistema: Mark Apperley, Sally Jo Cunningham, Matt Jones, Steve Jones, Te Taka Keegan, Michel Loots, Malika Mahoui, Gary Marsden, Dave Nichols e Lloyd Smith. Gostaríamos também de agradecer a todos que contribuíram com os pacotes de licenças GNU incluídos nesta distribuição: MG, GDBM, PDFTOHTML, PERL, WGET, WVWARE e XLHTML. </Text>
</Content>
</Section>
<Chapter id="versions_of_greenstone">
<Title>
<Text id="21">Versões do Greenstone</Text>
</Title>
<Content>
<Text id="22">O software Greenstone pode ser executado em diversas plataformas, e com várias configurações, como resumido na Figura <CrossRef target="Figure" ref="different_options"/>.</Text>
<Figure id="different_options">
<Title>
<Text id="23">As diferentes opções para as versões Unix e Windows do Greenstone</Text>
</Title>
<File width="542" height="264" url="images/Install_Fig_1.gif"/>
</Figure>
<Text id="24">Existem várias questões que afetam (ou podem afetar) o procedimento de instalação. Antes de continuar na leitura, considere os seguintes fatores: </Text>
<BulletList>
<Bullet>
<Text id="25">Você está utilizando o ambiente Windows ou Unix?</Text>
</Bullet>
<Bullet>
<Text id="26">Se você utiliza o Windows, está utilizando a versão Windows 3.1/3.11 ou alguma versão mais recente? Embora seja possível visualizar coleções em máquinas que utilizem o 3.1/3.11, e que utilizem outros computadores em uma mesma rede, não será possível construir novas coleções. O Greenstone completo pode ser executado somente em 95/98/Me, e NT/2000.</Text>
</Bullet>
<Bullet>
<Text id="27">Se você está com o ambiente Unix, você utiliza o Linux ou alguma outra versão do Unix? No caso do Linux, existe a versão binária do sistema completo já incluída, e sua instalação é fácil. Para os outros tipos de Unix será necessária a instalação do código fonte e a sua compilação. Para isso talvez seja necessário que você instale alguns softwares adicionais em sua máquina. </Text>
</Bullet>
<Bullet>
<Text id="28">Se o ambiente é Windows NT/2000 ou Unix, você consegue realizar o login como “administrator” ou “raiz”? Isso talvez seja necessário para configurar o servidor web adequadamente para o Greenstone.</Text>
</Bullet>
<Bullet>
<Text id="29">Você quer o código fonte? Se você utiliza o Windows ou Linux, você pode instalar  apenas os binários. Porém você pode querer o código fonte também- ele se encontra na distribuição do Greenstone. </Text>
</Bullet>
<Bullet>
<Text id="30">Você quer construir novas coleções de bibliotecas digitais? Se a resposta é sim, você precisa ter o Perl, que é disponível em código livre para ambos ambientes Windows e Unix.</Text>
</Bullet>
<Bullet>
<Text id="31">O seu computador está executando um servidor web? O software Greenstone já vem com um servidor web Windows. Entretanto, se você já tem um servidor web sendo executado, você poderá optar por continuar com ele. Em ambientes Unix, será necessário executar um servidor web. </Text>
</Bullet>
<Bullet>
<Text id="32">Você sabe como reconfigurar um servidor web? Se você não quer utilizar o servidor web do Greenstone, você vai ter de reconfigurar o seu servidor existente para reconhecer o Greenstone. </Text>
</Bullet>
</BulletList>
</Content>
</Chapter>
<Chapter id="installation_procedure">
<Title>
<Text id="33">O Procedimento de Instalação </Text>
</Title>
<Content>
<Text id="34">As versões do Greenstone estão disponíveis tanto para Windows como para Unix, como binários e arquivos fonte. A interface de usuário do Greenstone  ulitiza um navegador web: Netscape Navigator ou Internet Explorer (versões 4.0 ou posteriores em ambos os casos) podem ser utilizadas. Caso você ainda não tenha um navegador Web, versões Windows do Netscape são fornecidas no CD-ROM. </Text>
<Section id="windows">
<Title>
<Text id="35">Windows</Text>
</Title>
<Content>
<Text id="36">Se você é um usuário Unix,  por favor pule para a seção <CrossRef target="Section" ref="unix"/>. Para usuários Windows, se você quer apenas uma  instalação simples e básica, vá pelo procedimento "instalação simples". O sistema Greenstone ocupa aproximadamente 40 Mb de espaço em disco. </Text>
<Text id="37">Se você escolhe qualquer opção que não seja a configuração básica, você terá que decidir se utilizará o código binário ou o código fonte. Na dúvida, escolha o código binário. O procedimento de instalação é o mesmo para ambos. As seções seguintes lhe mostram as opções disponíveis. </Text>
<Text id="38">Quando você  tiver terminado a instalação, poderá pular para a seção <CrossRef target="Section" ref="how_to_find_greenstone"/>.</Text>
<Subsection id="simple_installation">
<Title>
<Text id="39">Instalação Simples</Text>
</Title>
<Content>
<Text id="40">Para instalaar a versão Windows a partir do CD-ROM, insira o disco no drive (por exemplo o drive  <i>D:</i>). Se o procedimento de instalação não iniciar automaticamente após 20 segundos, clique no menu <i>Início</i>, selecione <i>Executar</i> e digite <i>D:\setup.exe</i>, onde “ <i>D</i> ” é a letra que identifica o seu drive CD-ROM. Para o ambiente Windows 3.1, selecione <i>Run</i> do “File manager” e digite  <i>D:\Windows\win3.1\setup.exe</i>.</Text>
<Text id="41">Para a instalação simples, simplesmente aceite as opções padrões, clicando no botão <i>Próximo</i>. Isso é tudo o que você precisa fazer! O Greenstone é instalado no diretório  <i>C:\Program Files\gsdl</i>.</Text>
<Text id="42">Uma vez que a instalação esteja completa, inicie o sistema Greenstone clicando no botão <i>Início</i>, abra o menu <i>Programas</i>, e selecione <i>Biblioteca Digital Greenstone</i>. Isto lhe trará a caixa de diálogo: simplesmente clique em <i>Entrar na Biblioteca.</i> O seu navegador internet será inicializado automaticamente e carregará a página da Biblioteca Digital do Greenstone, que deve se parecer com o exemplo na figura <CrossRef target="Figure" ref="your_greenstone_home_page"/>. Você entra na coleção demo do Greenstone clicando neste ícone. </Text>
<Figure id="your_greenstone_home_page">
<Title>
<Text id="43">A sua página do Greenstone</Text>
</Title>
<File width="395" height="327" url="images/Install_Fig_2.png"/>
</Figure>
</Content>
</Subsection>
<Subsection id="windows_binaries">
<Title>
<Text id="44">Arquivos binários do Windows</Text>
</Title>
<Content>
<Text id="45">Existem dois  programas binários separados para o Windows no CD-ROM: a <i>Biblioteca Local</i> e a  <i>Biblioteca Web</i>. A instalação padrão descrita acima seleciona a versão da Biblioteca Local. Recomendamos fortemente que você utilize esta versão. A Biblioteca Web, muito mais difícil de configurar, somente é necessária se você já utiliza um servidor web e quer utilizá-lo também para o Greenstone. Apesar do seu nome modesto, a Biblioteca Local apresenta completa capacidade de ser concisa e de servir/disponibilizar as informações via web. </Text>
<Text id="46">Biblioteca Local. Ela habilita qualquer computador Windows a servir/visualizar coleções pré-construídas do Greenstone. A coleção Demo do Greenstone será instalada automaticamente; você poderá instalar também outras coleções disponíveis no CD-ROM (Section <CrossRef target="Chapter" ref="greenstone_collections"/>). O software da Biblioteca Local é o mesmo utilizado pelos CD-ROMs produzidos pelo sistema do Greenstone. </Text>
<Text id="47">A Biblioteca Local é feita para o uso de computadores isolados ou de computadores que ainda não têm um software para servidor web. Ela contém um pequeno servidor web interno para que outros computadores na mesma rede consigam acessar a biblioteca. (Porém o servidor web têm configurabilidade limitada.) </Text>
<Text id="48">O software de Biblioteca Local determina automaticamente se o seu computador tem software de rede instalado ou se está conectado em uma rede. Ele opera corretamente sobre qualquer combinação destas condições. Entretando existem dois possíveis problemas que podem ser encontrados. O Greenstone pode </Text>
<BulletList>
<Bullet>
<Text id="49">causar uma chamada de linha discada não requisitada; </Text>
</Bullet>
<Bullet>
<Text id="50">falha na execução porque o software de rede está instalado, porém instalado incorretamente. </Text>
</Bullet>
</BulletList>
<Text id="51">Uma versão restrita da Biblioteca Local é fornecida, com o objetivo de uso para estas situações. A versão restrita somente opera com Netscape (e não com o Internet Explorer). Quando você executar a versão de Biblioteca Local do Greenstone, a caixa de diálogo contem um botão que lhe permite usar a versão restrita. Ao menos que algum dos problemas listados acima ocorra, você  deveria sempre utilizar a versão padrão. </Text>
<Text id="52"><b>Biblioteca Web</b>. Isto habilita qualquer computador com um servidor web a visualizar coleções pré-construídas do Greenstone. Assim como a Biblioteca Local acima, a coleção DEMO do Greenstone será automaticamente instalada. Você poderá instalar também outras coleções do CD-ROM (veja a seção <CrossRef target="Chapter" ref="greenstone_collections"/>).</Text>
<Text id="53">A Biblioteca Web difere da Biblioteca Local porque tem o objetivo de operar em computadores que já tenham o software para servidor web.</Text>
<Text id="54">Para executar a Biblioteca Web, você também precisa de</Text>
<BulletList>
<Bullet>
<Text id="55">Software para servidor Web. Uma possibilidade é o Apache (verifique o Apêndice <CrossRef target="Chapter" ref="appendix_associated_software"/>).</Text>
</Bullet>
<Bullet>
<Text id="56"><b>O Coletor</b>. Este componente, que é incluído tanto na Biblioteca Local quanto na Biblioteca Web, lhe permite construir coleções contendo material de sua escolha (O Coletor não funciona em máquinas com Windows 3.1/3.11.)</Text>
</Bullet>
</BulletList>
</Content>
</Subsection>
<Subsection id="windows_webserver_configuration">
<Title>
<Text id="57">A configuração do web server para Windows (somente para a versão de Biblioteca Web)</Text>
</Title>
<Content>
<Text id="58">Uma vantagem da versão da Biblioteca Local do Greenstone é que ela roda “fora da caixa” de maneira fácil e não requer nenhuma configuração especial. Para a versão de Biblioteca Web, entretanto, alguns ajustes são necessários na configuração do seu servidor web. </Text>
<Text id="59">Se você já tem um servidor web, algumas pequenas mudanças terão que ser feitas na configuração, para a instalação do Greenstone funcionar. O script de instalação explica as alterações para o servidor Web Apache —verifique a seção <CrossRef target="Section" ref="pws_and_iis_webservers"/> para instruções de como configurar os servidores web PWS e IIS. Talvez você precise da ajuda de seu administrador de rede para reconfigurar o web server existente -eles devem ser capazes de compreender as instruções indicadas no script de instalação. </Text>
<Text id="60">Se você ainda não tem um servidor web, você terá que instalar um. (Verifique o Apêndice <CrossRef target="Chapter" ref="appendix_associated_software"/> para informações sobre o servidor Web Apache.)  Posteriormente você terá que configurá-lo apropriadamente. A seção <CrossRef target="Chapter" ref="setting_up_webserver"/> dá conta detalhada dos passos da instalação do servidor web que afetam o Greenstone, e como eles podem ser alterados. Aproximadamente meia dúzia de linhas são alteradas no arquivo de configuração. </Text>
</Content>
</Subsection>
<Subsection id="windows_source">
<Title>
<Text id="61">O código de fonte Windows </Text>
</Title>
<Content>
<Text id="62">O código fonte do Windows ocupa 50 Mb de espaço de disco, porém para compilá-lo, você precisará de aproximadamente 90Mb. Para compilar os fontes no Windows, você precisa de </Text>
<BulletList>
<Bullet>
<Text id="63">O compilador Microsoft Visual C++. (Ainda estamos verificando alguns problemas compilando o Greenstone com várias portas do Windows, utilizando o GNU GCC.)</Text>
</Bullet>
</BulletList>
<Text id="64">(Você não precisará do GDBM, o administrador de banco de dados Gnu, por que ele já está incluído na distribuição fonte do Greenstone.)</Text>
<Text id="65">Provavelmente você não conseguirá compilar o Greenstone em uma máquina Windows 3.1/3.11.</Text>
<Text id="66">No caso de você recompilar o Greenstone e querer usar esta versão para criar CD-ROMs, você precisa notar que o código produzido por versões recentes do compilador Visual C++ não consegue ser executado em Windows 3.1/3.11, apesar de não haver problemas com versões posteriores do Windows (95, 98, Me, NT, 2000). Se você quiser que seus CD-ROMs operem em versões anteriores de Windows, você precisará de uma versão diferente do compilador. De qualquer maneira, o Greenstone utiliza o STL, a biblioteca padrão de C++, e embora estes compiladores tenham o STL, as versões fornecidas não funcionam adequadamente. Assim, para recompilar o Greenstone de tal maneira que ele produza CD-ROMS que funcionem em versões anteriores do Windows, você precisa de</Text>
<BulletList>
<Bullet>
<Text id="67">O compilador Microsoft Visual C++ compiler, versões 4.0 ou 4.2.</Text>
</Bullet>
<Bullet>
<Text id="68">Uma versão externa do STL, o template da biblioteca padrão do C++. O STL é empacotado com o Greenstone para o uso destas versões de compiladores. </Text>
</Bullet>
</BulletList>
<Text id="69">Note que o procedimento de instalação no Windows não tenta compilar o Greenstone para você se você escolher instalar o código fonte. Para as instruções específicas sobre a plataforma e compiladores, veja o documento  <i>Install.txt</i>, que está localizado no diretório (<i>C:\Program Files\gsdl</i> por default) durante o processo de instalação. </Text>
</Content>
</Subsection>
</Content>
</Section>
<Section id="unix">
<Title>
<Text id="70">Unix</Text>
</Title>
<Content>
<Text id="71">Esta seção é escrita para usuários Unix. (Os usuários Windows deverão pular para a Seção <CrossRef target="Section" ref="how_to_find_greenstone"/>.) Você precisa escolher entre instalar o código fonte ou o código binário. O código binário ocupa aproximadamente 50Mb de disco; o código fonte requer aproximadamente 160 Mb para a compilação. </Text>
<Subsection id="unix_binaries">
<Title>
<Text id="72">Binários do Unix</Text>
</Title>
<Content>
<Text id="73">O código binário requer uma distribuição Linux baseada em Intel x86 que inclua o suporte binário ELF. Algumas das distribuições que têm este critério são: </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">As versões mais recentes destas distribuições deveriam funcionar também. </Text>
<Text id="79">Você precisará de um servidor web: nós recomendamos o Apache. Também recomendamos fortemente que você instale seu servidor web <i>antes</i> de instalar o Greenstone -- isso vai facilitar em muito para responder as perguntas questionadas durante o procedimento de instalação. Se você quiser construir novas coleções de bibliotecas digitais, você também precisa do Perl, se ele ainda não se encontra em seu sistema. Para verificar isso, abra uma janela do terminal, digite <i>perl —v</i>, e verifique se uma mensagem aparece especificando, entre outras coisas, o número da versão. Para a maioria das versões do Linux, o Perl é instalado por default. O Apêndice <CrossRef target="Chapter" ref="appendix_associated_software"/> dá informações sobre como obter o Apache e o Perl. </Text>
</Content>
</Subsection>
<Subsection id="unix_source">
<Title>
<Text id="80">Código fonte Unix</Text>
</Title>
<Content>
<Text id="81">O código fonte é o mesmo para usuários Unix e Windows. Ele foi compilado e testado em Linux, Solaris, e Macintosh OS/X; e deveria ser uma rotina fácil a questão da sua portabilidade para outras distribuições de Unix. </Text>
<Text id="82">Para compilar o código fonte do Greenstone no Unix, você precisa de</Text>
<BulletList>
<Bullet>
<Text id="83">GCC, o compilador Gnu C++.</Text>
</Bullet>
<Bullet>
<Text id="84">GDBM, o administrador de dados Gnu.</Text>
</Bullet>
</BulletList>
<Text id="85">Para executar o software Greenstone, você também precisa de um servidor web e do Perl, como descrito acima em  <i>Binários do Unix</i>.</Text>
</Content>
</Subsection>
<Subsection id="unix_installation">
<Title>
<Text id="86">A instalação Unix</Text>
</Title>
<Content>
<Text id="87">Para instalar a versão Unix a partir do CD-ROM, insira o disco no drive, e digite</Text>
<Table class="hidden" id="table_commands">
<Title/>
<TableContent>
<tr>
<th width="151">
<CodeLine>mount /cdrom</CodeLine>
</th>
<th width="246">
<Text id="88">monte o dispositivo de CD-ROM (este comando pode ser diferente de um sistema para outro; em OS/X, por exemplo,  você executaria o  <i>cd</i> para o diretório <i>/Volumes</i> e iria para o subdiretório apropriado do CD-ROM) </Text>
</th>
</tr>
<tr>
<th width="151">
<CodeLine>cd /cdrom</CodeLine>
</th>
<th width="246">
<Text id="89">mude o diretório para a raiz do CD-ROM</Text>
</th>
</tr>
<tr>
<th width="151">
<CodeLine>cd Unix</CodeLine>
</th>
<th width="246">
<Text id="90">mude este diretório para o diretório que contém os scripts de instalação do Unix</Text>
</th>
</tr>
<tr>
<th width="151">
<CodeLine>sh Install.sh</CodeLine>
</th>
<th width="246">
<Text id="91">inicie o processo de instalação (um explícito <i>sh</i> é utilizado pois muitas instalações proíbem os programas de serem executados a partir do CD-ROM)</Text>
</th>
</tr>
</TableContent>
</Table>
<Text id="92">O último comando inicia um diálogo interativo que requisita a informação necessária para a instalação do Greenstone no seu sistema, e lhe apresenta detalhes de cada comando executado no momento. </Text>
<Text id="93">O procedimento de instalação começa perguntando a você em qual diretório o Greenstone será instalado. O primeiro arquivo instalado será o programa de "desinstalação" que remove qualquer instalação parcial, caso você problemas ou termine a instalação de modo prematuro. Em seguida você escolhe se quer instalar os arquivos binários ou o código fonte. Você então será questionado sobre a configuração do servidor web. Voce precisa ter um diretório executável cgi (normalmente "cgi-bin" em sistemas Unix); você pode tanto criar um novo como utilizar algum existente.  Se você criar um novo, você precisará entrar com esta informação no arquivo de configuração de seu servidor web. Em qualquer dos casos você precisa entrar com o endereço web do diretório cgi. O diálogo de instalação lhe guiará durante todas estas escolhas. É importante configurar as permissões de arquivos corretamente em alguns diretórios, e você será questionado para dar estas informações necessárias.  Finalmente, será requisitada a você uma senha para o usuário "administrador"  <i>admin</i>.</Text>
<Text id="94">Por default, todo o software Greenstone é instalado no diretório <i>/usr/local/gsdl</i>, caso seja o usuário raiz que está realizando a instalação, e caso contrário no diretório  ~<i>/gsdl</i>  (onde “~” é o diretório home do usuário).</Text>
<Text id="95">A instalação do código binário leva somente alguns minutos, com tempo suficiente para você responder as questões apropriadas. Se você instalar o código fonte, o script de instalação irá compilá-lo, o que pode levar de dez minutos a uma hora, dependendo da velocidade de seu processador. </Text>
<Text id="96">Para desinstalar o software, digite </Text>
<CodeLine>cd ~/gsdl</CodeLine>
<Text id="97">ou <i>/usr/local/gsdl</i> caso seja o usuário raiz quem tenha instalado o Greenstone</Text>
<CodeLine>sh Uni nstall.sh</CodeLine>
<Text id="98">Durante o procedimento de instalação você será questionado se você quer instalar alguma coleção do Greenstone. A coleção Demo do Greenstone é instalada automaticamente; outras coleções do CD-ROM são descritas na seção  <CrossRef target="Chapter" ref="greenstone_collections"/>.</Text>
</Content>
</Subsection>
<Subsection id="unix_webserver_configuration">
<Title>
<Text id="99">A configuração do servidor web Unix</Text>
</Title>
<Content>
<Text id="100">Se você já tem um servidor web, algumas pequenas mudanças serão necessárias na configuração para a instalação do Greenstone.  O script de instalação explica estas modificações. Você provavelmente precisará de ajuda do seu administrador de rede para reconfigurar o servidor web - ele ou ela deverá estar habilitado para entender as instruções de saída indicadas pelo script de instalação. Para a sua conveniência, a saída do script de instalação é escrita em um arquivo nomeado INSTALL_RECORD no diretório escolhido para a instalação do Greenstone.</Text>
<Text id="101">Se você não tem um servidor web, será necessária a sua instalação. O Apêndice <CrossRef target="Chapter" ref="appendix_associated_software"/> apresenta informações sobre o servidor Apache. Será necessária a sua configuração apropriada. A seção  <CrossRef target="Chapter" ref="setting_up_webserver"/> apresenta os detalhes da instalação do servidor Apache que são afetados pelo Greenstone, e como devem ser alterados. Aproximadamente 6 linhas devem ser incluídas no arquivo de configuração. </Text>
<Text id="102">Não é necessário ser o usuário "raiz" para realizar o processo de instalação acima. Entretanto, se for necessária a configuração de um servidor Apache já existente, talvez sejam necessários os privilégios específicos do usuário “raiz” - dependendo de como está configurado o servidor Apache. Se você mesmo instalar o Apache, não precisará dos privilégios do usuário "raiz". E se você precisa contornar um administrador de rede que não coopera, sempre há a alternativa de instalar um segundo servidor Apache em seu computador - mesmo se já houver um instalado.</Text>
</Content>
</Subsection>
</Content>
</Section>
<Section id="how_to_find_greenstone">
<Title>
<Text id="103">Como encontrar o Greenstone</Text>
</Title>
<Content>
<Subsection id="local_library_windows_only">
<Title>
<Text id="104">Biblioteca local (para o Windows somente)</Text>
</Title>
<Content>
<Text id="105">Se você está usando a Biblioteca Local, simplesmente execute o programa <i>Greenstone</i> do menu <i>Iniciar</i> . Isto imediatamente abre uma caixa de diálogo que aciona seu navegador interne e carrega a página da Biblioteca Digital Greenstone no seu navegador. A coleção Demo do Greenstone estará acessível a partir desta página inicial. A caixa de diálogo contém um item de menu <i>Arquivo</i> que lhe permitirá trocar o navegador padrão utilizado pelo Greenstone. Não importa se você utiliza o Netscape ou o Internet Explorer, exceto se você estiver executando o  Windows 2000, neste caso nós recomendamos que você utilize o Internet Explorer.</Text>
</Content>
</Subsection>
<Subsection id="web_library_windows_and_unix">
<Title>
<Text id="106">Biblioteca Web (Windows e Unix)</Text>
</Title>
<Content>
<Text id="107">Se você estiver utilizando a Biblioteca Web,  após a instalação do software e configuração do servidor web, utilize esta URL para entrar no Greenstone:</Text>
<Text id="108"><i>http://localhost/gsdl/cgi-bin/library</i></Text>
<Text id="109">A coleção Demo do Greenstone está acessível a partir desta página.</Text>
</Content>
</Subsection>
<Subsection id="the_collector">
<Title>
<Text id="110">O Coletor</Text>
</Title>
<Content>
<Text id="111">Um link para o Coletor é fornecido na página web da biblioteca digital.</Text>
</Content>
</Subsection>
<Subsection id="administration">
<Title>
<Text id="112">Administração</Text>
</Title>
<Content>
<Text id="113">Um link para a página de Administração é fornecido  na página web da biblioteca digital. O usuário "administrador" é nomeado <i>admin</i>, com uma senha especificada durante o processo de instalação. O administrador é autorizado a adicionar novos usuários, e a construir coleções.  </Text>
</Content>
</Subsection>
</Content>
</Section>
<Section id="the_greenstone_librarian_interface_(gli)">
<Title>
<Text id="114">A Interface de Biblioteca do Greenstone (GLI) </Text>
</Title>
<Content>
<Text id="115">A Interface de Biblioteca do Greenstone (GLI) é uma ferramenta para ajudar no desenvolvimento de bibliotecas digitais para o Greenstone. Ela lhe dará acesso à funcionalidade de construção de coleção do Greenstone, em uma interface de fácil manuseio.  </Text>
<Text id="116">A GLI é instalada automaticamente com todas as distribuições do Greenstone. Está localizada no subdiretório <i>gli</i> no nível superior do diretório do Greenstone (<i>C:\Program Files\gsdl\gli</i> por default). Note que a GLI é executada em conjunto com o Greenstone e não trabalhará corretamente se não estiver localizada em um subdiretório da instalação do Greenstone. Este é o seu caso se você fez o download de uma das distribuições do Greenstone.</Text>
<Text id="117">Para utilizar a GLI, seu computador precisará do ambiente Java Runtime Environment. Se você ainda não o instalou, o instalador  lhe apresentará uma versão já inclusa no CD-ROM. No ambiente Unix você também deverá assegurar que o Perl está instalado (no ambiente Windows, o Perl já está incluso no software Greenstone). Caso você tenha algum problema usando ou executando a Interface de Biblioteca, por favor reporte o erro para <u>[email protected]</u>.</Text>
<Subsection id="running_under_windows">
<Title>
<Text id="118">Executando no ambiente Windows</Text>
</Title>
<Content>
<Text id="119">Para executar a GLI no ambiente Windows, selecione a pasta <i>gli</i> na instalação do Greenstone (utilizando o Windows Explorer), e faça um click duplo no arquivo <i>gli.bat</i>. Este arquivo checa se o Greenstone, o Java Runtime Environment, e o Perl estão instalados, e inicia a Interface de Biblioteca Greenstone.</Text>
</Content>
</Subsection>
<Subsection id="running_under_unix">
<Title>
<Text id="120">Executando no ambiente Unix</Text>
</Title>
<Content>
<Text id="121">Para executar a GLI no ambiente Unix, vá ao diretório <i>gli</i> da sua instalação Greenstone, e execute o script <i>gli.sh</i>. Este script verifica se o Greenstone, o Java Runtime Environment, e o Perl estão instalados e listados na variável de ambiente PATH, além de iniciar a Interface de Biblioteca do Greenstone.  </Text>
</Content>
</Subsection>
<Subsection id="getting_help">
<Title>
<Text id="122">Obtendo ajuda</Text>
</Title>
<Content>
<Text id="123">A Interface de Biblioteca do Greenstone tem vários recursos de ajuda online. É possivel obter ajuda clicando no botão <i>Help</i> no canto direito da tela.  Ele abre um texto para uma seção que relata o que você está fazendo -  em qual dos painéis da GLI você se encontra. Você pode selecionar qualquer parte do texto de ajuda para aprender o que você precisa saber. Utilize-o.  </Text>
</Content>
</Subsection>
<Subsection id="compiling_gli">
<Title>
<Text id="124">Compilando a Interface de Biblioteca do Greenstone</Text>
</Title>
<Content>
<Text id="125">Se você realizou o download da fonte da distribuição Geenstone, você terá o código fonte Java da Interface de Biblioteca. Para compilá-lo, seu computador precisa do Java Development Kit. O Apêndice <CrossRef target="Chapter" ref="appendix_associated_software"/> explica como obtê-lo. Para compilar o código fonte, execute o arquivo <i>makegli.bat</i>(Windows) ou  <i>makegli.sh</i>(Unix) . Uma vez compilados, você já pode executar a GLI como descrito acima. </Text>
</Content>
</Subsection>
</Content>
</Section>
<Section id="testing_and_troubleshooting">
<Title>
<Text id="126">Testando e Resolvendo Problemas</Text>
</Title>
<Content>
<Text id="127">Para testar o Greenstone,  direcione o seu navegador Web para a página do Greenstone e explore a coleção Demo, e qualquer outra coleção que você tenha instalado. Não se preocupe - você não pode quebrar nada. Clique livremente: a maioria das as imagens que aparecem na tela são clicáveis, são links para outras informações. Se você mantiver o mouse parado sobre uma imagem, a maioria dos navegadores rapidamente mostrará uma mensagem pop up que conta o que acontecerá se você clicar. Experimente! Escolha palavras comuns como "o" e "e" para fazer a busca - isso provavelmente retornará algumas respostas, e nada vai se quebrar. Para mais informações, verifique o <i>Guia do Usuário da Biblioteca Digital Greenstone</i>.</Text>
<Subsection id="troubleshooting">
<Title>
<Text id="128">Resolvendo 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">Experimente o seguinte</Text>
</th>
</tr>
<tr>
<th width="132">
<Text id="131">Biblioteca Local (somente para ambiente Windows)</Text>
</th>
<th width="151">
<Text id="132">Quando eu inicio o Greenstone meu computador requisita a discagem para o meu provedor de serviços Internet.</Text>
</th>
<th width="246">
<Text id="133">Clique no botão <i>Cancelar</i> na caixa de diálogo. Isto normalmente soluciona o problema.  </Text>
</th>
</tr>
<tr>
<th width="132"/>
<th width="151">
<Text id="134">Quando eu inicio o Greenstone meu computador <i>ainda</i> requisita a discagem para o meu provedor de serviços internet.  </Text>
</th>
<th width="246">
<Text id="135">Escolha a "Versão Restrita" quando você iniciar o Greenstone. Esta versão funciona somente com o Netscape.</Text>
</th>
</tr>
<tr>
<th width="132"/>
<th width="151">
<Text id="136">Quando eu direciono o meu navegador para a página da biblioteca digital, é exibida uma mensagem de que a página não pode ser encontrada.</Text>
</th>
<th width="246">
<Text id="137">Verifique a configuração de proxy internet e a desabilite os proxies (use <i>Editar Preferencias</i> no Netscape ou <i>Opções de Internet</i> no Explorer).</Text>
</th>
</tr>
<tr>
<th width="132"/>
<th width="151">
<Text id="138">O Coletor parece estar funcionando de maneira bastante lenta!</Text>
</th>
<th width="246">
<Text id="139">Você está utilizando o Netscape no ambiente Windows 2000? Se a resposta for sim, tente utilizar o Internet Explorer -  (somente) no Windows 2000 parece haver alguma incompatibilidade com o Netscape.</Text>
</th>
</tr>
<tr>
<th width="132">
<Text id="142">Biblioteca Web (Windows e Unix)</Text>
</th>
<th width="151">
<Text id="143">Quando eu inicio o Apache, ele imediatamente é finalizado.</Text>
</th>
<th width="246">
<Text id="144">Adicione uma diretiva <i>ServerName localhost</i> no arquivo de configuração do Apache (verifique a seção <CrossRef target="Section" ref="apache_web_server"/>).</Text>
</th>
</tr>
<tr>
<th width="132"/>
<th width="151">
<Text id="145">Quando eu direciono o meu navegador para a biblioteca digital, ele mostra um lixo -um arquivo binário.</Text>
</th>
<th width="246">
<Text id="146">Verifique a diretiva <i>ScriptAlias</i> no arquivo de configuração do Apache, certifique-se que ela está localizada antes da diretiva <i>Alias</i>  (verifique as Seções 4.2 e 4.3).</Text>
</th>
</tr>
<tr>
<th width="132"/>
<th width="151">
<Text id="147">Eu consigo acessar a página do Greenstone (Figure <CrossRef target="Figure" ref="your_greenstone_home_page"/>), mas o ícone da coleção Demo não aparece. </Text>
</th>
<th width="246">
<Text id="148">Execute o programa <i>library</i> (no diretório cgi-bin) a partir do prompt do DOS (ou do shell)  para gerar as informações necessárias para ajudar na localização do problema.  </Text>
</th>
</tr>
<tr>
<th width="132">
<Text id="149">Ambas as versões</Text>
</th>
<th width="151">
<Text id="150">Quando eu tento acessar a página da biblioteca digital no meu navegador, é exibida uma mensagem dizendo que a página não pode ser encontrada.</Text>
</th>
<th width="246">
<Text id="151">Tente utilizar o ip 127.0.0.1 em vez de <i>localhost</i>. Este número de IP reservado também pode ser utilizado para acessar seu computador local.</Text>
</th>
</tr>
<tr>
<th width="132"/>
<th width="151">
<Text id="152">Meu navegador exibe uma mensagem dizendo que não pode encontrar <i>main.cfg</i>.</Text>
</th>
<th width="246">
<Text id="153">Verifique se os arquivos do Greenstone existem e se têm permissão de serem lidos por qualquer usuário. Se você estiver utilizando a biblioteca Web, tente executar o programa <i>library</i> da linha de comando. Se funcionar, o problema é com as permissões do arquivo (verifique a Seção <CrossRef target="Section" ref="file_permissions"/>). Se não funcionar, a variável <i>gsdlhome</i> provavelmente está configurada de maneira errada no arquivo de configuração <i>gsdlsite.cfg</i>  (verifique a Seção <CrossRef target="Section" ref="gsdlsite_configuration_file"/>).</Text>
</th>
</tr>
<tr>
<th width="132"/>
<th width="151">
<Text id="154">Eu estou tendo problemas quando uso o Coletor.</Text>
</th>
<th width="246">
<Text id="155">Leia o <i>Guia de Usuário da Biblioteca Digital do Greenstone</i>, Seção <CrossRef external="User" lang="en" target="Chapter" ref="making_greenstone_collections"/>.</Text>
</th>
</tr>
<tr>
<th width="132"/>
<th width="151">
<Text id="156">Eu adicionei um novo usuário mas ele parece não conseguir acessar o sistema .</Text>
</th>
<th width="246">
<Text id="157">Verifique se o diretório <i>C:\Program Files\gsdl\etc</i> e todos os  seus arquivos têm permissão de escrita (see Section <CrossRef target="Section" ref="file_permissions"/>).</Text>
</th>
</tr>
</TableContent>
</Table>
</Content>
</Subsection>
</Content>
</Section>
<Section id="learn_more">
<Title>
<Text id="158">Para aprender mais</Text>
</Title>
<Content>
<Text id="159">Para aprender mais a respeito de detalhes da instalação do Greenstone, verifique o <i>Guia do Desenvolvedor da Biblioteca Digital Greenstone</i>.  Ele inclui (por exemplo) detalhes de estruturas de diretórios criados, e informação de como configurar o site do Greenstone.  </Text>
</Content>
</Section>
</Content>
</Chapter>
<Chapter id="greenstone_collections">
<Title>
<Text id="160">As Coleções do Greenstone</Text>
</Title>
<Content>
<Text id="161">Várias coleções de demonstração do Greenstone estão incluídas no CD-ROM. Se você tiver acesso a internet, poderá fazer o download de outras coleções,  pré-compiladas ou não, do website do Projeto da Bilioteca Digital da Nova Zelândia (<i>nzdl.org</i>). </Text>
<Text id="162">A coleção Demo do Greenstone é um pequeno subconjunto da Biblioteca de Desenvolvimento Humanitário (HDL), uma jóia de coleção. Esta coleção ilustra que relativamente ricas possibilidades de navegação podem ser acionadas (desde que haja metadados adequados disponíveis). Ela é incluida automaticamente quando o software é instalado.  </Text>
<Text id="163">O Greenstone também provê algumas coleções exemplo, bem documentadas, cuja página "sobre" descreve como foram construídas. Estas coleções demonstram várias capacidades do Greenstone. O programa de instalação perguntará se você quer incluí-las na sua instalação pessoal;  o espaço de disco aproximado requerido para cada coleção é mostrado abaixo.  </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">O Demo do Greenstone<br/>(7 Mb)</Text>
</th>
<th width="294">
<Text id="166">Um pequeno subconjunto da HDL. Se você criar uma segunda cópia desta coleção, os recursos completos somente aparecem se os seus novos arquivos fornecerem as informações apropriadas de metadados . </Text>
</th>
</tr>
<tr>
<th width="60">
<Text id="167"><i>dls-e</i></Text>
</th>
<th width="182">
<Text id="168">coleção Subconjunto da Biblioteca de Desenvolvimento<br/>(150 Mb)</Text>
</th>
<th width="294">
<Text id="169">Da mesma maneira que o Demo Greenstone, este é um subconjunto da HDL - porém bem maior. Ela contém 250 publicações —livros, relatórios e revistas— em várias áreas do desenvolvimento humano (a completa HDL contém 1,230 publicações). Ela têm a mesma estrutura que o Demo Greenstone. É um pouco complexa, e se você está iniciando o seu aprendizado com bibliotecas digitais, talvez seja interessante verificar outras coleções primeiro (como. <i> demonstrações MSWord e PDF</i>, the <i>Arquivos Greenstone </i>, ou a <i>Coleção de Imagens Simples</i>).</Text>
</th>
</tr>
<tr>
<th width="60">
<Text id="170"><i>wrdpdf-e</i></Text>
</th>
<th width="182">
<Text id="171">Demonstrações MSWord e PDF <br/>(4 Mb)</Text>
</th>
<th width="294">
<Text id="172">Aqui você encontrará alguns documentos em formatos PDF, MSWord, RTF, and Postscript, demonstrando a habilidade para construir coleções com documentos de tipos diferenciados. O arquivo de configuração da coleção é bem simples.  </Text>
</th>
</tr>
<tr>
<th width="60">
<Text id="173"><i>gsarch-e</i></Text>
</th>
<th width="182">
<Text id="174">A Coleção dos Arquivos Históricos do Greenstone <br/>(5 Mb)</Text>
</th>
<th width="294">
<Text id="175">Uma coleção de mensagens de email das listas históricas do Greesntone, que utiliza o plugin Email, dividindo arquivos em formatos de email. O arquivo de configuração da coleção é bem simples.  </Text>
</th>
</tr>
<tr>
<th width="60">
<Text id="176"><i>cltbib-e</i></Text>
</th>
<th width="182">
<Text id="177">Coleção Bibliográfica<br/>(7 Mb)</Text>
</th>
<th width="294">
<Text id="178">Com aproximadamente 4.000 entradas bibliográficas, esta coleção incorpora uma interface de busca baseada em formulário que permite a busca por campos. É bastante complexa. </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 pequena coleção de 10 entradas bibliográficas ilustram os recursos da "supercoleção" que permite a busca de várias coleções ao mesmo tempo. Ela trabalha junto com a coleção <i>Bibliografia</i>, e os seus arquivos de configuração são quase os mesmos.  </Text>
</th>
</tr>
<tr>
<th width="60">
<Text id="182"><i>MARC-e</i></Text>
</th>
<th width="182">
<Text id="183">exemplo com MARC<br/>(1 Mb)</Text>
</th>
<th width="294">
<Text id="184">Baseada em arquivos MARC  da Biblioteca do Congresso, esta coleção é simples (e não permite busca baseada em formulário).</Text>
</th>
</tr>
<tr>
<th width="60">
<Text id="185"><i>oai-e</i></Text>
</th>
<th width="182">
<Text id="186">A coleção Demo do OAI <br/>(18 Mb)</Text>
</th>
<th width="294">
<Text id="187">Utilizando o Protocolo Open Archive e a opção <i>Import-From</i>, ele recupera o histórico dos metadados, sendo possível utilizá-los para construir uma coleção com estes registros. Neste caso eles são imagens, portanto os plugins OAI e Image são utilizados.</Text>
</th>
</tr>
<tr>
<th width="60">
<Text id="188"><i>image-e</i></Text>
</th>
<th width="182">
<Text id="189">Coleção simples de imagens<br/>(1 Mb)</Text>
</th>
<th width="294">
<Text id="190">Esta coleção bem básica de imagens não contém texto nem metadados explícitos — o que a torna não muito realística. O arquivo de configuração é o mais simples que pode haver.</Text>
</th>
</tr>
<tr>
<th width="60">
<Text id="191"><i>authen-e</i></Text>
</th>
<th width="182">
<Text id="192">A formatação e autenticação da coleção demo<br/>(8 Mb)</Text>
</th>
<th width="294">
<Text id="193">Utilizando o mesmo material da coleção original Demo do Greenstone, duas características independentes podem ser mostradas: a formatação de documentos fora do padrão, e controle de acesso aos documentos utilizando a autenticação de usuário.  </Text>
</th>
</tr>
<tr>
<th width="60">
<Text id="194"><i>garish</i></Text>
</th>
<th width="182">
<Text id="195">Versão Garish da coleção demo <br/>(8 Mb)</Text>
</th>
<th width="294">
<Text id="196">Esta coleção também contém o mesmo material do demo Greenstone. A sua aparência foi alterada para demonstrar como as páginas geradas podem ser configuradas de modo diferente. Ele se baseia na utilização de um arquivo macro sem um padrão definido que é fornecido pelo Greenstone.  </Text>
</th>
</tr>
<tr>
<th width="60">
<Text id="197"><i>isis-e</i></Text>
</th>
<th width="182">
<Text id="198">exemplo CDS/ISIS  (1 Mb)</Text>
</th>
<th width="294">
<Text id="199">Esta coleção é construída a partir de um banco de dados CDS/ISIS com aproximadamente 150 entradas bibliográficas. Utiliza o plugin ISISPlug, que lê os arquivos de padrão ISIS .mst e .fdt e os converte para os metadados do Greenstone.</Text>
</th>
</tr>
</TableContent>
</Table>
</Content>
</Chapter>
<Chapter id="setting_up_webserver">
<Title>
<Text id="200">Configurando o Servidor Web  </Text>
</Title>
<Content>
<Text id="201">Nesta seção é descrito como configurar o seu servidor web para trabalhar com o Greenstone. Note que isto não é necessário quando a Biblioteca Local do Windows é utilizada, pois o software funciona “fora da caixa” e não necessariamente requer um servidor web.  </Text>
<Text id="202">Nós explicaremos sobre ambos o servidor web Apache, que está gratuitamente disponível em software livre nas plataformas Windows e Unix ( verifique o Apêndice  <CrossRef target="Chapter" ref="appendix_associated_software"/> para detalhes), o Microsoft Personal Web Server (PWS) e o servidor Internet Information Services (IIS). O PWS é o servidor Microsoft padrão para Windows 95/98; o IIS é o servidor padrão para o Windows 2000 e Windows XP ; o Windows NT pode utilizar ambos. A descrição do Apache se aplica igualmente  para a Biblioteca Web das versões Windows e Unix  (embora seja mostrado aqui com as variáveis e terminologias do ambiente Windows);  a seção PWS/IIS se aplica somente para a Biblioteca Web do Windows. </Text>
<Text id="203">Uma vez instalado o servidor web, o próximo passo é a instalação do Greenstone. Assumiremos que durante o processo de instalação você realizou a ação default em todas as etapas, clicando no botão <i>próximo</i>. O resultado é a criação do diretório <i>C:\Program Files\gsdl</i> com o armazenamento dos arquivos binários, além de alguns arquivos de suporte.  </Text>
<Text id="204">Todos os servidores web utilizam a URL especial “localhost” para denotar o computador em que o servidor web está sendo executado. Portanto, quando você instala um servidor web, você pode verificar seus documentos html digitando a URL <i>http://localhost</i> no seu navegador, após a sua instalação. Se o seu computador tem um domínio configurado, ele é utilizado para identificação do computador e sites remotos em vez do localhost. Então no computador da Biblioteca Digital da Nova Zelândia, <i>http://nzdl.org</i> e <i>http://localhost</i> são equivalentes. Se você digitar <i>http://nzdl.org</i> no seu computador você acessará o servidor web da Biblioteca Digital da Nova Zelândia, enquanto se você digitar <i>http://localhost</i> lhe direcionará ao  servidor web de seu computador. </Text>
<Section id="apache_web_server">
<Title>
<Text id="205">O Servidor Web Apache</Text>
</Title>
<Content>
<Text id="206">O servidor web Apache é normalmente instalado em <i>C:\Program Files\Apache Group\Apache</i> e é configurado para ter o diretório cgi-bin no subdiretório <i>\cgi-bin</i> e o documento root no subdiretório <i>\htdocs</i>. É possível reconfigurá-lo através da edição do arquivo de configuração <i>C:\Program Files\Apache Group\Apache\conf\httpd.conf</i>. É um arquivo texto: é fácil de ler e verificar como as coisas estão configuradas.  </Text>
<Text id="207">Dependendo de como o software de rede de seu computador esteja configurado, você pode precisar adicionar esta linha ao arquivo <i>httpd.conf</i>  do Apache:</Text>
<CodeLine>ServerName localhost</CodeLine>
<Text id="208">Se esta linha não está incluída, o sistema tentará encontrar o nome do seu servidor. Entretanto esta ação pode não ser executada devido a bugs em versões do windows. Neste caso, o Apache finalizará automaticamente quando iniciado. Uma mensagem de erro será exibida, porém apagada imediatamente, e você provavelmente não conseguirá lê-la. </Text>
<Subsection id="setting_up_cgi-bin_directory">
<Title>
<Text id="209">Configurando o diretório cgi-bin do Greenstone</Text>
</Title>
<Content>
<Text id="210">O diretório cgi-bin é considerado pelo servidor web como um diretório de programas executáveis. A diretiva <i>ScriptAlias</i> do Apache é utilizada para criar um diretório cgi-bin. Note que esta diretiva pode tornar qualquer diretório um diretório cgi-bin executável - não é necessário ter o nome “cgi-bin”! Da mesma maneira um diretório nomeado “cgi-bin” não é especial até que a diretiva <i>ScriptAlias</i> seja aplicada a ele.</Text>
<Text id="211">Quando instalado, o Apache tem um diretório cgi-bin <i>C:\Program Files\Apache Group\Apache\cgi-bin</i>. Isso significa que se a URL <i>http://localhost/cgi-bin/hello</i> for digitada, o servidor web irá tentar executar um arquivo chamado <i>hello</i> localizado dentro do diretório mencionado acima. </Text>
<Text id="212">Há um programa Greenstone chamado “library.exe” que precisa ser executado pelo servidor web; ele  por sua vez lê um arquivo chamado configuração do site Greenstone, “gsdlsite.cfg”, que precisa estar localizado no mesmo diretório. </Text>
<Text id="213">A melhor maneira de configurar isso é utilizar a diretiva Apache <i>ScriptAlias</i> para criar um novo diretório cgi-bin. É mostrado a seguir a parte do arquivo de configuração <i>httpd.conf</i> do Apache que adiciona <i>C:\Program Files\gsdl\cgi-bin</i> como um diretório cgi-bin adicional:</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">(É um fato curioso que os arquivos de configuração do Apache utilizam a barra (/) ao invés da barra invertida (\) que é o padrão do ambiente Windows.)</Text>
<Text id="215">Isso significa que qualquer URL da forma <i>http://localhost/gsdl/cgi-bin</i>...  será buscada no diretório <i>C:\Program Files\gsdl\cgi-bin</i>, e executada pelo servidor web. Se for apresentada com a URL <i>http://localhost/gsdl/cgi-bin/hello</i> por exemplo, o servidor web tentará recuperar o arquivo <i>C:\Program Files\gsdl\cgi-bin\hello</i> e executá-lo. Entretanto a URL <i>http://localhost/cgi-bin/hello</i> procura no diretório regular <i>cgi-bin</i> do Apache pelo arquivo <i>C:\Program Files\Apache Group\Apache\</i> <i>cgi-bin\hello</i> e o executa, da mesma forma que ele fez anteriormente.  </Text>
</Content>
</Subsection>
<Subsection id="document_root_directory">
<Title>
<Text id="216">O documento diretório raiz</Text>
</Title>
<Content>
<Text id="217">O documento diretório root é a raiz da estrutura de diretórios do seu servidor web. Quando instalado, o Apache tem um documento raiz  <i>of C:\Program Files\Apache Group\Apache\htdocs</i>. Isso significa que quando apresentado com a URL <i>http://localhost/hello.html</i>, o servidor web tentará recuperar um arquivo chamado <i>hello.html</i> do diretório mencionado. </Text>
<Text id="218">Vários arquivos do Greenstone têm que ser lidos pelo servidor web. O modo mais fácil de fazer esta tarefa é utilizar a diretiva <i>Alias</i>, que é semelhante ao <i>ScriptAlias</i>, exceto pelo fato de que se aplica a páginas web simples, e não a scripts cgi. Adicione estas linhas no arquivo de configuração do Apache, depois da diretiva <i>ScriptAlias</i>, para ter o diretório <i>C:\Program Files\gsdl</i> como um local adicional para a procura de 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">Isto significa que quaisquer URLs, que têm o formato procurado pelo primeiro argumento do Alias (gsdl), são encontradas como arquivos no lugar correspondente ao segundo argumento. Em outras palavras, URLs da forma <i>http://localhost/gsdl/</i>... serão buscadas como arquivos no diretório <i>C:\Program Files\gsdl</i>. Por exemplo, se for apresentada a URL <i>http://localhost/gsdl/hello.html</i>, o servidor web tentará recuperar o arquivo <i>C:\Program Files\gsdl\hello.html</i>. Entretanto, a URL <i>http://localhost/hello.html</i> procura no diretório regular <i>htdocs</i> pelo arquivo <i>C:\Program Files\Apache Group\Apache\htdocs\hello.html</i>, exatamente como antes.</Text>
<Text id="220">Assegure-se de adicionar a diretiva <i>Alias</i> depois da diretiva <i>ScriptAlias</i>. Se você direcionar o Apache para o alias <i>/gsdl</i> antes de <i>/gsdl/cgi-bin</i> você terá a URL <i>/gsdl/cgi-bin/library</i> utilizando a diretiva Alias ao invés do ScriptAlias, o que seria interpretado como uma requisição de um documento, em vez do resultado da execução de um programa. A saída seria “visualizar” o arquivo do programa binário como uma página do navegador Web, em vez de executá-lo.</Text>
</Content>
</Subsection>
<Subsection id="security">
<Title>
<Text id="221">Segurança</Text>
</Title>
<Content>
<Text id="222">Você deveria estar a par de que caso a versão da biblioteca web do Greenstone esteja configurada seguindo as instruções acima, qualquer pessoa terá permissão para realizar o download de arquivos no diretório <i>gsdl</i>. Isso inclui os arquivos de índices e arquivos fontes de qualquer coleção que você crie, banco de dados, logs de utilização, etc. </Text>
<Text id="223">Se isso é um problema para você, modifique a configuração do seu web server para melhorar a segurança. Para o servidor Apache, utilize as seguintes linhas  no arquivo de configuração ao invés daquelas listadas na seção anterior:  </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</CodeLine>
<CodeLine>"\.(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">Isto significa que somente os arquivos cujas extensões tiverem o mesmo critério da expressão regular na linha <i>FilesMatch</i> poderão ser baixados.</Text>
</Content>
</Subsection>
</Content>
</Section>
<Section id="pws_and_iis_webservers">
<Title>
<Text id="225">Os Web servers PWS e IIS</Text>
</Title>
<Content>
<Text id="226">Embora nem o PWS ou o IIS sejam instalados por default em atuais ambientes Windows, é possível instalá-los com facilidade através do painel de controle, utilizando a opção  “Add/Remove programs”. Se eles ainda não estiverem no seu CD-ROM da distribuição Windows, você terá que baixá-los no site web da Microsoft (<i>www.microsoft.com</i>).</Text>
<Text id="227">O procedimento de configuração do Greenstone é idêntico para o PWS e IIS. Execute o Personal Web Manager, realizando as seguintes ações. </Text>
<NumberedList>
<NumberedItem>
<Text id="228">Selecione <i>Avançado</i> para obter a tela <i>Opções Avançadas</i>.</Text>
</NumberedItem>
<NumberedItem>
<Text id="229">Selecione <i>Home</i> e cllique em <i>Adicionar</i>. Preencha os campos como é mostrado a seguir:</Text>                           
<Text id="230">Campo <i>Directory</i> :          <i>C:\Program Files\gsdl</i></Text>
<Text id="231">Campo <i>Alias</i>:               <i>gsdl</i></Text>
<Text id="232">Permissões de Acesso:              <i>Ler</i></Text>
<Text id="233">Permissões de Aplicação:         <i>Nenhuma</i></Text>
<Text id="234">Clique <i>OK</i></Text>
<Text id="235">Isto tornará os arquivos do Greenstone acessíveis ao servidor web. </Text>
</NumberedItem>
<NumberedItem>
<Text id="236">Retorne a opção <i>Opções Avançadas</i>, selecione <i>gsdl</i> e clique <i>Adicionar</i>. Preencha os campos como é mostrado a seguir:</Text>
<Text id="237">Campo <i>Diretório</i>:           <i>C:\Program Files\gsdl\cgi-bin</i></Text>
<Text id="238">Campo <i>Alias</i> :               <i>cgi-bin</i></Text>
<Text id="239">Permissões de Acesso:               <i>Nenhuma</i></Text>
<Text id="240">Permissões da Aplicação:          <i>Executar</i></Text>
<Text id="241">Clique em <i>OK</i></Text>
<Text id="242">Isto permite que o programa  <i>library.exe</i> do Greenstone seja executado pelo servidor web. </Text>
</NumberedItem>
<NumberedItem>
<Text id="243">Ir para a URL <i>http://localhost/gsdl/cgi-bin/library.exe</i></Text>
<Text id="244">Nota: você precisa especificar a extensão <i>.exe</i> com o  PWS e IIS.</Text>
</NumberedItem>
</NumberedList>
</Content>
</Section>
</Content>
</Chapter>
<Chapter id="configuring_your_site">
<Title>
<Text id="245">Configurando o seu Site</Text>
</Title>
<Content>
<Text id="246">Para o Greenstone funcionar adequadamente, as permissões de acesso para certos arquivos devem ser configuradas de modo apropriado. Além disso, há um arquivo de configuração associado a cada site do Greenstone. O procedimento de instalação cria uma configuração genérica baseada nas suas opções de instalação; entretanto o seu conteúdo pode ser adaptado a diferentes situações. Esta seção explica estas duas questões. </Text>
<Section id="file_permissions">
<Title>
<Text id="247">As Permissões de Arquivos</Text>
</Title>
<Content>
<Text id="248">Esta seção é irrelevante para Windows 95/98, pois estes sistemas não identificam os donos de arquivos. </Text>
<Text id="249">Nos ambientes Windows NT, 2000 e Unix,  os scripts cgi não são executados como usuários normais, pois os usuários não podem ser identificados na Web. Ao invés disso, eles utilizam o usuário que iniciou o servidor web (nos sistemas Windows), ou um usuário especial (geralmente chamado de  <i>nobody</i> ou <i>ninguém</i> em ambientes Unix). Por isso todos os arquivos e diretórios em <i>C:\Program Files\gsdl</i> precisam ter permissão de leitura (ou talvez ao menos o usuário do script-cgi, chamado de “<i>ninguém</i>”, deve ter esta permissão) .  Para testar se as permissões dos arquivos foram configuradas de forma correta, execute o programa <i>library.exe</i> da linha de comando. Se os arquivos estão localizados corretamente, porém com as permissões configuradas erroneamente, ele conseguirá executar da linha de comando - isto é, quando <i>você</i> executá-lo -porém não de um navegador. Um outro teste possível é realizar o login como outro usuário para verificar se as permissões de arquivo são específicas para o seu usuário original. </Text>
<Text id="250">Para trabalhar com um navegador web, todos os diretórios do Greenstone devem ter permissão de leitura. Além disso, o diretório <i>C:\Program Files\gsdl\etc</i> e todo o seu conteúdo devem ter permissão de <i>escrita</i>. Este é o diretório no qual o programa da biblioteca escreve o log de utilização, erro e inicialização, além de vários bancos de dados de usuários. Se você tem dúvidas em ter este diretório com permissão de escrita, você pode configurá-lo para que somente os arquivos <i>errout.txt</i>, <i>initout.txt</i>, <i>key.db</i>, <i>users.db</i>, <i>history.db</i> e <i>usage.txt</i> tenham permissão de escrita pelo usuário cgi.</Text>
<Text id="251">Se as permissões dos arquivos não estiverem configuradas de maneira correta para <i>C:\Program Files\gsdl\etc</i>, provavelmente você terá problemas com a autenticação de usuários e a busca no histórico, além da falta de geração do log de utilização (<i>usage.txt</i>).</Text>
</Content>
</Section>
<Section id="gsdlsite_configuration_file">
<Title>
<Text id="252">A configuração do arquivo gsdlsite.cfg</Text>
</Title>
<Content>
<Text id="253">O procedimento de instalação cria um arquivo de configuração genérico do Greenstone baseado nas escolhas de sua instalação. Em nossa instalação o arquivo é <i>C:\Program Files\gsdl\cgi-bin\gsdlsite.cfg</i> e o conteúdo está listado a seguir:</Text>
<CodeLine># Site configuration file for 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 images 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">Você poderá costumizar a sua instalação editando este arquivo, embora provavelmente você não precisará fazer isso.</Text>
<Text id="255">A linha <i>gsdlhome</i> simplesmente direciona para o diretório <i>C:\Program Files\gsdl</i>.</Text>
<Text id="256"><i>httpprefix</i> é o endereço web do diretório em que o Greenstone está instalado. Nós explicamos anteriormente como criar um alias para que URLs  da forma <i>http://localhost/gsdl/</i>... sejam buscadas no diretório <i>C:\Program Files\gsdl</i>. A inserção da linha <i>httpprefix/gsdl</i> no arquivo de configuração <i>gsdlsite</i> estabelece a mesma convenção para o Greenstone. </Text>
<Text id="257"><i>httpimg</i> é o endereço web do diretório <i>C:\Program Files\gsdl\images</i>; ele contem todas as imagens gif utilizadas na interface. Em qualquer instalação padrão do Greenstone este diretório sempre será <i>httpprefix/images</i>, e a linha no arquivo acima geralmente não é modificada. </Text>
<Text id="258"><i>gwcgi</i> é o endereço web do programa cgi da biblioteca.  Ele não é requerido pela maioria dos servidores web (incluindo o Apache), e deveria  continuar comentado. Não retire o comentário ao menos que você tenha certeza da necessidade de fazê-lo, pois isto pode causar problemas. </Text>
<Text id="259"><i>maxrequests</i> somente é utilizado por versões do Greenstone compiladas com a opção “fast-cgi”. A versão de distribuição binária não inclui esta opção porque nem todos os servidores web estão configurados para suportá-la. Fastcgi aumenta a velocidade de execução dos programas cgi mantendo-os na memória entre as chamadas do software, ao invés de carregá-lo do disco cada vez que uma página é requisitada pelo Greenstone. Porém a quantidade de memória utilizada pode aumentar, quanto maior o tempo que o programa estiver na memória. Uma vez que o número máximo de requisições de páginas <i>maxrequests</i> forem geradas, o programa cgi é finalizado, liberando a memória acumulada. Para responder à próxima requisição por uma página Web, o programa cgi é lido do disco novamente, e um novo ciclo de requisições de páginas é iniciado. A maioria das instalações utilizam o protocolo padrão cgi, o que significa que o número máximo de requisições de páginas <i>maxrequests</i> pode ser ignorado de maneira segura.</Text>
</Content>
</Section>
</Content>
</Chapter>
<Chapter id="personalizing">
<Title>
<Text id="260">Personalizando sua Instalação</Text>
</Title>
<Content>
<Text id="261">Provavelmente a primeira coisa que você vai querer fazer uma vez com o Greenstone instalado e rodando, será a personalizar a home page. O arquivo que gera a home page do Greenstone é chamado de <i>home.dm</i>, e está localizado no subdiretório <i>macros</i> no qual você instalou o Greenstone. (O caminho padrão em ambientes Windows é <i>C:\Program Files\gsdl</i>.) Este arquivo é um arquivo texto que você precisará editar para criar uma nova home page. Ao invés de editá-lo, recomendamos que você crie um novo arquivo, digamos <i>yourhome.dm</i>. Ele será parecido com o arquivo <i>home.dm</i> porém utilizará o “package home” - que é quem faz o trabalho atual - de maneira diferente. </Text>
<Text id="262">Quando você faz uma home page diferente, deve haver algum modo de linká-la para as páginas da biblioteca digital, para que seja possível realizar a busca e navegação nas coleções de seu sistema. A solução adotada pelo Greenstone é a utilização de “macros”. Esta é a razão pela qual o arquivo da home page tem a extensão “.dm” e  não “.html”— é um arquivo “macro” ao invés de um arquivo regular html. Mas não quail: este arquivo macro contém apenas html, com alguns detalhes específicos citados abaixo. A linguagem macro contém vários recursos poderosos, e somente uma pequena parte deles é listada abaixo—verifique o <i>Guia do Desenvolvedor da Biblioteca Digital Greenstone</i> para mais informações.</Text>
<Section id="example">
<Title>
<Text id="263">Exemplo</Text>
</Title>
<Content>
<Figure id="your_own_greenstone_home_page">
<Title>
<Text id="264">A sua própria página do Greenstone </Text>
</Title>
<File width="395" height="227" url="images/Install_Fig_3.png"/>
</Figure>
<Text id="265">A figura <CrossRef target="Figure" ref="your_own_greenstone_home_page"/> mostra o exemplo de uma nova home page para a biblioteca digital. Cada um dos links “Click here” lhe direcionará para um recurso do Greenstone. Esta página foi gerada pelo arquivo chamado <i>yourhome.dm</i> mostrado na figura  <CrossRef target="Figure" ref="yourhome_dm"/>.</Text>
<Figure id="yourhome_dm">
<Title>
<Text id="266"><i>yourhome.dm</i> foi utilizado para criar a figura <CrossRef target="Figure" ref="your_own_greenstone_home_page"/></Text>
</Title>
<CodeLine>package home</CodeLine>
<CodeLine>_content_ {</CodeLine>
<CodeLine>&lt;h2&gt;Your own Greenstone home page&lt;/h2&gt;</CodeLine>
<CodeLine>&lt;ul&gt;</CodeLine>
<CodeLine>&lt;table&gt;</CodeLine>
<CodeLine>&lt;tr valign=top&gt;&lt;td&gt;Search page for the demo collection&lt;br&gt;&lt;/td&gt;</CodeLine>
<CodeLine>      &lt;td&gt;&lt;a href="_httpquery_&amp;c=demo"&gt;Click here&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;</CodeLine>
<CodeLine>&lt;tr&gt;&lt;td&gt;"About" page for the demo collection&lt;/td&gt;</CodeLine>
<CodeLine>      &lt;td&gt;&lt;a href="_httppageabout_&amp;c=demo"&gt;Click here&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;</CodeLine>
<CodeLine>&lt;tr&gt;&lt;td&gt;Preferences page for the demo collection&lt;/td&gt;</CodeLine>
<CodeLine>      &lt;td&gt;&lt;a href="_httppagepref_&amp;c=demo"&gt;Click here&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;</CodeLine>
<CodeLine>&lt;tr&gt;&lt;td&gt;Home page&lt;/td&gt;</CodeLine>
<CodeLine>      &lt;td&gt;&lt;a href="_httppagehome_"&gt;Click here&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;</CodeLine>
<CodeLine>&lt;tr&gt;&lt;td&gt;Help page&lt;/td&gt;</CodeLine>
<CodeLine>      &lt;td&gt;&lt;a href="_httppagehelp_"&gt;Click here&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;</CodeLine>
<CodeLine>&lt;tr&gt;&lt;td&gt;Administration page&lt;/td&gt;</CodeLine>
<CodeLine>      &lt;td&gt;&lt;a href="_httppagestatus_"&gt;Click here&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;</CodeLine>
<CodeLine>&lt;tr&gt;&lt;td&gt;The Collector&lt;/td&gt;</CodeLine>
<CodeLine>      &lt;td&gt;&lt;a href="_httppagecollector_"&gt;Click here&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</CodeLine>
<CodeLine># page, uncomment these lines:</CodeLine>
<CodeLine># _header_ {</CodeLine>
<CodeLine># }</CodeLine>
</Figure>
<Text id="267">Você pode utilizar a figura  <CrossRef target="Figure" ref="yourhome_dm"/> como um template para criar sua própria página especializada Greenstone. Basicamente, ela define uma macro chamada <i>content</i>. Dentro das chaves é html normal.  É possível inserir textos adicionais, junto com quaisquer comandos de formatação html, para colocar o conteúdo que você quer ver na página. O texto é em html normal; caso queira, é possível incluir hyperlinks, e utilizar todos os recursos incluídos na linguagem html.</Text>
<Text id="268">Para fazer o seu link da nova home page em páginas de outras bibliotecas digitais, você precisa uitlizar as palavras mágicas apropriadas. Na linguagem macro, palavras mágicas são palavras cercadas por traço inferior (_), underscore. É possível ver isso na figura <CrossRef target="Figure" ref="yourhome_dm"/>. Por exemplo, <i>_httppagehome_</i> lhe direcionará para a home page, <i>_httppagehelp_</i> para a página de ajuda, e assim por diante. Em alguns casos será necessária a inclusão do nome da coleção. Por exemplo, <i>_httpquery_&amp;c=demo</i> especifica a página de busca para a coleção demo; para outras coleções é necessário substituir <i>demo</i> pelo nome de coleção adequado.</Text>
<Text id="269">A definição da macro <i>_content_</i> é puro html. Qualquer código padrão html pode ser substituído dentro de uma definição da macro. Entretanto, os caracteres especiais  '{', '}', '\', e '_'  devem ser utilizados juntos com a barra invertida para prevení-los de serem processados pelo interpretador da linguagem macro. </Text>
<Text id="270">Note que a definição da macro <i>_content_</i> não contém nenhum cabeçalho ou rodapé html. Se você deseja modificar o cabeçalho ou o rodapé de sua página, você deveria definir as macros <i>_header_</i> para cabeçalho e/ou <i>_footer_</i> para rodapé, adicionando-as ao arquivo <i>yourhome.dm</i> no formulário</Text>
<CodeLine>_macroname_ {</CodeLine>
<CodeLine>...</CodeLine>
<CodeLine>}</CodeLine>
<Text id="271">Por exemplo, a barra verde do lado esquerdo, abaixo nas páginas do Greenstone é definida pela macro do cabeçalho <i>_header_</i>, e quando ela tem o valor null, ela será removida, como indicado no final da figura <CrossRef target="Figure" ref="yourhome_dm"/>.</Text>
</Content>
</Section>
<Section id="how_to_make_it_work">
<Title>
<Text id="272">Como fazer as coisas funcionarem</Text>
</Title>
<Content>
<Text id="273">Você terá que contar para o Greenstone sobre sua nova home page <i>yourhome.dm</i>. O sistema lê os arquivos macro que estão especificados no arquivo de configuração central <i>main.cfg</i>, então caso você crie algum arquivo novo, você deve incluí-lo no arquivo central. A ordem nos nomes faz diferença: as definições mais recentes têm precedência. </Text>
<Text id="274">Assim, para fazer o software da biblioteca digital do Greenstone utilizar a home page na figura <CrossRef target="Figure" ref="your_own_greenstone_home_page"/> ao invés da padrão, primeiro coloque o arquivo <i>yourhome.dm</i> na figura <CrossRef target="Figure" ref="yourhome_dm"/> no diretório <i>macros</i>. Então edite o arquivo de configuração <i>main.cfg</i> para substituir  o <i>home.dm</i> com <i>yourhome.dm</i> na lista de arquivos macro que são carregadas na inicialização. </Text>
</Content>
</Section>
<Section id="redirecting_a_url_to_greenstone">
<Title>
<Text id="275">Redirecionando a URL para o Greenstone</Text>
</Title>
<Content>
<Text id="276">Você poderá querer redirecionar uma URL mais conveniente para o seu programa Greenstone cgi. Por exemplo, no seu sistema a URL <i>http://nzdl.org</i> (que é um atalho para <i>http://nzdl.org/index.html)</i> é redirecionada para <i>http://nzdl.org/cgi-bin/library</i>. O servidor web Apache webserver realiza isso com a diretiva <i>Redirect</i>.  Junto com outras diretivas,  ela se encontra no arquivo de configuração <i>C:\Program Files\Apache Group\Apache\conf\httpd.conf</i>. Para redirecionar a URL <i>http://www.seuservidor.com</i> para <i>http://www.seuservidor.com/cgi-bin/library</i>, adicione a seguinte linha em <i>httpd.conf</i>:  </Text>
<CodeLine>Redirect /index.html http://www.yourserver.com/cgi-bin/library</CodeLine>
<Text id="277">Então você vai acessar o seu sistema da biblioteca digital diretamente a partir da URL <i>http://www.seuservidor.com</i>. Se ao invés disso, você quiser que uma URL como <i>http://www.seuservidor.com/greenstone</i> seja direcionada para <i>http://www.seuservidor/cgi-bin/library</i>, inclua aí o arquivo <i>httpd.conf</i> </Text>
<CodeLine>Redirect /greenstone http://www.yourserver.com/cgi-bin/library</CodeLine>
<Text id="278">Se o seu computador não tem um nome de domínio (como o exemplo “www.seuservidor.com” acima),  simplesmente substitua <i>www.seuservidor.com</i> por <i>localhost</i> nas linhas acima. Desde que o seu navegador esteja sendo executado na mesma máquina que o servidor web - o que certamente acontece se o seu computador não têm um nome de domínio - isso tem o mesmo efeito que os redirecionamentos acima. </Text>
<Text id="279">Ao invés de inserir  redirecionamentos adicionais de diretivas no arquivo <i>httpd.conf</i>, você pode igualmente colocá-los no arquivo <i>.htaccess</i> dentro do seu diretório raiz de documentos do seu servidor. Na realidade, fazer isso tem duas vantagens. Primeiro, as mudanças em <i>.htaccess</i> têm um efeito imediato, quando o tiver que iniciar novamente o servidor Apache para verificar as mudanças em <i>httpd.conf</i>. Em segundo lugar, em ambientes Unix você geralmente tem que estar logado como usuário "root" para editar o arquivo <i>httpd.conf</i>, considerando que você não edite o arquivo <i>.htaccess</i>.</Text>
</Content>
</Section>
</Content>
</Chapter>
<Chapter id="appendix_associated_software">
<Title>
<Text id="280">Apêndice dos Softwares Associados </Text>
</Title>
<Content>
<Text id="281">Aqui explicamos como obter os pacotes de software mencionados acima. </Text>
<Section id="apache_webserver">
<Title>
<Text id="282">Servidor Web Apache </Text>
</Title>
<Content>
<Text id="283">Para executar qualquer versão do Greenstone separada da versão da Biblioteca Local do Windows, você precisa de um servidor web externo. Várias aplicações, particularmente as maiores, já terão provavelmente um servidor web. Se você estiver utilizando Linux, o Apache pode estar no seu disco de instalação, porém não foi selecionado durante o processo de instalação. O servidor web Apache do site <i>www.apache.org</i> é software livre, e fácil de ser instalado. </Text>
</Content>
</Section>
<Section id="perl">
<Title>
<Text id="284">Perl</Text>
</Title>
<Content>
<Text id="285">O Greenstone utiliza a linguagem Perl quando está construindo as coleções. No ambiente Windows, o Perl é incluído automaticamente com os pacotes do Greenstone. A maioria dos sistemas Unix já tem o Perl instalado, porém caso ele não esteja presente, o código fonte e arquivos binários de uma grande parte de plataformas Unix está presente em <i>www.perl.com</i>. É necessário ao menos a versão Perl 5.0 ou qualquer versão acima desta.</Text>
</Content>
</Section>
<Section id="gcc">
<Title>
<Text id="286">GCC</Text>
</Title>
<Content>
<Text id="287">A versão Unix do Greenstone  pode ser executada com o compilador Gnu C++ , o GCC. O Greenstone faz bastante uso da bilioteca padrão do  C++ (nós descobrimos que ela foi descontinuada em algumas versões antigas do GCC; por favor nos comunique se você tiver problemas de STL). Note que esta versão do Greenstone não compila com o GCC 3.0.</Text>
</Content>
</Section>
<Section id="gdbm">
<Title>
<Text id="288">GDBM</Text>
</Title>
<Content>
<Text id="289">Todas as versões do Greenstone utilizam o Gnu Database Manager, GDBM. Ele é utilizado com todas as versões Windows do Greenstone e instalado automaticamente durante o processo de instalação. Os sistemas Linux já têm o GDBM, então nós não o provemos para este sistema. A maioria dos sistemas Unix já o tem, porém caso seja necessário, é possível baixá-lo/realizar o download em <i>www.gnu.org</i>.</Text>
</Content>
</Section>
<Section id="java_runtime_environment">
<Title>
<Text id="290">Java runtime environment</Text>
</Title>
<Content>
<Text id="291">Para usar a Interface de Biblioteca do Greenstone, você terá ter uma versão do Java Runtime Environment. Se você ainda não o tem instalado,  ou alguma versão no CD-ROM, você pode baixar/realizar o download da última versão em <u>http://java.sun.com/j2se/downloads.html</u>. É necessária a versão 1.4.0 ou posterior.</Text>
</Content>
</Section>
<Section id="java_compiler">
<Title>
<Text id="292">O compilador Java </Text>
</Title>
<Content>
<Text id="293">Para compilar o código fonte da Interface de Biblioteca do Greenstone, você precisa primeiro instalar o Java Development Kit. É possível baixar o J2SE Software Development Kit de  <u>http://java.sun.com/j2se/downloads.html</u>. É necessária a versão 1.4.0 ou superior.</Text>
</Content>
</Section>
</Content>
</Chapter>
</Manual>