Modulo:StatsArticoli/man
Questa è la pagina di documentazione per Modulo:StatsArticoli
Questo modulo è stato creato per semplificare ( o evitare del tutto) la gestione delle lunghe concatenazioni di {{PAGESINCATEGORY}}, {{#expr:}} e {{formatNum:}} nelle tabelle che riassumono gli articoli e i loro livelli su Wikivoyage. Un esempio lo trovate su questa pagina.
Funzioni
[modifica]- totalDestinations
- Scopo: Calcola il numero totale di articoli relativi alle destinazioni (vedi Modelli articoli e gerarchia geografica) , considerando tutti i livelli.
- Utilizzo:
{{#invoke:StatsArticoli|totalDestinations}}: 8 624 - Ritorna: Il numero totale di articoli sulle destinazioni, formattato come numero.
- totalDestinationsByLevel
- Scopo: Calcola il numero totale di articoli relativi alle destinazioni per un specifico livello.
- Parametri:
- livello (stringa): Il livello degli articoli da contare (es. "Abbozzi", "Articoli usabili").
- Utilizzo:
{{#invoke:StatsArticoli|totalDestinationsByLevel|livello=Guide}}: 415 - Ritorna: Il numero totale di articoli sulle destinazioni per il livello specificato, formattato come numero.
- totalThematicArticles
- Scopo: Calcola il numero totale di articoli tematici, con trattamento speciale per "Frasari" e "Tematiche turistiche" a causa della nomenclatura delle categorie non consistente.
- Utilizzo:
{{#invoke:StatsArticoli|totalThematicArticles}}: 967 - Ritorna: Il numero totale di articoli tematici, formattato come numero.
- totalThematicArticlesByLevel
- Scopo: Calcola il numero totale di articoli tematici per un specifico livello.
- Parametri:
- livello (stringa): Il livello degli articoli da contare.
- Utilizzo:
{{#invoke:StatsArticoli|totalThematicArticlesByLevel|livello=Guide}}: 37 - Ritorna: Il numero totale di articoli tematici per il livello specificato, formattato come numero.
- percentagePerArticleType
- Scopo: Calcola la percentuale di articoli di un determinato tipo e livello all'interno della loro categoria principale. Può essere usato in combinazine con template come {{BarraMultiCol}}.
- Parametri:
- tipo (stringa): Il tipo degli articoli (es. "Città").
- livello (stringa): Il livello degli articoli (es. "Abbozzi").
- parent (stringa, opzionale): La categoria principale, se diversa dal tipo di articolo.
- Utilizzo:
{{#invoke:StatsArticoli|percentagePerArticleType|tipo=Città|livello=Abbozzi}}: 71.793 - Ritorna: La percentuale di articoli del tipo e livello specificati all'interno della loro categoria principale, formattata come numero decimale.
- percentageByTypeAndLevel
- Scopo: Calcola la percentuale di articoli di un determinato tipo e livello rispetto al totale degli articoli, sia per le destinazioni che per gli articoli tematici.
- Parametri:
- tipo (stringa): Specifica il tipo di articoli per cui calcolare la percentuale. Deve essere "destinazioni" per gli articoli relativi a luoghi geografici o "tematiche" per gli articoli tematici.
- livello (stringa): Il livello degli articoli per cui calcolare la percentuale (es. "Abbozzi", "Articoli usabili").
- Utilizzo:
{{#invoke:StatsArticoli|percentageByTypeAndLevel|tipo=destinazioni|livello=Abbozzi}}per calcolare la percentuale di articoli di tipo "destinazioni" al livello "Abbozzi" (75.383%). - Ritorna: La percentuale di articoli del tipo e livello specificati, formattata come numero decimale con tre cifre dopo il punto.
- Note: È importante specificare correttamente i parametri 'tipo' e 'livello' per evitare errori. La funzione restituirà un messaggio di errore se i parametri non sono validi o se il tipo specificato non è tra quelli ammessi ("destinazioni" o "tematiche").
- totalDisambiguation
- Scopo: Calcola il numero totale di pagine di disambiguazione.
- Utilizzo:
{{#invoke:StatsArticoli|totalDisambiguation}}(2 520) - Ritorna: Il numero totale di pagine di disambiguazione, formattato come numero.
- totalPortals
- Scopo: Calcola il numero totale di portali.
- Utilizzo:
{{#invoke:StatsArticoli|totalPortals}}(22) - Ritorna: Il numero totale di portali, formattato come numero.
- totalUNESCO
- Scopo: Calcola il numero totale di pagine nella categoria "Liste dei patrimoni mondiali dell'umanità".
- Utilizzo:
{{#invoke:StatsArticoli|totalUNESCO}}(169) - Ritorna: Il numero totale di pagine nella categoria specificata, formattato come numero.
- grandTotal
- Scopo: Calcola il numero totale di articoli, includendo destinazioni, articoli tematici, pagine di disambiguazione, portali e liste UNESCO.
- Utilizzo:
{{#invoke:StatsArticoli|grandTotal}}(12 302) - Ritorna: Il numero totale di articoli calcolato, formattato come numero.
- totalUncategorized
- Scopo: Calcola il numero totale di articoli non categorizzati, sottraendo il totale calcolato da `grandTotal` dal numero totale di articoli nel sito.
- Utilizzo:
{{#invoke:StatsArticoli|totalUncategorized}}(4) - Ritorna: Il numero totale di articoli non categorizzati, formattato come numero.
Esempi per il Debug
[modifica]Mentre si lavora ai Moduli Lua è possible fare dei test senza dover salvare o utilizzare il modulo su altre pagine del progetto. Lo strumento da usare in questi casi è l'estensione di debug. Qui alcuni esempi:
- Articoli tematici totali per tipo:
=p.totalThematicArticlesByLevel(mw.getCurrentFrame():newChild{title="Module:StatsArticoli",args={livello="Articoli usabili"}}) - Percentuale per tipo di articolo:
=p.percentagePerArticleType(mw.getCurrentFrame():newChild{title="Module:StatsArticoli",args={tipo="Città", livello="Abbozzi"}}) - Percentuale per tipo e livello:
=p.percentageByTypeAndLevel(mw.getCurrentFrame():newChild{title="Module:StatsArticoli",args={livello="Articoli usabili", tipo="tematiche"}})