mirror of
https://gerrit.wikimedia.org/r/mediawiki/extensions/SyntaxHighlight_GeSHi
synced 2024-11-15 18:49:22 +00:00
9debf59c9c
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 |
||
---|---|---|
i18n | ||
maintenance | ||
modules | ||
pygments | ||
tests | ||
.eslintrc.json | ||
.gitignore | ||
.gitreview | ||
.stylelintrc | ||
composer.json | ||
COPYING | ||
extension.json | ||
Gruntfile.js | ||
package.json | ||
phpcs.xml | ||
README | ||
ResourceLoaderGeSHiVisualEditorModule.php | ||
SyntaxHighlight_GeSHi.ace.php | ||
SyntaxHighlight_GeSHi.class.php | ||
SyntaxHighlight_GeSHi.compat.php | ||
SyntaxHighlight_GeSHi.lexers.php | ||
SyntaxHighlight_GeSHi.php |
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.