Docs For Class Text

$delim = "\xFF"

[line 208]

The delimiter for token numbers of parsed elements in source text.

Access: public

Type:

string

[ Top ]

$disable = array(
        'Html',
        'Include',
        'Embed'
    )

[line 102]

The list of rules to not-apply to the source text.

Access: public

Type:

array

[ Top ]

$formatConf = array(
'Docbook' => array(),'Latex'=>array(),'Pdf'=>array(),'Plain'=>array(),'Rtf'=>array(),'Xhtml'=>array())

[line 188]

Custom configuration for the output format itself.

Even though Text_Wiki will render the tokens from parsed text, the format itself may require some configuration. For example, RTF needs to know font names and sizes, PDF requires page layout information, and DocBook needs a section hierarchy. This array matches the $conf property of the the format-level renderer (e.g., Text_Wiki_Render_Xhtml).

In this array, the key is the rendering format name, and the value is an array of key-value configuration pairs corresponding to the $conf property in the rendering format rule.

Access: public

Type:

array

[ Top ]

$output = ''

[line 264]

The output text

Type:

string

[ Top ]

$parseConf = array()

[line 135]

Custom configuration for rules at the parsing stage.

In this array, the key is the parsing rule name, and the value is an array of key-value configuration pairs corresponding to the $conf property in the target parsing rule.

For example:

 $parseConf = array(

     'Include' => array(
         'base' => '/path/to/scripts/'
     )
 );

Note that most default rules do not need any parsing configuration.

Access: public

Type:

array

[ Top ]

$renderConf = array(
'Docbook' => array(),'Latex'=>array(),'Pdf'=>array(),'Plain'=>array(),'Rtf'=>array(),'Xhtml'=>array())

[line 157]

Custom configuration for rules at the rendering stage.

Because rendering may be different for each target format, the first-level element in this array is always a format name (e.g., 'Xhtml').

Within that first level element, the subsequent elements match the $parseConf format. That is, the sub-key is the rendering rule name, and the sub-value is an array of key-value configuration pairs corresponding to the $conf property in the target rendering rule.

Access: public

Type:

array

[ Top ]

$renderingType = 'preg'

[line 350]

Temporary configuration variable

Type:

string

[ Top ]

$rules = array(
        'Prefilter',
        'Delimiter',
        'Code',
        'Function',
        'Html',
        'Raw',
        'Include',
        'Embed',
        'Anchor',
        'Heading',
        'Toc',
        'Horiz',
        'Break',
        'Blockquote',
        'List',
        'Deflist',
        'Table',
        'Image',
        'Phplookup',
        'Center',
        'Newline',
        'Paragraph',
        'Url',
        'Freelink',
        'Interwiki',
        'Wikilink',
        'Colortext',
        'Strong',
        'Bold',
        'Emphasis',
        'Italic',
        'Underline',
        'Tt',
        'Superscript',
        'Subscript',
        'Revise',
        'Tighten'
    )

[line 51]

The default list of rules, in order, to apply to the source text.

Access: public

Type:

array

[ Top ]

Text_Wiki (Constructor) [line 386]

Text_Wiki Text_Wiki(
[array
$rules = null])

Constructor.

**DEPRECATED** Please use the singleton() or factory() methods.

Access: public

Parameters:

array $rules — The set of rules to load for this object. Defaults to null, which will load the default ruleset for this parser.

[ Top ]

addPath [line 1419]

void addPath(
string
$type, string
$dir)

Add a path to a path array.

Access: public

Parameters:

string	`$type`	—	The path-type to add (parse or render).
string	`$dir`	—	The directory to add to the path-type.

[ Top ]

addToken [line 1223]

string|int addToken(

$rule, [array
$options = array()], [boolean
$id_only = false])

Add a token to the Text_Wiki tokens array, and return a delimited token number.

Return: By default, return the number of the newly-created token array element with a delimiter prefix and suffix; however, if $id_only is set to true, return only the token number (no delimiters).
Access: public

Parameters:

array	`$options`	—	An associative array of options for the new token array element. The keys and values are specific to the rule, and may or may not be common to other rule options. Typical options keys are 'text' and 'type' but may include others.
boolean	`$id_only`	—	If true, return only the token number, not a delimited token string.
	`$rule`	—

