Ajuda:Como utilizar robôs

Origem: Wikipédia, a enciclopédia livre.

(Redirecionado de Ajuda:Como usar bots)
Bots


In other languages: de - en - fr - hu - it - ja - ko - nl - pl - pt - ru - sv - zh-hant


Sendo projetos colaborativos e voluntários e sabendo-se que este tipo de trabalho requer tempo e muito trabalho repetitivo, surgiu um framework inicialmente para atualizar elos de interwiki por meio de bots, ou robôs, como é dito em outras línguas. Não se trata precisamente de um robô que faz tudo sozinho; o robô da Wikipedia é um agente de manipulação de artigos. É um desafio manter links de um artigo em uma língua ligado a todas as versões desse artigo em outras línguas. Em tempos, uma nova versão é introduzida, com mudanças de nomes e anulações. Logo, todas as outras versões devem ser atualizadas. Ao longo do projeto foram criados outros módulos para lidarem com upload de arquivos, desambiguação entre artigos, introdução de categorias nas páginas, transformação de tabelas de html para wiki, etc.

O software usado para gerar bots é o Python Wikipedia Robot Framework, os outros módulos do projeto podem ser encontrados no repositório SVN.

O bot foi inicialmente escrito por Rob Hooft em 2003 em linguagem Python. Os bots da Wikipédia em português organizam-se na Coordenação robótica.

Índice

[editar] Download

Os arquivos do repositório estão em http://tools.wikimedia.de/~valhallasw/pywiki/package/pywikipedia/ para Windows e Linux.

Outra opção de download é diretamente do repositório SVN. Neste caso, você terá que obter o software Tortoisesvn para Windows e o pacote Subversion para Linux, e o endereço para a atualização é "svn checkout http://svn.wikimedia.org/svnroot/pywikipedia/trunk/pywikipedia/"

[editar] Usando bots no Windows

Primeiro é necessário o interpretador do programa Python que encontra-se aqui. Depois precisa-se dos módulos do PyWikipediaBot, faça o download e extraia os arquivos .zip para uma pasta dentro do diretório raiz C:/, por exemplo, c:/pywikipediabot.

Depois de extraído é necessário testar se o Python está funcionando corretamente, então digite python dentro do MS-DOS.

Se aparecer o inicializador do interpretador ">>>" então está tudo certo, mas se aparecer a seguinte mensagem:

'python' não é reconhecido como um comando interno ou externo, um
 programa operável ou um arquivo em lotes.

Então execute, na mesma janela do MS-DOS (supondo que o python está instalado em C:\Python2.5):

C:\Python2.5\python.exe 

se aparecer ">>>", está tudo certo, para sair digite Ctrl+Z.

Para executar um bot, entre na pasta onde os arquivos do bot está e digite o mesmo comando acima e o bot que você quer executar. por exemplo:

C:\Python2.5\python.exe login.py -sysop

Digite seu login e senha e você está logado. Teste-o C:\Python2.5\python.exe test.py.

[editar] Usando bots no Linux

A maioria das distribuições do Linux já veêm com o interpretador do Python nativos em seus sistemas. Faça download dos módulos do PyWikipediaBot, extraia os arquivos do arquivo.tar.gz para uma pasta a sua escolha, por exemplo, /home/pywikipediabot.

Entre no Console ou em algum Terminal e vá até o diretório onde o PyWikipediaBot está, digite seu login acessando o módulo

login.py. Digite: >>> python login.py

E está logado. Para sair do python digite Ctrl+D.


[editar] Usando bots com Cygwin

O cygwin criado e mantido pela Red Hat Linux é uma alternativa de usar Linux dentro do Windows, o uso do bot no cygwin é semelhante a do Linux precisando pegar o pacote do Python aqui.


[editar] Configuração Geral

Agora você irá configurá-lo, entre na pasta do PyWikipediaBot e procure o módulo config.py, clique no IDLE (botão direito do mouse, Edit with IDLE) e altere as linhas de comando seguintes:

   mylang = 'pt' 
   coloque a wikipedia que você quer logar, por exemplo, 'pt'.

E depois crie um arquivo user-config.py com a linha abaixo:

   usernames['wikipedia']['pt'] = 'myPortugueseUsername'

Neste mesmo arquivo há a opção de colocar opções de sua preferência como:

Interwiki alterando artigos da fr: e da pt:

interwiki_graph = True

  • Escolha do formato das figuras do graphviz

interwiki_graph_format = 'png'

  • Escolha de log

always_log = True ou never_log = False

  • Interface gráfica

userinterface = 'tkinter'

  • Artigos sem interwiki

without_interwiki = True

[editar] Configuração global de Interwiki

Para que o bot rode em todas as línguas, basta colocar as linhas de configuração para cada língua:

usernames['wikipedia']['pt'] = 'myPortugueseUsername'
usernames['wikipedia']['en'] = 'myEnglishUsername'

dentro do user-config.py.

Faça login novamente com o comando:

