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

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' en el lado derecho 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:

Ahora deberías encontrar la página guardada en tu lista de archivos PAWS.

Un ejemplo real de script
Cuando un sitio web usado en Wikipedia cambia sus URLs, los enlaces en Wikipedia se desactualizan, y posiblemente se conviertan en enlaces rotos si el sitio web no redirige desde las antiguas URLs a las nuevas. Por ejemplo, la Encyclopedia Britannica (EB) ha cambiado sus enlaces, moviendo sus páginas desde http://www.britannica.com/EBchecked/media/ a http://www.britannica.com/topic/[topic name]/images-videos/*. Puedes encontrar una lista de usos de la URL antigua en la Wikipedia en inglés en https://en.wikipedia.org/wiki/Special:LinkSearch/http://www.britannica.com/EBchecked/media. Actualizar todos estos enlaces manualmente consumiría mucho tiempo. Por suerte, EB ha mantenido redirecciones desde sus antiguas URLs a las nuevas URLs, por lo que no necesita ser corregido inmediatamente.

Para un ejemplo más simple, la Wikipedia en inglés actualmente contiene enlace a http://britannica.com/EBchecked/ en vez de a http://www.britannica.com/EBchecked/ ; es decir, falta el subdominio 'www.' en la URL.

En este momento hay 14 casos en la Wikipedia en inglés: https://en.wikipedia.org/wiki/Special:LinkSearch/http://britannica.com/EBchecked/

Wikipedia en otros idiomas también tiene este problema. Por ejemplo, hay un caso en la Wikipedia en alemán: https://de.wikipedia.org/wiki/Spezial:Weblinksuche/http://britannica.com/EBchecked/

Para arreglar todos estos enlaces, podemos usar el script replace.py de Pywikibot. En esta demostración usaremos el parámetro '-simulate' para evitar escribir la wiki, tal y como indican las reglas estrictas sobre las edición automática de la Wikipedia en español.

Primero vamos a obtener un lista de las páginas con el enlace http://britannica.com/EBchecked/.

Ahora comprobamos que estas páginas tenga de verdad la URL literal en la página; es decir, que no estén usando una plantilla.

Ahora usamos 'replace' para añadir el subdominio "www." que falta.

En PAWS, y en cualquier terminal con soporte de color, la diferencia de los cambios mostrará el "www." añadido en color verde, haciendo más fácil encontrar los cambios propuestos.

Dentro de Pywikibot
Lo siguiente será usar PAWS en una sesión de Python.


 * 1) Ve al inicio de PAWS.
 * 2) Haz clic en 'New' en el lado derecho y selecciona 'Python 3'.

Esto abrirá una nueva ventana.

En la caja de texto, introduce lo siguiente y en el menú 'Cell' selecciona 'Run' (o pulsa shift+enter para ejecutarlo).

Aparecerá una nueva caja de texto. Ejecuta lo siguiente para crear un objeto APISite conectado a https://test.wikipedia.org/:

Describe "site" introduciéndolo en la nueva caja de texto y selecciona "Run".

Esto debería mostrar:

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

Crea un objeto "page":

Comprueba si existe ejecutando:

Esto debería mostrar:

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

Muestra el texto en la página:

Cambia el texto en la página:

Guarda la página en la wiki:

Las respuesta debería ser:

La notebook de Python 3 interactivo permite ejecutar muchas líneas juntas. Lo anterior podría ser colocado en una sola caja de texto y ejecutarse:

El registro de tu sesión interactiva de Python puede guardarse o descargarse para una referencia futura.

Accediendo a la documentación online en PAWS
La documentación de Pywikibot se puede encontrar en https://doc.wikimedia.org/pywikibot/index.html. Está extraída principalmente de docstrings, que pueden ser cargadas en la notebook de Python 3 interactivo usando función incorporada de Python help.

Por ejemplo, para ver los argumentos para el método "save" anterior, funciona tanto:

como

Editando scripts de Pywikibot
La librería Pywikibot y los scripts están localizados en /srv/paws, y son de solo-lectura. La librería Pywikibot instalada no puede ser modificada en PAWS.

Los scripts pueden ser modificados copiándolos a tu inicio de PAWS.

Por ejemplo, para ejecutar una modificación de "checkimages.py":
 * 1) En la terminal, introduce
 * 2) En el navegador, ve a tu inicio de PAWS y haz clic en el archivo.
 * 3) Puedes editar el archivo en el navegador. Edita el código ―de momento, después del código   en la línea 1775, añade una nueva línea (1776) que muestre tu nombre:.
 * 4) En la interfaz de edición, usa el menú "File" y haz clic en 'Save' para guardar tus modificaciones.
 * 5) En la terminal, introduce   para ejecutar el script modificado.