Modulo:VociRecenti/man

Il modulo legge la cache generata dal bot e restituisce una lista di voci di Wikipedia recenti, filtrate secondo i parametri passati dal template chiamante.

La cache è distribuita su più pagine wiki: Modulo:VociRecenti/Dati1, Dati2, ... DatiN.

Ogni file è un modulo Lua che restituisce una tabella con questa struttura (formato attuale, array posizionale):

return {
  u  = [[DD/MM/YYYY HH:MM]],  -- ultimo aggiornamento
  v  = [[8.30]],              -- versione bot
  p  = 1,                     -- numero parte
  tp = 3,                     -- totale parti
  n  = 1000,                  -- numero voci in questa parte
  d  = {
    {
      [[titolo]],
      [[timestamp_14chr]],          -- es. "20260303041500"
      {[[cat1]], [[cat2]], ...},    -- categorie
      {                             -- template
        {[[NomeTemplate]], {[[param1]], [[param2]]}},
        ...
      },
      [[preview_100chr]],           -- preview del testo (primi 100 caratteri)
      [[move_timestamp]],           -- opzionale: data spostamento da sandbox/bozze
    },
    ...
  }
}

Le stringhe usano long string Lua ([[...]], [=[...]=], ecc.) con livello di escape automatico per evitare problemi con caratteri speciali nel wikitesto. Il modulo riconosce anche il vecchio formato con keyword (titolo=..., timestamp='...', ecc.) per retrocompatibilità.

Funzione principale richiamata dal template. Legge i parametri, carica tutti i file cache (con memoizzazione: i file vengono letti una sola volta per pagina anche in presenza di più template), filtra le voci e restituisce l'output formattato.

I valori del parametro Disp (e DispScroll):

I valori del parametro Order:

I valori del parametro Timestamp:

Tutti i parametri sono case-insensitive: |Disp=, |disp= e |DISP= sono equivalenti.

Funzione di debug: dato un titolo di voce, mostra le sue categorie, i suoi template (con parametri) e verifica se corrisponde a un filtro OrCat o Portali specificato. Esempio di utilizzo:

{{#invoke:VociRecenti|debugVoce|titolo=Nome voce|OrCat=aviatori}}
{{#invoke:VociRecenti|debugVoce|titolo=Nome voce|Portali=sport|NoTemplate=stub}}

La funzione mostra anche informazioni diagnostiche sul bug mw.ustring.find relativo ai template portale (vedi sezione "Problemi noti").

I filtri vengono applicati in sequenza su ogni voce della cache. La modalità di combinazione dipende dal parametro And:

• Modalità OR (default, And=off): basta che almeno uno dei filtri positivi sia soddisfatto. I filtri negativi (NoCat, NoTemplate, DataFine, ExclIfNotCat) sono sempre applicati come veto finale, indipendentemente da And=.
• Modalità AND (And=on): tutti i filtri specificati devono essere soddisfatti simultaneamente.

Se sono presenti solo filtri negativi (es. solo NoCat=), in modalità OR il modulo include tutte le voci che superano il veto, senza richiedere che soddisfino un filtro positivo.

Tutti i parametri filtro supportano i seguenti operatori:

OrCat include la voce se almeno una categoria contiene almeno uno dei termini; AndCat richiede che tutti i gruppi siano soddisfatti; NoCat esclude le voci che hanno almeno uno dei termini. La ricerca è per sottostringa, case-insensitive, salvo uso dei doppi apici per match parola intera.

Text cerca nella preview (primi 100 caratteri della voce); TextRegExp cerca nella preview e in categorie/template concatenati. I pattern per TextRegExp sono in formato Lua (non PCRE); il parametro CaseSensitive=on rende la ricerca sensibile alle maiuscole. I gruppi alternativi nella sintassi (a;b;c) vengono espansi in pattern multipli.

Il parametro ExclIfNotCat agisce sempre come veto finale, indipendentemente dalla modalità And=. Sintassi: X>Y dove > (Shift+.) separa la categoria trigger dalla categoria eccezione. Più regole separate da virgola vengono applicate in AND. Esempio:

ExclIfNotCat=Morti a Parigi>Nati a Parigi

Esclude le voci che hanno la categoria "Morti a Parigi" ma non hanno "Nati a Parigi". Risolve il caso di voci collegate a un argomento solo tramite una categoria "negativa" (es. luogo di morte) senza altri legami positivi.

L'ordinamento viene applicato dopo il filtraggio e prima del troncamento al numero di voci richiesto (num). Con Order=Alpha i caratteri accentati e diacritici vengono normalizzati alla lettera base prima del confronto (à=a, è=e, ecc.), in modo che "Élite" e "elite" siano ordinati come equivalenti.

Se nessuna voce corrisponde ai criteri di filtro, il modulo mostra un messaggio di avviso. Se Timestamp≠off, viene comunque visualizzata la riga di aggiornamento sotto il messaggio. Se la cache non è inizializzata (nessun file Dati presente), viene mostrato un avviso specifico che invita ad eseguire il bot.

Versione corrente: v8.33

Il modulo usa pcall per proteggere il require() di ogni file cache: se un file ha errori di sintassi Lua, viene saltato senza bloccare l'intera esecuzione. I long string Lua nei campi dati possono usare qualsiasi livello di escape — il modulo non deve gestirli esplicitamente perché Lua li interpreta nativamente.