# Pywikibot/category.py

El script category.py es una herramienta de Pywikibot diseñada para gestionar categorías en los proyectos Wikimedia. Permite a los usuarios realizar tareas como mover páginas de una categoría a otra, borrar categorías vacías, y fusionar categorías. Este script es útil para los editores que buscan automatizar la organización de contenido, simplificar la gestión de categorías masivas y mejorar la coherencia en los proyectos de Wikimedia.

## Sección teórica

El script category.py funciona interactuando con la API de Wikimedia, permitiendo la manipulación de categorías a través de comandos específicos. Pywikibot facilita esta interacción, traduciendo las órdenes del usuario en solicitudes HTTP que realizan las modificaciones directamente en las páginas. El script puede procesar grandes cantidades de datos, lo que lo convierte en una opción poderosa para proyectos de limpieza de categorías.
El script ofrece varias funcionalidades clave:
* Mover categorías: Cambia el contenido de una categoría a otra.
* Fusionar categorías: Combina dos categorías en una sola.
* Borrar categorías vacías: Elimina categorías sin contenido.

## Requisitos previos

Antes de usar el script category.py, los usuarios deben cumplir con los siguientes requisitos:
* Configuración de Pywikibot: Pywikibot debe estar instalado y configurado correctamente. Asegúrate de tener un archivo user-config.py adecuado.
* Acceso y autenticación en Wikimedia: Debes tener una cuenta en el proyecto Wikimedia donde deseas trabajar y estar autenticado con Pywikibot.
* Conocimiento básico de categorías en Wikimedia: Familiarízate con la estructura de categorías y cómo se utilizan en Wikipedia y otros proyectos Wikimedia.

## Guía paso a paso

Aquí te explicamos cómo ejecutar el script para una tarea básica de mover páginas de una categoría a otra.
* Abre la terminal y navega a la carpeta donde tienes Pywikibot instalado.
* Ejecuta el siguiente comando para mover las páginas de una categoría antigua a una nueva:
Esto trasladará todas las páginas de la categoría «Antigua» a «Nueva».
* Si deseas eliminar la categoría vacía después del traslado, añade el parámetro --delete:

## Tarea

Traslada todas las páginas de la categoría «Artículos sin categorizar 2023» a «Artículos sin categorizar 2024». A continuación, reflexiona sobre las siguientes preguntas:
* ¿Qué sucedió con las páginas cuando ejecutaste el comando?
* ¿Qué otras tareas podrías automatizar usando este script?

### Reflexión

* ¿Qué problemas encontraste al mover un gran número de páginas?
* ¿Cómo podrías mejorar la estructura de categorías en este proyecto?

## Opciones avanzadas y parámetros

El script category.py ofrece varias opciones avanzadas para realizar tareas más específicas. Algunos ejemplos útiles incluyen:
* Fusionar categorías: Combina el contenido de dos categorías sin eliminar ninguna.
* Eliminar categorías vacías: Borra todas las categorías vacías en el proyecto.
* Actualizar una categoría en varias páginas: Si deseas cambiar la categoría de varias páginas a la vez.
Donde archivo.txt contiene una lista de páginas.

## Resolución de problemas comunes

* Error de autenticación: Asegúrate de haber iniciado sesión en tu cuenta de Wikimedia. Puedes hacerlo con el comando:
* Categoría no encontrada: Verifica la ortografía exacta de las categorías, incluyendo mayúsculas y minúsculas.
* Permisos insuficientes: Algunos proyectos pueden requerir permisos específicos para mover o borrar categorías. Asegúrate de tener los derechos adecuados en el proyecto Wikimedia.

## Discusión y reflexión

En un entorno de aprendizaje colaborativo, plantea las siguientes preguntas:
* ¿Qué ventajas tiene el uso del script category.py frente a la gestión manual de categorías?
* ¿En qué situaciones puede resultar más eficiente no usar scripts automatizados y hacer ediciones manuales?
Explora con tus compañeros posibles mejoras al script, como la personalización de parámetros para necesidades específicas del proyecto en el que trabajas.

## Conclusión

El script category.py de Pywikibot es una herramienta potente para la gestión y organización de categorías en los proyectos Wikimedia. Su capacidad para mover, fusionar y eliminar categorías de manera automática simplifica el trabajo de los editores, permitiéndoles concentrarse en la mejora del contenido. Para profundizar más, puedes explorar los siguientes recursos:
* Guía de uso de categorías en Wikipedia