Histórico
Polvo

Visualização prévia da versão: 1

Polvo

Introdução: Polvo???


Polvo é um (grande) ajudante dos desenvolvedores do estudiolivre.org. O Polvo é um software escrito em 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 TikiWiki.

O caso de uso que esclarece isso é:
  1. o programador cria algo novo para o estudiolivre. Um novo arquivo php, por exemplo.
  2. ele copia esse arquivo para /var/www/estudiolivre, onde está instalado o TikiWiki/estudiolivre.org
  3. 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 com os desenvolvedores.


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 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