Visualize evolution of your MediaWiki based site
Visualize evolution of your MediaWiki based site.
The easiest way to use this tool is via Docker. You can build the Docker image locally from the provided Dockerfile and then run it:
docker build -t wiki-evolution .docker run --name=wiki-evolution --rm -it -v $(pwd)/data:/tmp/wiki-evolution wiki-evolution bashOnce inside the container, run:
./bin/wiki-evolution.sh <wiki domain>Gource log files and the rendered WebM movie will be stored in the data/ directory on your host.
Use the following command execute wiki-evolution:
npx wiki-evolution <wiki domain>Your system will need gource installed.
-
Clone the repo
-
Install Dependencies: Ensure you have
gourceinstalled on your system. Refer to the Requirements section for installation commands. -
Run the Command:
./bin/wiki2gource.js <wiki domain>Alternatively, if you want to use npx to execute wiki2gource.js, you can run:
npx wiki2gource <wiki domain>Gource log files and the rendered webm movie will be stored in the data/ directory on your host.
- MediaWiki-based wiki
- gource for visualizing the history (will create a set of images)
- ffmpeg to convert a set of images to a video file
- xvfb to run gource in a virtual X server environment
- nodejs with
npminstalled
Running
sudo apt-get install gource ffmpeg xvfb
should be enough on Debian-powered machines
For MacOS run:
brew install gource ffmpeg
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.
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>
...
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.