[ Top ]

changeRule [line 829]

void changeRule(
string
$old, string
$new)

Change from one rule to another in-place.

Access: public

Parameters:

string	`$old`	—	The name of the rule to change from.
string	`$new`	—	The name of the rule to change to.

[ Top ]

deleteRule [line 805]

void deleteRule(

$name, string
$rule)

Delete (remove or unset) a rule from the $rules property.

Access: public

Parameters:

string	`$rule`	—	The name of the rule to remove.
	`$name`	—

[ Top ]

disableRule [line 876]

void disableRule(

$name, string
$rule)

Disables a rule so that it is not applied when parsing.

Access: public

Parameters:

string	`$rule`	—	The name of the rule to disable.
	`$name`	—

[ Top ]

enableRule [line 854]

void enableRule(

$name, string
$rule)

Enables a rule so that it is applied when parsing.

Access: public

Parameters:

string	`$rule`	—	The name of the rule to enable.
	`$name`	—

[ Top ]

error [line 1524]

object PEAR_Error &error(
string
$message)

Simple error-object generator.

Access: public

Parameters:

string $message — The error message.

[ Top ]

factory [line 468]

Text_Wiki &factory(
[string
$parser = 'Default'], [array
$rules = null])

Returns a Text_Wiki Parser class for the specified parser.

Return: a Parser object extended from Text_Wiki
Access: public

Parameters:

string	`$parser`	—	The name of the parse to instantiate you need to have Text_Wiki_XXX installed to use $parser = 'XXX', it's E_FATAL
array	`$rules`	—	The rules to pass into the constructor {@see Text_Wiki::singleton} for a list of rules

[ Top ]

findFile [line 1469]

string|bool findFile(
array
$type, string
$file)

Searches a series of paths for a given file.

Return: The full path and file name for the target file, or boolean false if the file is not found in any of the paths.

Parameters:

array	`$type`	—	The type of paths to search (template, plugin, or filter).
string	`$file`	—	The file name to look for.

[ Top ]

getFormatConf [line 699]

mixed getFormatConf(
string
$format, [mixed
$key = null])

Get configuration for a specific format and key.

Return: The whole conf array if no key is specified, or the specific conf key value.
Access: public

Parameters:

string	`$format`	—	The format to get config for.
mixed	`$key`	—	A key in the conf array; if null, returns the entire conf array.

[ Top ]

getParseConf [line 537]

mixed getParseConf(
string
$rule, [string
$key = null])

Get parser configuration for a specific rule and key.

Return: The whole conf array if no key is specified, or the specific conf key value.
Access: public

Parameters:

string	`$rule`	—	The parse rule to get config for.
string	`$key`	—	A key in the conf array; if null, returns the entire conf array.

[ Top ]

getPath [line 1443]

array getPath(
[string
$type = null])

Get the current path array for a path-type.

Return: The array of paths for the requested type.
Access: public

Parameters:

string $type — The path-type to look up (plugin, filter, or template). If not set, returns all path types.

[ Top ]

getRenderConf [line 623]

mixed getRenderConf(
string
$format, string
$rule, [string
$key = null])

Get renderer configuration for a specific format, rule, and key.

Return: The whole conf array if no key is specified, or the specific conf key value.
Access: public

Parameters:

string	`$format`	—	The render format to get config for.
string	`$rule`	—	The render format rule to get config for.
string	`$key`	—	A key in the conf array; if null, returns the entire conf array.

[ Top ]

getSource [line 1164]

string getSource(
)

Returns the parsed source text with delimited token placeholders.

Return: The parsed source text.
Access: public

[ Top ]

getTokens [line 1184]

array getTokens(
[array
$rules = null])

Returns tokens that have been parsed out of the source text.

Return: An array of tokens.
Access: public

Parameters:

array $rules — If an array of rule names is passed, only return tokens matching these rule names. If no array is passed, return all tokens.

[ Top ]

insertRule [line 739]

void insertRule(
string
$name, [string
$tgt = null])

Inserts a rule into to the rule set.

Access: public

Parameters:

