# Pywikibot/add text.py

El script add_text.py es una herramienta útil dentro de Pywikibot que permite añadir texto a una página en un proyecto de Wikimedia. Este script puede utilizarse para agregar contenido predeterminado al principio o al final de múltiples páginas de manera automatizada, lo que ahorra tiempo y reduce la posibilidad de errores humanos. Es ideal para tareas como añadir plantillas, notas al pie, categorías o mensajes estandarizados en muchas páginas.
En este artículo, exploraremos cómo usar este script para hacer modificaciones masivas en un conjunto de páginas, lo que puede ser útil para editores avanzados que gestionan proyectos colaborativos en Wikipedia, Wikiversidad o cualquier otro proyecto Wikimedia.

## Sección teórica

El script add_text.py trabaja tomando como input un conjunto de páginas y un fragmento de texto que será añadido al principio o al final de dichas páginas. Utiliza la API de Wikimedia para acceder a las páginas y modificarlas. Al ejecutarse, Pywikibot se conecta al servidor del proyecto Wikimedia, accede a las páginas seleccionadas, realiza las ediciones y las guarda con un resumen de edición personalizado.
Internamente, el script usa las funciones de Pywikibot para manipular objetos de tipo Page, donde se almacena tanto el contenido actual de las páginas como las modificaciones. También cuenta con parámetros que permiten controlar si el texto se añade antes o después del contenido existente, o si se debe evitar añadir el texto en ciertas condiciones, como cuando ya está presente.

## Requisitos previos

Antes de utilizar add_text.py, es importante cumplir con los siguientes requisitos:
* Configuración de Pywikibot: Asegúrate de tener Pywikibot correctamente instalado y configurado. Esto incluye la autenticación en tu cuenta de Wikimedia a través del archivo user-config.py.
* Conocimiento de la API de Wikimedia: Si bien no es esencial para ejecutar el script, tener una comprensión básica de cómo la API de Wikimedia maneja las ediciones masivas te permitirá aprovechar mejor las opciones avanzadas del script.
* Permisos adecuados: Asegúrate de tener los permisos necesarios para editar las páginas donde deseas agregar texto. En algunos proyectos, puede ser necesario tener permisos de usuario autoconfirmado o administrador para realizar ediciones masivas.

## Guía paso a paso
### Instalación y ejecución

* Acceder al directorio de Pywikibot:
* Ejecutar el script:

### Ejemplo básico

Supongamos que queremos agregar la categoría [[Categoría:Ejemplo]] al final de la página «Mi_Página_de_Prueba». El comando sería:
Esto añadirá el texto al final de la página con el resumen de edición indicado.

## Tarea

Ahora que sabes cómo ejecutar el script, realiza el siguiente ejercicio práctico:
Utiliza add_text.py para agregar una plantilla de aviso al principio de una serie de páginas en un proyecto de Wikimedia.
* Modifica una lista de páginas añadiendo al principio la plantilla {{Aviso}}.
* Reflexiona sobre el resultado:
** ¿Qué dificultades encontraste al ejecutar el script?
** ¿Cómo podrías personalizar el comando para hacerlo más eficiente?

## Opciones avanzadas y parámetros

add_text.py incluye varias opciones avanzadas para personalizar su comportamiento. Aquí algunos parámetros útiles:
* -prefix:: Añade el texto al principio de las páginas.
* -summary:: Personaliza el resumen de edición.
* -always: Automatiza la edición sin pedir confirmación para cada página.
* -except:: Evita añadir texto si ya se encuentra presente en la página.

### Ejemplo avanzado

Este comando añade la plantilla {{Aviso}} al principio de la página solo si no está ya presente.

## Resolución de problemas comunes

Aquí se detallan algunos problemas que podrías encontrar al usar add_text.py:
* Error de autenticación: Verifica que tu cuenta esté correctamente configurada en user-config.py y que has ejecutado la autenticación.
* El script no añade texto: Asegúrate de que el texto no esté ya presente en la página o utiliza el parámetro -force para forzar la adición.
* Ediciones fallidas debido a bloqueos de bots: Algunos proyectos pueden restringir las ediciones automáticas. Verifica las políticas locales y solicita permisos si es necesario.

## Discusión y reflexión

Para fomentar un ambiente de aprendizaje colaborativo, considera las siguientes preguntas para la discusión:
* ¿Qué otros usos prácticos puedes imaginar para add_text.py en Wikimedia?
* ¿Qué mejoras se podrían implementar en el script para hacerlo más versátil?
* Reflexiona sobre los desafíos de realizar ediciones masivas. ¿Cuándo es preferible realizar ediciones manuales?

## Conclusión

El script add_text.py es una herramienta poderosa para agregar contenido de forma masiva en proyectos Wikimedia. Al utilizar este script, los editores pueden ahorrar tiempo y mantener la consistencia en el contenido. Con la práctica, se pueden aprovechar sus opciones avanzadas para tareas más complejas y personalizadas.
Para aprender más sobre Pywikibot y sus scripts, revisa los siguientes recursos adicionales:
* Documentación oficial de Pywikibot
* Foro de discusión de Pywikibot