Manual:Pywikibot/PAWS/es


 * Véase PAWS para más detalles.

Este documento proporciona una visión general rápida e interactiva de Pywikibot usando una 'notebook' alojada en el entorno Wikimedia Labs usando 'PAWS' (Pywikibot As Web Service).

Tenga en cuenta que la terminal de PAWS solamente soporta "copiar" y "pegar" en los navegadores basados en Chromium. Si usas un navegador diferente, necesitarás escribir manualmente los comandos mencionados en esta guía. También puedes crear un archivo bash que contenga el comando y luego ejecutar en la terminal con.

Crea una cuenta Wikimedia
Para seguir esta guía solamente necesitas una cuenta en el proyecto Wikimedia.

Para crear una cuenta Wikimedia, véase la página de ayuda de iniciar sesión.

Una vez hayas creado una cuenta por favor, visita https://test.wikipedia.org/ y comprueba que tu nombre de usuario aparece en la esquina superior derecha (esto funciona en torno a T120327).

Iniciar sesión en una notebook
Para iniciar una notebook alojada, ve a https://paws.wmflabs.org/paws

Haz clic en "Sign in with MediaWiki", y haz clic en "Permitir" cuando te pregunte si apruebas el "Uso OAuth". La primera vez que accedes a PAWS necesitas crear un servidor. Haz clic en el botón verde "Start my Server". Es normal que tengas que esperar unos cuantos minutos para iniciar el nuevo servidor.

Una vez esté completado, serás redirigido a una URL como https://paws.wmflabs.org/paws/user/ /tree.

Iniciar una terminal
Para iniciar una nueva terminal interactiva:
 * 1) Ve al inicio de PAWS.
 * 2) Haz clic en 'New' a la derecha y selecciona 'Terminal'.

Esto abrirá una nueva ventana con la URL https://paws.wmflabs.org/paws/user/ /terminals/1, con una línea de comandos '$' de Linux.

Puedes añadir la URL a tus marcadores y volver a la terminal en cualquier momento, incluso después de haber cerrado tu navegador o apagar el ordenador.

Esta terminal no es un emulador. Es una cónsola bash real, parte de una instalación Linux establecida en un contenedor Docker, por lo que puedes utilizar cualquier comando bash, y usar cualquier comando disponible en el sistema Linux que ha sido instalado.

Para ver algunos comandos disponibles, usa.

Conectarse a la wiki
Pywikibot necesita un archivo de configuración. PAWS lo creará automáticamente para ti, con https://test.wikipedia.org/ como la wiki por defecto.

El siguiente comando debería confirmar que puedes conectarte a https://test.wikipedia.org/. Usa OAuth, por lo que no necesitas introducir una contraseña.

Crear una página
Para crear una página, introduce el siguiente comando en la terminal, sustituyendo ' ' con tu nombre de usuario, y pulsa 'Y' cuando te lo solicite para aceptar tus cambios:

Has editado la wiki. Puedes ver tus cambios abriendo https://test.wikipedia.org/wiki/User_talk: en tu navegador web.

Puedes leer más sobre cada uno de estos scripts de línea de comandos con la opción '-help' de la línea de comandos.

Extraer una página
Puedes extraer muchas páginas con el comando "listpages".

Para obtener el contenido de la página creada en la sección anterior, introduce el siguiente comando:

Now if you go to your PAWS files list, the saved page should be present.

A real script example
When a website used on Wikipedia changes its URL, the links on Wikipedia become outdated, and possible also dead links if the website doesn't redirect from the old URLs to the new URLs. e.g. for example, Encyclopedia Britannica (EB) has changed their links, such as moving pages from http://www.britannica.com/EBchecked/media/ to http://www.britannica.com/topic/[topic name]/images-videos/*. You can find the list of usages of the old URL on English Wikipedia at https://en.wikipedia.org/wiki/Special:LinkSearch/http://www.britannica.com/EBchecked/media. Updating all those links manually will be very time consuming. Thankfully EB has maintained redirects from their old URLs to the new URLs, so this does not need to be fixed immediately.

For a simpler example, English Wikipedia currently contains links to http://britannica.com/EBchecked/ instead of http://www.britannica.com/EBchecked/ ; i.e. a 'www.' subdomain is missing in the URL.

There are currently 14 cases on English Wikipedia: https://en.wikipedia.org/wiki/Special:LinkSearch/http://britannica.com/EBchecked/

Wikipedia in other language also have this problem. e.g. there is one case on German Wikipedia: https://de.wikipedia.org/wiki/Spezial:Weblinksuche/http://britannica.com/EBchecked/

In order to fix those links, we can use Pywikibot replace.py script. In this demo we will use the '-simulate' argument to avoid writing to the wiki, as there are strict rules about automated editing of English Wikipedia.

First lets list all of the pages which link to http://britannica.com/EBchecked/.

Now we check those pages actually have the literal URL in the page; i.e. they are not using a template.

Now use replace to add the missing "www."

In PAWS, and any terminal that supports color, the diff of changes will show the added "www." in green text color, making it easier to find the proposed changes.

Inside Pywikibot
Next we will use the PAWS Python session.


 * 1) Go to your PAWS home,
 * 2) click 'New' on the right hand side, and
 * 3) select 'Python 3'.

This will open a new window.

In the text box, enter the following and in the Cell menu select 'Run' (or pressing shift+enter to run).

A new text box will appear below. Run the following to create an APISite object connected to https://test.wikipedia.org/:

Describe "site" by entering it into the new text box and selecting "Run".

It should show

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

Create a page object:

Check it exists by running:

It should output

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

Show the text on the page:

Change the page text in the object:

Save the page to the 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/index.html. 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:

o

Editing Pywikibot scripts
The Pywikibot library and scripts are located in /srv/paws, and are read-only. The installed Pywikibot library can not 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