Manual:Pywikibot/PAWS/pt-br


 * Veja PAWS para mais detalhes.

Este documento fornece uma rápida visão geral interativa de  usando um  notebook  hospedado no ambiente do Wikimedia labs usando PAWS (PAWS: Um Web Shell).

Crie uma conta Wikimedia
Para seguir este guia, você só precisa de uma conta na Wikipedia / Wikimedia. Use Special:CreateAccount para criar uma.

Depois de criar uma conta, visite https://test.wikipedia.org/ e verifique se seu nome de usuário aparece no canto superior direito (isso funciona em torno de ).

Se você é um novo usuário da Wikimedia, faça login com sua conta na meta.Wikimedia, Wikipédia, Wikidata e Commons. E em cada um deles leia e exclua todas as mensagens pendentes que você tem (na parte superior).

Entre em um notebook
Para iniciar um notebook hospedado, vá para https://hub.paws.wmcloud.org/hub

Clique em "Entrar com o MediaWiki" e, em seguida, clique em "Permitir" quando for solicitado a aprovar "Usar o OAuth para autenticação". Na primeira vez que você acessa o PAWS, você precisa criar um servidor. Clique no botão verde "Start my Server". É normal aguardar alguns minutos para a inicialização do novo servidor.

Uma vez concluído, você será redirecionado para um URL como https://hub.paws.wmcloud.org/user/ /lab

Iniciar um terminal
Para iniciar um novo terminal interativo,
 * 1) Vá para a sua [$paws PAWS home]
 * 2) clique em 'New' no lado direito e
 * 3) selecione 'Terminal'.
 * 1) click: File > New > Terminal

Isso abrirá uma nova janela com a URL $paws, com um prompt '$' do Linux.

Este terminal não é um emulador. É um verdadeiro bash shell, como parte de uma instalação real do Linux em um container docker, para que você possa usar qualquer comando bash e use todos os comandos disponíveis no Linux que foram instalados.

Para ver alguns dos comandos disponíveis, use.

To see them all, press TAB twice.

Faça login na wiki
Isso estabelecerá sua conta no servidor e permitirá que você efetue login na linha de comando. O comando a seguir deve confirmar que você pode efetuar login no testwiki. Ele usa o OAuth, portanto, não é necessário digitar uma senha.

Você pode conectar o pywikibot a um wiki diferente criando um arquivo chamado user-config.py em seu  directory  e adicionando variáveis de mylang e family:

Crie uma página
Para criar uma página, digite o seguinte comando no terminal, substituindo '&lt;username>' pelo seu nome de usuário e pressionando 'Y' quando solicitado a aceitar suas alterações:

Você editou o wiki. Veja suas alterações abrindo https://test.wikipedia.org/wiki/User_talk: no seu navegador.

Você pode ler mais sobre cada um desses scripts de linha de comando com a opção de linha de comando '-help'.

Buscar uma página
A busca de muitas páginas é obtida com o comando "listpages".

Para obter o conteúdo da página que você criou na seção anterior, digite o seguinte comando:

Agora, se você for para a sua [$pawshome PAWS files list], a página salva deverá estar presente.

Um exemplo de script real
Quando um site usado na Wikipedia altera seu URL, os links na Wikipedia ficam desatualizados e também são possíveis links mortos se o site não redirecionar dos URLs antigos para os novos URLs. Por exemplo, a Encyclopedia Britannica (EB) mudou seus links, como mover páginas de http://www.britannica.com/EBchecked/media/ para http://www.britannica.com/topic/[topic name]/images-videos/*. Você pode encontrar a lista de usos do URL antigo na Wikipedia em inglês por w:Special:LinkSearch/http://www.britannica.com/EBchecked/media. A atualização manual de todos esses links consumirá muito tempo. Felizmente, a EB manteve redirecionamentos de seus URLs antigos para os novos URLs, portanto, isso não precisa ser corrigido imediatamente.

