KnowledgeGraph

This extension provides the #knowledgegraph parser function to visualize the knowledge graph in Semantic MediaWiki with vis-network.js

Includes a KnowledgeGraph Designer through which interactively create/export graphs.

Requirements

• PHP 8.1 or later
• MediaWiki 1.39 or later
• SemanticMediaWiki 5.1.0 or later

Usage

Insert a parser function like

{{#knowledgegraph:
nodes=Page A, Page B
|properties=HasProperty1,HasProperty2
|depth=3
|graph-options=Mediawiki:KnowledgegraphGraphOptions
|property-options?HasProperty1=Mediawiki:KnowledgegraphNodeOptionsHasProperty1
|show-toolbar=false
|show-property-type=false
|width=100%
|height=400px
}}

nodes= and properties= are split on , by default. If your page titles or property names contain commas (e.g. legal citations, bibliographic entries), configure a different separator in LocalSettings.php:

$wgKnowledgeGraphListSeparator = ';';

Without properties=, only direct properties are loaded. To include inverse properties, list them with a - prefix, e.g. |properties=HasProperty1,-HasProperty1.

For Developers

Accessing a rendered graph

After a graph is built (and again after the Designer's "Reset graph"), the knowledgegraph.instance hook fires with the instance's vis-network handles. Handlers registered later still receive the last fire:

mw.hook( 'knowledgegraph.instance' ).add( ( instance ) => {
	// instance: { id, container, network, nodes, edges }
	console.log( instance.nodes.get(), instance.edges.get() );
} );

Updating vis-network Library

This extension uses the vis-network JavaScript library for rendering network diagrams. The version is managed via npm and bundled into the extension using a post-install script.

How It Works

After running npm install, the following happens automatically:

1. Copying Files
   The copy-files-from-to tool copies the minified vis-network files from node_modules to the resources/visNetwork/ directory:

   • vis-network.min.js
   • vis-network.min.js.map

2. Injecting Comment
   A custom script (inject-nomin.js) prepends the line /*@nomin*/ to vis-network.min.js.
   This comment prevents MediaWiki's ResourceLoader from re-minifying the file.

To Update vis-network

1. Open package.json and change the version under "vis-network"
   (e.g., "vis-network": "latest" or a specific version like "9.1.9").

2. Run:

   npm install

Credits

https://github.com/OpenSemanticLab/mediawiki-extensions-InteractiveSemanticGraph