Modulo:Lingue/man: differenze tra le versioni

Versione delle 06:04, 7 lug 2013

Versione attuale delle 18:05, 31 mar 2022

(4 versioni intermedie di 4 utenti non mostrate)

Riga 1:

{{Wikibozza}}

{{Man modulo}}

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

Line 5 ⟶ 4:

== Funzioni ==

=== Per moduli Lua ===

Il modulo rende disponibili alcune funzinifunzioni per altri moduli Lua, per utilizzarle occorre prima caricare il modulo con l'istruzione:

<code><nowiki>local lg = require( "Modulo:LinguaggiLingue" );</nowiki></code>

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

;<code>esiste(''code'')</code>: ritorna <code>true</code> se ''code'' corrisponde a una lingua, altrimenti <code>false</code>

;<code>get_nome(''code'', ''maiuscolo'', ''default'')</code>: 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 <code><nowiki>''</nowiki></code> e il valore di ''code'' originariamente passato.

;<code>get_voce(''code'')</code>: ritorna il nome della voce dedicata alla lingua corrispondente a ''code''. Se il modulo non trova la voce ritorna stringa nulla <code><nowiki>''</nowiki></code>

;<code>lingue(''lista_di_lingue'')</code>: ritorna le lingue corrispondenti a ''lista_di_lingue'' formattate come da template {{tl|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: <code>lg.lingue( {''stringa''} )</code>

Line 23 ⟶ 22:

=== Di documentazione ===

;<code>tabella</code>: richiamata da una pagina wiki con <code><nowiki>{{#Invoke:LinguaggiLingue|tabella}}</nowiki></code> ritorna una tabella di tutti i codici e dei nomi e collegamenti alle pagine deidelle linguaggilingue riconosciutiriconosciute.

== Note tecniche ==

I dati utilizzati sono caricati nel modulo [[modulo:LinguaggiLingue/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 <code>language_config.alias</code> una riga nel formato