Modulo:Software

Istruzioni per l'uso
Questo è un modulo scritto in Lua. Le istruzioni che seguono sono contenute nella sottopagina Modulo:Software/man (modifica · cronologia)
Sandbox: Modulo:Software/sandbox (modifica · cronologia) · Sottopagine: lista · Test: Modulo:Software/test (modifica · cronologia · Esegui)

Modulo Lua per integrare le informazioni espresse nel Template:Software con le informazioni provenienti da Wikidata.

Se alcuni linguaggi sono assenti è un problema di configurazione.

In seguito l'uso di alcune sotto-funzioni.

{{#invoke:Software|isFreeSoftware}}

Valori di ritorno:

1. sì: è software libero
2. no: è software proprietario
3. nil: nessuna informazione per determinarlo

A livello implementativo questa funzione cerca di uniformare alcune delle molte modalità con cui si può esprimere questa informazione in Wikidata.

Per quanto riguarda essere software libero:

1. Il template {{Software}} ha SoftwareLibero=sì?
2. La voce è istanza di (P31) software libero (Q341) / software open-source (Q1130645)?
3. Fra le licenze di questa voce espresse in licenza (P275) ce n'è una istanza di (P31) di licenza di software libero (Q3943414)? (funzione parser dispendiosa, vedi #Albero licenze Wikidata)

Per quanto riguarda essere software proprietario:

1. Il template {{Software}} ha SoftwareLibero=no?
2. La voce è istanza di (P31) software proprietario (Q218616) / freeware (Q178285)?
3. Fra le licenze di questa voce espresse in licenza (P275) ce n'è una sottoclasse di (P279) di licenza proprietaria (Q3238057)? (funzione parser dispendiosa, vedi #Albero licenze Wikidata)

{{#invoke:Software|specifiesALanguage}}

1. sì: vi sono linguaggi espressi da Wikidata o specificati da {{Software|Linguaggio}}
2. no: in caso contrario

{{#invoke:Software|shouldHaveALanguage}}

Valori di ritorno:

1. sì: questa voce dovrebbe (o potrebbe) mostrare l'etichetta dei linguaggi di programmazione. Vale per i software liberi o se vi sono linguaggi specificati.
2. no: la voce non dovrebbe (o non potrebbe) mostrare l'etichetta dei linguaggi di programmazione. Capita per software proprietario senza linguaggi noti.

TODO

Da novembre 2018 questa funzione è inutilizzata e potrebbe essere rimossa.

{{#invoke:Software|languages}}

Stampa i linguaggi di programmazione unendo i valori dal template con i valori da Wikidata dalla proprietà linguaggio di programmazione (P277) e categorizzando:

Categoria:Software libero senza linguaggio

La voce dovrebbe mostrare linguaggi perché è un software libero, ma non lo fa.

Categoria:P277 uguale su Wikidata

I linguaggi specificati nel template sono presenti identici in Wikidata.

Categoria:P277 letta da Wikidata

Il template mostra linguaggi esclusivamente grazie a Wikidata.

Categoria:P277 differente su Wikidata

Il template ha linguaggi che Wikidata non ha (o viceversa).

Categoria:P277 assente su Wikidata

Il template ha linguaggi, Wikidata no.

Categoria:Linguaggio di programmazione da Wikidata non previsto

Capita quando in Wikidata c'è un linguaggio assente nella configurazione.

{{#invoke:Software|languageCategories}}

Categorizza la voce in base ai suoi linguaggi di programmazione espressi in Wikidata (usata internamente in #languages).

{{#invoke:Software|licenseCategories}}

Categorizza la voce in base alle licenze con cui è distribuito il software.

Ricostruzione dell'albero inverso delle licenze presenti in Wikidata:

Lo stesso argomento in dettaglio: Modulo:Software/Configurazione.

Per cambiare il modo in cui è mostrato un linguaggio o una licenza, prova a guardare in Wikidata tale linguaggio o tale licenza. Considera anche che se il nome in Wikidata è troppo lungo, è scelto il nome in breve (P1813).

Per aggiungere una categoria di un linguaggio, o una licenza, vedi Modulo:Software/Configurazione.

Se il template {{Software}} ha l'errore «non in lista» significa che:

• Potrebbe essere un errore di battitura, si veda quella lista.
• Se non è un errore di battitura ma manca un linguaggio rilevante, vedere Modulo:Software/Configurazione.

• Template:Categoria software

local mWikidata = require('Modulo:Wikidata')
local getArgs = require('Module:Arguments').getArgs
local conf = mw.loadData('Modulo:Software/Configurazione')

local p = {}

--[[
* La voce è software libero?
*
* @return true|false|nil
]]
function p._isFreeSoftware(frame)
	local args = frame and getArgs(frame)
	local localIsFreeSoftware = args['SoftwareLibero']
	if localIsFreeSoftware then
		local yep = {['sì'] = true, ['si'] = true, ['no'] = false}
		localIsFreeSoftware = mw.ustring.lower(localIsFreeSoftware)
		localIsFreeSoftware = yep[localIsFreeSoftware]
	end
	local wikidataIsFreeSoftware = mWikidata._instanceOf('Q341')
	return localIsFreeSoftware or wikidataIsFreeSoftware
end

function p._specifiesALanguage(frame)
	local args = frame and getArgs(frame)
	return args['Linguaggio'] or mWikidata._getClaims('P277')
end

return p