Setup:Installation Manual/Extensions/SyntaxHighlight GeSHi

The MediaWiki-extensions SyntaxHighlight_GeSHi is not running correctly in some cases of setups. This document will show you how to configure your system environment that you can use the extension.

Tips for this Document

• Please, read this manual completely and work through the single installation steps one after another.
• For editing the configuration files with a text editor, the files must be saved in UTF-8 coding without BOM (Byte Order Mark).
• The placeholder <installpath-bluespice> stands for the path to your BlueSpice installation, e.g C:\inetpub\wwwroot\bluespice (Windows) or /var/www/bluespice (Linux).

SyntaxHighlight_GeSHi and Linux

If you are using Linux as BlueSpice server it's enough make two files executable (chmod 755):

                <installpath-bluespice>/extensions/SyntaxHighlight_GeSHi/pygments/create_pygmentize_bundle
<installpath-bluespice>/extensions/SyntaxHighlight_GeSHi/pygments/pygmentize

            

For more information please refer to the article "File System Permissions".

SyntaxHighlight_GeSHi and Windows

First, please install latest version of Python 2.7.x. It is recommended to use the standard installation path (C:\Python27).

After that please open your windows command line and change to the subfolder "Scripts" in the Python installation path. Install the needed package "pygments" by using this command:

pip.exe install pygments

Now tell your BlueSpice installation where the pygmentize.exe can be found by setup this variable in your LocalSettings.php:

$wgPygmentizePath = "c:\\Python27\\Scripts\\pygmentize.exe";

At the end please take care that the temporary directory of your PHP installation (default: C:\Windows\Temp) is fully writable by your webserver.

With these steps your should have a working system setup to use the SyntaxHighlight_GeSHi without problem.