Para um exemplo mais simples, atualmente a Wikipedia em inglês contém links para http://britannica.com/EBchecked/ em vez de http://www.britannica.com/EBchecked/ ; ou seja, um "www". O subdomínio está ausente no URL.

Atualmente, existem 14 casos na Wikipedia em inglês: w:Special:LinkSearch/http://britannica.com/EBchecked/

A Wikipedia em outro idioma também tem esse problema. por exemplo. há um caso na Wikipedia em alemão: w:de:Spezial:Weblinksuche/http://britannica.com/EBchecked/

Para corrigir esses links, podemos usar o script Pywikibot replace.py. Nesta demonstração, usaremos o argumento '-simulate' para evitar a escrita no wiki, pois existem regras estritas sobre a Wikipedia em inglês edição automática.

Primeiro vamos listar todas as páginas que apontam para $<nowiki.

Agora, verificamos se essas páginas realmente possuem o URL literal na página; ou seja, eles não estão usando um modelo.

Agora use substituir para adicionar o "www" ausente.

No PAWS e em qualquer terminal que suporte cores, a diferença de alterações mostrará o "www." adicionado na cor verde do texto, facilitando a localização das alterações propostas.

Dentro do Pywikibot
Em seguida, usaremos a sessão do PAWS Python.


 * 1) Vá para a sua [$paws PAWS home],
 * 2) clique em 'Novo' no lado direito e
 * 3) selecione 'Python 3'.

Isso abrirá uma nova janela.

Na caixa de texto, digite o seguinte e, no menu Cell, selecione 'Run' (ou pressione Shift+Enter para executar).

Uma nova caixa de texto será exibida abaixo. Execute o seguinte para criar um objeto APISite conectado a https://test.wikipedia.org/:

Descreva o "site" inserindo-o na nova caixa de texto e selecionando "Run".

Deve mostrar

Out[3]: APISite("test", "wikipedia")

Crie um objeto de página:

Verifique se existe executando:

Deve gerar

VERBOSE:pywiki:Found 1 wikipedia:test processes running, including this one. Out[5]: True

Mostre o texto na página:

Altere o texto da página no objeto:

Salve a página no wiki:

A resposta deve ser:

O notebook interativo Python 3 permite que muitas linhas sejam executadas juntas. O acima pode ser colocado em uma caixa de texto e Executar

O log da sua sessão interativa do Python pode ser salvo ou baixado para referência futura.

Acessando a documentação online no PAWS
A documentação do Pywikibot pode ser encontrada em https://doc.wikimedia.org/pywikibot/. Ele é originário principalmente de docstrings, que pode ser carregado no notebook interativo do Python 3 usando a função interna do Python help.

Por exemplo, para examinar os argumentos do método save acima, execute:

ou

Editando scripts Pywikibot
A biblioteca e os scripts do Pywikibot estão localizados em /srv/paws e são somente leitura. A biblioteca Pywikibot instalada não pode ser modificada no PAWS.

Os scripts podem ser modificados após copiá-los para a sua casa no PAWS.

Por exemplo, para executar um "checkimages.py" modificado:


 * 1) No terminal, digite
 * 1) Em um navegador, vá para a sua [$paws PAWS home] e clique no arquivo.
 * 1) No navegador, você pode editar o arquivo. Edite o código -- por exemplo, logo após o código   na linha 1775, adicione uma nova linha 1776 que imprimirá seu nome:
 * 2) Na interface de edição, use o menu Arquivo e clique em Salvar para salvar suas modificações.
 * 3) No terminal, digite   (If no '-limit:x' defined, the program would run until all images checked, it may take long time.)

Veja também

 * PAWS/PAWS and Pywikibot
 * Using Pywikibot with PAWS notebook based tutorial - A tutorial that helps users get started with using Pywikibot and PAWS
 * Example notebooks using Pywikibot - A list of notebooks hosted on PAWS that use Pywikibot
 * [$1 PAWS cheatsheet] por um usuário (por exemplo, sobre acesso à API e ao banco de dados)
 * Source code on GitHub