Modulo:Categoria principale/man
Questa è la pagina di documentazione per Modulo:Categoria principale
Questo è il Modulo:Categoria principale ed implementa il template {{Categoria principale}} che ricava la categoria principale di una pagina ottenendola dalla proprietà Wikidata categoria principale dell'argomento (P910).
Ad esempio la categoria principale per la voce software libero (Q341) è: Categoria:Software libero.
Uso
[modifica wikitesto]Se si ha intenzione di aggiungere automaticamente la categoria principale a tutte le voci che usano un certo sinottico, si può usare il {{Categoria principale}} direttamente in testa al sinottico.
Nel caso in cui tale template sinottico in questione usasse un modulo, per maggiore efficienza allora è meglio adottare questa soluzione direttamente nel modulo di tale sinottico:
local wikitestoCategoriaPrincipale = require('Modulo:Categoria principale')._main()
Documentazione
[modifica wikitesto]Metodi forniti dal modulo:
- _main(from)
- Per ottenere il wikitesto pronto da inserire in una pagina per categorizzarla (sempre se ha una categoria principale). Ritorna sempre una stringa, al massimo vuota.
- _hasMainCategory(from)
- Per sapere se la voce ha una categoria principale. Ritorna
true
ofalse
. - _getMainCategory(from)
- Per ottenere il nome della categoria senza wikitesto sotto forma di
Categoria:...
oppurenil
se assente.
Tutti questi metodi supportano il parametro from
che è opzionale. Se specificato è una funzione dispendiosa.