string	`$name`	—	The name of the rule. Should be different from all other keys in the rule set.
string	`$tgt`	—	The rule after which to insert this new rule. By default (null) the rule is inserted at the end; if set to '', inserts at the beginning.

[ Top ]

isError [line 1545]

bool isError(

&$obj, mixed
$obj)

Simple error checker.

Return: True if a PEAR_Error, false if not.
Access: public

Parameters:

mixed	`$obj`	—	Check if this is a PEAR_Error object or not.
	`&$obj`	—

[ Top ]

loadFormatObj [line 1382]

bool loadFormatObj(

$format)

Load a format-render class file.

Return: True if loaded, false if not.
Access: public

Parameters:

$format —

[ Top ]

loadParseObj [line 1311]

bool loadParseObj(

$rule)

Load a rule parser class file.

Return: True if loaded, false if not.
Access: public

Parameters:

$rule —

[ Top ]

loadRenderObj [line 1347]

bool loadRenderObj(

$format, 
$rule)

Load a rule-render class file.

Return: True if loaded, false if not.
Access: public

Parameters:

	`$format`	—
	`$rule`	—

[ Top ]

parse [line 936]

void parse(
string
$text)

Sets the $_source text property, then parses it in place and retains tokens in the $_tokens array property.

Access: public

Parameters:

string $text — The source text to which wiki rules should be applied, both for parsing and for rendering.

[ Top ]

popRenderCallback [line 1137]

void popRenderCallback(
)

[ Top ]

registerRenderCallback [line 1131]

void registerRenderCallback(

$callback)

Parameters:

$callback —

[ Top ]

render [line 978]

string render(
[string
$format = 'Xhtml'])

Renders tokens back into the source text, based on the requested format.

Return: The transformed wiki text.
Access: public

Parameters:

string $format — The target output format, typically 'xhtml'. If a rule does not support a given format, the output from that rule is rule-specific.

[ Top ]

setFormatConf [line 665]

void setFormatConf(
string
$format, 
$arg1, [
$arg2 = null], string
$key, string
$val)

Set format configuration for a specific rule and key.

Access: public

Parameters:

string	`$format`	—	The format to set config for.
string	`$key`	—	The config key within the format.
string	`$val`	—	The config value for the key.
	`$arg1`	—
	`$arg2`	—

[ Top ]

setParseConf [line 502]

void setParseConf(
string
$rule, array|string
$arg1, [string
$arg2 = null])

Set parser configuration for a specific rule and key.

Access: public

Parameters:

string	`$rule`	—	The parse rule to set config for.
array\|string	`$arg1`	—	The full config array to use for the parse rule, or a conf key in that array.
string	`$arg2`	—	The config value for the key.

[ Top ]

setRenderConf [line 581]

void setRenderConf(
string
$format, string
$rule, array|string
$arg1, [string
$arg2 = null])

Set renderer configuration for a specific format, rule, and key.

Access: public

Parameters:

string	`$format`	—	The render format to set config for.
string	`$rule`	—	The render rule to set config for in the format.
array\|string	`$arg1`	—	The config array, or the config key within the render rule.
string	`$arg2`	—	The config value for the key.

[ Top ]

setToken [line 1280]

void setToken(
int
$id, int
$rule, [array
$options = array()])

Set or re-set a token with specific information, overwriting any previous rule name and rule options.

Access: public

Parameters:

int	`$id`	—	The token number to reset.
int	`$rule`	—	The rule name to use.
array	`$options`	—	An associative array of options for the token array element. The keys and values are specific to the rule, and may or may not be common to other rule options. Typical options keys are 'text' and 'type' but may include others.

[ Top ]

singleton [line 444]

&object &singleton(
[string
$parser = 'Default'], [array
$rules = null])

Singleton.

This avoids instantiating multiple Text_Wiki instances where a number of objects are required in one call, e.g. to save memory in a CMS invironment where several parsers are required in a single page.

$single = & singleton();

$single = & singleton('Parser', array('Prefilter', 'Delimiter', 'Code', 'Function', 'Html', 'Raw', 'Include', 'Embed', 'Anchor', 'Heading', 'Toc', 'Horiz', 'Break', 'Blockquote', 'List', 'Deflist', 'Table', 'Image', 'Phplookup', 'Center', 'Newline', 'Paragraph', 'Url', 'Freelink', 'Interwiki', 'Wikilink', 'Colortext', 'Strong', 'Bold', 'Emphasis', 'Italic', 'Underline', 'Tt', 'Superscript', 'Subscript', 'Revise', 'Tighten'));