python login.py -all

Depois somente rodar o interwiki.py e ele irá ligar as línguas umas nas outras, acabando com os warnfiles.

[editar] Módulos

Módulo que checa artigos com mesmo nome em todas as wikipedias e a faz-se um link para ela na coluna da esquerda do site.

[editar] interwiki.py

Bot de Interwiki trabalhando

Para procurar as ligações para outras wikipédias para uma determinada página (digamos, nome da página), basta rodar:

python interwiki.py nome_da_página

O programa irá então procurar as ligações para outras wikipédias que já existirem em nome da página. Então ele irá acessar cada uma das páginas a que correspondem estas ligações a fim de procurar mais ligações e assim sucessivamente, até que cada ligação já tenha sido investigada.

[editar] -hint

Percebe-se que se nome da página não possuir ligação alguma, o programa não irá achar mais nenhuma ligação para outra wikipédia. Deveremo então achar uma página correspondente em outra wikipédia (que no nosso exemplo vai ser achada em nome da página em inglês na en.wp). O comando a ser dado é então:

python interwiki.py nome da página -hint:en:nome_da_página_em_inglês

[editar] -years

Para fazer os interwikis de todas as paginas de anos de ano_de_início até 2050 o comando é:

python interwiki.py -years:ano_de_início

Este processo deve apenas ser realizado periodicamente, definido em Wikipedia:Coordenação robótica.

[editar] -days

Para fazer os interwikis de todas as paginas de dias do ano do mês_de_início (um número de 1 a 12) até o mês 12 o comando é:

python interwiki.py -days:mês_de_início

Este processo deve apenas ser realizado periodicamente, definido em Wikipedia:Coordenação robótica.

[editar] -start

O comando -start pode-se combinar com o comando -continue. O -start funciona adicionando o nome da página no comando para o interwiki fazer as ligações em todas as páginas que estão dentro dela. O comando é:

python interwiki.py -start:nome_da_página

[editar] Imagetransfer.py


Módulo que serve para transferir imagens de um projeto como a wikipédia para o commons, o que é mais sensato, mas pode transferir para outros projetos.

  • Transferência simples para o commons:
python imagetransfer.py Imagem:XX.ext
  • Multiplas transferências para o commons, obtendo o nome das imagens em um arquivo externo do computador.
python imagetransfer.py -file:tocommons.py

[editar] table2wiki.py


Este programa transforma tabelas do formato html para o formato wiki que é mais simples para a edição. O comando a ser usado é:

python table2wiki.py nome da página

As páginas a serem alteradas também podem ser lidas em um arquivo texto (lista.txt para o nosso exemplo):

python table2wiki.py -file:lista.txt

[editar] category.py


Este programa é muito poderoso e só deve ser usado pelos que já dominam a Força.

O programa category.py serve a muitas utilidades.

[editar] Movendo (ou renomeando) categorias

Se todos os artigos que estiverem em categoria 1 deveriam estar em categoria 2, basta rodar:

python category.py rename

Então o programa irá perguntar primeiro qual categoria a ser abandonada (categoria 1) e depois a categoria a ser enchida (categoria 2).

[editar] Categorizando uma lista

O programa também pode categorizar uma lista de páginas ou todas as páginas que apontam para algum artigo. Bastará rodar:

python category.py add

e informar onde buscar a lista. Nota: o programa categoriza todas as páginas da lista em apenas uma categoria informada pelo usuário.

[editar] solve_disambiguation.py


Serve para desambiguar páginas rapidamente.

[editar] Redirecionamentos

Se todos os artigos que apontam para um redirecionamento (artigo 1) deveriam apontar para o artigo-alvo do redirecionamento (artigo 1), basta rodar:

python solve_disambig.py -just -always:0 -pos:artigo_1 artigo 1

[editar] Todas os ambiguamentos

Para rodar o bot em todas as páginas com ambiguamento no domínio principal:

python solve_disambiguation.py -start:! -main

[editar] Catall.py


Categoriza todos os artigos. O bot pede a categoria para cada artigo.

[editar] catall.py -onlynew

categoriza somente os artigos que não contém categorias.

[editar] Marcação dos bots

Os robots podem ser marcados, i.e., identificados ao nível do software como bots, para que as suas intervenções sejam escondidas da página de Mudanças Recentes por defeito (mediante a opção hidebots=0 no endereço).

No entanto, esta medida carece da aprovação da comunidade existente na Wikipédia. Os passos a tomar para a marcação de bots são:

  • Apresentação do bot na Esplanada sobre a sua função e âmbito de utilização, bem como o software utilizado.
  • Inscrição das funções e âmbito do bot na página: Wikipedia:Robôs/Pedidos de aprovação
  • Prestar atenção a alterações da página supracitada, pois será nela que será discutida a marcação do bot.
  • Caso o bot seja aprovado, adicioná-lo à lista da Coordenação robótica

[editar] Ligações externas

Ferramentas pessoais
Criar um livro