wiki-evolution's Introduction

wiki-evolution

Visualize evolution of your MediaWiki based site

Requirements

MediaWiki-based wiki
gource for visualizing the history (will create a set of images)
avconv to convert a set of images to a video file
xvfb to run gource in a virtual X server environment
nodejs with npm installed

Running

sudo apt-get install gource libav-tools xvfb

should be enough on Debian-powered machines

How to install and run it?

npm install -g wiki-evolution

and then run wiki-evolution <wiki domain>, for instance:

wiki-evolution poznan.wikia.com
wiki-evolution fo.wikipedia.org

This will install wiki-evolution npm module globally and render the visualization for poznan.wikia.com and Faroese Wikipedia.

For large wikis with a long edits history you can include every N-th edit only:

EDITS_COMPRESSION=150 wiki-evolution muppet.wikia.com

This will include only the first, 150th, 300th, ... edit of each article.

Debug mode

Run the wiki-evolution script with DEBUG=1 env variable set to enable nodemw library debug mode:

DEBUG=1 EDITS_COMPRESSION=150 wiki-evolution muppet.wikia.com
...
debug:   API action: query
debug:   GET <http://muppet.wikia.com/api.php?action=query&prop=revisions&rvprop=ids%7Ctimestamp%7Csize%7Cflags%7Ccomment%7Cuser&rvdir=newer&rvlimit=5000&titles=X&continue=&format=json>
...

Genesis

Port of WikiEvolution extension developed during Wikia 2012 internship programme by @drzejzi. It's meant to be run standalone (i.e. outside MediaWiki stack) and generate wonderful videos of how your site evolved from its very beginning.