User:Dapete/vCat

Deutsch

vCat ist ein Tool, um Kategorienstrukturen graphisch darzustellen. Es zeichnet mit Hilfe von Graphviz ein Diagramm (in Form eines Baumes), bei dem unten die angegebene Kategorie oder Seite steht und darüber deren Überkategorien.

vCat ist unter https://tools.wmflabs.org/vcat/render direkt ansprechbar und erwartet alle Informationen in URL-Parametern. Diese sind weiter unten dokumentiert.

Beispiel: https://tools.wmflabs.org/vcat/render?wiki=dewiki&category=Deutschland für die Oberkategorien von Kategorie:Deutschland in der deutschen Wikipedia

Weiterführende Links:

• Migration von Catgraph, dem Vorgänger von vCat auf dem Toolserver
• Fonts, Schriftart-Unterstützung verschiedener Schriftsysteme (englisch)
• Quellcode bei GitHub: dapete42/vcat (Java-Code), dapete42/vcat-deployed (Umgebung auf Tool Labs)

Pflichtparameter

Name	Beschreibung	Anmerkungen
wiki	Wiki-Datenbank/Projektname	Beispiele: "dewiki" (deutsche Wikipedia), "enwikisource" (englisches Wikisource) Liste der verfügbaren Werte (englisch, Spalte "dbname")
category	Kategorientitel	Kann mehr als einmal angegeben werden (oder mehrere Kategorientitel, durch "|" getrennt enthalten) um mehrere Seiten als Wurzel des Kategorienbaumes zu verwenden. Kann nicht zusammen mit title benutzt werden.
title	Seitentitel	Falls ns nicht angegeben ist wird der Namensraum automatisch bestimmt. Kann mehr als einmal angegeben werden (oder mehrere Seitentitel, durch "|" getrennt enthalten) um mehrere Seiten als Wurzel des Kategorienbaumes zu verwenden. Kann nicht zusammen mit category benutzt werden.

Weitere Parameter

Name	Beschreibung	Erlaubte Werte	Standardwert	Anmerkungen
ns	Namensraum	eine Namensraum-Nummer		Beispiel: Namensräume der deutschen Wikipedia. Erzwingt für einen angegebenen Seitentitel (title) diesen Namensraum Kann nicht zusammen mit category benutzt werden.
rel	Relation	"category" (zeige Oberkategorien) "subcategory" (zeige Unterkategorien)	"category"	Erstelle einen Kategorienbaum mit den Ober- oder Unterkategorien einer Seite. Letzteres ist nur möglich, wenn die Wurzelknoten Kategorien sind.
depth	maximale Tiefe	eine Zahl		Der Kategorienbaum soll nur die angegebene Zahl an Ebenen umfassen.
limit	maximale Anzahl an Knoten/Blättern	eine Zahl Maximum ist 250, außer für format=gv	250	Die maximale Anzahl wird erreicht, indem die maximale Tiefe automatisch begrenzt wird. Das Maximum ist nötig, da das Rendern von Bildern mit vielen Knoten sehr lange dauert und große Dateien erzeugt. format=gv rendert kein Bild, daher ist in diesem Fall keine Grenze nötig. Nutzer können diese Datei verwenden, um selbst eine Grafikdatei daraus zu erzeugen.
format	Ausgabeformat	"dot" oder "gv" "gif" "pdf" "png" "svg"	"png"	"dot" oder "gv" erzeugt Textdateien im Eingabeformat von Graphviz, die andern Grafikdateien im angegebenen Format. Falls links verwendet wird, werden für "png" und "gif" HTML-Seiten with einer Imagemap (<map>-Element) erzeugt. Siehe unten.
showhidden	Versteckte Kategorien anzeigen	"0" "1"	"0"	Mit __HIDDENCAT__ auf ihrer Beschreibungsseite markierte Kategorien werden normalerweise nicht im Kategorienbaum dargestellt.
algorithm	Graphviz-Algorithmus	"dot" "fdp"	"dot"	Definiert, welches der Graphviz-Kommandozeilenprogramme den Kategorienbaum umsetzt.
links	Links im Kategorienbaum setzen	kein Wert "graph" "wiki"	kein Wert	"graph" erstellt für jeden Artikel/jede Kategorie im Baum einen Link auf einen weiteren Baum, der dort beginnt. "wiki" erstellt Links auf die entsprechenden Seiten im Wiki. Falls format=png oder format=gif verwendet werden, wird eine HTML-Seite with einer Imagemap (<map>-Element) erzeugt. Die Bilder werden dort als data:-URI eingebettet.

