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 ]

$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 341]

Temporary configuration variable

Type:

mixed

[ 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 356]

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 1312]

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 1116]

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 796]

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 772]

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 843]

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 821]

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 1417]

object PEAR_Error &error(
string
$message)

Simple error-object generator.

Access: public

Parameters:

string $message — The error message.

[ Top ]

factory [line 435]

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 1362]

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 666]

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 504]

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 1336]

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 590]

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 1057]

string getSource(
)

Returns the parsed source text with delimited token placeholders.

Return: The parsed source text.
Access: public

[ Top ]

getTokens [line 1077]

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 706]

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 1438]

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 1275]

bool loadFormatObj(

$format)

Load a format-render class file.

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

Parameters:

$format —

[ Top ]

loadParseObj [line 1204]

bool loadParseObj(

$rule)

Load a rule parser class file.

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

Parameters:

$rule —

[ Top ]

loadRenderObj [line 1240]

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 903]

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 ]

render [line 945]

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 632]

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 469]

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 548]

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 1173]

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 411]

&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 882]

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())

$parseConf = array()

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

$renderingType = 'preg'

Method Detail

Text_Wiki (Constructor) [line 356]

Parameters:

addPath [line 1312]

Parameters:

addToken [line 1116]

Parameters:

changeRule [line 796]

Parameters:

deleteRule [line 772]

Parameters:

disableRule [line 843]

Parameters:

enableRule [line 821]

Parameters:

error [line 1417]

Parameters:

factory [line 435]

Parameters:

findFile [line 1362]

Parameters:

getFormatConf [line 666]

Parameters:

getParseConf [line 504]

Parameters:

getPath [line 1336]

Parameters:

getRenderConf [line 590]

Parameters:

getSource [line 1057]

getTokens [line 1077]

Parameters:

insertRule [line 706]

Parameters:

isError [line 1438]

Parameters:

loadFormatObj [line 1275]

Parameters:

loadParseObj [line 1204]

Parameters:

loadRenderObj [line 1240]

Parameters:

parse [line 903]

Parameters:

render [line 945]

Parameters:

setFormatConf [line 632]

Parameters:

setParseConf [line 469]

Parameters:

setRenderConf [line 548]

Parameters:

setToken [line 1173]

Parameters:

singleton [line 411]

Parameters:

transform [line 882]

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())