# Pywikibot/newitem.py

El script newitem.py de Pywikibot permite la creación de nuevos elementos en Wikidata, el repositorio de datos estructurados que respalda muchos proyectos de Wikimedia. Es particularmente útil cuando es necesario agregar un nuevo elemento (como una persona, un lugar, un concepto, etc.) a la base de datos de Wikidata, ya sea manualmente o como parte de una tarea automatizada.
Este script facilita la tarea de crear nuevos ítems, evitando la necesidad de hacerlo directamente a través de la interfaz de Wikidata, lo que puede ahorrar tiempo y reducir errores al automatizar este proceso. Para los usuarios que gestionan proyectos en Wikidata o aquellos que contribuyen con datos masivos, este script es una herramienta invaluable.

## Contextos de uso

* Creación de ítems relacionados con personas o lugares a partir de una lista externa.
* Automatización de la adición de ítems que luego serán enriquecidos con más datos.
* Simplificación de la interacción con la API de Wikidata.

## Sección teórica

El script newitem.py funciona como un intermediario entre el usuario y la API de Wikidata. Básicamente, permite enviar solicitudes a la API para crear nuevos ítems con un conjunto mínimo de propiedades. El script facilita la tarea de iniciar un ítem en blanco, el cual luego puede ser ampliado con más declaraciones, etiquetas y descripciones a través de otros scripts o manualmente.

### Flujo del script

* El script toma la entrada del usuario o de un archivo.
* Hace una solicitud a la API de Wikidata para crear un nuevo ítem.
* Devuelve un identificador (QID) que corresponde al nuevo ítem creado.
Este proceso está alineado con los principios de contribución estructurada en Wikidata, asegurando que los ítems sean únicos y puedan ser reutilizados a lo largo de diferentes proyectos.

## Requisitos previos

Antes de comenzar a utilizar newitem.py, los usuarios deben cumplir con los siguientes requisitos:
* Instalación de Pywikibot: Asegúrate de tener instalado Pywikibot y configurado correctamente con acceso a Wikidata. Esto implica:
** Clonar el repositorio de Pywikibot.
** Configurar el archivo user-config.py con tus credenciales.
** Autenticarse con una cuenta válida de Wikimedia.
* Permisos de edición: Para crear nuevos ítems en Wikidata, tu cuenta debe tener privilegios de edición. Asegúrate de cumplir con las políticas de Wikidata en cuanto a creación de contenido.
* Conocimiento básico de Wikidata: Familiarízate con la estructura de los ítems en Wikidata, sus propiedades y cómo se interrelacionan. Esto será crucial para definir correctamente los datos que añadirás a los nuevos ítems.

## Guía paso a paso
### Paso 1: Configurar el entorno

Abre tu terminal y navega a la carpeta donde tienes instalado Pywikibot. Si aún no lo has hecho, autentícate en Wikimedia ejecutando:

### Paso 2: Ejecutar el script

Para crear un nuevo ítem en Wikidata, utiliza el siguiente comando básico:
El argumento -page: indica que el nuevo ítem se asociará a una página existente de un proyecto Wikimedia (por ejemplo, un artículo de Wikipedia).

### Paso 3: Personalizar el ítem

También puedes agregar una etiqueta o descripción inicial al ítem:
Esto creará el ítem con una etiqueta (nombre) y una descripción inicial que pueden ampliarse más tarde.

## Tarea: Crear un nuevo ítem en Wikidata

Imagina que necesitas crear un nuevo ítem sobre un científico no documentado en Wikidata, utilizando el script newitem.py. Sigue estos pasos:
* Selecciona un artículo de Wikipedia que hable sobre dicho científico.
* Ejecuta el script newitem.py para crear el ítem en Wikidata con la etiqueta y descripción apropiadas.
* Reflexiona sobre lo que ocurre: ¿Cómo influye la estructura de Wikidata en la creación de un nuevo ítem? ¿Qué propiedades iniciales debería tener?

### Preguntas de reflexión

* ¿Qué tan fácil fue crear un ítem utilizando el script?
* ¿Qué limitaciones encontraste en este proceso?
* ¿Cómo podrías enriquecer el ítem recién creado?

## Opciones avanzadas y parámetros

El script newitem.py ofrece varias opciones avanzadas que permiten un mayor control sobre la creación de ítems. Algunas de las más útiles incluyen:
* -summary:"Texto del resumen": Permite especificar un resumen de la edición que se guardará en el historial del ítem.
* -fromfile:"archivo.txt": Permite crear múltiples ítems desde un archivo de texto, donde cada línea del archivo contiene el nombre de una página para la cual se creará un ítem.
* -lang:"es": Define el idioma en el cual se añadirá la etiqueta y descripción del ítem, útil cuando se trabaja con múltiples idiomas.

## Resolución de problemas comunes
### Problema 1: Error de autenticación

Si el script te pide autenticarte repetidamente, asegúrate de que tu sesión con Pywikibot esté correctamente configurada. Revisa que el archivo user-config.py tenga los datos correctos y que el comando login se haya ejecutado sin errores.

### Problema 2: Creación fallida del ítem

Si el ítem no se crea, es posible que la página de origen que indicaste en -page: ya tenga un ítem en Wikidata. Usa la opción -dry para verificar sin crear el ítem:

## Discusión y reflexión

Para fomentar la colaboración y la discusión, puedes plantear las siguientes preguntas:
* ¿Cuáles son las ventajas y desventajas de utilizar Pywikibot para crear ítems en lugar de hacerlo manualmente?
* ¿En qué situaciones sería más apropiado automatizar la creación de ítems?
* ¿Qué dificultades encontraste al personalizar el script para tus necesidades?

## Conclusión

En este subartículo, has aprendido a utilizar el script newitem.py para crear nuevos ítems en Wikidata. Ahora comprendes cómo se configura el entorno, cómo ejecutar el script y las opciones avanzadas para personalizar la creación de ítems. Este conocimiento es clave para automatizar tareas en Wikidata y facilitar la gestión de datos estructurados.

### Recursos adicionales

* Documentación oficial de Pywikibot
* Guía de contribución a Wikidata