Extension:SyntaxHighlight

This extension adds the &lt;source&gt; tag to present formatted source code.

Introduction
The source tags allow the display of preformatted code modules but in addition they add coloring according to the code language settings. Like the pre tags and the poem tags, they preserve white space, that is, they depict the code module exactly as it was typed.

When line numbering is added with line, long code lines will be wrapped. See the HTML example below. When text is the selected language, and numbering is used, the behaviour resembles the use of pre tags with numbering and long-line wrapping.

The following example shows how to color an HTML code listing: A typical result is just: The main text below gives details of source tag use for various languages.

Installation

 * Step 1:

Download the 4 extension files from the Subversion repository and save them into the extensions/SyntaxHighlight_GeSHi directory of your wiki. If you have shell access to your server, you may do the following to download the extension: cd extensions svn co http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/SyntaxHighlight_GeSHi


 * Step 2: Step 1 apparently now automatically checks out the 1.0.X stable release of GeSHi, rendering this step superfluous.

(Recommended) Download 1.0.X stable release of Subversion repository in SourceForge.net: cd SyntaxHighlight_GeSHi svn co http://geshi.svn.sourceforge.net/svnroot/geshi/branches/RELEASE_1_0_X_STABLE/geshi-1.0.X/src/ geshi
 * 1) change to the directory of the SyntaxHighlight_GeSHi extension
 * 1) check out a current version of GeSHi into a directory called geshi

The geshi.php file can also be downloaded from GeSHi, and unzip it inside the extensions/SyntaxHighlight_GeSHi directory. (Note: the zip file creates a sub-directory called geshi/, and places the file geshi.php there - Also note that GeSHi 1.1.2alpha3 does not work with this extension!)

(Note: You need both the mediawiki plugin files and the geshi files from sourceforge to make it work!)


 * Step 3.

Add this line to the end of your LocalSettings.php:


 * step 4. (Optional)

If needed, change the following line in SyntaxHighlight_GeSHi.class.php to suit the path of your geshi.php file

Sometimes you'll need to add the absolute path to geshi (/var/www/html/.../geshi/geshi.php)

Here's a shortcut using the PHP dirname function with the magic __FILE__ constant:

Problem with CSS / Border
If you want the dashed border like for  tags you have to edit the SyntaxHighlight_GeSHi.class.php around line 213. Look for this: and change it to: Link to Extension Talk (2008): Extension_talk:SyntaxHighlight_GeSHi

Usage
On the wiki page, you can now use "source" elements:

show:

Parameters

 * lang: Defines the language
 * line: Corresponds to enable_line_numbers method on GeSHi
 * start: Corresponds to start_line_numbers_at method on GeSHi


 * enclose: Corresponds to set_header_type method on GeSHi: takes values "none", "div", "pre"
 * strict: Corresponds to enable_strict_mode method on GeSHi

The effect and usage of these parameters can be consulted in GeSHi's documentation.

Since r22246, you can override the colors using MediaWiki:Geshi.css.

C#
Results in:

Java
Results in:

PHP
Results in:

Python
Results in:

Fortran
bugs:
 * comments for fortran77 do not work (line starts with C)

Results in:

SQL
Results in:

XML
Results in:

Supported languages
These are the languages known by GeSHi that can be used in the lang parameter.

Note that installed GeSHi version (can be revealed by previewing e.g. ) might not be the most recent version;  see 10967 for Wikimedia sites.

License
GPLv2 according to the COPYING file