Go to file
Edward Chernenko 9debf59c9c Workaround for intermittent problems in Symfony/Process under HHVM.
Due to https://github.com/facebook/hhvm/issues/6921, $process->getOutput()
from Symfony/Process doesn't work reliably under HHVM.
This causes the result of "pygmentize" to be unexpectably truncated.

Until this is fixed in HHVM or Symfony, we can use callback of $process->run()
instead of the buggy $process->getOutput().

Bug: T151523
Change-Id: I21ef340eccca0741d7e86840f444272623675c46
2017-01-19 23:09:42 +03:00
i18n Localisation updates from https://translatewiki.net. 2016-12-23 22:33:20 +01:00
maintenance Remove duplicate values from the lexer list 2016-02-03 17:30:01 -08:00
modules build: Replace jshint/jscs with eslint 2016-11-19 13:56:05 +00:00
pygments Add pygments/AUTHORS file 2016-06-16 18:36:02 -07:00
tests SECURITY: Replace strip markers before syntax highlighting 2016-05-20 10:21:06 -07:00
.eslintrc.json build: Replace jshint/jscs with eslint 2016-11-19 13:56:05 +00:00
.gitignore Support local composer setup 2015-06-25 22:49:53 +00:00
.gitreview Whoops, track not trace 2016-10-24 17:03:53 -07:00
.stylelintrc Introduce stylelint 2016-05-19 17:44:00 +01:00
composer.json Update symfony/process to ~3.0 2016-04-02 20:57:52 +00:00
COPYING Add COPYING 2014-01-22 19:44:32 +00:00
extension.json Convert SyntaxHighlight names to Ace names 2016-10-31 14:13:36 +01:00
Gruntfile.js build: Replace jshint/jscs with eslint 2016-11-19 13:56:05 +00:00
package.json build: Replace jshint/jscs with eslint 2016-11-19 13:56:05 +00:00
phpcs.xml Update mediawiki-codesniffer and parallel-lint settings 2015-09-29 01:45:26 +02:00
README Support local composer setup 2015-06-25 22:49:53 +00:00
ResourceLoaderGeSHiVisualEditorModule.php Convert SyntaxHighlight names to Ace names 2016-10-31 14:13:36 +01:00
SyntaxHighlight_GeSHi.ace.php Convert SyntaxHighlight names to Ace names 2016-10-31 14:13:36 +01:00
SyntaxHighlight_GeSHi.class.php Workaround for intermittent problems in Symfony/Process under HHVM. 2017-01-19 23:09:42 +03:00
SyntaxHighlight_GeSHi.compat.php Add language mapping for geshi apt_sources to debsources 2016-04-11 13:30:17 +02:00
SyntaxHighlight_GeSHi.lexers.php Remove duplicate values from the lexer list 2016-02-03 17:30:01 -08:00
SyntaxHighlight_GeSHi.php Add php code sniffer to SyntaxHighlight_GeSHi 2015-09-27 21:16:58 +02: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.