Go to file
Ori Livneh 927f40e98a Hide the red border around syntax errors
MZMcBride noticed the red border around '國' in
https://en.wikipedia.org/wiki/Swift_(programming_language)#Example_code

That particular case happens to be a Pygments bug, because multibyte characters
are valid variable names in Swift. But even in cases of legitimate syntax
errors, I don't think we want to show the red border. This behavior may be
useful in code editors, but it is not useful in a wiki environment, especially
given the longstanding habit of using an existing, mostly-compatible lexer to
highlight a language for which no specific lexer exists.

To fix this, override the style in pygments.wrapper.css, and swap the order in
which the two CSS files are concatenated, so that in general we have the
ability to override Pygments-generated CSS.

Change-Id: I304fdaf3a462445d316e0f7fecc983fa87afc629
2015-06-25 17:24:15 -07:00
i18n Localisation updates from https://translatewiki.net. 2015-06-25 20:47:57 +02:00
maintenance Highlight using Pygments rather than Geshi 2015-06-22 23:37:15 +01:00
modules Hide the red border around syntax errors 2015-06-25 17:24:15 -07:00
pygments Revert "Add Pyglet, a web micro-service for highlighting using Pygments" 2015-06-25 01:11:54 +00:00
tests Add parser tests for block and inline behaviour 2015-06-25 05:46:42 +01:00
.csslintrc Add VisualEditor support 2015-06-24 22:43:42 +01:00
.gitignore Support local composer setup 2015-06-25 22:49:53 +00:00
.gitreview Adding .gitreview 2012-03-23 10:35:01 -07:00
.jscsrc build: Use npm for repo testing (jshint, jsonlint, jscs, banana) 2015-05-29 17:21:59 +00:00
.jshintrc build: Use npm for repo testing (jshint, jsonlint, jscs, banana) 2015-05-29 17:21:59 +00:00
composer.json Highlight using Pygments rather than Geshi 2015-06-22 23:37:15 +01:00
COPYING Add COPYING 2014-01-22 19:44:32 +00:00
extension.json Hide the red border around syntax errors 2015-06-25 17:24:15 -07:00
Gruntfile.js Add VisualEditor support 2015-06-24 22:43:42 +01:00
package.json Add VisualEditor support 2015-06-24 22:43:42 +01:00
README Support local composer setup 2015-06-25 22:49:53 +00:00
ResourceLoaderGeSHiVisualEditorModule.php ext.geshi.visualEditor: Store languages in the module instead of mw.config 2015-06-25 00:35:20 +00:00
SyntaxHighlight_GeSHi.class.php Support local composer setup 2015-06-25 22:49:53 +00:00
SyntaxHighlight_GeSHi.compat.php Render "xpp" as "java" 2015-06-23 11:29:08 -07:00
SyntaxHighlight_GeSHi.lexers.php Highlight using Pygments rather than Geshi 2015-06-22 23:37:15 +01:00
SyntaxHighlight_GeSHi.php Revert "Revert "Add extension.json, empty PHP entry point"" 2015-05-20 14:36:46 -07:00

This extension allows source code to be syntax highlighted on the wiki pages.
This README file might be out of date, have a look at the extension page
for updated informations:

    https://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi

== Requirements ==

This version of the extension has been tested with Pygments 1.6, 2.0.2 and
MediaWiki 1.25 as of 2015-06-19. To get releases of this extension compatible
with earlier versions of MediaWiki, visit:

    https://www.mediawiki.org/wiki/Special:ExtensionDistributor/SyntaxHighlight_GeSHi

== Installation ==

First, you will need to ensure that this extension's Composer-managed
dependencies are available. In the extension directory, run 'composer update'.

Next, Add this line to your LocalSettings.php:

    wfLoadExtension( 'SyntaxHighlight_GeSHi' );

By default, this extension will use a bundled copy of Pygments 2.0.2. If you
would like to use a different copy of the library, you can set
$wgPygmentizePath to point to the path to the 'pygmentize' binary.

== Usage ==

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

<source lang="php">
<?php
    v = "string";    // sample initialization
?>
html text
<?php
    echo v;         // end of php code
?>
</source>

== Parameters ==

For details information of these parameters, see the documentation of Pygments'
HtmlFormatter at <http://pygments.org/docs/formatters/#HtmlFormatter>.

* lang;		Defines the language.
* line;		Corresponds to linenos="inline" option.
* start;	Corresponds to linenostart opion.
* enclose;  If set to "none", corresponds to the nowrap=1 option.
* inline;   Corresponds to the nowrap=1 option.
* highlight;    Corresponds to hl_lines option (comma separated).

== Note ==

Pygments is generous about creating HTML elements: highlighting large blocks of
code can easily generate enough of them to crash a browser. As a guard, syntax
highlighting is turned off for code fragments larger than 100 kB.