1. Instalao
----------------------------------------------------
Se voc est acostumado com Perl, aqui esto algumas instrues que voc
precisa para ter o script rodando rapidamente. 

1. Descomprima (Unzip) o arquivo de distribuio e voc dever ver alguns arquivos e 
   um diretrio. Envie tudo para um diretrio em seu servidor que possa rodar cgi, mas 
   envie tudo em modo ASCII. Eu recomendo que voc envie para um diretrio chamado busca
   dentro do seu cgi-bin. Voc ter uma estrutura como:

          /cgi-bin/busca        - CGI dos usurios, como busca.cgi, adicionar.cgi, etc.
          /cgi-bin/busca/admin  - Todos os programas de administrao.
                
    Tenha certeza de que todos os arquivos so transferidos em modo ASCII!!
    
2. Cheque que todos os arquivos .cgi tem o caminho para o Perl correto. O padro do sistema 
        #!/usr/local/bin/perl
  
   Se ele estiver incorreto, voc ter que editar a primeira linha de todos os 
   arquivos .cgi, e alter-los para onde voc tem o Perl 5 instalado.

3. Defina as permissess:
     chmod 755 (-rwxr-xr-x) em todos os arquivos .cgi.
     chmod 666 (-rw-rw-rw-) em todos os arquivos no diretrio data.
     chmod 666 (-rw-rw-rw-) em todos os arquivos no diretrio templates
     chmod 777 (drwxrwxrwx) no diretrio hits
     chmod 777 (drwxrwxrwx) no diretrio ratings
     chmod 777 (drwxrwxrwx) no diretrio onde as pginas do sistema de busca devero ser criadas.

4. Edite o arquivo links.cfg e configure todas as variveis descritas l.
    
5. ** Protega o seu diretrio admin com senha. Nunca deixe o seu diretrio admin desprotegido
   em um site pblico, o seu sistema inteiro poder ser deletado!!
   
6. Faa um teste! V em http://seusite.com.br/cgi-bin/busca/admin/admin.cgi ou qualquer
   outro onde voc colocou o admin.cgi, e voc dever ver a tela de administrao.
   Tente (nesta ordem):
   
        1. Adicionar uma categoria.
        2. Adicionar um link naquela categoria.
        3. Construir pginas.
        4. Procurar pelo link, usando as novas pginas criadas.
        5. Adicionar um link pelas novas pginas criadas.
        6. Validar um link do admin.
    
    Se tudo der certo, voc deve ter configurado corretamente o sistema!

  Se voc tiver algum problema, pode nos contatar pelo email 
webmaster@brasildesigner.com
  
4. Como Criar Categorias:
Para criar categorias  o seguinte:

Nome: Educacao/Escolas/Bahia <- as barras "/" so importantes nesta direo
no use espaos e nem acentuao e por fim...

Nonenglish: Educao\Escolas\Bahia <- as barras "\" nesta posio, pode usar 
os espaes e acentuaes


5. Problemas
====================================================
* Erro 500 do Servidor.
Aqui esto as possibilidades de estarem causando o erro 500. Se voc receber um  cheque o seguinte:

   - Voc enviou os arquivos em modo ASCII?
   - O caminho para o Perl est correto? (#!/usr/bin/perl)
   - O caminho do Perl  para a verso do perl5?
   - H algum erro de sintaxe que voc fez editando links.cfg?
   - Voc definiu as permisses corretamente?
   
Erros 500 do servidor so 99% das vezes causados por motivos como: Arquivo enviado
em modo BINARY, ou caminho para o Perl ou est errado ou e para verses anteriores  Perl 5.

* Erro Fatal: (Maybe you didn't strip carriage returns after a network transfer?)
Voc enviou algo em modo BINARY! Tenha certeza de que voc enviou TODOS os arquivos em 
modod ASCII. No confie nos modo AUTO-DETECT do programas, ao invs trasnfira
tudo em ASCII.

* Erro Fatal: unrecognized token my( ...
Voc tem o caminho do Perl apontado para a verso 4. Corrija e coloque tudo para o Perl 5.

Boa Sorte!

Vinicius Martins
Brasil Designer Solutions - http://www.brasildesigner.com


