Modulo:Lingue/man: differenze tra le versioni

Versione delle 14:56, 30 giu 2013

Versione attuale delle 18:05, 31 mar 2022

(6 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 illa 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

Line 38 ⟶ 37:

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

</syntaxhighlight>

dove ''codice_standard'' è il codice standard usato dal programma (normalmenteusare 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, [[ISO_639purchè non sia un codice ISO 639-3]]1 dellao 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 istruziniistruzioni del paragrafo sopra.

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