Módulo:Wikidata/unidades

Este módulo implementa desde cero una forma de obtener las unidades, en base a la entidad de Wikidata asociada a dicha unidad. Toda actualización debe hacerse en Módulo:Wikidata/unidades/datos, siguiendo este formato:

--  Entidad     Texto
    ['Q8805'] = '[[Bit|b]]',

Uso

main()

Para integrar la funcionalidad en otros módulos, se puede seguir el siguiente código de ejemplo:

local getUnit       = require('Módulo:Wikidata/unidades').main
local elementoTabla = require('Módulo:Tablas').elemento

local Dato  = elementoTabla(Entidad, 'claims', idPropiedad, 'mainsnak', 'datavalue')
local Valor = elementoTabla(Dato, 'value')
local Tipo  = elementoTabla(Dato, 'type')

if Tipo == 'quantity' then
    Unidad      = elementoTabla(Valor, 'unit')
    Valor       = string.sub(elementoTabla(Valor, 'amount'), 2)
    if Unidad then Valor = Valor .. getUnit(Unidad) end -- La posición y espaciado de la unidad depende del valor
end

Parámetros

• |val= el identificador de unidad de Wikidata.

numeroUnidad()

Se provee la función auxiliar numeroUnidad() como una forma conveniente de concatenar el número con su unidad disponible.

local numeroUnidad	= require('Módulo:Wikidata/unidades').numeroUnidad
...
local Edad = numeroUnidad(elementoTabla(Entidad, 'claims', 'P6249', 1, 'mainsnak', 'datavalue'))

Parámetros

• |objeto=, el objeto datavalue
• |opciones=, una tabla de opciones, usualmente pasada mediante la función propiedad() presente en varios módulos. Las opciones aceptadas son:

• |opciones['izquierda']= permite colocar la unidad a la izquerda. Por defecto, este va a la derecha.
• |opciones['separador']= especificar un separador alternativo (por defecto un espacio duro  ).

numeroUnidad() acepta como parámetro el objeto datavalue. Si el tipo de dato es amount, y se ha especificado una unidad válida, dicha unidad será concatenada de acuerdo a los parámetros |opciones['izquierda']= y |opciones['separador']=.

Función envoltura propiedad()

La siguiente función envoltura provee una fácil integración de este módulo en módulos de fichas.

function propiedad(idPropiedad, opciones, entidad)
	if not entidad then entidad = Entidad end

	if entidad and entidad.claims and entidad.claims[idPropiedad] then
		if not opciones then
			opciones = {['linkback']='sí'}
		end

		-- Valores cuya unidad deba ir a la derecha, separada de un espacio
		if opciones['unidad'] then
			if elementoTabla(Entidad, 'claims', idPropiedad, 2, 'mainsnak', 'datavalue') then
				return formatoNumero(elementoTabla(Entidad, 'claims', idPropiedad, 1, 'mainsnak', 'datavalue', 'value', 'amount')) .. ' - ' .. numeroUnidad(elementoTabla(Entidad, 'claims', idPropiedad, 2, 'mainsnak', 'datavalue'))
			else
				return numeroUnidad(elementoTabla(Entidad, 'claims', idPropiedad, 1, 'mainsnak', 'datavalue'))
			end
			
		-- Valores cuya unidad deba ir a la izquierda (ej, las monedas o divisas)
		elseif opciones['precio'] then
			if elementoTabla(Entidad, 'claims', idPropiedad, 2, 'mainsnak', 'datavalue') then
				return numeroUnidad(elementoTabla(Entidad, 'claims', idPropiedad, 1, 'mainsnak', 'datavalue'), false) .. ' - ' .. numeroUnidad(elementoTabla(Entidad, 'claims', idPropiedad, 2, 'mainsnak', 'datavalue'), false)
			else
				return numeroUnidad(elementoTabla(Entidad, 'claims', idPropiedad, 1, 'mainsnak', 'datavalue'), false)
			end
		end

		opciones.entityId  = entidad.id
		opciones.propiedad = idPropiedad
		return ModuloWikidata.getPropiedad(opciones,entidad.claims[idPropiedad])
	end
end

¿Por qué los datos en un módulo separado?

Véase la función loadData() de la extensión Scribunto para más información.

¿Qué hay de los módulos auxiliares de Módulo:Wikidata?

Este módulo no pretende ser un reemplazo para los módulos auxiliares de formato del Módulo:Wikidata, sino que una alternativa para ser usada en módulos con un nuevo código, mucho más limpio. Aunque, tarde o temprano, este código terminará integrándose dentro del módulo principal.

---

local p = {}
local ModuloWikidata	= require('Módulo:Wikidata')
local ModuloFormatos	= require('Módulo:Wikidata/Formatos')
local elementoTabla		= require('Módulo:Tablas').elemento

-- Obtener el wikitexto de la unidad como entidad de Wikidata
-- @param string val el valor a buscar
function p.main(val)
	local vals				= mw.loadData('Módulo:Wikidata/unidades/datos')
    q = string.sub(val, 32)
    return	vals[q]--[[ or (function()
    	if q then
	    	local entidad = mw.wikibase.getEntity(q:gsub("-plural", ""))
	    	if entidad then
	    		return ModuloWikidata.propiedad(entidad, 'P5061', {['idioma'] = 'es'})
	    		or ModuloFormatos.enlazar(ModuloWikidata.obtenerEtiquetaWikidata(entidad))
	    	end
	    end
    end)()--]]
end

-- Función para formatear un valor numérico con su unidad.
-- @param table objecto El objeto 'datavalue'
-- @param bool right Dónde colocar la unidad
-- (a la derecha por defecto; 'false' para colocarla a la izquierda)
-- @param string separador Un separador ('' (string vacío) por defecto)
-- @param bool plural Agregar '-plural' al string correspondiente al item de
-- Wikidata a buscar entre la lista de unidades, y devolver su variante plural.
-- @return string Si el tipo de valor 'datavalue.type' es 'quantity', devuelve el valor 
-- 'datavalue.value.amount' concatenado con 'datavalue.value.unit', de estar este disponible.
-- Si el tipo de valor 'datavalue.type' es diferente de 'quantity',
-- simplemente devuelve 'datavalue.value'
function p.numeroUnidad(objecto, opciones)
	local Valor	= elementoTabla(objecto, 'value')
	local Tipo	= elementoTabla(objecto, 'type')

	if Tipo == 'quantity' then
		if not opciones then opciones = {} end

		local Separador 	= opciones['separador'] or ' '
		local Izquierda		= opciones['izquierda']
		local Unidad = (function()
			local Unidad = elementoTabla(Valor, 'unit')
			if Unidad then return p.main(Unidad .. '-plural') or p.main(Unidad) end
		end)()

		if Unidad then
			Valor	= ModuloFormatos.formatoNumero2(string.sub(elementoTabla(Valor, 'amount'), 2))
			if Izquierda then return Unidad .. Separador .. Valor end
			return Valor .. Separador .. Unidad
		end
	end
	return Valor
end

return p