,
* contains every other tag and all text.
* @tutorial tutorials.pkg
* @package phpDocumentor
* @subpackage Tutorial
*/
/**
* Represents sections.
*
* These sections are interpreted as plain text
* @package phpDocumentor
* @subpackage Tutorial
*/
class parserCData extends parserStringWithInlineTags
{
/**
* @uses Converter::getCData() convert contents to text
* @param Converter
*/
function Convert(&$c, $postprocess = true)
{
$val = $this->value;
if ($postprocess)
foreach($this->value as $key => $value)
{
if (is_string($value)) $this->value[$key] = $c->getCData($value);
}
$this->cache = false;
$x = parent::Convert($c, false);
$this->value = $val;
return $x;
}
}
/**
* a standard XML DocBook Tag
*
* This class is designed to represent all DocBook tags. It is intelligent
* enough to understand the tag, and also the <refname> tag for
* as title for <refentry>
* @since 1.2
* @package phpDocumentor
* @subpackage Tutorial
*/
class parserXMLDocBookTag extends parserStringWithInlineTags
{
/**
* Attributes from the XML tag
*
* Format: array(attrname => attrvalue, attrname => attrvalue,...)
* @var array
*/
var $attributes = array();
/**
* Name of the tag
* @var string
*/
var $name;
/**#@+ @access private */
/** @var parserCData */
var $_cdata;
/** @var parserTag */
var $_title;
/** @var parserIdLineTag */
var $_id;
/**
* Set to <refpurpose> in <refsynopsisdiv>
* @var parserTag
*/
var $_description;
/**#@-*/
/**
* @param string tag name
*/
function parserXMLDocBookTag($name)
{
$this->name = $name;
}
/**
* @param Converter
* @param boolean
* @uses Converter::TranslateTag() Calls this to enclose the contents of the
* DocBook tag based on the values in template options.ini file
*/
function Convert(&$c, $postprocess = true)
{
$value = parent::Convert($c, $postprocess);
$simvalue = parent::Convert($c, false);
foreach($this->attributes as $a => $v)
{
$this->attributes[$a] = (is_string($v) ? $v : $v->Convert($c, $postprocess));
}
if (isset($this->_title))
{
list($this->attributes,$value) = $c->ConvertTitle($this->name, $this->attributes, $this->_title->Convert($c, $postprocess), $value);
}
return $c->TranslateTag($this->name,$this->attributes,$value,$simvalue);
}
/**
* Begin a new CData section
* @see addCData()
*/
function startCData()
{
$this->_cdata = new parserCData;
}
/**
* Adds {@link $_cdata} to {@link $value}
*/
function endCData()
{
$this->value[] = $this->_cdata;
unset($this->_cdata);
}
/**
* Retrieve either the table of contents index, or the location that
* the TOC will go
* @see setTOC()
* @param false|integer either an index of the {@}toc} tag in $this->value
* or false, if the next index value of $this->value
* is needed
*/
function getTOC($state = false)
{
if ($state !== false) return $this->value[$state];
return count($this->value);
}
/**
* @param integer index of the TOC in $this->value
* @param parserTocInlineTag
*/
function setTOC($state, $val)
{
$this->value[$state] = $val;
}
/**
* add a word to CData
* @param string
*/
function addCData($word)
{
$this->_cdata->add($word);
}
/**
* Add an xml tag attribute name="value" pair
*
* if the attribute is id, value must be a {@link parserIdInlineTag}
* @param string attribute name
* @param string|parserIdInlineTag value of attribute
*/
function addAttribute($name,$value)
{
$this->attributes[$name] = $value;
if ($name == 'id')
{
// fix 1153593
if (is_string($value))
{
addWarning(PDERROR_ID_MUST_BE_INLINE,$this->name,$value,$this->name,$value);
} else {
$this->setId($value);
}
}
}
/**
* Set the title of a DocBook tag section.
*
* For most DocBook tags, the title is represented with a <title>
* tag pair. The top-level tag is a little different. Instead
* of using , phpDocumentor uses the contents of the
* tag in the tag
* @param parserXMLDocBookTag the title element
*/
function setTitle($title)
{
$this->_title = $title;
}
/**
* If the id attribute is present, this method will set its id
* @param parserIdInlineTag
*/
function setId($id)
{
$this->_id = $id;
}
/**
* Return converter-specific formatting of ID.
*
* Passes $c to {@link parserIdInlineTag::Convert()}
* @param Converter
* @return string
*/
function getId(&$c)
{
if ($this->_id) return trim($this->_id->Convert($c));
}
/**
* Determine whether the docbook element has a title
* @return boolean
*/
function hasTitle()
{
return isset($this->_title);
}
/**
* Retrieve Converter-specific formatting of the title of this element
* @return string
* @param Converter
*/
function getTitle(&$c)
{
if ($this->name == 'refentry')
{
foreach($this->value as $tag)
{
if (is_object($tag) && $tag->name == 'refnamediv')
{
return $tag->getTitle($c);
}
}
}
if ($this->name == 'refnamediv')
{
foreach($this->value as $tag)
{
if (is_object($tag) && $tag->name == 'refname')
{
$t = new parserStringWithInlineTags;
foreach($tag->value as $val) $t->add($val);
$this->_title = $t;
}
if (is_object($tag) && $tag->name == 'refpurpose')
{
$t = new parserStringWithInlineTags;
foreach($tag->value as $val) $t->add($val);
$this->_description = $t;
}
}
}
if (isset($this->_title))
return $this->_title->Convert($c);
if (is_object($this->value[0])) return $this->value[0]->getTitle($c);
if (isset($this->value[1]))
if (is_object($this->value[1])) return $this->value[1]->getTitle($c);
return '';
}
/**
* Retrieve the contents of a subsection
*
* This method uses the $_id members of nested docbook tags to retrieve
* the section defined by $subsection
* @param Converter
* @param string converter-specific subsection
*/
function getSubsection(&$c,$subsection)
{
if (!is_object($this->_id)) {
return false;
}
$search = phpDocumentor_clone($this->_id);
if (is_string($this->_id)) return false;
if (phpDocumentor_get_class($search) != 'parseridinlinetag') return false;
$search->id = $subsection;
foreach($this->value as $el)
{
if (phpDocumentor_get_class($el) == 'parserxmldocbooktag')
{
if ($el->getId($c) == $search->Convert($c))
{
return $el;
} elseif ($a = $el->getSubsection($c,$subsection))
{
return $a;
}
}
}
return false;
}
/**
* Add contents to this tag.
*
* There are four kinds of data in a DocBook tutorial:
* 1. tags - normal tags like
* 2. entities - normal entities like ”
* 3. - character data that should not be interpreted,
* like contents
* 4. text - normal non-markup text
*
* All four kinds of data are added here
* @param parserEntity|parserCData|parserXMLDocBookTag|string nested tag,
* entity, or text
*/
function add($el)
{
if (is_string($el)) return parent::add($el);
if (phpDocumentor_get_class($el) == 'parserxmldocbooktag')
{
if ($el->name == 'title')
{
$this->setTitle($el);
} else return parent::add($el);
} else return parent::add($el);
}
}
/**
* a standard entity like ”
*
* This class is designed to represent all DocBook entities.
* @since 1.2
* @package phpDocumentor
* @subpackage Tutorial
*/
class parserEntity
{
/**
* @param string entity name
*/
function parserEntity($name)
{
$this->value = $name;
}
/**
* @uses Converter::TranslateEntity() convert contents to text
* @param Converter
* @return string
*/
function Convert(&$c, $postprocess = true)
{
if ($postprocess)
return $c->TranslateEntity($this->value);
else
{
$trans_tbl = get_html_translation_table (HTML_ENTITIES);
$trans_tbl = array_flip ($trans_tbl);
$ret = strtr ('&'.$this->value.';', $trans_tbl);
return $ret;
}
}
}
?>