1 Date: Thu, 9 Dec 2010 17:30:39 +0000
2 Mime-Version: 1.0 (Produced by PhpWiki 1.4.0RC1)
4 Content-Type: application/x-phpwiki;
5 pagename=Help%2FPhpHighlightPlugin;
6 flags=PAGE_LOCKED%2CEXTERNAL_PAGE;
9 Content-Transfer-Encoding: binary
11 The **~PhpHighlight** [[Help:WikiPlugin|plugin]] pretty-prints PHP code using the
12 php-function:highlight-string.
16 You specify options for the plugin on the same line as ##~<~<~PhpHighlight##,
17 and put the code on the following lines, until the final ##~>~>##:
20 <<PhpHighlight [wrap?] [color options]
21 code to be highlighted
27 Depending on the ##wrap## option, then the plugin will take care of
28 adding ##<?php## and ##?>## to the code before passing it to
29 php-function:highlight-string. If the PHP delimiters were added, then
30 the plugin removes them again from the highlighted string, before
37 If you don't want the plugin to automatically wrap the source code
38 in ##<?php## and ##?>##, then set ##wrap## to ##0##. The default value is ##1##
39 which means that the plugin takes care of adding and removing
40 ##<?php## and ##?>## automatically.
42 If you set ##wrap## to ##0##, then you'll be able to mix PHP code with
43 HTML. The plugin will then translate '##< ?php##' into '##<?php##' and
44 '##? >##' into '##?>##' to allow you to start and stop PHP mode in your
49 The plugin accepts optional color arguments which correspond to the
50 highlight settings in *php.ini*. Specified colors must be a valid
52 [[http://www.w3.org/TR/REC-html40/types.html#h-6.5|HTML 4 color name]]
53 in lowercase, such as ##'#0f0344'## or ##blue##. You can set the
56 ##string##, ##comment##, ##keyword##, ##bg##, ##default##, and ##html##
60 === PHP with default colors from ##php.ini##: ===
64 echo "Hello World<p>";
68 === HTML with embedded PHP ===
70 Here we have to use ##wrap=0## to prevent automatic wrapping, and escape
71 '##?>##' as '##? >##':
73 <<PhpHighlight wrap=0 html='#000000' bg='#dddddd'
76 <title>PHP Test</title>
79 < ?php echo "<p>Hello World</p>\n"; ? >
86 Although ##highlight_string()## was designed with PHP code in mind it is
87 suitable for basic syntax-highlighting of most C code because the two
90 <<PhpHighlight default=black string=blue comment=gray keyword=purple
96 if ((fp = fopen("/proc/loadavg", "r")) == NULL) {
97 syslog(LOG_ERR, _("%s %s: unable to open %s: %s"), _("FATAL ERROR:"),
98 "getload()", "/proc/loadavg", strerror(errno));
106 * [[mailto:gimpster@gimpster.com|Martin Geisler]]
107 * [[mailto:carstenklapp@users.sourceforge.net|Carsten Klapp]]
110 * [[Help:SyntaxHighlighterPlugin|SyntaxHighlighter]] plugin for highlighting other languages.
114 [[PhpWikiDocumentation]] [[CategoryWikiPlugin]]