Módulo:Wikidata/doc

De Wikiviajes, la guía libre de viajes
Ir a la navegación Ir a la búsqueda

Esta es la página de documentación de Módulo:Wikidata

Uso[editar]

Este módulo es un proyecto de declaración para la herramienta de formato Wikidata

Tiene las funciones Wikidata, getDeclaraciones, getPropiedad y setFrame.

Función Wikidata[editar]

Permite instrucción de formato(s) para una propiedad específica del tema relacionado con la página actual (no podemos acceder a los otros ítems).

Parámetros[editar]

propiedad

La identificación de la propiedad como "p18". Necesario .

valor

Si se da el valor anula el valor de Wikidata.

prioridad

Si se da prioridad = sí tendrá prioridad el valor de Wikidata que el valor que se de al parámetro valor

debeExistir

Si se informa con "sí" no se recuperan las entidades de Wikidata sin un enlace a un artículo de Wikipedia.

enlace

Puede tomar los valores enlace = sí o enlace = no.

  • Si se da enlace = no aparecerá solamente la etiqueta del valor sin enlace interno.
  • Si se utiliza enlace = sí se mostrará un enlace a la correspondiente página de la Wikipedia definida en Wikidata si existe, si no se enlazará a la página con nombre igual a la etiqueta de Wikidata (si no existe un artículo con ese nombre) y si no se mostrará un enlace al elemento de Wikidata.
formatoTexto

Si se da formatoTexto = mayúscula o cursiva o mayúscula cursiva (da igual el orden)

  • Con el valor mayúscula:

la primera letra de la propiedad se pondrá en mayúsculas. Cuando no se da el valor al parámetro separador y por consiguiente los valores aparecen separados por una coma a excepción de último que se separa por una conjunción por defecto y, solo se pondra en mayúscula la inicial del primer valor. En caso de que se dé valor al parámetro enlace todos los valores apareceran con la inicial en mayúscula.

  • Con el valor cursiva:

el texto de la propiedad se pondrá en cursivas.

formatoFecha

Los valores posibles son:

  • =año: Se devuelve la fecha como una año. Por ejemplo 2014 o 1 a. C.

Parámetros para listas[editar]

lista(opcional): tipo de lista. Los valores posibles son:

  • =no (por implementar): Solo se devuelve el primer elemento de Wikidata. De momento puede utilizarse el parámetro uno=sí . Por ejemplo, en el artículo de España, si se escribe {{#invoke:Wikidata|Wikidata|propiedad=p37|uno=sí}} se generaría "español".
  • =ordenada: Se devuelve una lista ordenada o numerada. Por ejemplo, en el artículo de España, si se escribe {{#invoke:Wikidata|Wikidata|propiedad=p37|lista=ordenada}} se generaría:
  1. español
  2. gallego
  3. euskera
  4. catalán
  5. occitano
  • =no ordenada: Se devuelve una lista no ordenada o con viñetas. Por ejemplo, en el artículo de España, si se escribe {{#invoke:Wikidata|Wikidata|propiedad=p37|lista=no ordenada}} se generaría:
  • Si no se informa el tipo de lista se devuelve una lista de los elementos separados por coma. Por ejemplo, si se escribe{{#invoke:Wikidata|Wikidata|propiedad=p37}} se generaría "español, gallego, euskera, catalán Esta plantilla no acepta corchetes de enlace en el primer parámetro. Para enlazar el resultado agrega la palabra «enlazar» como segundo parámetro. occitano"
En este último caso se pueden utilizar los parámetros separador y conjunción que permiten separar los primeros valores y el último valor de una propiedad. Si no se especifica se toma por defecto como separador una coma y como conjunción "y" respectivamente. Por ejemplo, en el artículo de España, si se escribe {{#invoke:Wikidata|Wikidata|propiedad=p37|separador=/|conjunción=/}} se mostraría "español/gallego/euskera/catalán/occitano".

Funciones específicas para el formato[editar]

valor-función

Nombre de la función Lua que se llama para dar formato al valor. La función acepta como argumentos las siguientes tablas Lua:

  • valor: datos obtenidos de Wikidata para la propiedad. El único argumento obligatorio al llamar a la función
  • opciones: argumentos con los que se accede a la plantilla {{propiedad}} o en el tipo de dato específico
  • marco o frame:
  • calificativos: calificativos de la propiedad en Wikidata
valor-módulo

Nombre del módulo donde está definida la función. Si no se especifica el módulo se intentará buscar la función en el módulo:Wikidata/Formatos y si no se buscará en el módulo definido en la tabla modulosTipos del módulo Wikidata. Algunas de las funciones permitidas son:

tipo de dato / valor-función Módulo de Wikidata en el que se encuentra definido Descripción Ejemplos de propiedades de Wikidata
altura Formato magnitud Se muestra la altura junto a sus unidades y en su caso entre paréntesis el valor en el sistema internacional. Plantilla:Q
área Formato magnitud Se muestra el área junto a sus unidades y en su caso entre paréntesis el valor en el sistema internacional. Plantilla:Q
educado en Formatos educación Se muestra el lugar donde se ha educado y en su caso entre paréntesis el grado académico, especialidad y periodo. Plantilla:Q
imagen Formato imagen Plantilla:Q
lugar Formato lugar Formato para lugares de la forma ciudad, unidad administrativa, país Plantilla:Q, Plantilla:Q
movimiento Formato movimiento Formato para movimientos Plantilla:Q
periodicidad Formato magnitud Se muestra la periodicidad (anual, mensual, quincenal, semanal, etc). Plantilla:Q
premio Formato premio Formato para premios de obras eliminando los literales de la forma " a ...", " a la ..." o " en la categoría ...". Plantilla:Q

Valores devueltos[editar]

Devuelve la declaración formateada de acuerdo a las opciones.

Función getDeclaraciones[editar]

Para ser usado en otro módulos.

Valores devueltos[editar]

Devuelve una tabla con todas las declaraciones del elemento

Función getPropiedad[editar]

Para ser usado en otros módulos.

Parámetros[editar]

declaraciones

Una tabla de declaraciones

opciones

Una tabla con las opciones. los elementos de la tabla son los parámetros de la función Wikidata.

Valores devueltos[editar]

Devuelve la declaración formateada de acuerdo a las opciones.

Función setFrame[editar]

Para pasar el frame desde otro módulo. Es necesario poner esta función cuando se usa la anterior en casos en que haya que expandir wikitexto como por ejemplo con las coordenadas o los formatos de banderas.

Parámetros[editar]

frame

Una tabla/objeto que se pasa desde la invocación del módulo.

Valores devueltos[editar]

Ninguno.

Función addLinkback(texto, identificador de la entidad, identificador de la propiedad)[editar]

La función añade al texto recibido la imagen de un lápiz que enlaza a la propiedad de la entidad en Wikidata.

Valores devueltos[editar]