Histórico
Polvo

Fonte da versão: 2

-=Polvo=-

{maketoc}

!Introdução: Polvo???

Polvo é um (grande) ajudante dos desenvolvedores do estudiolivre.org. O Polvo é um software escrito em [http://perl.com|Perl] para fazer a publicação automática do site. E isso não significa somente que o Polvo é utilizado para publicar o site em estudiolivre.org; mas que ele pode ser utilizado para 'publicar' o site localmente na máquina do desenvolvedor.

Isso é necessário pois assim é possível manter o código do estudiolivre.org separado do código do [http://www.tikiwiki.org|TikiWiki].

!!-Caso de uso esclarecedor
# o programador cria algo novo para o estudiolivre. Um novo arquivo php, por exemplo.
# ele copia esse arquivo para ''/var/www/estudiolivre'', onde está instalado o [http://www.tikiwiki.org|TikiWiki]/estudiolivre.org
# quando ele muda alguma coisa no seu código, repete a operação
Fica fácil ver que quando são feitas muitas modificações esse procedimento se torna um fardo muito grande para o programador. Aí entra o Polvo, automatizando a 'cópia' de arquivos do projeto estudiolivre.org para a instalação (local ou não) do estudiolivre.org.

Não se preocupe muito caso ainda não tenha entendido muito bem como funciona o Polvo, continue lendo esse texto e, caso continue não entendendo nada, entre em ((contato|contato com os desenvolvedores)).

!Organização de pastas

A arquitetura de um projeto que utiliza Polvo é mais ou menos a seguinte:

# diretório com instalação base do sistema ([http://www.tikiwiki.org|TikiWiki]) ex: /var/www/estudiolivre_base
# diretório de desenvolvimento do projeto ex: /home/fulano/devel/estudiolivre, contendo:
##__db__ - com as 'queries'' que devem ser rodadas no banco do sistema
##__src__ - com os arquivos que devem ser compiados para o diretório de publicação
##__patch__ - com os patches que devem ser aplicados aos arquivos que originais do sistema (os arquivos do [http://www.tikiwiki.org|TikiWiki])
# diretório de publicação do projeto (diretório do Apache) ex: /var/www/estudiolivre
# diretório do polvo: ex: /home/fulano/polvo



!Uso

!!Como instalar

Primeiro instale as dependências do Polvo:
$ sudo apt-get install libxml-perl
$ perl -MCPAN -e 'install XML::Simple' (responda sim para tudo)
$ perl -MCPAN -e 'install MD5'
$ cd /home/fulano/polvo :ext:seuusuario@incubadora.fapesp.br:/cvsroot/arca
$ cvs co polvo
$ perl Makefile.PL
$ make
$ sudo make install
$ chmod a+x polvo.pl

!! Criando um arquivo de configuração para o Polvo

Exemplo de um arquivo de configuração do Polvo, no caso para o estudiolivre.org, ''estudiolivre.conf'':
^
<polvoConfig>
<targetDir>/var/www/estudiolivre</targetDir>
<sourceDir>/home/fulano/estudiolivre</sourceDir>
<connection>
<database>estudiolivre</database>
<user>mapsys</user>
<password/>
</connection>
</polvoConfig>
^
Onde:
* <polvoConfig> - delimitador do arquivo de configuração
* <targetDir> - diretório do Apache
* <sourceDir> - diretório de desenvolvimento
* <connection> - tag que contém os dados de conexão
* <database> - nome do banco de dados
* <user> - usuário
* <password> - senha

Se você não usa senha no seu banco, simplesmente não preencha <password/>

!! Rode o polvo e publique o seu projeto

$ ./polvo.pl estudiolivre.conf

Após rodar o script, várias mensagens aparecerão:
* patching file ./freetag_apply.php
* patching file ./freetag_list.php
* patching file ./freetag.php
* Hunk #1 succeeded at 1988 (offset 3 lines).
...

São mensagens dos patches sendo aplicados.

Caso você receba mensagens como:
Hunk #1 FAILED at 52.

Entre em contato pela ((contato|lista de desenvolvimento)).

Histórico

Legenda: v - view, s - source, c - compare, d - diff

Data Usuári@ IpComentário Versão Ação
19:17:26 de 23/08/13 rodrigo189.122.225.29atualiza url do repositorio no github 8
atual
 v  s
10:56:27 de 23/11/10 rodrigo201.17.96.97substituindo url do cvs que nao existe mais por repositorio git 7  v  s  c  d  
18:50:36 de 22/11/10 rodrigo201.17.108.109instalacao das depencias do perl usando apt-get 6  v  s  c  d  
20:22:32 de 05/12/06 rhwinter201.81.178.177arrumando mais. seção sobre as pastas 5  v  s  c  d  
22:50:51 de 19/03/08 diagogue201.6.137.235  4  v  s  c  d  
17:52:48 de 24/04/07 rodrigo201.81.178.177conteúdo migrado para página do polvo no culturadigital.org.br 3  v  s  c  d  
20:22:32 de 05/12/06 rhwinter201.81.178.177arrumando mais. seção sobre as pastas 2  v  s  c  d  
20:15:45 de 05/12/06 rhwinter201.81.178.177página própria para o polvo, com explixações mais detalhadas 1  v  s  c  d