Modulo:Lingue

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

Modulo Lua per implementare le funzioni dei template {{Nomelingua}}, {{Lingue}} e templati ad essi collegati e per offrire le medesime funzionalità ad altri moduli Lua senza dover dipendere da chiamate ai medesimi template.

Il modulo rende disponibili alcune funzioni per altri moduli Lua, per utilizzarle occorre prima caricare il modulo con l'istruzione: local lg = require( "Modulo:Lingue" );

Le funzioni saranno disponibili come lg.nomefunzione (lg è solo un nome di esempio, si può scegliere quello che si preferisce purché si richiamino coerentemente le funzioni, per esempio si può usare local lingue = require( "Modulo:Lingue" );, in questo caso le funzioni andranno richiamate come lingua.nomefunzione

esiste(code)

ritorna true se code corrisponde a una lingua, altrimenti false

get_nome(code, maiuscolo, default)

ritorna la coppia nome della lingua corrispondente a code e code normalizzato (per esempio se code è "inglese" ritorna (lingua inglese, en). Se maiuscolo è vero la prima lettera del nome ritornato è maiuscola. Se non trova una lingua corrispondente a code ritorna il valore default se questo è definito, altrimenti ritorna stringa nulla '' e il valore di code originariamente passato.

get_voce(code)

ritorna il nome della voce dedicata alla lingua corrispondente a code. Se il modulo non trova la voce ritorna stringa nulla ''

lingue(lista_di_lingue)

ritorna le lingue corrispondenti a lista_di_lingue formattate come da template {{lingue}}. Se si deve passare una stringa piuttosto che una lista trasformarla in lista, per esempio chiamando la funzione racchiudendo la stringa tra parentesi graffe: lg.lingue( {stringa} )

Il modulo comprende anche funzioni per implementare direttamente alcuni template, a cui si rimanda per la sintassi d'uso:

lingue(frame)

oltre a fare da interfaccia diretta per altri moduli Lua implementa anche il modulo {{Lingue}}

nomecompleto(frame)

implementa le funzionalità di {{nomelingua}}

nome(frame)

implementa le funzionalità di {{nomelingua/nome}}

voce(frame)

implementa le funzionalità di {{nomelingua/voce}}

tabella

richiamata da una pagina wiki con {{#Invoke:Lingue|tabella}} ritorna una tabella di tutti i codici e dei nomi e collegamenti alle pagine delle lingue riconosciute.

I dati utilizzati sono caricati nel modulo modulo:Lingue/Configurazione, che contiene due tabelle, la prima di alias di lingue che associa ad ogni codice riconosciuto per una lingua un codice standard (generalmente il codice ISO_639-3 della lingua). La seconda che associa a ogni codice standard il nome per la lingua e la sua pagina su it.wiki.

Per aggiungere un nuovo alias per una lingua già riconosciuta dal modulo basta aggiungere alla tabella language_config.alias una riga nel formato

    ["alias"] = "codice_standard"',

dove alias è l'alias da inserire e codice_standard è il codice standard che deve essere già inserito nella tabella language_config.codici.

Per inserire una nuova lingua basta aggiungere alla tabella language_config.codici una riga nel formato:

    [ "codice_standard"] = { "nome_lingua", "articolo" },

dove codice_standard è il codice standard usato dal programma (usare in ordine di preferenza codice ISO 639-1 (due lettere) altrimenti il ISO 639-2 (tre lettere), se nessuno dei due esiste usare un altro codice, purchè non sia un codice ISO 639-1 o ISO 639-2 dedicato ad altra lingua), nome lingua il nome della lingua come dev'essere visualizzato a video e articolo il nome dell'articolo di wikipedia dedicato alla lingua. Per inserire codici alternativi per la lingua vedi istruzioni del paragrafo sopra.

Nota bene: i codici e gli alias delle lingue devono essere inseriti in lettere minuscole o non verranno riconosciuti.

local language = {}

-- tabella contenente due tabelle:
-- lg.alias: tabella per normalizzare i codici
-- lg.codici: tabella che dato un codice restituisce un array contente
-- nome della lingua e collegamento all'articolo su it.wiki dedicato alla lingua
local lg = mw.loadData( 'Modulo:Linguaggi/Configurazione' );

local function _get_voce(code)
    if code == nil then return '' end
    local code = mw.ustring.lower(code)
    if lg.alias[code] then code = lg.alias[code] end
    lingua = lg.codici[code]
    if lingua then
        return lingua[2]
    end
    return ''
end

function _get_nome(code, maiuscolo)
    if code == nil then return '' end
    local code = mw.ustring.lower(code)
    if lg.alias[code] then code = lg.alias[code] end
    lingua = lg.codici[code]
    if lingua then
        local nome = lingua[1]
        if maiuscolo then
            nome = mw.ustring.gsub(nome, '^%l', mw.ustring.upper)
        end
        return nome
    end
    return ''
end

function language.voce(frame)
    local code = frame.args[1]
    if code == nil or code == '' then
        return ''
    end
    return _get_voce(code)
end

function language.nome(frame)
    local code = frame.args[1]
    if code == nil or code == '' then
        return ''
    end
    local maiuscolo = false
    if frame.args['M']~=nil and frame.args['M']~='' then
        maiuscolo = true
    end
    return _get_nome(code, maiuscolo)
end

function language.nomecompleto(frame)
    local code = frame.args[1]
    if code == nil or code == '' then
        return ''
    end
    local maiuscolo = false
    if frame.args['M']~=nil and frame.args['M']~='' then
        maiuscolo = true
    end
    local voce = _get_voce(code)
    local nome = _get_nome(code, maiuscolo)
    if nome == "" and voce ~="" then
        if maiuscolo then
            nome = mw.ustring.gsub(voce, '^%l', mw.ustring.upper)
        else
            nome = voce
        end
    end
    if voce == "" then
        return nome
    else
        return table.concat({'[[', voce, "|", nome, "]]"})
    end
end

function language.tabella(frame)
    local HtmlBuilder = require('Module:HtmlBuilder')
    local alias_table = {}
    for alias, code in pairs(lg.alias) do
        if alias_table[code] then
            table.insert(alias_table[code], alias)
        else
            alias_table[code] = {}
        end
    end
    root = HtmlBuilder.create('table')
    root
        .addClass('wikitable')
        .div('tr')
            .tag('th')
                .wikitext('Codici')
                .done()
            .tag('th')
                .wikitext('Nome')
                .done()
            .tag('th')
                .wikitext('Voce')
                .done()

    for code, value in pairs(lg.codici) do
        if alias_table[code] then
            code = code .. ", " table.concat(alias_table[code], ", ")
        end
        local nome, voce = unpack(value)
        if voce ~= '' then voce = '[[' .. voce .. ']]' end
        root
            .div('tr')
                .div('td')
                    .wikitext(code)
                    .done()
                .div('td')
                    .wikitext(nome)
                    .done()
                .div('td')
                    .wikitext(voce)
    end
    return tostring(root)
end


return language