Modulo:Coord
Istruzioni per l'uso
Questo è un modulo scritto in Lua. Le istruzioni che seguono sono contenute nella sottopagina Modulo:Coord/man (modifica · cronologia)
Sandbox: Modulo:Coord/sandbox (modifica · cronologia) · Test: Modulo:Coord/test (modifica · cronologia · Esegui)
Questo è un modulo scritto in Lua. Le istruzioni che seguono sono contenute nella sottopagina Modulo:Coord/man (modifica · cronologia)
Sandbox: Modulo:Coord/sandbox (modifica · cronologia) · Test: Modulo:Coord/test (modifica · cronologia · Esegui)
Modulo Lua che implementa le funzionalità del Template:Coord.
Ha una sottopagina di configurazione: Modulo:Coord/Configurazione.
Utilizzo da un altro modulo
Il modulo può essere usato anche da un altro modulo tramite "require". È sufficiente inserire nel modulo:
local mCoord = require('Modulo:Coord')
La funzione esportata è _main, con gli stessi parametri del template.
- Esempio
local mCoord = require('Modulo:Coord')
local p = {}
function p.main(frame)
local sydney, wd
sydney = mCoord._main( { '-33.86', '151.211111', format = 'dms' } )
wd = mCoord._main( { display = 'inline,title', format = 'dec' } )
return string.format('Le coordinate dms di Sydney sono: %s. ' ..
'Le coordinate dec dell\'elemento Wikidata collegato: %s.',
sydney, wd)
end
return p
--[[
* Modulo che implementa il template Coord.
* Modulo importato da http://it.wikipedia.org/w/index.php?title=Modulo:Coord&oldid=83469442
]]
require('strict')
local mWikidata = require('Modulo:Wikidata')
local errorCategory = '[[Categoria:Errori di compilazione del template Coord]]'
-- Configurazione
local cfg = mw.loadData('Modulo:Coord/Configurazione')
-------------------------------------------------------------------------------
-- Funzioni di utilità
-------------------------------------------------------------------------------
-- Error handler per xpcall, formatta l'errore
local function errhandler(msg)
local cat = mw.title.getCurrentTitle().namespace == 0 and errorCategory or ''
return string.format('<span style="color:red">Il template {{Coord}} ha riscontrato degli errori ' ..
'([[Template:Coord|istruzioni]]):\n%s</span>%s', msg, cat)
end
-- Raccoglie più messaggi di errore in un'unica table prima di usare error()
local function dumpError(t, ...)
local args = {...}
table.insert(t, '* ')
for _, val in ipairs(args) do
table.insert(t, val)
end
table.insert(t, '\n')
end
-- Ritorna il numero arrotondato al numero di cifre decimali richiesto
local function round(num, idp)
local mult = 10^(idp or 0)
return math.floor(num * mult + 0.5) / mult
end
-- Ritorna la stringa "0 + numero" quando il numero è di una sola cifra, altrimenti lo stesso numero
local function padleft0(num)
return (num < 10 and '0' or '') .. num
end
-- Converte un numero in stringa senza usare la notazione scientifica, esempio tostring(0.00001)
local function numberToString(num)
-- la parentesi () extra serve per non ritornare anche il gsub.count
return (string.format('%f', num):gsub('%.?0+$', ''))
end
-- Legge il parametro display
local function getDisplay(args)
return {
inline = not args.display or args.display == 'inline' or args.display == 'inline,title',
title = args.display == 'title' or args.display == 'inline,title',
debug = args.display == 'debug'
}
end
local function getArgs(frame)
local args = {}
-- copia i parametri ricevuti, eccetto quelli con nome valorizzati a stringa vuota
for k, v in pairs(frame:getParent().args) do
if v ~= '' or tonumber(k) then
args[k] = string.gsub(v, '^%s*(.-)%s*$', '%1')
end
end
-- retrocompatibilità con una funzionalità nascosta del precedente template:
-- ignorava qualunque parametro posizionale vuoto dopo longitudine e parametri geohack
for i = #args, 1, -1 do
if args[i] == '' then
table.remove(args, i)
else
break
end
end
-- rimuove i parametri posizionali vuoti front to back fermandosi al primo non vuoto
while args[1] == '' do
table.remove(args, 1)
end
return args
end
local function isempty(s)
return s == nil or s == ''
end
-------------------------------------------------------------------------------
-- classi DecCoord e DmsCoord
-------------------------------------------------------------------------------
-- Rappresenta una coordinata (lat o long) in gradi decimali
local DecCoord = {}
-- Rappresenta una coordinata (lat o long) in gradi/minuti/secondi
local DmsCoord = {}
-- Costruttore di DecCoord
-- deg: gradi decimali, positivi o negativi, se negativi viene cambiato il segno e
-- la direzione cardinale eventualmente invertita
-- card: direzione cardinale (N|S|E|W)
function DecCoord:new(deg, card)
local self = {}
setmetatable(self, { __index = DecCoord,
__tostring = function(t) return self:__tostring() end,
__concat = function(t, t2) return tostring(t) .. tostring(t2) end })
self.deg = tonumber(deg)
if self.deg < 0 then
self.card = card == 'N' and 'S' or (card == 'E' and 'W' or card)
self.deg = -self.deg
else
self.card = card
end
return self
end
-- Richiamata automaticamente ogni volta che è richiesto un tostring o un concatenamento
function DecCoord:__tostring()
return numberToString(self.deg) .. '°' .. self.card
end
-- Ritorna i gradi con segno
function DecCoord:getDeg()
local deg = self.deg * ((self.card == 'N' or self.card =='E') and 1 or -1)
return numberToString(deg)
end
-- Ritorna un nuovo oggetto DmsCoord, convertendo in gradi/minuti/secondi
function DecCoord:toDms()
local deg, min, sec
deg = round(self.deg * 3600, 2)
sec = round(math.floor(deg) % 60 + deg - math.floor(deg), 2)
deg = math.floor((deg - sec) / 60)
min = deg % 60
deg = math.floor((deg - min) / 60) % 360
return DmsCoord:new(deg, min, sec, self.card)
end
-- Costruttore di DmsCoord
-- deg: gradi
-- min: minuti, può essere nil
-- sec: secondi, può essere nil
-- card: direzione cardinale (N|S|E|W)
function DmsCoord:new(deg, min, sec, card)
local self = {}
setmetatable (self, { __index = DmsCoord,
__tostring = function(t) return self:__tostring() end,
__concat = function(t, t2) return tostring(t) .. tostring(t2) end })
self.deg = tonumber(deg)
self.min = min and tonumber(min)
self.sec = sec and tonumber(sec)
self.card = card
return self
end
-- Richiamata automaticamente ogni volta che è richiesto un tostring o un concatenamento
function DmsCoord:__tostring()
return self.deg .. '°' ..
(self.min and (padleft0(self.min) .. '′') or '') ..
(self.sec and (padleft0(self.sec) .. '″') or '') ..
self.card
end
-- Ritorna un nuovo oggetto DecCoord, convertendo in gradi decimali
function DmsCoord:toDec()
local deg = round((self.deg + ((self.min or 0) + (self.sec or 0) / 60) / 60), 6)
return DecCoord:new(deg, self.card)
end
-------------------------------------------------------------------------------
-- classe Coord
-------------------------------------------------------------------------------
local Coord = {}
function Coord:new(args)
local decLat, decLong, dmsLat, dmsLong
local self = { args = args }
setmetatable(self, { __index = Coord })
-- nel namespace principale e con display=title (o con il parametro "prop")
-- legge le coordinate da P625 per utilizzarle o per confrontarle con quelle inserite
if mw.title.getCurrentTitle().namespace == 0 and (getDisplay(self.args).title or self.args.prop) then
self:_checkWikidata()
end
-- identifica il tipo di chiamata
self:_checkRequestFormat()
-- in base al tipo di chiamata crea gli oggetti DecCoord o DmsCoord
if self.reqFormat == 'dec' then
-- {{coord|1.111|2.222}}
decLat = DecCoord:new(args[1], 'N')
decLong = DecCoord:new(args[2], 'E')
elseif self.reqFormat == 'd' then
-- {{coord|1.111|N|3.333|W}}
decLat = DecCoord:new(args[1], args[2])
decLong = DecCoord:new(args[3], args[4])
elseif self.reqFormat == 'dm' then
-- {{coord|1|2|N|4|5|W}}
dmsLat = DmsCoord:new(args[1], args[2], nil, args[3])
dmsLong = DmsCoord:new(args[4], args[5], nil, args[6])
elseif self.reqFormat == 'dms' then
-- {{coord|1|2|3|N|5|6|7|W}}
dmsLat = DmsCoord:new(args[1], args[2], args[3], args[4])
dmsLong = DmsCoord:new(args[5], args[6], args[7], args[8])
end
-- effettua le conversioni dec <=> dms
if self.reqFormat == 'dec' or self.reqFormat == 'd' then
dmsLat = decLat:toDms()
dmsLong = decLong:toDms()
-- rimuove secondi e minuti se zero e presenti in lat e long
if dmsLat.sec == 0 and dmsLong.sec == 0 then
dmsLat.sec, dmsLong.sec = nil, nil
if dmsLat.min == 0 and dmsLong.min == 0 then
dmsLat.min, dmsLong.min = nil, nil
end
end
elseif self.reqFormat == 'dm' or self.reqFormat == 'dms' then
decLat = dmsLat:toDec()
decLong = dmsLong:toDec()
end
-- se presente args.catuguali e non è stato usato Wikidata verifica se uguali
if args.catuguali and self.wdLat and self.wdLong and
self.wdCat == nil and
self.wdLat == round(decLat:getDeg(), 6) and
self.wdLong == round(decLong:getDeg(), 6) then
self.wdCat = '[[Categoria:Coordinate uguali a Wikidata]]'
end
self.decLat = decLat
self.decLong = decLong
self.dmsLat = dmsLat
self.dmsLong = dmsLong
return self
end
-- Legge la P625 e la utilizza come latitudine e longitudine se non fornite dall'utente.
function Coord:_checkWikidata()
if self.args.prop then
self.wdLat = mWikidata._getQualifier({ self.args.prop, 'P625', coord = 'latitude', n = 1, nq = 1 })
self.wdLong = mWikidata._getQualifier({ self.args.prop, 'P625', coord = 'longitude', n = 1, nq = 1 })
else
self.wdLat = mWikidata._getProperty({ 'P625', coord = 'latitude', n = 1 })
self.wdLong = mWikidata._getProperty({ 'P625', coord = 'longitude', n = 1 })
end
if self.wdLat and self.wdLong then
self.wdLat = round(self.wdLat, 6)
self.wdLong = round(self.wdLong, 6)
-- se l'utente non ha fornito lat e long usa quelli di Wikidata
if #self.args == 0 or (#self.args == 1 and not tonumber(self.args[1])) then
table.insert(self.args, 1, numberToString(self.wdLat))
table.insert(self.args, 2, numberToString(self.wdLong))
self.wdCat = '[[Categoria:Coordinate lette da Wikidata]]'
end
else
self.wdCat = '[[Categoria:Coordinate assenti su Wikidata]]'
end
end
-- Riconosce il tipo di richiesta: dec, d, dm o dms.
function Coord:_checkRequestFormat()
local currFormat, globe, earth, prefix, num, str
local param = {}
local errorTable = {}
-- riconoscimento tipo di richiesta
if #self.args < 2 then
error('* coordinate non specificate', 4)
elseif #self.args < 4 then
self.reqFormat = 'dec'
elseif #self.args < 6 then
self.reqFormat = 'd'
elseif #self.args < 8 then
self.reqFormat = 'dm'
elseif #self.args < 10 then
self.reqFormat = 'dms'
else
error('* errato numero di parametri', 4)
end
-- con le richieste dm e dms verifica se ci sono parametri lasciati vuoti in modo valido.
if self.reqFormat == 'dms' then
-- {{coord|1|2||N|5|6||E}} valido
if self.args[3] == '' and self.args[7] == '' then
table.remove(self.args, 7)
table.remove(self.args, 3)
self.reqFormat = 'dm'
-- {{coord|1|2|3|N|5|6||E}} non valido
elseif self.args[3] == '' or self.args[7] == '' then
error('* lat e long hanno diversa precisione', 4)
-- {{coord|1||3|N|5||7|E}} valido
elseif self.args[2] == '' and self.args[6] == '' then
self.args[2], self.args[6] = 0, 0
-- {{coord|1|2|3|N|5||7|E}} non valido
elseif self.args[2] == '' or self.args[6] == '' then
error('* lat e long hanno diversa precisione', 4)
end
end
if self.reqFormat == 'dm' then
-- {{coord|1||N|4||E}} valido
if self.args[2] == '' and self.args[5] == '' then
table.remove(self.args, 5)
table.remove(self.args, 2)
self.reqFormat = 'd'
-- {{coord|1|2|N|4||E}} non valido
elseif self.args[2] == '' or self.args[5] == '' then
error('* lat e long hanno diversa precisione', 4)
end
end
-- validazione parametri posizionali
currFormat = cfg.params[self.reqFormat]
globe = self.args[#self.args]:match('globe:(%w+)')
earth = not globe or globe == 'earth'
for k, v in ipairs(self.args) do
if currFormat[k] then
param.type = currFormat[k][1]
param.name = currFormat[k][2]
param.min = currFormat[k][3]
param.max = currFormat[k][4]
prefix = self.reqFormat .. ' format: ' .. param.name
-- valida un parametro di tipo numero
if param.type == 'number' then
num = tonumber(v)
if num then
if earth and num < param.min then
dumpError(errorTable, prefix, ' < ', param.min)
elseif earth and math.floor(num) > param.max then
dumpError(errorTable, prefix, ' > ', param.max)
end
else
dumpError(errorTable, prefix, ' non è un numero')
end
-- valida un parametro di tipo stringa
elseif param.type == 'string' then
if v ~= param.min and v ~= param.max then
dumpError(errorTable, prefix, ' diverso da ', param.min, ' e da ', param.max)
end
end
end
end
if #errorTable > 0 then
error(table.concat(errorTable), 4)
end
end
-- Utilizza l'estensione [[mw:Extension:GeoData]]
function Coord:_setGeoData(display)
local gdStr = string.format('{{#coordinates:%s|%s|name=%s}}',
table.concat(self.args, '|'),
(display.title and mw.title.getCurrentTitle().namespace == 0) and 'primary' or '',
self.args.name or '')
return mw.getCurrentFrame():preprocess(gdStr)
end
-- Funzione di debug
function Coord:getDebugCoords()
return self.decLat .. ' ' .. self.decLong .. ' ' .. self.dmsLat .. ' ' .. self.dmsLong
end
-- Crea l'HTML contenente le coordinate in formato dec e dms come collegamento esterno a geohack.php.
function Coord:getHTML()
local defaultFormat, geohackParams, display, root, html, url, htmlTitle
-- legge il parametro display
display = getDisplay(self.args)
if self.args.format then
defaultFormat = self.args.format
elseif self.reqFormat == 'dec' then
defaultFormat = 'dec'
else
defaultFormat = 'dms'
end
-- crea la stringa per il parametro params di geohack.php
if self.reqFormat == 'dec' then
geohackParams = string.format('%s_N_%s_E', self.args[1], self.args[2])
if self.args[3] then
geohackParams = geohackParams .. '_' .. self.args[3]
end
else
-- concatena solo i posizionali
geohackParams = table.concat(self.args, '_')
end
-- geohack url e parametri
url = string.format('%s&pagename=%s¶ms=%s', cfg.geohackUrl,
mw.uri.encode(mw.title.getCurrentTitle().prefixedText, 'WIKI'), geohackParams)
if self.args.name then
url = url .. '&title=' .. mw.uri.encode(self.args.name)
end
root = mw.html.create('')
root
:tag('span')
:addClass('plainlinks nourlexpansion')
:wikitext('[' .. url)
:tag('span')
:addClass(defaultFormat == 'dec' and 'geo-nondefault' or 'geo-default')
:tag('span')
:addClass('geo-dms')
:attr('title', 'Mappe, foto aeree e altri dati per questa posizione')
:tag('span')
:addClass('latitude')
:wikitext(tostring(self.dmsLat))
:done()
:wikitext(' ')
:tag('span')
:addClass('longitude')
:wikitext(tostring(self.dmsLong))
:done()
:done()
:done()
:tag('span')
:addClass('geo-multi-punct')
:wikitext(' / ')
:done()
:tag('span')
:addClass(defaultFormat == 'dec' and 'geo-default' or 'geo-nondefault')
:wikitext(self.args.name and '<span class="vcard">' or '')
:tag('span')
:addClass('geo-dec')
:attr('title', 'Mappe, foto aeree e altri dati per questa posizione')
:wikitext(self.decLat .. ' ' .. self.decLong)
:done()
:tag('span')
:attr('style', 'display:none')
:tag('span')
:addClass('geo')
:wikitext(self.decLat:getDeg() .. '; ' .. self.decLong:getDeg())
:done()
:done()
:wikitext(self.args.name and ('<span style="display:none"> (<span class="fn org">' ..
self.args.name .. '</span>)</span></span>') or '')
:done()
:wikitext(']')
:done()
html = tostring(root) .. (self.args.notes or '')
-- formatta il risultato a seconda di args.display (nil, 'inline', 'title', 'inline,title')
-- se inline e title, in stampa visualizza solo il primo
htmlTitle = string.format('<span style="font-size: small"><span %s id="coordinates">[[Coordinate geografiche|Coordinate]]: %s</span></span>',
display.inline and 'class="noprint"' or '', html)
return (display.inline and html or '') ..
(display.title and htmlTitle or '') ..
self:_setGeoData(display) ..
(self.wdCat or '')
end
-- standardizzo i simboli del formato dms ossia: '°', "'", '"', ' '
local function normalizedms(coordinate)
if isempty(coordinate) then return '' end
local pattern = {
{'[‘’′]', "'"}, --standardizzo i primi
--standardizzo i secondi
{'[“”″]', '"'},
{"''", '"'},
{'−', '-'}, --standardizzo il meno
{'[_/\t\n\r]', ' '}, --converto eventuali spaziature speciali in semplici spazi
--formatto simboli e spazi
{'°', '° '},
{"'", "' "},
{'"', '" '},
--formatto punti cardinali e spazi
{'N', ' N'},
{'S', ' S'},
{'W', ' W'},
{'E', ' E'}
}
for _, ptrn in ipairs(pattern) do
coordinate = mw.ustring.gsub( coordinate, ptrn[1], ptrn[2])
end
--elimino gli spazi di troppo
coordinate = mw.ustring.gsub( mw.text.trim(coordinate), "%s+", ' ')
return coordinate
end
-- Divido le singole parti che compongono un dms
local function dividedms(coordinate)
if isempty(coordinate) then return '' end
coordinate = string.gsub( coordinate, "%s+", '')
coordinate = string.gsub( coordinate, "^%+", '')
local deg, min, sec, card = string.match(coordinate, "^(.+)°(.+)'(.+)\"([NSWE])$")
if deg == nil then
deg, min, card = string.match(coordinate, "^(.+)°(.+)'([NSWE])$")
if deg == nil then
deg, sec, card = string.match(coordinate, "^(.+)°(.+)\"([NSWE])$")
if deg == nil then
deg, card = string.match(coordinate, "^(.+)°([NSWE])$")
end
end
end
if card == nil or deg == nil or tonumber(deg) == nil then
return
end
if min ~= nil and tonumber(min) == nil then
return
end
--if true then return mw.text.jsonEncode( { deg, min, sec, card }, mw.text.JSON_PRETTY ) end
if sec ~= nil and tonumber(sec) == nil then
return
end
return { deg, sec or '0', min or '0', card }
end
-------------------------------------------------------------------------------
-- API
-------------------------------------------------------------------------------
local p = {}
-- Per l'utilizzo da un altro modulo
function p._main(args)
local coord = Coord:new(args)
return args.display == 'debug' and coord:getDebugCoords() or coord:getHTML()
end
-- Entry-point per eventuale {{dms2dec}}
function p.dms2dec(frame)
local args = frame.args
-- {{dms2dec|N|2|3|4}}
return DmsCoord:new(args[2], args[3], args[4], args[1]):toDec():getDeg()
end
-- Entry-point per eventuale {{dec2dms}}
function p.dec2dms(frame)
local args = frame.args
-- {{dec2dms|1.111|N|S}}
return DecCoord:new(args[1], tonumber(args[1]) >= 0 and args[2] or args[3]):toDms()
end
-- Entry-point per {{Coord}}
function p.main(frame)
return select(2, xpcall(function()
return p._main(getArgs(frame))
end, errhandler))
end
-- Divido le singole parti che compongono una coppia di coordinate dms
function p.dividedmscoords(frame)
local args = frame.args
local coordinate = args[1] or ''
coordinate = mw.ustring.gsub(coordinate, "%s+", '')
local coordArray = {}
local coordArrayApp = {}
local pos = mw.ustring.find( coordinate, '[NS]' )
if( isempty(pos) ) then
return nil, nil, nil, nil
end
frame.args[1] = mw.ustring.sub(coordinate, 1, pos)
coordArray = p.dividedms(frame)
frame.args[1] = mw.ustring.sub(coordinate, pos+1, mw.ustring.len(coordinate))
for k, v in ipairs( p.dividedms(frame) ) do
coordArray[k+4] = v
end
return coordArray
end
-- converte coppia di coordinate dms con sintassi non standard in decimali
function p.anydmscoords2dec(frame)
frame.args[1] = p.normalizedms(frame)
local coordArray = p.dividedmscoords(frame)
if( isempty(coordArray) or isempty(coordArray[1]) or isempty(coordArray[5]) ) then
-- TO DO andrebbe inserito il controllo se le coordinate sono già in formato decimale
return nil
end
local dmsLat = DmsCoord:new(coordArray[1], coordArray[2], coordArray[3], coordArray[4]):toDec():getDeg()
if( not isempty(dmsLat) ) then
dmsLat = round(dmsLat, frame.args['prec'])
end
local dmsLong = DmsCoord:new(coordArray[5], coordArray[6], coordArray[7], coordArray[8]):toDec():getDeg()
if( not isempty(dmsLong) ) then
dmsLong = round(dmsLong, frame.args['prec'])
end
return dmsLat .. ', ' .. dmsLong
end
-- converte coordinate dms con sintassi non standard in decimali
function p.anydms2dec(frame)
if frame.args[1] == nil then return '' end
local coord_normalized = normalizedms(frame.args[1])
local prec = (frame.args['prec'] and tonumber(frame.args['prec'])) or 3
--if true then return dividedms(coord_normalized) end
local coordArray = dividedms(coord_normalized)
if coordArray == nil then
--se il numero di input è un numero, assumo che sia una corretta coordinata in formato decimale
local coord_dec = tonumber(frame.args[1])
if coord_dec ~= nil then
return round(coord_dec, prec)
end
return nil
end
return round(DmsCoord:new(coordArray[1], coordArray[2], coordArray[3], coordArray[4]):toDec():getDeg(), prec)
end
return p