to surround the source */
define('GESHI_HEADER_DIV', 1);
/** Use a
to surround the source */
define('GESHI_HEADER_PRE', 2);
// Capatalisation constants
/** Lowercase keywords found */
define('GESHI_CAPS_NO_CHANGE', 0);
/** Uppercase keywords found */
define('GESHI_CAPS_UPPER', 1);
/** Leave keywords found as the case that they are */
define('GESHI_CAPS_LOWER', 2);
// Link style constants
/** Links in the source in the :link state */
define('GESHI_LINK', 0);
/** Links in the source in the :hover state */
define('GESHI_HOVER', 1);
/** Links in the source in the :active state */
define('GESHI_ACTIVE', 2);
/** Links in the source in the :visited state */
define('GESHI_VISITED', 3);
// Important string starter/finisher
// Note that if you change these, they should be as-is: i.e., don't
// write them as if they had been run through htmlentities()
/** The starter for important parts of the source */
define('GESHI_START_IMPORTANT', '');
/** The ender for important parts of the source */
define('GESHI_END_IMPORTANT', '');
/**#@+
* @access private
*/
// When strict mode applies for a language
/** Strict mode never applies (this is the most common) */
define('GESHI_NEVER', 0);
/** Strict mode *might* apply, and can be enabled or
disabled by {@link GeSHi::enable_strict_mode()} */
define('GESHI_MAYBE', 1);
/** Strict mode always applies */
define('GESHI_ALWAYS', 2);
// Advanced regexp handling constants, used in language files
/** The key of the regex array defining what to search for */
define('GESHI_SEARCH', 0);
/** The key of the regex array defining what bracket group in a
matched search to use as a replacement */
define('GESHI_REPLACE', 1);
/** The key of the regex array defining any modifiers to the regular expression */
define('GESHI_MODIFIERS', 2);
/** The key of the regex array defining what bracket group in a
matched search to put before the replacement */
define('GESHI_BEFORE', 3);
/** The key of the regex array defining what bracket group in a
matched search to put after the replacement */
define('GESHI_AFTER', 4);
/** Used in language files to mark comments */
define('GESHI_COMMENTS', 0);
// Error detection - use these to analyse faults
/** No sourcecode to highlight was specified */
define('GESHI_ERROR_NO_INPUT', 1);
/** The language specified does not exist */
define('GESHI_ERROR_NO_SUCH_LANG', 2);
/** GeSHi could not open a file for reading (generally a language file) */
define('GESHI_ERROR_FILE_NOT_READABLE', 3);
/** The header type passed to {@link GeSHi::set_header_type()} was invalid */
define('GESHI_ERROR_INVALID_HEADER_TYPE', 4);
/** The line number type passed to {@link GeSHi::enable_line_numbers()} was invalid */
define('GESHI_ERROR_INVALID_LINE_NUMBER_TYPE', 5);
/**#@-*/
/**
* The GeSHi Class.
*
* Please refer to the documentation for GeSHi 1.0.X that is available
* at http://qbnz.com/highlighter/documentation.php for more information
* about how to use this class.
*
* @package core
* @author Nigel McNie
* @copyright Copyright © 2004, 2005 Nigel McNie
*/
class GeSHi
{
/**#@+
* @access private
*/
/**
* The source code to highlight
* @var string
*/
var $source = '';
/**
* The language to use when highlighting
* @var string
*/
var $language = '';
/**
* The data for the language used
* @var array
*/
var $language_data = array();
/**
* The path to the language files
* @var string
*/
var $language_path = GESHI_LANG_ROOT;
/**
* The error message associated with an error
* @var string
* @todo check err reporting works
*/
var $error = false;
/**
* Possible error messages
* @var array
*/
var $error_messages = array(
GESHI_ERROR_NO_INPUT => 'No source code inputted',
GESHI_ERROR_NO_SUCH_LANG => 'GeSHi could not find the language {LANGUAGE} (using path {PATH})',
GESHI_ERROR_FILE_NOT_READABLE => 'The file specified for load_from_file was not readable',
GESHI_ERROR_INVALID_HEADER_TYPE => 'The header type specified is invalid',
GESHI_ERROR_INVALID_LINE_NUMBER_TYPE => 'The line number type specified is invalid'
);
/**
* Whether highlighting is strict or not
* @var boolean
*/
var $strict_mode = false;
/**
* Whether to use CSS classes in output
* @var boolean
*/
var $use_classes = false;
/**
* The type of header to use. Can be one of the following
* values:
*
*
* - GESHI_HEADER_PRE: Source is outputted in
* a <pre> HTML element.
* - GESHI_HEADER_DIV: Source is outputted in
* a <div> HTML element.
*
*
* @var int
*/
var $header_type = GESHI_HEADER_PRE;
/**
* Array of permissions for which lexics should be highlighted
* @var array
*/
var $lexic_permissions = array(
'KEYWORDS' => array(),
'COMMENTS' => array('MULTI' => true),
'REGEXPS' => array(),
'ESCAPE_CHAR' => true,
'BRACKETS' => true,
'SYMBOLS' => true,
'STRINGS' => true,
'NUMBERS' => true,
'METHODS' => true,
'SCRIPT' => true
);
/**
* The time it took to parse the code
* @var double
*/
var $time = 0;
/**
* The content of the header block
* @var string
*/
var $header_content = '';
/**
* The content of the footer block
* @var string
*/
var $footer_content = '';
/**
* The style of the header block
* @var string
*/
var $header_content_style = '';
/**
* The style of the footer block
* @var string
*/
var $footer_content_style = '';
/**
* The styles for hyperlinks in the code
* @var array
*/
var $link_styles = array();
/**
* Whether important blocks should be recognised or not
* @var boolean
* @todo REMOVE THIS FUNCTIONALITY!
*/
var $enable_important_blocks = false;
/**
* Styles for important parts of the code
* @var string
* @todo As above - rethink the whole idea of important blocks as it is buggy and
* will be hard to implement in 1.2
*/
var $important_styles = 'font-weight: bold; color: red;'; // Styles for important parts of the code
/**
* Whether CSS IDs should be added to the code
* @var boolean
*/
var $add_ids = false;
/**
* Lines that should be highlighted extra
* @var array
*/
var $highlight_extra_lines = array();
/**
* Styles of extra-highlighted lines
* @var string
*/
var $highlight_extra_lines_style = 'color: #cc0; background-color: #ffc;';
/**
* Number at which line numbers should start at
* @var int
* @todo Warning documentation about XHTML compliance
*/
var $line_numbers_start = 1;
/**
* The overall style for this code block
* @var string
*/
var $overall_style = '';
/**
* The style for the actual code
* @var string
*/
var $code_style = 'font-family: \'Courier New\', Courier, monospace; font-weight: normal;';
/**
* The overall class for this code block
* @var string
*/
var $overall_class = '';
/**
* The overall ID for this code block
* @var string
*/
var $overall_id = '';
/**
* Line number styles
* @var string
*/
var $line_style1 = 'font-family: \'Courier New\', Courier, monospace; color: black; font-weight: normal; font-style: normal;';
/**
* Line number styles for fancy lines
* @var string
*/
var $line_style2 = 'font-weight: bold;';
/**
* Flag for how line nubmers are displayed
* @var boolean
*/
var $line_numbers = GESHI_NO_LINE_NUMBERS;
/**
* The "nth" value for fancy line highlighting
* @var int
*/
var $line_nth_row = 0;
/**
* The size of tab stops
* @var int
*/
var $tab_width = 8;
/**
* Default target for keyword links
* @var string
*/
var $link_target = '';
/**
* The encoding to use for entity encoding
* @var string
*/
var $encoding = 'ISO-8859-1';
/**
* Unused (planned for future)
* @var int
*/
var $output_format = GESHI_OUTPUT_HTML;
/**#@-*/
/**
* Creates a new GeSHi object, with source and language
*
* @param string The source code to highlight
* @param string The language to highlight the source with
* @param string The path to the language file directory. This
* is deprecated! I've backported the auto path
* detection from the 1.1.X dev branch, so now it
* should be automatically set correctly. If you have
* renamed the language directory however, you will
* still need to set the path using this parameter or
* {@link GeSHi::set_language_path()}
* @since 1.0.0
*/
function GeSHi ($source, $language, $path = '')
{
$this->set_source($source);
$this->set_language_path($path);
$this->set_language($language);
}
/**
* Returns an error message associated with the last GeSHi operation,
* or false if no error has occured
*
* @return string|false An error message if there has been an error, else false
* @since 1.0.0
*/
function error ()
{
if ($this->error) {
$msg = $this->error_messages[$this->error];
$debug_tpl_vars = array(
'{LANGUAGE}' => $this->language,
'{PATH}' => $this->language_path
);
foreach ($debug_tpl_vars as $tpl => $var) {
$msg = str_replace($tpl, $var, $msg);
}
return "
GeSHi Error: $msg (code $this->error)
";
}
return false;
}
/**
* Gets a human-readable language name (thanks to Simon Patterson
* for the idea :))
*
* @return string The name for the current language
* @since 1.0.2
*/
function get_language_name ()
{
if (GESHI_ERROR_NO_SUCH_LANG == $this->_error) {
return $this->language_data['LANG_NAME'] . ' (Unknown Language)';
}
return $this->language_data['LANG_NAME'];
}
/**
* Sets the source code for this object
*
* @param string The source code to highlight
* @since 1.0.0
*/
function set_source ($source)
{
if ('' == trim($source)) {
$this->error = GESHI_ERROR_NO_INPUT;
}
$this->source = $source;
}
/**
* Sets the language for this object
*
* @param string The name of the language to use
* @since 1.0.0
*/
function set_language ($language)
{
$this->error = false;
$this->strict_mode = GESHI_NEVER;
$language = preg_replace('#[^a-zA-Z0-9\-_]#', '', $language);
$this->language = strtolower($language);
$file_name = $this->language_path . $this->language . '.php';
if (!is_readable($file_name)) {
$this->error = GESHI_ERROR_NO_SUCH_LANG;
return;
}
// Load the language for parsing
$this->load_language($file_name);
}
/**
* Sets the path to the directory containing the language files. Note
* that this path is relative to the directory of the script that included
* geshi.php, NOT geshi.php itself.
*
* @param string The path to the language directory
* @since 1.0.0
* @deprecated The path to the language files should now be automatically
* detected, so this method should no longer be needed. The
* 1.1.X branch handles manual setting of the path differently
* so this method will disappear in 1.2.0.
*/
function set_language_path ($path)
{
if ($path) {
$this->language_path = ('/' == substr($path, strlen($path) - 1, 1)) ? $path : $path . '/';
}
}
/**
* Sets the type of header to be used.
*
* If GESHI_HEADER_DIV is used, the code is surrounded in a .This
* means more source code but more control over tab width and line-wrapping.
* GESHI_HEADER_PRE means that a
is used - less source, but less
* control. Default is GESHI_HEADER_PRE.
*
* @param int The type of header to be used
* @since 1.0.0
*/
function set_header_type ($type)
{
if (GESHI_HEADER_DIV != $type && GESHI_HEADER_PRE != $type) {
$this->error = GESHI_ERROR_INVALID_HEADER_TYPE;
return;
}
$this->header_type = $type;
}
/**
* Sets the styles for the code that will be outputted
* when this object is parsed. The style should be a
* string of valid stylesheet declarations
*
* @param string The overall style for the outputted code block
* @param boolean Whether to merge the styles with the current styles or not
* @since 1.0.0
*/
function set_overall_style ($style, $preserve_defaults = false)
{
if (!$preserve_defaults) {
$this->overall_style = $style;
} else {
$this->overall_style .= $style;
}
}
/**
* Sets the overall classname for this block of code. This
* class can then be used in a stylesheet to style this object's
* output
*
* @param string The class name to use for this block of code
* @since 1.0.0
*/
function set_overall_class ($class)
{
$this->overall_class = $class;
}
/**
* Sets the overall id for this block of code. This id can then
* be used in a stylesheet to style this object's output
*
* @param string The ID to use for this block of code
* @since 1.0.0
*/
function set_overall_id ($id)
{
$this->overall_id = $id;
}
/**
* Sets whether CSS classes should be used to highlight the source. Default
* is off, calling this method with no arguments will turn it on
*
* @param boolean Whether to turn classes on or not
* @since 1.0.0
*/
function enable_classes ($flag = true)
{
$this->use_classes = ($flag) ? true : false;
}
/**
* Sets the style for the actual code. This should be a string
* containing valid stylesheet declarations. If $preserve_defaults is
* true, then styles are merged with the default styles, with the
* user defined styles having priority
*
* Note: Use this method to override any style changes you made to
* the line numbers if you are using line numbers, else the line of
* code will have the same style as the line number! Consult the
* GeSHi documentation for more information about this.
*
* @param string The style to use for actual code
* @param boolean Whether to merge the current styles with the new styles
*/
function set_code_style ($style, $preserve_defaults = false)
{
if (!$preserve_defaults) {
$this->code_style = $style;
} else {
$this->code_style .= $style;
}
}
/**
* Sets the styles for the line numbers.
*
* @param string The style for the line numbers that are "normal"
* @param string|boolean If a string, this is the style of the line
* numbers that are "fancy", otherwise if boolean then this
* defines whether the normal styles should be merged with the
* new normal styles or not
* @param boolean If set, is the flag for whether to merge the "fancy"
* styles with the current styles or not
* @since 1.0.2
*/
function set_line_style ($style1, $style2 = '', $preserve_defaults = false)
{
if (is_bool($style2)) {
$preserve_defaults = $style2;
$style2 = '';
}
if (!$preserve_defaults) {
$this->line_style1 = $style1;
$this->line_style2 = $style2;
} else {
$this->line_style1 .= $style1;
$this->line_style2 .= $style2;
}
}
/**
* Sets whether line numbers should be displayed.
*
* Valid values for the first parameter are:
*
*
* - GESHI_NO_LINE_NUMBERS: Line numbers will not be displayed
* - GESHI_NORMAL_LINE_NUMBERS: Line numbers will be displayed
* - GESHI_FANCY_LINE_NUMBERS: Fancy line numbers will be displayed
*
*
* For fancy line numbers, the second parameter is used to signal which lines
* are to be fancy. For example, if the value of this parameter is 5 then every
* 5th line will be fancy.
*
* @param int How line numbers should be displayed
* @param int Defines which lines are fancy
* @since 1.0.0
*/
function enable_line_numbers ($flag, $nth_row = 5)
{
if (GESHI_NO_LINE_NUMBERS != $flag && GESHI_NORMAL_LINE_NUMBERS != $flag
&& GESHI_FANCY_LINE_NUMBERS != $flag) {
$this->error = GESHI_ERROR_INVALID_LINE_NUMBER_TYPE;
}
$this->line_numbers = $flag;
$this->line_nth_row = $nth_row;
}
/**
* Sets the style for a keyword group. If $preserve_defaults is
* true, then styles are merged with the default styles, with the
* user defined styles having priority
*
* @param int The key of the keyword group to change the styles of
* @param string The style to make the keywords
* @param boolean Whether to merge the new styles with the old or just
* to overwrite them
* @since 1.0.0
*/
function set_keyword_group_style ($key, $style, $preserve_defaults = false)
{
if (!$preserve_defaults) {
$this->language_data['STYLES']['KEYWORDS'][$key] = $style;
} else {
$this->language_data['STYLES']['KEYWORDS'][$key] .= $style;
}
}
/**
* Turns highlighting on/off for a keyword group
*
* @param int The key of the keyword group to turn on or off
* @param boolean Whether to turn highlighting for that group on or off
* @since 1.0.0
*/
function set_keyword_group_highlighting ( $key, $flag = true )
{
$this->lexic_permissions['KEYWORDS'][$key] = ($flag) ? true : false;
}
/**
* Sets the styles for comment groups. If $preserve_defaults is
* true, then styles are merged with the default styles, with the
* user defined styles having priority
*
* @param int The key of the comment group to change the styles of
* @param string The style to make the comments
* @param boolean Whether to merge the new styles with the old or just
* to overwrite them
* @since 1.0.0
*/
function set_comments_style ($key, $style, $preserve_defaults = false)
{
if (!$preserve_defaults) {
$this->language_data['STYLES']['COMMENTS'][$key] = $style;
} else {
$this->language_data['STYLES']['COMMENTS'][$key] .= $style;
}
}
/**
* Turns highlighting on/off for comment groups
*
* @param int The key of the comment group to turn on or off
* @param boolean Whether to turn highlighting for that group on or off
* @since 1.0.0
*/
function set_comments_highlighting ($key, $flag = true)
{
$this->lexic_permissions['COMMENTS'][$key] = ($flag) ? true : false;
}
/**
* Sets the styles for escaped characters. If $preserve_defaults is
* true, then styles are merged with the default styles, with the
* user defined styles having priority
*
* @param string The style to make the escape characters
* @param boolean Whether to merge the new styles with the old or just
* to overwrite them
* @since 1.0.0
*/
function set_escape_characters_style ($style, $preserve_defaults = false)
{
if (!$preserve_defaults) {
$this->language_data['STYLES']['ESCAPE_CHAR'][0] = $style;
} else {
$this->language_data['STYLES']['ESCAPE_CHAR'][0] .= $style;
}
}
/**
* Turns highlighting on/off for escaped characters
*
* @param boolean Whether to turn highlighting for escape characters on or off
* @since 1.0.0
*/
function set_escape_characters_highlighting ($flag = true)
{
$this->lexic_permissions['ESCAPE_CHAR'] = ($flag) ? true : false;
}
/**
* Sets the styles for brackets. If $preserve_defaults is
* true, then styles are merged with the default styles, with the
* user defined styles having priority
*
* This method is DEPRECATED: use set_symbols_style instead.
* This method will be removed in 1.2.X
*
* @param string The style to make the brackets
* @param boolean Whether to merge the new styles with the old or just
* to overwrite them
* @since 1.0.0
* @deprecated In favour of set_symbols_style
*/
function set_brackets_style ($style, $preserve_defaults = false)
{
if (!$preserve_defaults) {
$this->language_data['STYLES']['BRACKETS'][0] = $style;
} else {
$this->language_data['STYLES']['BRACKETS'][0] = $style;
}
}
/**
* Turns highlighting on/off for brackets
*
* This method is DEPRECATED: use set_symbols_highlighting instead.
* This method will be remove in 1.2.X
*
* @param boolean Whether to turn highlighting for brackets on or off
* @since 1.0.0
* @deprecated In favour of set_symbols_highlighting
*/
function set_brackets_highlighting ($flag)
{
$this->lexic_permissions['BRACKETS'] = ($flag) ? true : false;
}
/**
* Sets the styles for symbols. If $preserve_defaults is
* true, then styles are merged with the default styles, with the
* user defined styles having priority
*
* @param string The style to make the symbols
* @param boolean Whether to merge the new styles with the old or just
* to overwrite them
* @since 1.0.1
*/
function set_symbols_style ($style, $preserve_defaults = false)
{
if (!$preserve_defaults) {
$this->language_data['STYLES']['SYMBOLS'][0] = $style;
} else {
$this->language_data['STYLES']['SYMBOLS'][0] = $style;
}
// For backward compatibility
$this->set_brackets_style ($style, $preserve_defaults);
}
/**
* Turns highlighting on/off for symbols
*
* @param boolean Whether to turn highlighting for symbols on or off
* @since 1.0.0
*/
function set_symbols_highlighting ($flag)
{
$this->lexic_permissions['SYMBOLS'] = ($flag) ? true : false;
// For backward compatibility
$this->set_brackets_highlighting ($flag);
}
/**
* Sets the styles for strings. If $preserve_defaults is
* true, then styles are merged with the default styles, with the
* user defined styles having priority
*
* @param string The style to make the escape characters
* @param boolean Whether to merge the new styles with the old or just
* to overwrite them
* @since 1.0.0
*/
function set_strings_style ($style, $preserve_defaults = false)
{
if (!$preserve_defaults) {
$this->language_data['STYLES']['STRINGS'][0] = $style;
} else {
$this->language_data['STYLES']['STRINGS'][0] = $style;
}
}
/**
* Turns highlighting on/off for strings
*
* @param boolean Whether to turn highlighting for strings on or off
* @since 1.0.0
*/
function set_strings_highlighting ($flag)
{
$this->lexic_permissions['STRINGS'] = ($flag) ? true : false;
}
/**
* Sets the styles for numbers. If $preserve_defaults is
* true, then styles are merged with the default styles, with the
* user defined styles having priority
*
* @param string The style to make the numbers
* @param boolean Whether to merge the new styles with the old or just
* to overwrite them
* @since 1.0.0
*/
function set_numbers_style ($style, $preserve_defaults = false)
{
if (!$preserve_defaults) {
$this->language_data['STYLES']['NUMBERS'][0] = $style;
} else {
$this->language_data['STYLES']['NUMBERS'][0] = $style;
}
}
/**
* Turns highlighting on/off for numbers
*
* @param boolean Whether to turn highlighting for numbers on or off
* @since 1.0.0
*/
function set_numbers_highlighting ($flag)
{
$this->lexic_permissions['NUMBERS'] = ($flag) ? true : false;
}
/**
* Sets the styles for methods. $key is a number that references the
* appropriate "object splitter" - see the language file for the language
* you are highlighting to get this number. If $preserve_defaults is
* true, then styles are merged with the default styles, with the
* user defined styles having priority
*
* @param int The key of the object splitter to change the styles of
* @param string The style to make the methods
* @param boolean Whether to merge the new styles with the old or just
* to overwrite them
* @since 1.0.0
*/
function set_methods_style ($key, $style, $preserve_defaults = false)
{
if (!$preserve_defaults) {
$this->language_data['STYLES']['METHODS'][$key] = $style;
} else {
$this->language_data['STYLES']['METHODS'][$key] .= $style;
}
}
/**
* Turns highlighting on/off for methods
*
* @param boolean Whether to turn highlighting for methods on or off
* @since 1.0.0
*/
function set_methods_highlighting ($flag)
{
$this->lexic_permissions['METHODS'] = ($flag) ? true : false;
}
/**
* Sets the styles for regexps. If $preserve_defaults is
* true, then styles are merged with the default styles, with the
* user defined styles having priority
*
* @param string The style to make the regular expression matches
* @param boolean Whether to merge the new styles with the old or just
* to overwrite them
* @since 1.0.0
*/
function set_regexps_style ($key, $style, $preserve_defaults = false)
{
if (!$preserve_defaults) {
$this->language_data['STYLES']['REGEXPS'][$key] = $style;
} else {
$this->language_data['STYLES']['REGEXPS'][$key] = $style;
}
}
/**
* Turns highlighting on/off for regexps
*
* @param int The key of the regular expression group to turn on or off
* @param boolean Whether to turn highlighting for the regular expression group on or off
* @since 1.0.0
*/
function set_regexps_highlighting ($key, $flag)
{
$this->lexic_permissions['REGEXPS'][$key] = ($flag) ? true : false;
}
/**
* Sets whether a set of keywords are checked for in a case sensitive manner
*
* @param int The key of the keyword group to change the case sensitivity of
* @param boolean Whether to check in a case sensitive manner or not
* @since 1.0.0
*/
function set_case_sensitivity ($key, $case)
{
$this->language_data['CASE_SENSITIVE'][$key] = ($case) ? true : false;
}
/**
* Sets the case that keywords should use when found. Use the constants:
*
*
* - GESHI_CAPS_NO_CHANGE: leave keywords as-is
* - GESHI_CAPS_UPPER: convert all keywords to uppercase where found
* - GESHI_CAPS_LOWER: convert all keywords to lowercase where found
*
*
* @param int A constant specifying what to do with matched keywords
* @since 1.0.1
* @todo Error check the passed value
*/
function set_case_keywords ($case)
{
$this->language_data['CASE_KEYWORDS'] = $case;
}
/**
* Sets how many spaces a tab is substituted for
*
* Widths below zero are ignored
*
* @param int The tab width
* @since 1.0.0
*/
function set_tab_width ($width)
{
$this->tab_width = intval($width);
}
/**
* Enables/disables strict highlighting. Default is off, calling this
* method without parameters will turn it on. See documentation
* for more details on strict mode and where to use it.
*
* @param boolean Whether to enable strict mode or not
* @since 1.0.0
*/
function enable_strict_mode ($mode = true)
{
if (GESHI_MAYBE == $this->language_data['STRICT_MODE_APPLIES']) {
$this->strict_mode = ($mode) ? true : false;
}
}
/**
* Disables all highlighting
*
* @since 1.0.0
* @todo Rewrite with an array traversal
*/
function disable_highlighting ()
{
foreach ($this->lexic_permissions as $key => $value) {
if (is_array($value)) {
foreach ($value as $k => $v) {
$this->lexic_permissions[$key][$k] = false;
}
} else {
$this->lexic_permissions[$key] = false;
}
}
// Context blocks
$this->enable_important_blocks = false;
}
/**
* Enables all highlighting
*
* @since 1.0.0
* @todo Rewrite with array traversal
*/
function enable_highlighting ()
{
foreach ($this->lexic_permissions as $key => $value) {
if (is_array($value)) {
foreach ($value as $k => $v) {
$this->lexic_permissions[$key][$k] = true;
}
} else {
$this->lexic_permissions[$key] = true;
}
}
// Context blocks
$this->enable_important_blocks = true;
}
/**
* Given a file extension, this method returns either a valid geshi language
* name, or the empty string if it couldn't be found
*
* @param string The extension to get a language name for
* @param array A lookup array to use instead of the default
* @since 1.0.5
* @todo Re-think about how this method works (maybe make it private and/or make it
* a extension->lang lookup?)
* @todo static?
*/
function get_language_name_from_extension ( $extension, $lookup = array() )
{
if ( !$lookup )
{
$lookup = array(
'actionscript' => array('as'),
'ada' => array('a', 'ada', 'adb', 'ads'),
'apache' => array('conf'),
'asm' => array('ash', 'asm'),
'asp' => array('asp'),
'bash' => array('sh'),
'c' => array('c'),
'c_mac' => array('c'),
'caddcl' => array(),
'cadlisp' => array(),
'cpp' => array('cpp'),
'csharp' => array(),
'css' => array('css'),
'delphi' => array('dpk', 'dpr'),
'html4strict' => array('html', 'htm'),
'java' => array('java'),
'javascript' => array('js'),
'lisp' => array('lisp'),
'lua' => array('lua'),
'mpasm' => array(),
'nsis' => array(),
'objc' => array(),
'oobas' => array(),
'oracle8' => array(),
'pascal' => array('pas'),
'perl' => array('pl', 'pm'),
'php' => array('php', 'php5', 'phtml', 'phps'),
'python' => array('py'),
'qbasic' => array('bi'),
'smarty' => array(),
'vb' => array('bas'),
'vbnet' => array(),
'visualfoxpro' => array(),
'xml' => array('xml')
);
}
foreach ($lookup as $lang => $extensions) {
foreach ($extensions as $ext) {
if ($ext == $extension) {
return $lang;
}
}
}
return '';
}
/**
* Given a file name, this method loads its contents in, and attempts
* to set the language automatically. An optional lookup table can be
* passed for looking up the language name. If not specified a default
* table is used
*
* The language table is in the form
*
array(
* 'lang_name' => array('extension', 'extension', ...),
* 'lang_name' ...
* );
*
* @todo Complete rethink of this and above method
* @since 1.0.5
*/
function load_from_file ($file_name, $lookup = array())
{
if (is_readable($file_name)) {
$this->set_source(implode('', file($file_name)));
$this->set_language($this->get_language_name_from_extension(substr(strrchr($file_name, '.'), 1), $lookup));
} else {
$this->error = GESHI_ERROR_FILE_NOT_READABLE;
}
}
/**
* Adds a keyword to a keyword group for highlighting
*
* @param int The key of the keyword group to add the keyword to
* @param string The word to add to the keyword group
* @since 1.0.0
*/
function add_keyword ($key, $word)
{
$this->language_data['KEYWORDS'][$key][] = $word;
}
/**
* Removes a keyword from a keyword group
*
* @param int The key of the keyword group to remove the keyword from
* @param string The word to remove from the keyword group
* @since 1.0.0
*/
function remove_keyword ($key, $word)
{
$this->language_data['KEYWORDS'][$key] =
array_diff($this->language_data['KEYWORDS'][$key], array($word));
}
/**
* Creates a new keyword group
*
* @param int The key of the keyword group to create
* @param string The styles for the keyword group
* @param boolean Whether the keyword group is case sensitive ornot
* @param array The words to use for the keyword group
* @since 1.0.0
*/
function add_keyword_group ( $key, $styles, $case_sensitive = true, $words = array() )
{
$words = (array) $words;
$this->language_data['KEYWORDS'][$key] = $words;
$this->lexic_permissions['KEYWORDS'][$key] = true;
$this->language_data['CASE_SENSITIVE'][$key] = $case_sensitive;
$this->language_data['STYLES']['KEYWORDS'][$key] = $styles;
}
/**
* Removes a keyword group
*
* @param int The key of the keyword group to remove
* @since 1.0.0
*/
function remove_keyword_group ($key)
{
unset($this->language_data['KEYWORDS'][$key]);
unset($this->lexic_permissions['KEYWORDS'][$key]);
unset($this->language_data['CASE_SENSITIVE'][$key]);
unset($this->language_data['STYLES']['KEYWORDS'][$key]);
}
/**
* Sets the content of the header block
*
* @param string The content of the header block
* @since 1.0.2
*/
function set_header_content ($content)
{
$this->header_content = $content;
}
/**
* Sets the content of the footer block
*
* @param string The content of the footer block
* @since 1.0.2
*/
function set_footer_content ($content)
{
$this->footer_content = $content;
}
/**
* Sets the style for the header content
*
* @param string The style for the header content
* @since 1.0.2
*/
function set_header_content_style ($style)
{
$this->header_content_style = $style;
}
/**
* Sets the style for the footer content
*
* @param string The style for the footer content
* @since 1.0.2
*/
function set_footer_content_style ($style)
{
$this->footer_content_style = $style;
}
/**
* Sets the base URL to be used for keywords
*
* @param int The key of the keyword group to set the URL for
* @param string The URL to set for the group. If {FNAME} is in
* the url somewhere, it is replaced by the keyword
* that the URL is being made for
* @since 1.0.2
*/
function set_url_for_keyword_group ($group, $url)
{
$this->language_data['URLS'][$group] = $url;
}
/**
* Sets styles for links in code
*
* @param int A constant that specifies what state the style is being
* set for - e.g. :hover or :visited
* @param string The styles to use for that state
* @since 1.0.2
*/
function set_link_styles ($type, $styles)
{
$this->link_styles[$type] = $styles;
}
/**
* Sets the target for links in code
*
* @param string The target for links in the code, e.g. _blank
* @since 1.0.3
*/
function set_link_target ( $target )
{
if (!$target) {
$this->link_target = '';
} else {
$this->link_target = ' target="' . $target . '" ';
}
}
/**
* Sets styles for important parts of the code
*
* @param string The styles to use on important parts of the code
* @since 1.0.2
*/
function set_important_styles ($styles)
{
$this->important_styles = $styles;
}
/**
* Sets whether context-important blocks are highlighted
*
* @todo REMOVE THIS SHIZ FROM GESHI!
*/
function enable_important_blocks ( $flag )
{
$this->enable_important_blocks = ( $flag ) ? true : false;
}
/**
* Whether CSS IDs should be added to each line
*
* @param boolean If true, IDs will be added to each line.
* @since 1.0.2
*/
function enable_ids ($flag = true)
{
$this->add_ids = ($flag) ? true : false;
}
/**
* Specifies which lines to highlight extra
*
* @param mixed An array of line numbers to highlight, or just a line
* number on its own.
* @since 1.0.2
* @todo Some data replication here that could be cut down on
*/
function highlight_lines_extra ($lines)
{
if (is_array($lines)) {
foreach ($lines as $line) {
$this->highlight_extra_lines[intval($line)] = intval($line);
}
} else {
$this->highlight_extra_lines[intval($lines)] = intval($lines);
}
}
/**
* Sets the style for extra-highlighted lines
*
* @param string The style for extra-highlighted lines
* @since 1.0.2
*/
function set_highlight_lines_extra_style ($styles)
{
$this->highlight_extra_lines_style = $styles;
}
/**
* Sets what number line numbers should start at. Should
* be a positive integer, and will be converted to one.
*
*
Warning: Using this method will add the "start"
* attribute to the <ol> that is used for line numbering.
* This is
not valid XHTML strict, so if that's what you
* care about then don't use this method. Firefox is getting
* support for the CSS method of doing this in 1.1 and Opera
* has support for the CSS method, but (of course) IE doesn't
* so it's not worth doing it the CSS way yet.
*
* @param int The number to start line numbers at
* @since 1.0.2
*/
function start_line_numbers_at ($number)
{
$this->line_numbers_start = abs(intval($number));
}
/**
* Sets the encoding used for htmlspecialchars(), for international
* support.
*
* @param string The encoding to use for the source
* @since 1.0.3
*/
function set_encoding ($encoding)
{
if ($encoding) {
$this->encoding = $encoding;
}
}
/**
* Returns the code in $this->source, highlighted and surrounded by the
* nessecary HTML.
*
* This should only be called ONCE, cos it's SLOW! If you want to highlight
* the same source multiple times, you're better off doing a whole lot of
* str_replaces to replace the <span>s
*
* @since 1.0.0
*/
function parse_code ()
{
// Start the timer
$start_time = microtime();
// Firstly, if there is an error, we won't highlight
if ($this->error) {
$result = $this->header();
if ($this->header_type != GESHI_HEADER_PRE) {
$result .= $this->indent(@htmlspecialchars($this->source, ENT_COMPAT, $this->encoding));
} else {
$result .= @htmlspecialchars($this->source, ENT_COMPAT, $this->encoding);
}
// Stop Timing
$this->set_time($start_time, microtime());
return $result . $this->footer();
}
// Add spaces for regular expression matching and line numbers
$code = ' ' . $this->source . ' ';
// Replace all newlines to a common form.
$code = str_replace("\r\n", "\n", $code);
$code = str_replace("\r", "\n", $code);
// Initialise various stuff
$length = strlen($code);
$STRING_OPEN = '';
$CLOSE_STRING = false;
$ESCAPE_CHAR_OPEN = false;
$COMMENT_MATCHED = false;
// Turn highlighting on if strict mode doesn't apply to this language
$HIGHLIGHTING_ON = ( !$this->strict_mode ) ? true : '';
// Whether to highlight inside a block of code
$HIGHLIGHT_INSIDE_STRICT = false;
$stuff_to_parse = '';
$result = '';
// "Important" selections are handled like multiline comments
// @todo GET RID OF THIS SHIZ
if ($this->enable_important_blocks) {
$this->language_data['COMMENT_MULTI'][GESHI_START_IMPORTANT] = GESHI_END_IMPORTANT;
}
if ($this->strict_mode) {
// Break the source into bits. Each bit will be a portion of the code
// within script delimiters - for example, HTML between < and >
$parts = array(0 => array(0 => ''));
$k = 0;
for ($i = 0; $i < $length; $i++) {
$char = substr($code, $i, 1);
if (!$HIGHLIGHTING_ON) {
foreach ($this->language_data['SCRIPT_DELIMITERS'] as $key => $delimiters) {
foreach ($delimiters as $open => $close) {
// Get the next little bit for this opening string
$check = substr($code, $i, strlen($open));
// If it matches...
if ($check == $open) {
// We start a new block with the highlightable
// code in it
$HIGHLIGHTING_ON = $open;
$i += strlen($open) - 1;
$char = $open;
$parts[++$k][0] = $char;
// No point going around again...
break(2);
}
}
}
} else {
foreach ($this->language_data['SCRIPT_DELIMITERS'] as $key => $delimiters) {
foreach ($delimiters as $open => $close) {
if ($open == $HIGHLIGHTING_ON) {
// Found the closing tag
break(2);
}
}
}
// We check code from our current position BACKWARDS. This is so
// the ending string for highlighting can be included in the block
$check = substr($code, $i - strlen($close) + 1, strlen($close));
if ($check == $close) {
$HIGHLIGHTING_ON = '';
// Add the string to the rest of the string for this part
$parts[$k][1] = ( isset($parts[$k][1]) ) ? $parts[$k][1] . $char : $char;
$parts[++$k][0] = '';
$char = '';
}
}
$parts[$k][1] = ( isset($parts[$k][1]) ) ? $parts[$k][1] . $char : $char;
}
$HIGHLIGHTING_ON = '';
} else {
// Not strict mode - simply dump the source into
// the array at index 1 (the first highlightable block)
$parts = array(
1 => array(
0 => '',
1 => $code
)
);
}
// Now we go through each part. We know that even-indexed parts are
// code that shouldn't be highlighted, and odd-indexed parts should
// be highlighted
foreach ($parts as $key => $data) {
$part = $data[1];
// If this block should be highlighted...
if ($key % 2) {
if ($this->strict_mode) {
// Find the class key for this block of code
foreach ($this->language_data['SCRIPT_DELIMITERS'] as $script_key => $script_data) {
foreach ($script_data as $open => $close) {
if ($data[0] == $open) {
break(2);
}
}
}
if ($this->language_data['STYLES']['SCRIPT'][$script_key] != '' &&
$this->lexic_permissions['SCRIPT']) {
// Add a span element around the source to
// highlight the overall source block
if (!$this->use_classes &&
$this->language_data['STYLES']['SCRIPT'][$script_key] != '') {
$attributes = ' style="' . $this->language_data['STYLES']['SCRIPT'][$script_key] . '"';
} else {
$attributes = ' class="sc' . $script_key . '"';
}
$result .= "
";
}
}
if (!$this->strict_mode || $this->language_data['HIGHLIGHT_STRICT_BLOCK'][$script_key]) {
// Now, highlight the code in this block. This code
// is really the engine of GeSHi (along with the method
// parse_non_string_part).
$length = strlen($part);
for ($i = 0; $i < $length; $i++) {
// Get the next char
$char = substr($part, $i, 1);
// Is this char the newline and line numbers being used?
if (($this->line_numbers != GESHI_NO_LINE_NUMBERS
|| count($this->highlight_extra_lines) > 0)
&& $char == "\n") {
// If so, is there a string open? If there is, we should end it before
// the newline and begin it again (so when s are put in the source
// remains XHTML compliant)
// note to self: This opens up possibility of config files specifying
// that languages can/cannot have multiline strings???
if ($STRING_OPEN) {
if (!$this->use_classes) {
$attributes = ' style="' . $this->language_data['STYLES']['STRINGS'][0] . '"';
} else {
$attributes = ' class="st0"';
}
$char = '' . $char . "";
}
} elseif ($char == $STRING_OPEN) {
// A match of a string delimiter
if (($this->lexic_permissions['ESCAPE_CHAR'] && $ESCAPE_CHAR_OPEN) ||
($this->lexic_permissions['STRINGS'] && !$ESCAPE_CHAR_OPEN)) {
$char .= '';
}
if (!$ESCAPE_CHAR_OPEN) {
$STRING_OPEN = '';
$CLOSE_STRING = true;
}
$ESCAPE_CHAR_OPEN = false;
} elseif (in_array($char, $this->language_data['QUOTEMARKS']) &&
($STRING_OPEN == '') && $this->lexic_permissions['STRINGS']) {
// The start of a new string
$STRING_OPEN = $char;
if (!$this->use_classes) {
$attributes = ' style="' . $this->language_data['STYLES']['STRINGS'][0] . '"';
} else {
$attributes = ' class="st0"';
}
$char = "" . $char;
$result .= $this->parse_non_string_part( $stuff_to_parse );
$stuff_to_parse = '';
} elseif (($char == $this->language_data['ESCAPE_CHAR']) && ($STRING_OPEN != '')) {
// An escape character
if (!$ESCAPE_CHAR_OPEN) {
$ESCAPE_CHAR_OPEN = true;
if ($this->lexic_permissions['ESCAPE_CHAR']) {
if (!$this->use_classes) {
$attributes = ' style="' . $this->language_data['STYLES']['ESCAPE_CHAR'][0] . '"';
} else {
$attributes = ' class="es0"';
}
$char = "" . $char;
}
} else {
$ESCAPE_CHAR_OPEN = false;
if ($this->lexic_permissions['ESCAPE_CHAR']) {
$char .= '';
}
}
} elseif ($ESCAPE_CHAR_OPEN) {
if ($this->lexic_permissions['ESCAPE_CHAR']) {
$char .= '';
}
$ESCAPE_CHAR_OPEN = false;
$test_str = $char;
} elseif ($STRING_OPEN == '') {
// Is this a multiline comment?
foreach ($this->language_data['COMMENT_MULTI'] as $open => $close) {
$com_len = strlen($open);
$test_str = substr( $part, $i, $com_len );
$test_str_match = $test_str;
if ($open == $test_str) {
$COMMENT_MATCHED = true;
//@todo If remove important do remove here
if ($this->lexic_permissions['COMMENTS']['MULTI'] ||
$test_str == GESHI_START_IMPORTANT) {
if ($test_str != GESHI_START_IMPORTANT) {
if (!$this->use_classes) {
$attributes = ' style="' . $this->language_data['STYLES']['COMMENTS']['MULTI'] . '"';
} else {
$attributes = ' class="coMULTI"';
}
$test_str = "" . @htmlspecialchars($test_str, ENT_COMPAT, $this->encoding);
} else {
if (!$this->use_classes) {
$attributes = ' style="' . $this->important_styles . '"';
} else {
$attributes = ' class="imp"';
}
// We don't include the start of the comment if it's an
// "important" part
$test_str = "";
}
} else {
$test_str = @htmlspecialchars($test_str, ENT_COMPAT, $this->encoding);
}
$close_pos = strpos( $part, $close, $i + strlen($close) );
if ($close_pos === false) {
$close_pos = strlen($part);
}
// Short-cut through all the multiline code
$rest_of_comment = @htmlspecialchars(substr($part, $i + $com_len, $close_pos - $i), ENT_COMPAT, $this->encoding);
if (($this->lexic_permissions['COMMENTS']['MULTI'] ||
$test_str_match == GESHI_START_IMPORTANT) &&
($this->line_numbers != GESHI_NO_LINE_NUMBERS ||
count($this->highlight_extra_lines) > 0)) {
// strreplace to put close span and open span around multiline newlines
$test_str .= str_replace("\n", "\n", $rest_of_comment);
} else {
$test_str .= $rest_of_comment;
}
if ($this->lexic_permissions['COMMENTS']['MULTI'] ||
$test_str_match == GESHI_START_IMPORTANT) {
$test_str .= '';
}
$i = $close_pos + $com_len - 1;
// parse the rest
$result .= $this->parse_non_string_part($stuff_to_parse);
$stuff_to_parse = '';
break;
}
}
// If we haven't matched a multiline comment, try single-line comments
if (!$COMMENT_MATCHED) {
foreach ($this->language_data['COMMENT_SINGLE'] as $comment_key => $comment_mark) {
$com_len = strlen($comment_mark);
$test_str = substr($part, $i, $com_len);
if ($this->language_data['CASE_SENSITIVE'][GESHI_COMMENTS]) {
$match = ($comment_mark == $test_str);
} else {
$match = (strtolower($comment_mark) == strtolower($test_str));
}
if ($match) {
$COMMENT_MATCHED = true;
if ($this->lexic_permissions['COMMENTS'][$comment_key]) {
if (!$this->use_classes) {
$attributes = ' style="' . $this->language_data['STYLES']['COMMENTS'][$comment_key] . '"';
} else {
$attributes = ' class="co' . $comment_key . '"';
}
$test_str = "" . @htmlspecialchars($this->change_case($test_str), ENT_COMPAT, $this->encoding);
} else {
$test_str = @htmlspecialchars($test_str, ENT_COMPAT, $this->encoding);
}
$close_pos = strpos($part, "\n", $i);
if ($close_pos === false) {
$close_pos = strlen($part);
}
$test_str .= @htmlspecialchars(substr($part, $i + $com_len, $close_pos - $i - $com_len), ENT_COMPAT, $this->encoding);
if ($this->lexic_permissions['COMMENTS'][$comment_key]) {
$test_str .= "";
}
$test_str .= "\n";
$i = $close_pos;
// parse the rest
$result .= $this->parse_non_string_part($stuff_to_parse);
$stuff_to_parse = '';
break;
}
}
}
} elseif ($STRING_OPEN != '') {
// Otherwise, convert it to HTML form
if (strtolower($this->encoding) == 'utf-8') {
//only escape <128 (we don't want to break multibyte chars)
if (ord($char) < 128) {
$char = @htmlspecialchars($char, ENT_COMPAT, $this->encoding);
}
} else {
//encode everthing
$char = @htmlspecialchars($char, ENT_COMPAT, $this->encoding);
}
}
// Where are we adding this char?
if (!$COMMENT_MATCHED) {
if (($STRING_OPEN == '') && !$CLOSE_STRING) {
$stuff_to_parse .= $char;
} else {
$result .= $char;
$CLOSE_STRING = false;
}
} else {
$result .= $test_str;
$COMMENT_MATCHED = false;
}
}
// Parse the last bit
$result .= $this->parse_non_string_part($stuff_to_parse);
$stuff_to_parse = '';
} else {
$result .= @htmlspecialchars($part, ENT_COMPAT, $this->encoding);
}
// Close the that surrounds the block
if ($this->strict_mode && $this->lexic_permissions['SCRIPT']) {
$result .= '';
}
} else {
// Else not a block to highlight
$result .= @htmlspecialchars($part, ENT_COMPAT, $this->encoding);
}
}
// Parse the last stuff (redundant?)
$result .= $this->parse_non_string_part($stuff_to_parse);
// Lop off the very first and last spaces
$result = substr($result, 1, strlen($result) - 1);
// Are we still in a string?
if ($STRING_OPEN) {
$result .= '';
}
// We're finished: stop timing
$this->set_time($start_time, microtime());
return $this->finalise($result);
}
/**
* Swaps out spaces and tabs for HTML indentation. Not needed if
* the code is in a pre block...
*
* @param string The source to indent
* @return string The source with HTML indenting applied
* @since 1.0.0
* @access private
*/
function indent ($result)
{
/// Replace tabs with the correct number of spaces
if (false !== strpos($result, "\t")) {
$lines = explode("\n", $result);
foreach ($lines as $key => $line) {
if (false === strpos($line, "\t")) {
$lines[$key] = $line;
continue;
}//echo 'checking line ' . $key . '
';
$pos = 0;
$tab_width = $this->tab_width;
$length = strlen($line);
$result_line = '';
//echo 'line: ' . htmlspecialchars($line) . '
';
$IN_TAG = false;
for ($i = 0; $i < $length; $i++) {
$char = substr($line, $i, 1);
// Simple engine to work out whether we're in a tag.
// If we are we modify $pos. This is so we ignore HTML
// in the line and only workout the tab replacement
// via the actual content of the string
// This test could be improved to include strings in the
// html so that < or > would be allowed in user's styles
// (e.g. quotes: '<' '>'; or similar)
if ($IN_TAG && '>' == $char) {
$IN_TAG = false;
$result_line .= '>';
++$pos;
} elseif (!$IN_TAG && '<' == $char) {
$IN_TAG = true;
$result_line .= '<';
++$pos;
} elseif (!$IN_TAG && '&' == $char) {
//echo "matched & in line... ";
$substr = substr($line, $i + 3, 4);
//$substr_5 = substr($line, 5, 1);
$posi = strpos($substr, ';');
if (false !== $posi) {
//echo "found entity at $posi\n";
$pos += $posi + 3;
}
$result_line .= '&';
} elseif (!$IN_TAG && "\t" == $char) {
$str = '';
// OPTIMISE - move $strs out. Make an array:
// $tabs = array(
// 1 => ' ',
// 2 => ' ',
// 3 => ' ' etc etc
// to use instead of building a string every time
$strs = array(0 => ' ', 1 => ' ');
//echo "building (pos=$pos i=$i) (" . ($i - $pos) . ") " . ($tab_width - (($i - $pos) % $tab_width)) . " spaces\n";
for ($k = 0; $k < ($tab_width - (($i - $pos) % $tab_width)); $k++) $str .= $strs[$k % 2];
$result_line .= $str;
//$pos--;
$pos++;
//$pos -= $tab_width-1;
if (false === strpos($line, "\t", $i + 1)) {
//$lines[$key] = $result_line;
//echo 'got here';
$result_line .= substr($line, $i + 1);
break;
}
} elseif ( $IN_TAG ) {
++$pos;
$result_line .= $char;
} else {
$result_line .= $char;
//++$pos;
}
}
$lines[$key] = $result_line;
}
$result = implode("\n", $lines);
}
// Other whitespace
$result = str_replace(' ', ' ', $result);
$result = str_replace(' ', ' ', $result);
$result = str_replace("\n ", "\n ", $result);
if ($this->line_numbers == GESHI_NO_LINE_NUMBERS) {
$result = nl2br($result);
}
return $result;
}
/**
* Changes the case of a keyword for those languages where a change is asked for
*
* @param string The keyword to change the case of
* @return string The keyword with its case changed
* @since 1.0.0
* @access private
*/
function change_case ($instr)
{
if ($this->language_data['CASE_KEYWORDS'] == GESHI_CAPS_UPPER) {
return strtoupper($instr);
} elseif ($this->language_data['CASE_KEYWORDS'] == GESHI_CAPS_LOWER) {
return strtolower($instr);
}
return $instr;
}
/**
* Adds a url to a keyword where needed.
*
* @param string The keyword to add the URL HTML to
* @param int What group the keyword is from
* @param boolean Whether to get the HTML for the start or end
* @return The HTML for either the start or end of the HTML <a> tag
* @since 1.0.2
* @access private
* @todo Get rid of ender
*/
function add_url_to_keyword ($keyword, $group, $start_or_end)
{
if (isset($this->language_data['URLS'][$group]) &&
$this->language_data['URLS'][$group] != '' &&
substr($keyword, 0, 5) != '</') {
// There is a base group for this keyword
if ($start_or_end == 'BEGIN') {
// HTML workaround... not good form (tm) but should work for 1.0.X
$keyword = ( substr($keyword, 0, 4) == '<' ) ? substr($keyword, 4) : $keyword;
$keyword = ( substr($keyword, -4) == '>' ) ? substr($keyword, 0, strlen($keyword) - 4) : $keyword;
if ($keyword != '') {
$keyword = ( $this->language_data['CASE_SENSITIVE'][$group] ) ? $keyword : strtolower($keyword);
return '<|UR1|"' .
str_replace(
array('{FNAME}', '.'),
array(@htmlspecialchars($keyword, ENT_COMPAT, $this->encoding), ''),
$this->language_data['URLS'][$group]
) . '">';
}
return '';
} else {
return '';
}
}
}
/**
* Takes a string that has no strings or comments in it, and highlights
* stuff like keywords, numbers and methods.
*
* @param string The string to parse for keyword, numbers etc.
* @since 1.0.0
* @access private
* @todo BUGGY! Why? Why not build string and return?
*/
function parse_non_string_part (&$stuff_to_parse)
{
$stuff_to_parse = ' ' . quotemeta(@htmlspecialchars($stuff_to_parse, ENT_COMPAT, $this->encoding));
// These vars will disappear in the future
$func = '$this->change_case';
$func2 = '$this->add_url_to_keyword';
//
// Regular expressions
//
foreach ($this->language_data['REGEXPS'] as $key => $regexp) {
if ($this->lexic_permissions['REGEXPS'][$key]) {
if (is_array($regexp)) {
$stuff_to_parse = preg_replace(
"#" .
$regexp[GESHI_SEARCH] .
"#{$regexp[GESHI_MODIFIERS]}",
"{$regexp[GESHI_BEFORE]}<|!REG3XP$key!>{$regexp[GESHI_REPLACE]}|>{$regexp[GESHI_AFTER]}",
$stuff_to_parse
);
} else {
$stuff_to_parse = preg_replace( "#(" . $regexp . ")#", "<|!REG3XP$key!>\\1|>", $stuff_to_parse);
}
}
}
//
// Highlight numbers. This regexp sucks... anyone with a regexp that WORKS
// here wins a cookie if they send it to me. At the moment there's two doing
// almost exactly the same thing, except the second one prevents a number
// being highlighted twice (eg 5)
// Put /NUM!/ in for the styles, which gets replaced at the end.
//
if ($this->lexic_permissions['NUMBERS'] && preg_match('#[0-9]#', $stuff_to_parse )) {
$stuff_to_parse = preg_replace('#([^a-zA-Z0-9\#])([0-9]+)([^a-zA-Z0-9])#', "\\1<|/NUM!/>\\2|>\\3", $stuff_to_parse);
$stuff_to_parse = preg_replace('#([^a-zA-Z0-9\#>])([0-9]+)([^a-zA-Z0-9])#', "\\1<|/NUM!/>\\2|>\\3", $stuff_to_parse);
}
// Highlight keywords
// if there is a couple of alpha symbols there *might* be a keyword
if (preg_match('#[a-zA-Z]{2,}#', $stuff_to_parse)) {
foreach ($this->language_data['KEYWORDS'] as $k => $keywordset) {
if ($this->lexic_permissions['KEYWORDS'][$k]) {
foreach ($keywordset as $keyword) {
$keyword = quotemeta($keyword);
//
// This replacement checks the word is on it's own (except if brackets etc
// are next to it), then highlights it. We don't put the color=" for the span
// in just yet - otherwise languages with the keywords "color" or "or" have
// a fit.
//
if (false !== stristr($stuff_to_parse, $keyword )) {
$stuff_to_parse .= ' ';
// Might make a more unique string for putting the number in soon
// Basically, we don't put the styles in yet because then the styles themselves will
// get highlighted if the language has a CSS keyword in it (like CSS, for example ;))
$styles = "/$k/";
$keyword = quotemeta($keyword);
if ($this->language_data['CASE_SENSITIVE'][$k]) {
$stuff_to_parse = preg_replace(
"#([^a-zA-Z0-9\$_\|\.\#;>])($keyword)([^a-zA-Z0-9_<\|%\-&])#e",
"'\\1' . $func2('\\2', '$k', 'BEGIN') . '<|$styles>' . $func('\\2') . '|>' . $func2('\\2', '$k', 'END') . '\\3'",
$stuff_to_parse
);
} else {
// Change the case of the word.
$stuff_to_parse = preg_replace(
"#([^a-zA-Z0-9\$_\|\.\#;>])($keyword)([^a-zA-Z0-9_<\|%\-&])#ie",
"'\\1' . $func2('\\2', '$k', 'BEGIN') . '<|$styles>' . $func('\\2') . '|>' . $func2('\\2', '$k', 'END') . '\\3'",
$stuff_to_parse
);
}
$stuff_to_parse = substr($stuff_to_parse, 0, strlen($stuff_to_parse) - 1);
}
}
}
}
}
//
// Now that's all done, replace /[number]/ with the correct styles
//
foreach ($this->language_data['KEYWORDS'] as $k => $kws) {
if (!$this->use_classes) {
$attributes = ' style="' . $this->language_data['STYLES']['KEYWORDS'][$k] . '"';
} else {
$attributes = ' class="kw' . $k . '"';
}
$stuff_to_parse = str_replace("/$k/", $attributes, $stuff_to_parse);
}
// Put number styles in
if (!$this->use_classes && $this->lexic_permissions['NUMBERS']) {
$attributes = ' style="' . $this->language_data['STYLES']['NUMBERS'][0] . '"';
} else {
$attributes = ' class="nu0"';
}
$stuff_to_parse = str_replace('/NUM!/', $attributes, $stuff_to_parse);
//
// Highlight methods and fields in objects
//
if ($this->lexic_permissions['METHODS'] && $this->language_data['OOLANG']) {
foreach ($this->language_data['OBJECT_SPLITTERS'] as $key => $splitter) {
if (false !== stristr($stuff_to_parse, $splitter)) {
if (!$this->use_classes) {
$attributes = ' style="' . $this->language_data['STYLES']['METHODS'][$key] . '"';
} else {
$attributes = ' class="me' . $key . '"';
}
$stuff_to_parse = preg_replace("#(" . quotemeta($this->language_data['OBJECT_SPLITTERS'][$key]) . "[\s]*)([a-zA-Z\*\(][a-zA-Z0-9_\*]*)#", "\\1<|$attributes>\\2|>", $stuff_to_parse);
}
}
}
//
// Highlight brackets. Yes, I've tried adding a semi-colon to this list.
// You try it, and see what happens ;)
// TODO: Fix lexic permissions not converting entities if shouldn't
// be highlighting regardless
//
if ($this->lexic_permissions['BRACKETS']) {
$code_entities_match = array('[', ']', '(', ')', '{', '}');
if (!$this->use_classes) {
$code_entities_replace = array(
'<| style="' . $this->language_data['STYLES']['BRACKETS'][0] . '">[|>',
'<| style="' . $this->language_data['STYLES']['BRACKETS'][0] . '">]|>',
'<| style="' . $this->language_data['STYLES']['BRACKETS'][0] . '">(|>',
'<| style="' . $this->language_data['STYLES']['BRACKETS'][0] . '">)|>',
'<| style="' . $this->language_data['STYLES']['BRACKETS'][0] . '">{|>',
'<| style="' . $this->language_data['STYLES']['BRACKETS'][0] . '">}|>',
);
} else {
$code_entities_replace = array(
'<| class="br0">[|>',
'<| class="br0">]|>',
'<| class="br0">(|>',
'<| class="br0">)|>',
'<| class="br0">{|>',
'<| class="br0">}|>',
);
}
$stuff_to_parse = str_replace( $code_entities_match, $code_entities_replace, $stuff_to_parse );
}
//
// Add class/style for regexps
//
foreach ($this->language_data['REGEXPS'] as $key => $regexp) {
if ($this->lexic_permissions['REGEXPS'][$key]) {
if (!$this->use_classes) {
$attributes = ' style="' . $this->language_data['STYLES']['REGEXPS'][$key] . '"';
} else {
$attributes = ' class="re' . $key . '"';
}
$stuff_to_parse = str_replace("!REG3XP$key!", "$attributes", $stuff_to_parse);
}
}
// Replace with . for urls
$stuff_to_parse = str_replace('', '.', $stuff_to_parse);
// Replace <|UR1| with link_styles[GESHI_LINK])) {
if ($this->use_classes) {
$stuff_to_parse = str_replace('<|UR1|', 'link_target . ' href=', $stuff_to_parse);
} else {
$stuff_to_parse = str_replace('<|UR1|', 'link_target . ' style="' . $this->link_styles[GESHI_LINK] . '" href=', $stuff_to_parse);
}
} else {
$stuff_to_parse = str_replace('<|UR1|', 'link_target . ' href=', $stuff_to_parse);
}
//
// NOW we add the span thingy ;)
//
$stuff_to_parse = str_replace('<|', '', '', $stuff_to_parse );
return substr(stripslashes($stuff_to_parse), 1);
}
/**
* Sets the time taken to parse the code
*
* @param microtime The time when parsing started
* @param microtime The time when parsing ended
* @since 1.0.2
* @access private
*/
function set_time ($start_time, $end_time)
{
$start = explode(' ', $start_time);
$end = explode(' ', $end_time);
$this->time = $end[0] + $end[1] - $start[0] - $start[1];
}
/**
* Gets the time taken to parse the code
*
* @return double The time taken to parse the code
* @since 1.0.2
*/
function get_time ()
{
return $this->time;
}
/**
* Gets language information and stores it for later use
*
* @access private
* @todo Needs to load keys for lexic permissions for keywords, regexps etc
*/
function load_language ($file_name)
{
require $file_name;
// Perhaps some checking might be added here later to check that
// $language data is a valid thing but maybe not
$this->language_data = $language_data;
// Set strict mode if should be set
if ($this->language_data['STRICT_MODE_APPLIES'] == GESHI_ALWAYS) {
$this->strict_mode = true;
}
// Set permissions for all lexics to true
// so they'll be highlighted by default
foreach ($this->language_data['KEYWORDS'] as $key => $words) {
$this->lexic_permissions['KEYWORDS'][$key] = true;
}
foreach ($this->language_data['COMMENT_SINGLE'] as $key => $comment) {
$this->lexic_permissions['COMMENTS'][$key] = true;
}
foreach ($this->language_data['REGEXPS'] as $key => $regexp) {
$this->lexic_permissions['REGEXPS'][$key] = true;
}
$this->enable_highlighting();
// Set default class for CSS
$this->overall_class = $this->language;
}
/**
* Takes the parsed code and various options, and creates the HTML
* surrounding it to make it look nice.
*
* @param string The code already parsed
* @return string The code nicely finalised
* @since 1.0.0
* @access private
*/
function finalise ($parsed_code)
{
// Remove end parts of important declarations
// This is BUGGY!! My fault for bad code: fix coming in 1.2
// @todo Remove this crap
if ($this->enable_important_blocks &&
(strstr($parsed_code, @htmlspecialchars(GESHI_START_IMPORTANT, ENT_COMPAT, $this->encoding)) === false)) {
$parsed_code = str_replace(@htmlspecialchars(GESHI_END_IMPORTANT, ENT_COMPAT, $this->encoding), '', $parsed_code);
}
// Add HTML whitespace stuff if we're using the header
if ($this->header_type == GESHI_HEADER_DIV) {
$parsed_code = $this->indent($parsed_code);
}
// If we're using line numbers, we insert
s and appropriate
// markup to style them (otherwise we don't need to do anything)
if ($this->line_numbers != GESHI_NO_LINE_NUMBERS) {
// If we're using the header, we shouldn't add newlines because
// the will line-break them (and the
s already do this for us)
$ls = ($this->header_type != GESHI_HEADER_PRE) ? "\n" : '';
// Get code into lines
$code = explode("\n", $parsed_code);
// Set vars to defaults for following loop
$parsed_code = '';
$i = 0;
// Foreach line...
foreach ($code as $line) {
$line = ( $line ) ? $line : ' ';
// If this is a "special line"...
if ($this->line_numbers == GESHI_FANCY_LINE_NUMBERS &&
$i % $this->line_nth_row == ($this->line_nth_row - 1)) {
// Set the attributes to style the line
if ($this->use_classes) {
$attr = ' class="li2"';
$def_attr = ' class="de2"';
} else {
$attr = ' style="' . $this->line_style2 . '"';
// This style "covers up" the special styles set for special lines
// so that styles applied to special lines don't apply to the actual
// code on that line
$def_attr = ' style="' . $this->code_style . '"';
}
// Span or div?
$start = "";
$end = '';
} else {
$parsed_code .= "
highlight_extra_lines_style}\">";
}
$parsed_code .= $line . "
\n";
} else {
$parsed_code .= $line . "\n";
}
}
}
// purge some unnecessary stuff
$parsed_code = preg_replace('#
]+>(\s*)#', '\\1', $parsed_code);
$parsed_code = preg_replace('#]+>(\s*)