MWTidy Class Reference

Class to interact with HTML tidy. More...

List of all members.

Static Public Member Functions
static	checkErrors ($text, &$errorStr=null)
	Check HTML for errors, used if $wgValidateAllHtml = true.
static	tidy ($text)
	Interface with html tidy, used if $wgUseTidy = true.
Static Private Member Functions
static	execExternalTidy ($text, $stderr=false, &$retval=null)
	Spawn an external HTML tidy process and get corrected markup back from it.
static	execInternalTidy ($text, $stderr=false, &$retval=null)
	Use the HTML tidy extension to use the tidy library in-process, saving the overhead of spawning a new process.

---

Detailed Description

Class to interact with HTML tidy.

Either the external tidy program or the in-process tidy extension will be used depending on availability. Override the default $wgTidyInternal setting to disable the internal if it's not working.

Definition at line 117 of file Tidy.php.

---

Member Function Documentation

static MWTidy::checkErrors	(	$	text,
		&$	errorStr = null
	)		[static]

Check HTML for errors, used if $wgValidateAllHtml = true.

Parameters:

$text	String
&$errorStr	String: return the error string

Returns:

Boolean: whether the HTML is valid

Definition at line 159 of file Tidy.php.

Referenced by wfHtmlValidationHandler().

static MWTidy::execExternalTidy	(	$	text,
		$	stderr = false,
		&$	retval = null
	)		[static, private]

Spawn an external HTML tidy process and get corrected markup back from it.

Also called in OutputHandler.php for full page validation

Parameters:

string	$text	HTML to check
	$stderr	Boolean: Whether to read result from STDERR rather than STDOUT
	&$retval	int Exit code (-1 on internal error)

Returns:

mixed String or null

Definition at line 181 of file Tidy.php.

static MWTidy::execInternalTidy	(	$	text,
		$	stderr = false,
		&$	retval = null
	)		[static, private]

Use the HTML tidy extension to use the tidy library in-process, saving the overhead of spawning a new process.

Parameters:

string	$text	HTML to check
	$stderr	Boolean: Whether to read result from error status instead of output
	&$retval	int Exit code (-1 on internal error)

Returns:

mixed String or null

Definition at line 248 of file Tidy.php.

static MWTidy::tidy

(

$

text

)

[static]

Interface with html tidy, used if $wgUseTidy = true.

If tidy isn't able to correct the markup, the original will be returned in all its glory with a warning comment appended.

Parameters:

string

$text

hideous HTML input

Returns:

String: corrected HTML output

Definition at line 126 of file Tidy.php.

Referenced by SpecialExpandTemplates\execute(), TidyTest\setUp(), and TidyTest\testTidyWrapping().

---

The documentation for this class was generated from the following file:

• includes/parser/Tidy.php