Editing Wiki Syntax Highlighting (section)

== SyntaxHighlight extension ==

The '''SyntaxHighlight''' extension relies on the [http://pygments.org/ Pygments] library. <ref>[https://www.mediawiki.org/wiki/Extension:SyntaxHighlight SyntaxHighlight extension] - MediaWiki documentation</ref>

=== Installation ===

Add the following line to `LocalSettings.php`:

<syntaxhighlight lang="php">
wfLoadExtension( 'SyntaxHighlight_GeSHi' );
</syntaxhighlight>

It's necessary to install the Pygments library on the server. 

<syntaxhighlight lang="sh">
$ pip3 install Pygments
</syntaxhighlight>

If the extension is installed somewhere that's not in the PATH, add this line to `LocalSettings.php`:

<syntaxhighlight lang="php">
$wgPygmentizePath = "/usr/local/bin/pygmentize";
</syntaxhighlight>

=== Formatting errors ===

Pages with incorrectly formatted `<syntaxhightligh>` tags will be added to a category named [[:Category:Pages_with_syntax_highlighting_errors|pages with syntax highlighting errors]].

Any `<syntaxhightligh>` tag without a `lang` attribute will log an error. Another common `lang` attribute error is to set `lang="bash"` when the only acceptable shell language value is `lang="sh"`. <ref>[http://pygments.org/docs/lexers/ Available Lexers] - Pygments documentation</ref>