Extension:SyntaxHighlight

This extension adds the  tag to present formatted source code.

As of 50696, an alternative tag  is provided. is recommended to avoid possible conflicts. The original syntax  is also used in some other languages, e.g. XML.

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

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

show:

Alternative Tag
is also used in some other languages (for example XML). If your source code contains is provided. is recommended to avoid the conflicts mentioned above.

Parameters

 * lang="??": Defines what programming language the source code is using. This affects how the extension highlights the source code. See the section "Supported languages" in this page for details of supported languages.
 * line="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS": Type of line numbering to use (default is no line numbering). Corresponds to enable_line_numbers the flag in GeSHi.
 * line start="??": Use together with the parameter "line". Define the start number of the line. If you type line start="55", it will start counting at 55, then 56,57,58... and so on. Corresponds to start_line_numbers_at method on GeSHi


 * highlight="??": Specifies which line is highlighted. Note that the parameter line start="??" doesn't affect how it counts the lines.
 * enclose="??": Specifies what container is used to enclose the source code. Takes values "pre" (default value), "div", "none". Corresponds to set_header_type method on GeSHi.
 * strict: Type the name of the parameter to enable the strict mode. 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.

More Usage
When line numbering is added with line, long code lines will be wrapped. See the 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:

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.

Default Source Language
Added in 50693.

If the site mainly quote the source code of a specific programming language, it would be helpful to set a default language.

To do so, add a new variable to LocalSettings.php, just before the require_once line. We set C programming language as an example:

Bugs and Limitations
''None so far. You may report bugs by clicking here.''

Method 1, already bundled
Since r46666, we bundle Geshi into subversion. When downloading via the ExtensionDistributor or directly from SVN, there should already be a "geshi" directory inside your SyntaxHighlight_GeSHi directory. If this is the case then GeSHi is already installed.

Method 2, manual downloading
Browse to the extension's Subversion repository. Open each of the 4 file's pages, and download the files by opening and saving the pages behind the download link. Save (or upload) these files into the extensions/SyntaxHighlight_GeSHi directory of your wiki.

Next, go to the GeSHi project site and download the latest stable release. Unpack (and upload) these files into the extensions/SyntaxHighlight_GeSHi/geshi directory of your wiki.

Notes:
 * GeSHi 1.1.2alpha3 does not work with the MediaWiki extension.
 * You need both the MediaWiki extension files and the GeSHi project files from SourceForge to make it work!
 * You can delete the extensions/SyntaxHighlight_GeSHi/geshi/docs directory to save a few megabytes.

Method 3, using an SVN tool
Use an SVN tool to checkout http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/SyntaxHighlight_GeSHi/.

For example using the SVN command-line tool:

svn co http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/SyntaxHighlight_GeSHi

This will automatically also download the lastest stable version of GeSHi.

Save (or upload) everything into the extensions/SyntaxHighlight_GeSHi directory of your wiki.

Note: You can delete the extensions/SyntaxHighlight_GeSHi/geshi/docs directory and the various .svn directories to save a few megabytes.

Step 2, installation
Add this line to the end of your LocalSettings.php:

Step 3, GeSHi installation (optional)
If you didn't put GeSHi in the extensions/SyntaxHighlight_GeSHi/geshi directory, then 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:

Configuration
If you want the dashed border like for   </tt> tags you have to add them again.

Method 1, CSS file

 * This method requires r52346 or higher of this extension.

Add to MediaWiki:Geshi.css, MediaWiki:Monobook.css or MediaWiki:Common.css: div.mw-geshi { padding: 1em; margin:1em 0; border: 1px dashed #2fab6f; }

This will give all GeSHi output (except for enclose="none"</tt>) a dashed border almost identical to &lt;pre&gt; in monobook/main.css

Method 2, inline CSS
You can also edit the SyntaxHighlight_GeSHi.class.php around line 222. Look for this: and change it to: On a Unix-like system simply type this command in the directory containing "SyntaxHighlight_GeSHi.class.php": Link to Extension Talk (2008): Extension_talk:SyntaxHighlight_GeSHi
 * See also 52346.