User:Dapete/vCat/Catgraph migration


DeutschEdit

Siehe User:Dapete/vCat für allgemeine Informationen über vCat.

vCat verwendet teilweise andere Parameter als Catgraph.

Zugriffe auf die alte Catgraph-URL toolserver.org/~dapete/catgraph/graph.php werden aber automatisch an ein Kompatibilitäts-Servlet weitergeleitet, das sich praktisch identisch zu Catgraph verhält. Es ist unter tools.wmflabs.org/vcat/catgraphRedirect zu finden und setzt die Parameter intern um.

Zusätzlich gibt es ein Umwandlungs-Tool, mit dem man sich aus den alten Cagraph-Parametern die vCat-Parameter umwandeln kann.

Auch wenn an sich keine Änderungen nötig sind, ist es sinnvoll, zumindest die URL auf das Kombatibilitäts-Servlet zu ändern. Idealerweise sollte aber komplett auf vCat umgestellt werden. Als Hilfe gibt es eine Umsetzungstabelle, mit deren Hilfe bestehende Links umgewandelt werden können. Leider nur auf Englisch, aber auf der vCat-Übersichtsseite sind zumindest die neuen Parameter auch auf Deutsch beschrieben.

EnglishEdit

See User:Dapete/vCat for general information about vCat.

vCat uses different parameters than Catgraph.

However, accesses to the old Catgraph url toolserver.org/~dapete/catgraph/graph.php will automatically be redirected to a compatibility servlet, which behaves nearly identical to Catgraph. It can be found at tools.wmflabs.org/vcat/catgraphRedirect.

Additionally, there is a conversion tool to convert the old Catgraph parameters to vCat ones.

Although no changes are really necessary it is useful to at least change the URL to the compatibility servlet. Ideally links should be changed to vCat completely. The following conversion table should be helpful. See also the vCat overview page for some information.

Parameter conversion table
Catgraph parameters vCat parameters Description of changes
Name Values Description Name Values Description
wiki e.g. "wikipedia", "wikinews" Name of the wiki (long, readable).
lang must be supplied for wikis in multiple languages.
wiki e.g. "dewiki" Wiki abbreviation (as used in DBs). The old wiki/lang combination is replaced by just wiki, using the wiki database names. This makes looking up the wiki much easier. May still be changed to also support the old system; decision not made yet.
lang e.g. "de", "en" Language of the wiki for wikis in multiple languages.
cat category title Title of the category.
Can be specified more than once to have multiple categories as roots for the graph.
category category title Title of the category.
Can be specified more than once to have multiple categories as roots for the graph.
Can not be used with title or ns (it is essentially an abbreviation for title=…&ns=14).
The ns parameter was never really documented. It could be used with sub=article to change the namespace of the title given in cat.
Internally, category now always uses title and ns, but users don't see any of that.
title page name Title of the page.
If ns is not specified, the namespace is automatically determined from the title.
Can be specified more than once to have multiple pages as roots for the graph.
Can not be used with category.
ns number Number of namespace (never publically documented). ns number Number of namespace.
Forces the namespace for the title specified to this namespace.
Cannot be used with category.
sub "0", "article", other values "0" shows categories, other values show subcategories of a category and "article" makes a graph for an article given by cat. rel "category", "subcategory" 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. The old sub parameter combined things that should have been separate. The new rel parameter only determines the direction in the category tree, the rest is now possible by using title.
d number Maximum depth of the tree. depth number Maximum depth of the tree. Renamed for clarity.
n number Maximum number of nodes in the tree. limit number Maximum number of nodes in the tree. Renamed for clarity.
Maximum value (used unless using the Graphviz output format) raised from 100 to 250.
format "dot" (Graphviz), "pdf", "svg" Output format (default PNG).
If links is used and the output format is PNG, a HTML file with an image map (showing the PNG image) is created instead.
format "dot", "gv" (both Graphviz), "gif", "pdf", "png", "svg" Output format (default PNG).
ignorehidden If it has a value considered true by PHP, ignore hidden categories. showhidden "0", "1" Flag to show hidden categories (marked with __HIDDENCAT__). Meaning reversed.
Also this feature never really worked correctly in Graphviz.
fdp If the parameter has a value considered true by PHP, use Graphviz's fdp utility instead of dot. algorithm "dot", "fdp" Use the specified Graphviz utility to create the graph (default dot). Unchanged in functionality, but this is clearer (and allows for alternative graph algorithms).
links no value, "wiki", any other value If the parameter has a value considered true by PHP, include links in graph.
"wiki" makes links to the wiki articles, anything else to a Catgraph starting there with the same parameters as the current one.
links no value, "wiki", "graph" If set, include links in graph.
"wiki" makes links to the wiki articles.
"graph" makes links to a Catgraph starting there with the same parameters as the current one.
Only the two specific values are allowed now.
Still creates HTML pages with an image map (<map> element) for PNG and GIF images. The images are, however, embedded in the page as data: URIs.
small If the parameter has a value considered true by PHP, make a more compact graph with smaller fonts an less spacing. Removed without replacement.