Módulo:Wikidata/doc
Esta es la página de documentación de Módulo:Wikidata
Uso[editar código]
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 código]
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 código]
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 = noaparecerá 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:
Parámetros para listas[editar código]
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ámetrouno=sí. Por ejemplo, en el artículo de España, si se escribe {{#invoke:Wikidata|Wikidata|propiedad=p37|uno=sí}} se generaría "Error de Lua en Módulo:Wikidata en la línea 906: attempt to index field 'wikibase' (a nil value).".=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:
- Error de Lua en Módulo:Wikidata en la línea 906: attempt to index field 'wikibase' (a nil value).
=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:
- Error de Lua en Módulo:Wikidata en la línea 906: attempt to index field 'wikibase' (a nil value).
- 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 "Error de Lua en Módulo:Wikidata en la línea 906: attempt to index field 'wikibase' (a nil value)."
- En este último caso se pueden utilizar los parámetros
separadoryconjunciónque 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 "Error de Lua en Módulo:Wikidata en la línea 906: attempt to index field 'wikibase' (a nil value).".
Funciones específicas para el formato[editar código]
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:
Valores devueltos[editar código]
Devuelve la declaración formateada de acuerdo a las opciones.
Función getDeclaraciones[editar código]
Para ser usado en otro módulos.
Valores devueltos[editar código]
Devuelve una tabla con todas las declaraciones del elemento
Función getPropiedad[editar código]
Para ser usado en otros módulos.
Parámetros[editar código]
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 código]
Devuelve la declaración formateada de acuerdo a las opciones.
Función setFrame[editar código]
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 código]
frame
Una tabla/objeto que se pasa desde la invocación del módulo.
Valores devueltos[editar código]
Ninguno.
Función addLinkback(texto, identificador de la entidad, identificador de la propiedad)[editar código]
La función añade al texto recibido la imagen de un lápiz que enlaza a la propiedad de la entidad en Wikidata.