Difference between revisions of "GeSHi"
(→Technical: don't do geshi for xml action either) |
m (formatting) |
||
| Line 7: | Line 7: | ||
== Using syntax highlighting on Organic Design wikis == | == Using syntax highlighting on Organic Design wikis == | ||
Blocks of source code can be wrapped in language tags like usual, as follows: | Blocks of source code can be wrapped in language tags like usual, as follows: | ||
| − | <pre><php> | + | {{code|<pre> |
| + | <php> | ||
print "foo"; | print "foo"; | ||
| − | </php></pre> | + | </php> |
| + | </pre>}} | ||
but also template syntax can be used to make the entire article be rendered by the GeSHi parser. The templates expand to nothing, so they can be placed anywhere in the article without affecting its execution (if the raw article is requested, ''templates=expand'' will need to be included in the query-string to make the template reduce to nothing). It's probably best to put the template in a comment so that the execution is not affected even if templates do not expand. Here's an example: | but also template syntax can be used to make the entire article be rendered by the GeSHi parser. The templates expand to nothing, so they can be placed anywhere in the article without affecting its execution (if the raw article is requested, ''templates=expand'' will need to be included in the query-string to make the template reduce to nothing). It's probably best to put the template in a comment so that the execution is not affected even if templates do not expand. Here's an example: | ||
| − | <pre> | + | {{code|<pre> |
# {{per1}} | # {{per1}} | ||
print "bar"; | print "bar"; | ||
| − | </pre> | + | </pre>}} |
== Technical == | == Technical == | ||
To get around these issues, I've added a few extra lines after the GeSHi include to allow the tags to be added before parsing if a language template is transcluded. Here's the additional code which as added at the end of the GeSHiCodeTag.php file. | To get around these issues, I've added a few extra lines after the GeSHi include to allow the tags to be added before parsing if a language template is transcluded. Here's the additional code which as added at the end of the GeSHiCodeTag.php file. | ||
| − | <php>include('extensions/geshi/GeSHiCodeTag.php'); | + | {{code|<php> |
| + | include('extensions/geshi/GeSHiCodeTag.php'); | ||
$wgHooks['ParserBeforeStrip'][] = 'GeSHi'; | $wgHooks['ParserBeforeStrip'][] = 'GeSHi'; | ||
function GeSHi(&$parser, &$text, &$strip_state) { | function GeSHi(&$parser, &$text, &$strip_state) { | ||
if (isset($_REQUEST['action']) && ($_REQUEST['action'] == 'raw' || $_REQUEST['action'] == 'xml')) return true; | if (isset($_REQUEST['action']) && ($_REQUEST['action'] == 'raw' || $_REQUEST['action'] == 'xml')) return true; | ||
if (preg_match('/\\{\\{(xml|bash|php|perl|c|r|as|js|css|sql)\\}\\}/i',$text,$m)) $text = "<$m[1]>\n$text\n</$m[1]>"; | if (preg_match('/\\{\\{(xml|bash|php|perl|c|r|as|js|css|sql)\\}\\}/i',$text,$m)) $text = "<$m[1]>\n$text\n</$m[1]>"; | ||
| − | return true;</php> | + | return true; |
| + | </php>}} | ||
| + | |||
Templates or variables must be added which expand to nothing so they don't render as a red link. Also an extra line must be added to the [[GeSHiCodeTag.php]] file just before the geshi object is instantiated in the hook function to force the templates to expand. | Templates or variables must be added which expand to nothing so they don't render as a red link. Also an extra line must be added to the [[GeSHiCodeTag.php]] file just before the geshi object is instantiated in the hook function to force the templates to expand. | ||
| − | <php>$source = trim($GLOBALS["wgParser"]->replaceVariables($source));</php> | + | {{code|<php> |
| + | $source = trim($GLOBALS["wgParser"]->replaceVariables($source)); | ||
| + | </php>}} | ||
| + | |||
The end of the function needs to have a hack added to remove some spurious &lt;'s and &gt;'s that crop up on transcluded code: | The end of the function needs to have a hack added to remove some spurious &lt;'s and &gt;'s that crop up on transcluded code: | ||
| − | <php>$text = $geshi->parse_code(); | + | {{code|<php> |
| + | $text = $geshi->parse_code(); | ||
$text = preg_replace("/&([lg]t;)/","&$1",$text); | $text = preg_replace("/&([lg]t;)/","&$1",$text); | ||
| − | return $text;</php> | + | return $text; |
| + | </php>}} | ||
| − | ==Bugs== | + | == Bugs == |
The geshi syntax highlighter has a language called <nowiki><</nowiki>div>, this interferes with any wiki site <nowiki><</nowiki>div> tags. To suppress this bug either delete the language file, of rename it to <nowiki><</nowiki>div-lang>. | The geshi syntax highlighter has a language called <nowiki><</nowiki>div>, this interferes with any wiki site <nowiki><</nowiki>div> tags. To suppress this bug either delete the language file, of rename it to <nowiki><</nowiki>div-lang>. | ||
| + | |||
== See also == | == See also == | ||
*[http://meta.wikimedia.org/wiki/GeSHiCodeTag_Extension GeSHiCodeTag Extension] ''- the GeSHi extension which worked most easily for us'' | *[http://meta.wikimedia.org/wiki/GeSHiCodeTag_Extension GeSHiCodeTag Extension] ''- the GeSHi extension which worked most easily for us'' | ||
*[[GeSHiCodeTag.php]] ''- the code with adjustments added'' | *[[GeSHiCodeTag.php]] ''- the code with adjustments added'' | ||
Revision as of 21:23, 1 July 2009
Contents
Syntax highlighting on Organic Design
The standard GeSHi MediaWiki extensions don't quite suit our purposes because our articles containing code are usually directly executed which means that we can't include GeSHi code tags, but this problem can be easily fixed by a quick hack which I've included here.
Another problem is that we'd often like the ability to use MediaWiki templates even if the content is code, for example when defining LocalSettings articles by transcluding the wiki template and extension templates. So I've also added an extra line of code into the GeSHi extension before it parses the content to achieve this:
Using syntax highlighting on Organic Design wikis
Blocks of source code can be wrapped in language tags like usual, as follows:
but also template syntax can be used to make the entire article be rendered by the GeSHi parser. The templates expand to nothing, so they can be placed anywhere in the article without affecting its execution (if the raw article is requested, templates=expand will need to be included in the query-string to make the template reduce to nothing). It's probably best to put the template in a comment so that the execution is not affected even if templates do not expand. Here's an example:
Technical
To get around these issues, I've added a few extra lines after the GeSHi include to allow the tags to be added before parsing if a language template is transcluded. Here's the additional code which as added at the end of the GeSHiCodeTag.php file.
Templates or variables must be added which expand to nothing so they don't render as a red link. Also an extra line must be added to the GeSHiCodeTag.php file just before the geshi object is instantiated in the hook function to force the templates to expand.
The end of the function needs to have a hack added to remove some spurious <'s and >'s that crop up on transcluded code:
Bugs
The geshi syntax highlighter has a language called <div>, this interferes with any wiki site <div> tags. To suppress this bug either delete the language file, of rename it to <div-lang>.
See also
- GeSHiCodeTag Extension - the GeSHi extension which worked most easily for us
- GeSHiCodeTag.php - the code with adjustments added
