blob: c0004318373192491a760c82911776a89a99b103 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
|
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:
http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi
== Requirements ==
This version of the extension has been tested with GeSHi 1.0.8.10 and MediaWiki 1.18
as of 2011-02-19. It may or may not work with earlier versions of the aforementioned
software. To get releases of this extension compatible with earlier versions of
MediaWiki, visit:
http://www.mediawiki.org/wiki/Special:ExtensionDistributor/SyntaxHighlight_GeSHi
== Installation ==
If you downloaded this from MediaWiki.org, there should already be
a 'geshi' directory in this folder. If there is, you can skip the next
paragraph.
Download the latest stable build from
http://sourceforge.net/project/showfiles.php?group_id=114997, and unzip it into
your extensions/SyntaxHighlight_GeSHi/ directory. (Note: the zip file creates a
sub-directory called geshi/, and places a file geshi.php there)
Add this line to your LocalSettings.php:
require_once("extensions/SyntaxHighlight_GeSHi/SyntaxHighlight_GeSHi.php");
If your MediaWiki software is obtained via Subversion, then the latest build
can be downloaded via the Subversion repository. First of all, is to switch
into your extensions/SyntaxHighlight_GeSHi/ directory. Then invoke the command
to obtain the latest build of the GeSHi code:
svn checkout https://geshi.svn.sourceforge.net/svnroot/geshi/trunk/geshi-1.0.X/src/ geshi
If needed, change the following line on SyntaxHighlight_GeSHi.class.php to
suit the path of your geshi.php file
require_once( 'geshi/geshi.php' );
== 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 ==
Please see the documentation of GeSHi on http://qbnz.com/highlighter/geshi-doc.html
for detailed information to use some of the parameters.
* lang; Defines the language
* line; Corresponds to enable_line_numbers method on GeSHi
* start; Corresponds to start_line_numbers_at method on GeSHi
* strict; Corresponds to enable_strict_mode method on GeSHi
== Note ==
GeSHi is generous about creating HTML elements: highlighting large blocks of
code can easily generate enough of them to crash a browser. As a guard, symbol
highlighting is turned off for code fragments larger than 100 kB. For fragments
larger than 200 kB, string highlighting is turned off as well.
|
