# Pywikibot/delete.py

El script delete.py de Pywikibot es una herramienta poderosa utilizada para eliminar páginas en proyectos de Wikimedia. Es particularmente útil para administradores que necesitan borrar múltiples páginas, ya sea por violaciones de políticas, contenido duplicado o mantenimiento general del sitio. Este script automatiza el proceso de eliminación, ahorrando tiempo y esfuerzo en comparación con la eliminación manual de cada página a través de la interfaz web.

## Contextos útiles

* Eliminación masiva de páginas que cumplen con criterios específicos.
* Limpieza de categorías enteras de páginas no deseadas o innecesarias.
* Mantenimiento de proyectos en Wikimedia, especialmente en situaciones donde las páginas requieren ser eliminadas en bloque.
Este artículo enseñará a los administradores cómo utilizar el script delete.py de manera eficiente, cubriendo tanto su uso básico como opciones avanzadas para tareas más específicas.

## Sección teórica

El script delete.py opera a través de la API de los proyectos Wikimedia, permitiendo a los usuarios con permisos de administrador borrar páginas automáticamente. Internamente, el script accede a la lista de páginas o categorías que se desean eliminar, solicita confirmación si es necesario y realiza la acción de eliminación. El proceso se registra en el sistema de Wikimedia, manteniendo un registro de las acciones administrativas.

### Funcionamiento técnico

* Conexión a la API: Pywikibot se conecta al servidor de Wikimedia.
* Validación de permisos: Verifica que el usuario tenga derechos de administrador.
* Proceso de eliminación: Se ejecutan las eliminaciones solicitadas de forma secuencial, respetando los parámetros configurados.
El conocimiento de cómo interactúan los scripts de Pywikibot con la API y los permisos es fundamental para usar esta herramienta correctamente.

## Requisitos previos

Antes de usar el script delete.py, los usuarios deben cumplir con los siguientes requisitos:
* Pywikibot instalado y configurado: El usuario debe tener Pywikibot correctamente instalado en su entorno. Si no tienes experiencia con la instalación de Pywikibot, sigue la guía de instalación de Pywikibot.
* Permisos de administrador: Solo los administradores de proyectos de Wikimedia tienen permiso para borrar páginas. Asegúrate de que tu cuenta esté autenticada y tenga los permisos adecuados.
* Familiaridad con los comandos básicos de Pywikibot: Se asume que el usuario ya tiene cierta experiencia ejecutando scripts de Pywikibot y puede editar el archivo user-config.py para personalizar su configuración.

## Guía paso a paso

A continuación, te guiaré paso a paso para utilizar el script delete.py:

### Paso 1: Verifica que tu cuenta esté autenticada como administrador

Ejecuta el siguiente comando para verificar que tu cuenta esté correctamente autenticada:

### Paso 2: Ejecuta el script con el nombre de la página que deseas eliminar

Esto eliminará la página especificada si cumples con los permisos necesarios.

### Paso 3: Elimina múltiples páginas desde una lista

Para eliminar varias páginas a la vez, puedes utilizar un archivo de texto que contenga una lista de páginas:

### Paso 4: Confirma la eliminación de las páginas

El script te pedirá confirmación antes de proceder con las eliminaciones. Responde según las opciones presentadas.

## Ejercicio práctico
### Tarea

Crea un archivo de texto llamado páginas_a_eliminar.txt con al menos tres nombres de páginas de prueba que quieras eliminar en un proyecto Wikimedia (asegúrate de usar un entorno de pruebas o páginas que realmente necesiten ser eliminadas).
* Ejecuta el comando para eliminar esas páginas.
* Reflexiona sobre los siguientes aspectos:
** ¿El script funcionó como esperabas?
** ¿Hubo alguna dificultad en el proceso de eliminación masiva?
** ¿Qué consideraciones adicionales tendrías si las páginas contenían muchas ediciones previas?

### Reflexión

¿Qué ventajas ofrece este método en comparación con la eliminación manual de páginas a través de la interfaz web? ¿Cómo podrías mejorar el uso del script en proyectos más grandes?

## Opciones avanzadas y parámetros

El script delete.py ofrece una variedad de parámetros que permiten personalizar su funcionamiento. A continuación, algunos de los más útiles:
* -summary:"resumen de la eliminación": Permite especificar un resumen personalizado para la acción de borrado.
* -always: Este parámetro permite eliminar páginas sin pedir confirmación, útil para eliminar muchas páginas.
* -reason:"motivo de eliminación": Especifica un motivo para la eliminación que se mostrará en el registro de acciones.
Explora más parámetros consultando la documentación oficial del script delete.py.

## Resolución de problemas comunes

Aquí algunos problemas comunes que puedes enfrentar al usar el script, junto con sus soluciones:
* Error: «No tienes permisos para eliminar esta página». Asegúrate de que tu cuenta esté autenticada y tenga permisos de administrador.
* El script se detiene al intentar eliminar una página: Esto puede suceder si la página tiene muchas revisiones. Usa el parámetro -always para evitar que el script se detenga por confirmaciones.
* Error de conexión con la API: Verifica tu conexión a internet y asegúrate de que los servidores de Wikimedia estén en funcionamiento.

## Discusión y reflexión

* ¿Cuáles son los principales desafíos al realizar eliminaciones masivas?
* ¿Cómo podrías automatizar aún más el proceso de borrado en proyectos grandes?
* ¿Qué criterios éticos deben considerarse al eliminar páginas en Wikimedia?

## Conclusión

En este subartículo, hemos aprendido a utilizar el script delete.py de Pywikibot para automatizar la eliminación de páginas en proyectos Wikimedia. Hemos explorado tanto su uso básico como algunas opciones avanzadas para personalizar su comportamiento. Este script puede ser una herramienta invaluable para los administradores que gestionan grandes cantidades de páginas en proyectos de Wikimedia.

### Recursos adicionales

* Documentación oficial de Pywikibot
* Guía avanzada de administración en Wikimedia