From the MediaWiki Extension Distributor

Download from Special:ExtensionDistributor/GraphViz

With Composer

GraphViz should be installed using built-in Composer support. The package name is mediawiki/graph-viz. For instructions on how to install Composer see MediaWiki's user manual for Composer.

Once you have Composer properly installed, go to your MediaWiki installation directory and add the extension to your to your composer.local.json:

{
  "require": {
    "mediawiki/graph-viz": "^3.1"
  }
}

And then run:

composer update

Without Composer

1. Download the GraphViz extension archive from GIT and extract it into your MediaWiki "/extensions/GraphViz" directory.

Common

1. Update LocalSettings.php to include the following:

   wfLoadExtension( 'GraphViz' );
   

2. Visit your wiki's Special:Version page and verify that the correct version of the GraphViz extension is installed.
3. Install one of the external tools "Graphviz" or "Mscgen".
   1. Windows: Get your copy here: http://www.graphviz.org/Download.php or here http://www.mcternan.me.uk/mscgen/
   2. Unix: Same links as for windows but normally it should be pre-installed (at least graphviz - search for dot) or can be found in the package manager.
   3. Ubuntu/Debian:

      sudo apt-get install graphviz
      

      and

      sudo apt-get install mscgen
      

• Make sure that write permissions for the "$IP/images" directory are granted.
• Make sure that internet users get read/execute access on your executables if you use server installations (especially under Windows).

Graph Tag Attributes

Graph tag attributes may be supplied with either graphviz or mscgen as follows:

<graphviz attr1="value1" attr2="value2" ... attrN="valueN">
dot-language
<graphviz/>

<mscgen attr1="value1" attr2="value2" ... attrN="valueN">
mscgen-language
<mscgen/>

The following extended image syntax attributes are supported as graph tag attributes: type, border, location, alignment, size, link, alt, caption.

The option preparse="dynamic" makes it also possible to use GraphViz and templates and import these into a MediaWiki site. Changes to the original template will then be passed on. No preparse option will lead to two images, in case of a change to the original, of which the older version will always be imported should the template be called.

• svg requires additional configuration.

Multiple Graphs Per Page

For graphviz, use unique names for each graph to display multiple graphs on the same page.

<graphviz>
graph NAME {...
}
</graphviz>

<graphviz>
graph ANOTHERNAME {...
}
</graphviz>

For mscgen, use the "uniquifier" tag attribute to display multiple message sequence charts on the same page.

<mscgen uniquifier="NAME">
msc {...
}
</mscgen>

<mscgen uniquifier="ANOTHERNAME">
msc {...
}
</mscgen>

Links

Graphs in the DOT and mscgen languages may include URLs. These follow the pattern URL="link" where "link" is governed by the ImageMap syntax:

"All links are given in either the form [[Page title]] or [[Page title|description]]. In the latter case, the part after the pipe becomes the title attribute of the link—in most browsers, it will pop up as a tooltip when the user hovers over it; the part after the pipe also becomes the alt text for the link. If no explicit link description is given, the page title is used."

Additionally, external links are supported with or without square brackets. Specify external links without square brackets in order to honor DOT tooltip attributes (e.g. URL="http://mediawiki.org", tooltip="MediaWiki"). The MediaWiki "external link with different label" form is also supported (e.g. [http://mediawiki.org MediaWiki]).

Remark:

The link format is different from the format used in earlier versions. ( < 1.0).

See #Example 3 for an example with links.

Example 1

Graph for example no. 1

<graphviz border='frame' format='png' caption='Graph for example no. 1'>
digraph example1 {Hello->World}
</graphviz>

Example 2

Graph for example no. 2

<graphviz renderer="neato" caption="Graph for example no. 2">
graph example2 {
  run -- intr;
  intr -- runbl;
  runbl -- run;
  run -- kernel;
  kernel -- zombie;
  kernel -- sleep;
  kernel -- runmem;
  sleep -- swap;
  swap -- runswap;
  runswap -- new;
  runswap -- runmem;
  new -- runmem;
  sleep -- runmem;
}
</graphviz>

Example 3

Graph for example no. 3 (contains Wiki-Links)

<graphviz caption="Graph for example no. 3 (contains Wiki-Links)" alt="phylogenetic tree" format="png">
digraph example3 {
  node [shape=plaintext];
  Mollusca [URL="[[w:Mollusca]]"];
  Neomeniomorpha [URL="[[w:Neomeniomorpha]]"];
  X1 [shape=point,label=""];
  Caudofoveata [URL="[[w:Caudofoveata]]"];
  Testaria [URL="[[w:Testaria]]"];
  Polyplacophora [URL="[[w:Polyplacophora]]"];
  Conchifera [URL="[[w:Conchifera]]"];
  Tryblidiida [URL="[[w:Tryblidiida]]"];
  Ganglioneura [URL="[[w:Ganglioneura]]"];
  Bivalvia [URL="[[w:Bivalvia]]"];
  X2 [shape=point,label=""];
  X3 [shape=point,label=""];
  Scaphopoda [URL="[[w:Scaphopoda]]"];
  Cephalopoda [URL="[[w:Cephalopoda]]"];
  Gastropoda [URL="[[w:Gastropoda]]"];
  Mollusca->X1->Testaria->Conchifera->Ganglioneura->X2->Gastropoda
  Mollusca->Neomeniomorpha
  X1->Caudofoveata
  Testaria->Polyplacophora
  Conchifera->Tryblidiida
  Ganglioneura ->Bivalvia
  X2->X3->Cephalopoda
  X3->Scaphopoda
}
</graphviz>

Example 4

Message sequence chart for example no. 4

<mscgen caption="Message sequence chart for example no. 4">
msc {
  a,b,c;

  a->b  [label="ab()"];
  b->c  [label="bc(TRUE)"];
  c=>c  [label="process(1)"];
  c=>c  [label="process(2)"];
  ...;
  c=>c  [label="process(n)"];
  c=>c  [label="process(END)"];
  a<<=c [label="callback()"];
  ---   [label="If more to run", ID="*"];
  a->a  [label="next()"];
  a->c  [label="ac()"];
  b<-c  [label="cb(TRUE)"];
  b->b  [label="stalled(...)"];
  a<-b  [label="ab() = FALSE"];
}
</mscgen>