Esta plantilla está diseñada para obtener datos de Wikidata con o sin un enlace al artículo de Wikipedia conectado y con muchas otras características.
La estructura general de una llamada a esta plantilla es la siguiente. Observe que la estructura básica consta de comandos posicionales, indicadores y argumentos, todos los cuales tienen una posición fija.
{{wikidata|command1|flag1a|flag1b|flag1c|command2|flag2a|flag2b|flag2c|flag0a|flag0b|flag0c|arg1|arg2|arg3}}
Utilice diferentes comandos para obtener distintos tipos de valores de Wikidata. Se debe proporcionar al menos un comando y se pueden combinar varios comandos en una sola llamada como se muestra arriba (en cualquier orden, también es posible más de dos), pero esto solo se aplica a los comandos de la clase de reclamación; las llamadas que contienen un comando de la clase general no pueden contener ningún otro comando. Cada comando puede ir seguido de cualquier número de indicadores de comando, que son opcionales y se pueden utilizar para modificar la salida generada por ese comando.
Los comandos y sus indicadores pueden ir seguidos de cualquier número de indicadores de configuración, que también son opcionales y afectan a la selección de datos y al comportamiento de la plantilla en general. La llamada se cierra con los argumentos posicionales, que pueden ser necesarios según los comandos proporcionados. También existen algunos argumentos con nombre (es decir, pares nombre-valor), así como un conjunto de indicadores con nombre para uso avanzado que se pueden utilizar para cambiar la forma en que los valores obtenidos se fusionan en la salida.
Esta plantilla fue diseñada para satisfacer las necesidades básicas de obtención de datos de Wikidata, pero se puede lograr mucho mediante diferentes combinaciones de llamadas. Para mayor comodidad, dichas combinaciones se pueden incluir en nuevas plantillas que satisfagan una necesidad específica. Consulte también la sección sobre casos de uso comunes a continuación para ver algunos ejemplos de "bloques de construcción" útiles. Asimismo, la funcionalidad de esta plantilla se puede ampliar mediante la creación de plantillas contenedoras que utilicen el main
comando proporcionado por Module:Wd que está siendo utilizado por esta plantilla (tal como lo hace {{ WikidataOI }} ).
A continuación se muestra una lista de casos de uso comunes. En el futuro, se podrán implementar comandos de acceso directo que sean equivalentes a estas llamadas para mayor comodidad.
Los comandos ( command1
, command2
, ...) determinan qué tipo de valores se devuelven. Una llamada solo puede contener comandos de una sola clase.
Los comandos de clase de reclamo se pueden combinar, lo que significa que se pueden dar múltiples comandos de diferentes tipos de esta clase a la vez (ver arriba para su uso).
Combine varios comandos en una llamada a esta plantilla, en lugar de realizar múltiples llamadas a esta plantilla con un comando cada una, para asegurarse de que toda la información devuelta pertenezca entre sí (consulte también los ejemplos a continuación).
Los comandos de clase generales no se pueden combinar.
Están disponibles las siguientes banderas (opcionales) que se pueden usar para modificar el comportamiento de esta plantilla. Deben indicarse después del (primer) comando y antes de los argumentos posicionales . Por conveniencia, ||
se permiten banderas vacías (es decir, ) y simplemente se ignorarán.
Estas banderas ( flag1*
, flag2*
, ...) se aplican directamente al comando que las precede.
Estas banderas ( flag0*
) son banderas de configuración general y se pueden proporcionar en cualquier lugar después del primer comando (pero antes de los argumentos posicionales ).
Los argumentos determinan las fuentes de donde se obtienen todos los valores devueltos.
La siguiente tabla muestra los argumentos posicionales ( arg*
) disponibles en su orden fijo. Para cada comando, se marca el conjunto de argumentos aplicable. Si se proporcionan varios comandos, el conjunto aplicable es la unión de los conjuntos individuales. Por ejemplo, si se han proporcionado los comandos properties
y , entonces se deben proporcionar también qualifiers
al menos ambos argumentos property_id
y .qualifier_id
Se puede dar más de un comando qualifier
/ . El orden en el que se dan estos comandos con sus indicadores coincide con el orden en el que se dan los respectivos argumentos.qualifiers
qualifier_id
A continuación se muestra una descripción de todos los argumentos posicionales.
A continuación se incluye una descripción de todos los argumentos nombrados, que son pares nombre-valor (es decir, |name=value
). Todos son opcionales y se pueden proporcionar en cualquier lugar dentro de la llamada.
Los alias de propiedad son otros nombres para los identificadores P que se pueden utilizar en su lugar. Los siguientes alias de propiedad (que distinguen entre mayúsculas y minúsculas ) están disponibles actualmente:
Cuando se utiliza el comando reference
o references
y se encuentra una referencia (en Wikidata), el módulo comprueba si la referencia contiene una propiedad importada de un proyecto Wikimedia (P143), inferida de (P3452) o URL de importación de Wikimedia (P4656). En caso de que una de estas propiedades esté presente, se ignora toda la referencia (es decir, se trata como si no estuviera presente).
De lo contrario, el módulo intenta mostrar la referencia utilizando la plantilla {{ Cite web }} . La referencia debe tener una propiedad URL de referencia (P854). La siguiente tabla muestra la asignación de propiedades de Wikidata a parámetros de Cite web.
Se ignoran las siguientes propiedades: imagen (P18), tipo de referencia (P3865).
Si no hay ninguna propiedad URL de referencia (P854) presente en la referencia, pero una propiedad del tipo de datos "Identificador externo" está presente tanto en la referencia como en la propiedad Wikidata (P1687) del elemento indicado en (P248), se genera una URL a partir de su contenido y se utiliza de la misma manera que una URL dada en la URL de referencia (P854).
Si no hay ninguna propiedad URL de referencia (P854) o la referencia tiene propiedades desconocidas, el módulo intenta mostrarla utilizando la plantilla {{ Cite Q }} . La propiedad indicada en (P248) es obligatoria. La siguiente tabla muestra la asignación de propiedades a los parámetros de Cite Q.
Las propiedades enumeradas en la primera tabla (en esta sección) también se ignoran cuando se utiliza Cite Q.
Una referencia se puede mostrar usando Cite Q solo si la referencia tiene una propiedad indicada en (P248) y solo tiene propiedades enumeradas en la tabla anterior. Si no se puede usar ni Cite web ni Cite Q para mostrar una referencia, se devuelve el siguiente mensaje de error con una explicación.
Para corregir este error, verifique que la referencia tenga las propiedades requeridas y no tenga propiedades desconocidas, como se describe anteriormente. La página de ayuda de Wikidata sobre referencias también puede ser útil para obtener las fuentes de las declaraciones.
El diseño de la salida de (una combinación de) comandos que tienen tanto una forma singular como una plural (por ejemplo, property
/ properties
) se puede personalizar mediante el uso de una serie de indicadores con nombre, que son pares de nombre-valor (por ejemplo, |flag=value
), que se pueden indicar en cualquier lugar dentro de la llamada. La siguiente tabla muestra los indicadores con nombre disponibles.
Para insertar un espacio al principio o al final de un value
, utilice un guión bajo _
. Para obtener un guión bajo literal, escápelo colocando una barra invertida \
directamente delante de él (es decir, \_
); lo mismo se aplica a una barra invertida literal (es decir, \\
). Para obtener una barra vertical literal |
, utilice o .{{!}}
|
Esta plantilla obtiene datos de la base de conocimiento centralizada Wikidata. Para editar los datos, haga clic en "Elemento Wikidata" en la barra lateral izquierda.