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 T120327).

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://paws.wmflabs.org/paws/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://paws.wmflabs.org/paws/user/ /tree

Iniciar um terminal
Para iniciar um novo terminal interativo,
 * 1) Vá para a sua PAWS home
 * 2) clique em 'New' no lado direito e
 * 3) selecione 'Terminal'.

Isso abrirá uma nova janela com a URL https://paws.wmflabs.org/paws/user/ /terminals/1, com um prompt '$' do Linux.

Você pode marcar este URL como favorito e retornar ao terminal a qualquer momento, mesmo depois de fechar o navegador ou desligar o computador.

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.

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 $ file 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 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 http://britannica.com/EBchecked/.

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

The response should be:

The interactive Python 3 notebook allows many lines to be run together. The above could be put into one text box and Run

The log of your interactive Python session can be saved or downloaded for future reference.

Accessing online documentation in PAWS
Pywikibot documentation may be found at https://doc.wikimedia.org/pywikibot/. It is primarily sourced from docstrings, which can be loaded in the interactive Python 3 notebook using the Python built-in function help.

For example, to look at the arguments for the save method above, run either:

or

Editing Pywikibot scripts
The Pywikibot library and scripts are located in /srv/paws, and are read-only. The installed Pywikibot library cannot be modified in PAWS.

Scripts may be modified after copying them into your PAWS home.

For example, to run a modified "checkimages.py":


 * 1) In the terminal, enter
 * 2) In a browser, go to your PAWS home and click on the file.
 * 3) In the browser, you can edit the file. Edit the code -- for instance, just after the   code on line 1775, add a new line 1776 that will print out your name:
 * 4) In the editing interface, use the File menu and click Save to save your modifications.
 * 5) In the terminal, enter