User:Dapete/vCat
Deutsch
[edit]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://vcat.toolforge.org/render direkt ansprechbar und erwartet alle Informationen in URL-Parametern. Diese sind weiter unten dokumentiert.
Beispiel: https://vcat.toolforge.org/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)
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.
|
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 NamensraumKann 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.
|
English
[edit]vCat is a tool to graphically display category structures. Using Graphviz, it creates a diagram (in tree form) with a specified category or page at the bottom and its supercategories above.
vCat can be reached directly at https://vcat.toolforge.org/render and needs all information as URL parameters. These are documented below.
Example: https://vcat.toolforge.org/render?wiki=dewiki&category=Deutschland for categories of Kategorie:Deutschland (category for Germany) in German Wikipedia
Links:
- Migration from Catgraph, vCat's predecessor on the Toolserver
- Fonts, font support for various writing systems
- Source code on GitHub: dapete42/vcat (Java code), dapete42/vcat-deployed (environment on Tool Labs)
Name | Description | Remarks |
---|---|---|
wiki | Wiki database/project name | Examples: "dewiki" (German Wikipedia), "enwikisource" (English Wikisource) List of available values ("dbname" column) |
category | Category title | Can be specified more than once (or contain several category titles separated by "|") to have multiple pages as roots for the graph. Cannot be used with title .
|
title | Page title | If ns is not specified, the namespace is automatically determined from the page title.Can be specified more than once (or contain several page titles separated by "|") to have multiple pages as roots for the graph. Cannot be used with category .
|
Name | Description | Allowed values | Default value | Remarks |
---|---|---|---|---|
ns | Namespace | a namespace number | Example: namespaces on English Wikipedia. Forces the namespace for the title specified to this namespace.Cannot be used with category .
| |
rel | Relation | "category" (show categories) "subcategory" (show subcategories) |
"category" | Shows a graph of a category's or article's categories, or of a category's subcategories. The latter can only be used if the roots of the graph are categories. |
depth | Maximum depth | a number | The graph will only go down the given number of levels. | |
limit | Maximum number of nodes/leaves | a number maximum is 250, except for format=gv
|
250 | The maximum number is achieved by automatically limiting the depth. The limit is enforced because rendering images with many nodes takes a long time and produces huge files. format=gv does not actually render an image, so the limit is not necessary. Users can then take this file and render an image from it themselves.
|
format | Output format | "dot" or "gv" "gif" "pdf" "png" "svg" |
"png" | "dot" or "gv" creates a text file in Graphviz' input format, the others create images in the specified format. If links is used, creates HTML pages with an image map (<map> element) for "png" and "gif". See below.
|
showhidden | Show hidden categories | "0" "1" |
"0" | Categories marked with __HIDDENCAT__ on their description page are normally not included in the graph.
|
algorithm | Graphviz algorithm | "dot" "fdp" |
"dot" | Use the specified Graphviz utility to create the graph. |
links | Include links in graph | no value "graph" "wiki" |
no value | "graph" creates links to a graph starting from each article/category in the graph. "wiki" creates links to the wiki page of each article/category Creates HTML pages with an image map ( <map> element) for format=png and format=gif . The images are embedded in the page as data: URIs.
|
Italiano
[edit]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://vcat.toolforge.org/render e richiede informazioni tramite parametri dell'URL. Queste sono spiegate qui sotto.
Ad esempio, https://vcat.toolforge.org/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)
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 .
|
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: .
|
日本語
[edit]vCatはカテゴリ構造をグラフィカルに視覚化するためのツールです。Graphvizを使用して、指定したカテゴリまたはページを一番下に配置し、その上に一連の上位カテゴリを配した図(ツリー形式)を描画します。
vCatは https://vcat.toolforge.org/render とURLパラメータで、すべての情報に直接アクセスすることができます。以下にこれらの情報を記述します。
例: https://vcat.toolforge.org/render?wiki=dewiki&category=Deutschland - ドイツ語版ウィキペディアのKategorie:Deutschlandというカテゴリの上位カテゴリを図示
関連リンク:
- Catgraphからの移行 - Toolserver上にあるvCatの前身
- フォント - 各種文字フォントへの対応
- GitHub上のソースコード: dapete42/vcat (Javaコード), dapete42/vcat-deployed (Tool Labsの環境)
名称 | 説明 | 注意 |
---|---|---|
wiki | Wikiデータベース/プロジェクト名 | 例: "dewiki" (ドイツ語版ウィキペディア), "enwikisource" (英語版ウィキソース) 利用可能な値の一覧 ("dbname"の列) |
category | カテゴリ名 | 複数のページをツリーのルート(根)とするために、複数回指定する(または "|" で区切られた複数のカテゴリ名を含める)ことができます。title と一緒に使うことはできません。
|
title | ページ名 | ns が指定されていない場合、名前空間はページ名から自動的に決定されます。複数のページをツリーのルート(根)とするために、複数回指定する(または "|" で区切られた複数のページ名を含める)ことができます。 category と一緒に使うことはできません。
|
名称 | 説明 | 指定可能な値 | 既定値 | 注意 |
---|---|---|---|---|
ns | 名前空間 | 名前空間番号 | 例: 日本語版ウィキペディアの名前空間 指定されたページ名 ( title ) に対して、指定した名前空間を強制します。category と一緒に使うことはできません。
| |
rel | 関係 | "category" (上位カテゴリを表示) "subcategory" (下位カテゴリを表示) |
"category" | カテゴリもしくは記事の上位カテゴリ、またはカテゴリのサブカテゴリのカテゴリツリーを表示します。 後者はルートノードがカテゴリの場合のみ使うことができます。 |
depth | 最大深度 | 数字 | 指定したレベル数までのカテゴリツリーしか出力されなくなります。 | |
limit | ノード/リーフの最大数 | 数字 最大値は250 ( format=gv は例外)
|
250 | 最大数は最大深度を自動的に制限することで実���されます。 多数のノードを持つ画像のレンダリングには時間がかかり、巨大なファイルが生成されるため、この制限が強制されます。 format=gv は画像をレンダリングしないので、制限は必要ありません。ユーザーはこのファイルを取得して、自分で画像をレンダリングすることができます。
|
format | 出力フォーマット | "dot" または "gv" "gif" "pdf" "png" "svg" |
"png" | "dot" または "gv" はGraphviz入力フォーマットでテキストファイルを作成し、その他は指定したフォーマットで画像を作成します。links が使用されている場合、"png" と "gif" についてはイメージマップ (<map> 要素) を持つHTMLページが作成されます。詳しくは以下を参照。
|
showhidden | 隠しカテゴリを表示 | "0" "1" |
"0" | 説明ページに__HIDDENCAT__ とマークされたカテゴリは通常、カテゴリツリーに表示されません。
|
algorithm | Graphvizのアルゴリズム | "dot" "fdp" |
"dot" | いずれのGraphvizコマンドライン・プログラムがカテゴリツリーを実装するかを定義します。 |
links | ツリーにリンクを設定 | 値なし "graph" "wiki" |
値なし | "graph" は、ツリー内の各記事/カテゴリに対して、そこから始まる別のツリーへのリンクを作成します。 "wiki" は、各記事/カテゴリに対応するウィキページへのリンクを作成します。 format=png またはformat=gif が使われると、イメージマップ (<map> element) を持つHTMLページが作成されます。画像はページ中にdata: URIとして埋め込まれます。
|