Call using a subset of this list. The order of passing rulesets in the $rules array is important!

After calling this, call $single->setParseConf(), setRenderConf() or setFormatConf() as usual for a constructed object of this class.

The internal static array of singleton objects has no index on the parser rules, the only index is on the parser name. So if you call this multiple times with different rules but the same parser name, you will get the same static parser object each time.

Return: a reference to the Text_Wiki unique instantiation.
Since: Method available since Release 1.1.0
Access: public

Parameters:

string	`$parser`	—	The parser to be used (defaults to 'Default').
array	`$rules`	—	The set of rules to instantiate the object. This will only be used when the first call to singleton is made, if included in further calls it will be effectively ignored.

[ Top ]

transform [line 915]

string transform(
string
$text, [string
$format = 'Xhtml'])

Parses and renders the text passed to it, and returns the results.

First, the method parses the source text, applying rules to the text as it goes. These rules will modify the source text in-place, replacing some text with delimited tokens (and populating the $this->tokens array as it goes).

Next, the method renders the in-place tokens into the requested output format.

Finally, the method returns the transformed text. Note that the source text is transformed in place; once it is transformed, it is no longer the same as the original source text.

Return: The transformed wiki text.
Access: public

Parameters:

string	`$text`	—	The source text to which wiki rules should be applied, both for parsing and for rendering.
string	`$format`	—	The target output format, typically 'xhtml'. If a rule does not support a given format, the output from that rule is rule-specific.

[ Top ]

Class: Text_Wiki

Class Overview

Author(s):

Version:

Variables

Methods

Child classes:

Inherited Variables

Inherited Methods

Class Details

Class Variables

$delim = "\xFF"

$disable = array( 'Html', 'Include', 'Embed' )

$formatConf = array( 'Docbook' => array(),'Latex'=>array(),'Pdf'=>array(),'Plain'=>array(),'Rtf'=>array(),'Xhtml'=>array())

$output = ''

$parseConf = array()

$renderConf = array( 'Docbook' => array(),'Latex'=>array(),'Pdf'=>array(),'Plain'=>array(),'Rtf'=>array(),'Xhtml'=>array())

$renderingType = 'preg'

Method Detail

Text_Wiki (Constructor) [line 386]

Parameters:

addPath [line 1419]

Parameters:

addToken [line 1223]

Parameters:

changeRule [line 829]

Parameters:

deleteRule [line 805]

Parameters:

disableRule [line 876]

Parameters:

enableRule [line 854]

Parameters:

error [line 1524]

Parameters:

factory [line 468]

Parameters:

findFile [line 1469]

Parameters:

getFormatConf [line 699]

Parameters:

getParseConf [line 537]

Parameters:

getPath [line 1443]

Parameters:

getRenderConf [line 623]

Parameters:

getSource [line 1164]

getTokens [line 1184]

Parameters:

insertRule [line 739]

Parameters:

isError [line 1545]

Parameters:

loadFormatObj [line 1382]

Parameters:

loadParseObj [line 1311]

Parameters:

loadRenderObj [line 1347]

Parameters:

parse [line 936]

Parameters:

popRenderCallback [line 1137]

registerRenderCallback [line 1131]

Parameters:

render [line 978]

Parameters:

setFormatConf [line 665]

Parameters:

setParseConf [line 502]

Parameters:

setRenderConf [line 581]

Parameters:

setToken [line 1280]

Parameters:

singleton [line 444]

Parameters:

transform [line 915]

Parameters:

$disable = array(
'Html',
'Include',
'Embed'
)

$formatConf = array(
'Docbook' => array(),'Latex'=>array(),'Pdf'=>array(),'Plain'=>array(),'Rtf'=>array(),'Xhtml'=>array())

$renderConf = array(
'Docbook' => array(),'Latex'=>array(),'Pdf'=>array(),'Plain'=>array(),'Rtf'=>array(),'Xhtml'=>array())