<?php
/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
/**
 * BB code renderer.
 *
 * This BB renderer produces BB code, ready to be pasted in bulletin boards and
 * other applications that accept BB code. Based on the HTML renderer by Andrey Demenev.
 *
 * LICENSE: This source file is subject to version 3.0 of the PHP license
 * that is available through the world-wide-web at the following URI:
 * http://www.php.net/license/3_0.txt.  If you did not receive a copy of
 * the PHP License and are unable to obtain it through the web, please
 * send a note to license@php.net so we can mail you a copy immediately.
 *
 * @category   Text
 * @package    Text_Highlighter
 * @author     Stoyan Stefanov <ssttoo@gmail.com>
 * @copyright  2005 Stoyan Stefanov
 * @license    http://www.php.net/license/3_0.txt  PHP License
 * @version    CVS: $Id$
 * @link       http://pear.php.net/package/Text_Highlighter
 */

/**
 * @ignore
 */

require_once 'Text/Highlighter/Renderer.php';

/**
 * BB code renderer, based on Andrey Demenev's HTML renderer.
 *
 * Elements of $options argument of constructor (each being optional):
 *
 * - 'numbers' - Line numbering TRUE or FALSE
 * - 'tabsize' - Tab size, default is 4
 * - 'bb_tags' - An array containing three BB tags, see below
 * - 'tag_brackets' - An array that conains opening and closing tags, [ and ]
 * - 'colors' - An array with all the colors to be used for highlighting
 *
 * The default BB tags are:
 * - 'color' => 'color'
 * - 'list'  => 'list'
 * - 'list_item' => '*'
 *
 * The default colors for the highlighter are:
 * - 'default'    => 'Black',
 * - 'code'       => 'Gray',
 * - 'brackets'   => 'Olive',
 * - 'comment'    => 'Orange',
 * - 'mlcomment'  => 'Orange',
 * - 'quotes'     => 'Darkred',
 * - 'string'     => 'Red',
 * - 'identifier' => 'Blue',
 * - 'builtin'    => 'Teal',
 * - 'reserved'   => 'Green',
 * - 'inlinedoc'  => 'Blue',
 * - 'var'        => 'Darkblue',
 * - 'url'        => 'Blue',
 * - 'special'    => 'Navy',
 * - 'number'     => 'Maroon',
 * - 'inlinetags' => 'Blue',
 *
 *
 * @author     Stoyan Stefanov <ssttoo@gmail.com>
 * @category   Text
 * @package    Text_Highlighter
 * @copyright  20045 Stoyan Stefanov
 * @license    http://www.php.net/license/3_0.txt  PHP License
 * @version    Release: 0.5.0
 * @link       http://pear.php.net/package/Text_Highlighter
 */

class Text_Highlighter_Renderer_BB extends Text_Highlighter_Renderer
{

    /**#@+
     * @access private
     */

    /**
     * Line numbering - will use the specified BB tag for listings
     *
     * @var boolean
     */
    var $_numbers = false;

    /**
     * Tab size
     *
     * @var integer
     */
    var $_tabsize = 4;

    var $_bb_tags = array (
        'color'     => 'color',
        'list'      => 'list=1',
        'list_item' => '*',
    );

    var $_tag_brackets = array ('start' => '[', 'end' => ']');

    var $_colors = array(
        'default'    => 'Black',
        'code'       => 'Gray',
        'brackets'   => 'Olive',
        'comment'    => 'Orange',
        'mlcomment'  => 'Orange',
        'quotes'     => 'Darkred',
        'string'     => 'Red',
        'identifier' => 'Blue',
        'builtin'    => 'Teal',
        'reserved'   => 'Green',
        'inlinedoc'  => 'Blue',
        'var'        => 'Darkblue',
        'url'        => 'Blue',
        'special'    => 'Navy',
        'number'     => 'Maroon',
        'inlinetags' => 'Blue',
    );

    /**
     * Highlighted code
     *
     * @var string
     */
    var $_output = '';

    /**#@-*/


    function preprocess($str)
    {
        // normalize whitespace and tabs
        $str = str_replace("\r\n","\n", $str);
        // some browsers refuse to display empty lines
        $str = preg_replace('~^$~m'," ", $str);
        $str = str_replace("\t",str_repeat(' ', $this->_tabsize), $str);
        return rtrim($str);
    }


    /**
     * Resets renderer state
     *
     * @access protected
     *
     *
     * Descendents of Text_Highlighter call this method from the constructor,
     * passing $options they get as parameter.
     */
    function reset()
    {
        $this->_output = '';
        $this->_lastClass = 'default';
        if (isset($this->_options['numbers'])) {
            $this->_numbers = $this->_options['numbers'];
        }
        if (isset($this->_options['tabsize'])) {
            $this->_tabsize = $this->_options['tabsize'];
        }
        if (isset($this->_options['bb_tags'])) {
            $this->_bb_tags = array_merge($this->_bb_tags, $this->_options['bb_tags']);
        }
        if (isset($this->_options['tag_brackets'])) {
            $this->_tag_brackets = array_merge($this->_tag_brackets, $this->_options['tag_brackets']);
        }
        if (isset($this->_options['colors'])) {
            $this->_colors = array_merge($this->_colors, $this->_options['colors']);
        }
    }



    /**
     * Accepts next token
     *
     * @abstract
     * @access public
     *
     * @param  string $class   Token class
     * @param  string $content Token content
     */
    function acceptToken($class, $content)
    {
        $iswhitespace = ctype_space($content);
        $content = htmlspecialchars($content);
        if (!$iswhitespace && !empty($this->_colors[$class])) {
            $this->_output .= $this->_tag_brackets['start'] .
                              $this->_bb_tags['color'] .
                              '=' .
                              $this->_colors[$class] .
                              $this->_tag_brackets['end'] .
                              $content .
                              $this->_tag_brackets['start'] .
                              '/' .
                              $this->_bb_tags['color'] .
                              $this->_tag_brackets['end'];
        } else {
            $this->_output .= $content;
        }
    }

    /**
     * Signals that no more tokens are available
     *
     * @abstract
     * @access public
     *
     */
    function finalize()
    {
        if ($this->_numbers) {

            $item_tag = $this->_tag_brackets['start'] .
                        $this->_bb_tags['list_item'] .
                        $this->_tag_brackets['end'];
            /* additional whitespace for browsers that do not display
            empty list items correctly */
            $this->_output = $item_tag . str_replace("\n", "\n". $item_tag .' ', $this->_output);
            $this->_output = $this->_tag_brackets['start'] .
                             $this->_bb_tags['list'] .
                             $this->_tag_brackets['end'] .
                             $this->_output.
                             $this->_tag_brackets['start'] .
                             '/'.
                             $this->_bb_tags['list'] .
                             $this->_tag_brackets['end']
                             ;
        }
        $this->_output = '[code]' . $this->_output . '[/code]';

    }

    /**
     * Get generated output
     *
     * @abstract
     * @return string Highlighted code
     * @access public
     *
     */
    function getOutput()
    {
        return $this->_output;
    }
}

/*
 * Local variables:
 * tab-width: 4
 * c-basic-offset: 4
 * c-hanging-comment-ender-p: nil
 * End:
 */

?>