mirror of
https://gerrit.wikimedia.org/r/mediawiki/extensions/SyntaxHighlight_GeSHi
synced 2024-11-15 10:39:53 +00:00
927f40e98a
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 |
||
---|---|---|
i18n | ||
maintenance | ||
modules | ||
pygments | ||
tests | ||
.csslintrc | ||
.gitignore | ||
.gitreview | ||
.jscsrc | ||
.jshintrc | ||
composer.json | ||
COPYING | ||
extension.json | ||
Gruntfile.js | ||
package.json | ||
README | ||
ResourceLoaderGeSHiVisualEditorModule.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.