Aiuto:Albero delle categorie

Da Memory Alpha.

L'estensione albero delle categorie fornisce una vista dinamica della struttura delle categorie della wiki come albero ramificato. Utilizza l'AJAX per caricare porzioni dell'albero a comando. L'albero delle categorie fu originalmente scritto da Daniel Kinzler con un tool esterno (vedi User: Duesentrieb/CategoryTree su Meta-Wiki). E' stato successivamente integrato nel software MediaWiki con l'aiuto di Tim Starling.

Indice 1 Uso 1.1 Il tag <categorytree> 1.2 La funzione parser {{#categorytree}} 1.3 La pagina speciale: CategoryTree 1.4 Modalità 2 Ulteriori informazioni

[modifica] Uso

L'estensione CategoryTree può essere utilizzata in tre modi: direttamente nelle pagine "categoria", come "tag personalizzato" (o "funzione parser") per visualizzare una struttura delle categorie interna su una pagina wiki, e come pagina speciale.

L'estensione CategoryTree aggiunge le funzioni [+] o [×] "espandi" alle sottocategorie elencate sulle pagine categoria, dove [+] indica la presenza di ulteriori sottocategorie e [×] ne indica l'assenza. Se è disattivato Javascript, queste funzioni non avranno effetto.

Nota per gli utilizzatori di bot: bot e macro che analizzano il codice HTML delle pagine categoria possono sfruttare il parametro URL notree per forzare il risultato tradizionale. Tuttavia, il risultato HTML non è generalmente stabile, quindi si raccomanda di cambiare la macro per usare query.php o api.php per ottenere i listati delle categorie.

[modifica] Il tag <categorytree>

Esempio:

<categorytree mode=pages style="float:right; 
clear:right; 
margin-left:1ex; 
border:1px solid gray; 
padding:0.7ex; 
background-color:black;">Memory Alpha immagini</categorytree>

Il tag personalizzato è chiamato <categorytree>. Per esempio, se inserisci <categorytree>Foo</categorytree> su una pagina wiki, sarà visualizzato il contenuto della categoria "Foo" come albero dinamico su quella stessa pagina (vedi l'esempio sulla destra). Il tag accetta i seguenti attributi, usando una sintassi simile all'HTML:

mode

può essere "categories", "pages" o "all" - vedi la sezione Modes che segue per i singoli significati. L'impostazione predefinita per questo attributo è controllata da $wgCategoryTreeDefaultMode, e inizialmente è impostata come CT_MODE_CATEGORIES, equivalente a "categories".

depth

determina il numero di livelli da mostrare inizialmente. L'impostazione predefinita per questo attributo è 1, 0 imposta solo il nodo radice. Il valore massimo dipende dal modo specificato, e dall'opzione $wgCategoryTreeMaxDepth. Nota: i valori di profondità maggiori di 1 non sono (ancora) attivi con $wgCategoryTreeDynamicTag abilitato.

onlyroot

impostato su "on" per visualizzare inizialmente solo il nodo "radice" dell'albero. Equivale a depth="0".

hideroot

impostato su "on" nasconde il nodo "radice" dell'albero, ad esempio la menzione della categoria "Foo" dall'esempio.

style

può essere usato per specificare ogni stile CSS desiderato per la visualizzazione dell'albero.

[modifica] La funzione parser {{#categorytree}}

Puoi anche usare la sintassi della funzione parser per inserire un albero delle categorie su una pagina. Questo funziona proprio come il tag <categorytree>, utilizzando una sintassi diversa, ad es. {{#categorytree:Foo}}; le opzioni possono essere specificate utilizzando la sintassi per i parametri dei template, come ad es. {{#categorytree:Foo|hideroot|mode=pages}}.

Usando la sintassi delle funzioni parser, si ha il vantaggio di poter utilizzare le parole magiche, i template ed i parametri dei template per specificare la categoria da visualizzare.

Alcuni esempi:

• Usando una variabile "magica" per visualizzare l'albero delle categorie di "questa pagina" (potrebbe essere utile nelle pagine di descrizione delle categorie): {{#categorytree:{{PAGENAME}}}}.
• Usando un template per specificare la categoria: {{#categorytree:{{root category}}}} - il nome della radice della categoria dovrà essere definito dal contenuto del Template:Root_category.
• Usando un parametro di template per specificare la categoria, quando si usa CategoryTree all'interno di un template: {{#categorytree:{{{1}}}}} nel Template:Baz ad es., può essere richiamato usando {{Baz|Foo}}

[modifica] La pagina speciale: CategoryTree

La pagina speciale viene chiamata Special: CategoryTree; dove puoi inserire il nome di una categoria e quindi esplorarne i contenuti. L'estensione CategoryTree inoltre aggiunge una etichetta per questa pagina speciale ad ogni pagina categoria.

[modifica] Modalità

L'albero delle categorie può essere visualizzato in differenti modi, determinando quale tipo di "rami" possono essere mostrati:

• categories (constant CT_MODE_CATEGORIES): visualizza solo le sottocategorie;
• pages (constant CT_MODE_PAGES): visualizza le sottocategorie e le pagine, eccetto le immagini;
• all (constant CT_MODE_ALL): visualizza tutte le pagine, sottocategorie, immagini, ecc.

[modifica] Ulteriori informazioni

Per altre informazioni sull'estensione CategoryTree, vedi Extension: CategoryTree su MediaWiki.