Italiano

vCat è uno strumento che rappresenta graficamente la struttura delle categorie. Esso traccia con l'aiuto di Graphviz un diagramma a forma di albero, in cui si trova, nella parte inferiore, la categoria o la pagina scelta, e al di sopra le categorie di livello superiore.

vCat è disponibile direttamente all'indirizzo https://tools.wmflabs.org/vcat/render e richiede informazioni tramite parametri dell'URL. Queste sono spiegate qui sotto.

Ad esempio, https://tools.wmflabs.org/vcat/render?wiki=itwiki&category=Italia mostra le categorie al di sopra di Categoria:Italia sulla Wikipedia in lingua italiana.

Link per approfondimento:

• Migrazione da Catgraph, il predecessore di vCat su Toolserver
• Caratteri, informazioni sul supporto ai caratteri di diversi sistemi di scrittura
• Codice sorgente su GitHub: dapete42/vcat (codice Java); dapete42/vcat-deployed (ambiente su Tool Labs)

Parametri obbligatori

Nome	Descrizione	Note
wiki	Nome del progetto	Esempi: "itwiki" (Wikipedia in italiano), "enwikisource" (Wikisource in inglese) Lista dei valori inseribili (in inglese, nella colonna "dbname")
category	Nome della categoria	Si può inserire più di una volta (o può contenere i nomi di più categorie, separati da "|") per usare più categorie come radice dell'albero delle categorie. Non si può usare insieme a title.
title	Titolo della pagina	Se ns non viene inserito, il namespace viene stabilito automaticamente. Si può inserire più di una volta (o può contenere i titoli di più pagine, separati da "|") per usare più pagine come radice dell'albero delle categorie. Non si può usare insieme a category.

Ulteriori parametri

Nome	Descrizione	Valori accettati	Valore predefinito	Note
ns	Namespace	il numero di un namespace		Esempio: Namespace della Wikipedia in italiano. Forza questo namespace per un titolo di pagina inserito (title). Non si può usare insieme a category.
rel	Relazione	"category" (mostra le categorie superiori) "subcategory" (mostra le sottocategorie)	"category"	Crea un albero delle categorie con le categorie di livello superiore a una categoria o pagina (cioè che la contengono) o con quelle quelle di livello inferiore (cioè le sottocategorie, le categorie contenute in una categoria). Quest'ultima possibilità si ha solo se le radici sono categorie.
depth	Profondità massima	un numero		L'albero delle categorie deve mostrare solo il numero di livelli indicato.
limit	Numero massimo di nodi/foglie	un numero il massimo è 250, tranne per format=gv	250	Il numero massimo viene ottenuto limitando automaticamente la profondità massima. Il numero massimo è necessario perché il rendering di immagini con molti nodi richiede molto tempo e produce file molto grandi. format=gv non crea alcuna immagine, perciò in questo caso non è necessario alcun limite. Gli utenti possono usare questo file per creare da soli un file grafico.
format	Formato di output	"dot" o "gv" "gif" "pdf" "png" "svg"	"png"	"dot" o "gv" crea file di testo nel formato di input di Graphviz, gli altri creano file grafici nel formato indicato. Se si usa links, per "png" e "gif" vengono create pagine HTML con una mappa immagine (elemento <map>). Vedi sotto.
showhidden	Mostra categorie nascoste	"0" "1"	"0"	Le categorie con __HIDDENCAT__ sulla loro pagina di descrizione normalmente non vengono mostrate nell'albero delle categorie.
algorithm	Algoritmo di Graphviz	"dot" "fdp"	"dot"	Definisce quali dei programmi a riga di comando di Graphviz compone l'albero delle categorie.
links	Inserisce link nell'albero delle categorie	nessun valore "graph" "wiki"	nessun valore	"graph" crea per ogni pagina o categoria nell'albero un link a un altro albero, che inizia con quella pagina o categoria. "wiki" crea link alle pagine corrispondenti sul wiki. Se si usano format=png o format=gif, viene creata una pagina HTML con una mappa immagine (elemento <map>). Le immagini vengono incluse come URI data:.