Inherited Variables
Class: Converter
- Converter::$all_packages
- Converter::$class
- Converter::$classes
- Converter::$class_contents
- Converter::$class_data
- Converter::$class_elements
- Converter::$curfile
- Converter::$curpage
- Converter::$define_elements
- Converter::$elements
- Converter::$function_elements
- Converter::$global_elements
- Converter::$highlightingSource
- Converter::$package
- Converter::$packagecategories
- Converter::$package_elements
- Converter::$package_output
- Converter::$package_parents
- Converter::$page
- Converter::$page_contents
- Converter::$page_data
- Converter::$page_elements
- Converter::$parseprivate
- Converter::$path
- Converter::$pkg_elements
- Converter::$quietmode
- Converter::$smarty_dir
- Converter::$sort_absolutely_everything
- Converter::$sourcePaths
- Converter::$subpackage
- Converter::$targetDir
- Converter::$templateDir
- Converter::$templateName
- Converter::$template_options
- Converter::$title
- Converter::$todoList
Inherited Constants
Inherited Methods
Class: Converter
- Converter::Converter()
- Initialize Converter data structures
- Converter::AttrToString()
- Convert the attribute of a Tutorial docbook tag's attribute list
- Converter::Bolden()
- Used to convert the contents of <b> in a docblock
- Converter::Br()
- Used to convert <br> in a docblock
- Converter::checkState()
- Compare parserStringWithInlineTags::Convert() cache state to $state
- Converter::cleanup()
- Finish up parsing/cleanup directories
- Converter::Convert()
- Convert all elements to output format
- Converter::convertClass()
- Default Class Handler
- Converter::convertConst()
- Converts class constants for template output.
- Converter::convertDefine()
- Converts defines for template output
- Converter::ConvertErrorLog()
- Convert the phpDocumentor parsing/conversion error log
- Converter::convertFunction()
- Converts function for template output
- Converter::convertGlobal()
- Converts global variables for template output
- Converter::convertInclude()
- Converts includes for template output
- Converter::convertMethod()
- Converts method for template output
- Converter::convertPage()
- Default Page Handler
- Converter::ConvertTitle()
- Convert the title of a Tutorial docbook tag section
- Converter::ConvertTodoList()
- Convert the list of all @todo tags
- Converter::convertTutorial()
- Default Tutorial Handler
- Converter::convertVar()
- Converts class variables for template output.
- Converter::Convert_RIC()
- Convert README/INSTALL/CHANGELOG file contents to output format
- Converter::copyFile()
- Copies a file from the template directory to the target directory
- Converter::createParentDir()
- Recursively creates all subdirectories that don't exist in the $dir path
- Converter::EncloseList()
- Used to convert the contents of <ol> or <ul> in a docblock
- Converter::EncloseParagraph()
- Used to enclose a paragraph in a docblock
- Converter::endClass()
- Called by walk() while converting, when the last class element has been parsed.
- Converter::endPage()
- Called by walk() while converting, when the last procedural page element has been parsed.
- Converter::exampleProgramExample()
- Used to convert the {@example} inline tag in a docblock.
- Converter::flushHighlightCache()
- Return the close text for the current token
- Converter::formatIndex()
- Called by walk() while converting.
- Converter::formatLeftIndex()
- Called by walk() while converting.
- Converter::formatPkgIndex()
- Called by walk() while converting.
- Converter::formatTutorialTOC()
- Creates a table of contents for a {@toc} inline tag in a tutorial
- Converter::generateChildClassList()
- returns a list of child classes
- Converter::generateFormattedClassTree()
- returns an array containing the class inheritance tree from the root object to the class.
- Converter::getClassesOnPage()
- gets a list of all classes declared on a procedural page represented by
- Converter::getClassLink()
- return false or a classLink to $expr
- Converter::getConstLink()
- return false or a constLink to $expr in $class
- Converter::getConverterDir()
- Get the absolute path to the converter's base directory
- Converter::getCurrentPageLink()
- Converter::getCurrentPageURL()
- Return the path to the current
- Converter::getDefineLink()
- return false or a defineLink to $expr
- Converter::getFileSourceName()
- Translate the path info into a unique file name for the highlighted source code.
- Converter::getFileSourcePath()
- Return the fixed path to the source-code file folder.
- Converter::getFormattedConflicts()
- Converter::getFormattedDescMethods()
- Get a list of methods in child classes that override this method
- Converter::getFormattedDescVars()
- Get a list of vars in child classes that override this var
- Converter::getFormattedImplements()
- returns an array containing the class inheritance tree from the root object to the class.
- Converter::getFormattedInheritedConsts()
- Return template-enabled list of inherited class constants
- Converter::getFormattedInheritedMethods()
- Return template-enabled list of inherited methods
- Converter::getFormattedInheritedVars()
- Return template-enabled list of inherited variables
- Converter::getFormattedMethodImplements()
- Get the method this method(s) implemented from an interface, if any
- Converter::getFormattedOverrides()
- Get the method this method overrides, if any
- Converter::getFunctionLink()
- return false or a functionLink to $expr
- Converter::getGlobalLink()
- return false or a globalLink to $expr
- Converter::getGlobalValue()
- Parse a global variable's default value for class initialization.
- Converter::getHighlightState()
- Converter::getId()
- take abstractLink descendant and text $eltext and return a
- Converter::getIncludeValue()
- Parse an include's file to see if it is a file documented in this project
- Converter::getLink()
- The meat of the @see tag and inline {@link} tag
- Converter::getMethodLink()
- return false or a methodLink to $expr in $class
- Converter::getPageLink()
- return false or a pageLink to $expr
- Converter::getSortedClassTreeFromClass()
- Return a tree of all classes that extend this class
- Converter::getSourceLink()
- Converter::getState()
- Return parserStringWithInlineTags::Convert() cache state
- Converter::getTutorialId()
- Return a converter-specific id to distinguish tutorials and their sections
- Converter::getTutorialLink()
- The meat of the @tutorial tag and inline {@tutorial} tag
- Converter::getTutorialTree()
- Get a tree structure representing the hierarchy of tutorials
- Converter::getVarLink()
- return false or a varLink to $expr in $class
- Converter::hasSourceCode()
- Determine whether an element's file has generated source code, used for linking to line numbers of source.
- Converter::hasTutorial()
- Converter::highlightDocBlockSource()
- Used to allow converters to format the source code of DocBlocks the way they'd like.
- Converter::highlightSource()
- Used to allow converters to format the source code the way they'd like.
- Converter::highlightTutorialSource()
- Used to allow converters to format the source code of Tutorial XML the way they'd like.
- Converter::Italicize()
- Used to convert the contents of <i> in a docblock
- Converter::Kbdize()
- Used to convert the contents of <kbd> in a docblock
- Converter::ListItem()
- Used to convert the contents of <li> in a docblock
- Converter::newSmarty()
- Return a Smarty template object to operate with
- Converter::Output()
- do all necessary output
- Converter::postProcess()
- This version does nothing
- Converter::prepareDocBlock()
- convert the element's DocBlock for output
- Converter::PreserveWhiteSpace()
- Used to convert the contents of <pre> in a docblock
- Converter::ProgramExample()
- Used to convert the <code> tag in a docblock
- Converter::returnLink()
- take URL $link and text $text and return a link in the format needed for the Converter
- Converter::returnSee()
- take abstractLink descendant and text $eltext and return a link
- Converter::Sampize()
- Used to convert the contents of <samp> in a docblock
- Converter::setSourcePaths()
- Mark a file as having had source code highlighted
- Converter::setTargetDir()
- Sets the output directory for generated documentation
- Converter::setTemplateBase()
- Set the template directory with a different template base directory
- Converter::setTemplateDir()
- sets the template directory based on the $outputformat and $name
- Converter::sortPageContentsByElementType()
- sorts $page_contents by element type as well as alphabetically
- Converter::sourceLine()
- Return a line of highlighted source code with formatted line number
- Converter::startHighlight()
- Initialize highlight caching
- Converter::TranslateEntity()
- Used to translate an XML DocBook entity like ” from a tutorial by reading the options.ini file for the template.
- Converter::TranslateTag()
- Used to translate an XML DocBook tag from a tutorial by reading the options.ini file for the template.
- Converter::TutorialExample()
- Converter::type_adjust()
- Called by parserReturnTag::Convert() to allow converters to change type names to desired formatting
- Converter::unmangle()
- Called by parserSourceInlineTag::stringConvert() to allow converters to format the source code the way they'd like.
- Converter::vardump_tree()
- Debugging function for dumping $tutorial_tree
- Converter::Varize()
- Used to convert the contents of <var> in a docblock
- Converter::walk()
- called by phpDocumentor_IntermediateParser::Convert() to traverse the array of pages and their elements, converting them to the output format
- Converter::walk_everything()
- walk over elements by package rather than page
- Converter::writeExample()
- Write out the formatted source code for an example php file
- Converter::writeFile()
- Writes a file to target dir
- Converter::writeSource()
- Write out the formatted source code for a php file
- Converter::_rmdir()
- Completely remove a directory and its contents
- Converter::_setHighlightCache()
- Converter::_tutorial_path()
- Returns the path to this tutorial as a string
Class Details
HTML output converter.
This Converter takes output from the Parser and converts it to HTML-ready output for use with Smarty.
Tags:
- author - Greg Beaver <[email protected]>
- version - $Revision: 318096 $
- see - parserDocBlock, parserInclude, parserPage, parserClass, parserDefine, parserFunction, parserMethod, parserVar
- since - 1.0rc1
[ Top ]
Class Variables
$base_dir
[line 89]
target directory passed on the command-line.
$targetDir is malleable, always adding package/ and package/subpackage/ subdirectories onto it.
Type: string
Overrides:
[ Top ]
$class_dir
[ Top ]
$current
[line 120]
contains all of the template procedural page element loop data needed for the current template
Type: array
Overrides:
[ Top ]
$currentclass
[line 126]
contains all of the template class element loop data needed for the current template
Type: array
Overrides:
[ Top ]
$juststarted = false
[line 114]
controls formatting of parser informative output
Converter prints: "Converting /path/to/file.php... Procedural Page Elements... Classes..." Since HTMLdefaultConverter outputs files while converting, it needs to send a \n to start a new line. However, if there is more than one class, output is messy, with multiple \n's just between class file output. This variable prevents that and is purely cosmetic
Type: boolean
Overrides:
[ Top ]
$leftindex = array('classes' => true, 'pages' => true, 'functions' => true, 'defines' => false, 'globals' => false)
[ Top ]
$name = 'Smarty'
[ Top ]
$outputformat = 'HTML'
[ Top ]
$package_pages = array()
[line 102]
array of converted package page names.
Used to link to the package page in the left index
Tags:
- var - Format: array(package => 1)
Type: array
Overrides:
[ Top ]
$page_dir
[ Top ]
$processSpecialRoots = true
[line 61]
This converter knows about the new root tree processing
In order to fix PEAR Bug #6389
Type: boolean
Overrides: Array
[ Top ]
$ric_set = array()
[ Top ]
$sort_page_contents_by_type = true
[line 67]
Smarty Converter wants elements sorted by type as well as alphabetically
Tags:
Type: boolean
Overrides: Array
[ Top ]
$wrote = false
[ Top ]
Class Methods
HTMLSmartyConverter
HTMLSmartyConverter HTMLSmartyConverter(
&$allp,
&$packp,
&$classes,
&$procpages,
$po,
$pp,
$qm,
$targetDir,
$templateDir,
$title)
[line 148]
Parameters:
- &$allp -
- &$packp -
- &$classes -
- &$procpages -
- $po -
- $pp -
- $qm -
- $targetDir -
- $templateDir -
- $title -
[ Top ]
convertClass
void convertClass(
parserClass
&$element)
[line 1078]
Converts class for template output
Tags:
- see - Converter::getFormattedInheritedMethods(), Converter::getFormattedInheritedVars()
- see - Converter::prepareDocBlock(), Converter::generateChildClassList(), HTMLSmartyConverter::generateFormattedClassTree(), Converter::getFormattedConflicts()
Overrides Converter::convertClass() (Default Class Handler)
Parameters:
- parserClass &$element -
[ Top ]
convertConst
void convertConst(
parserDefine
&$element)
[line 1106]
Converts class variables for template output
Tags:
Overrides Converter::convertConst() (Converts class constants for template output.)
Parameters:
- parserDefine &$element -
[ Top ]
convertDefine
void convertDefine(
parserDefine
&$element)
[line 1147]
Converts defines for template output
Tags:
Overrides Converter::convertDefine() (Converts defines for template output)
Parameters:
- parserDefine &$element -
[ Top ]
ConvertErrorLog
void ConvertErrorLog(
)
[line 928]
Create errors.html template file output
This method takes all parsing errors and warnings and spits them out ordered by file and line number.
Tags:
- global - ErrorTracker $phpDocumentor_errors: We'll be using it's output facility
Overrides Converter::ConvertErrorLog() (Convert the phpDocumentor parsing/conversion error log)
Parameters:
[ Top ]
convertFunction
void convertFunction(
parserFunction
&$element)
[line 1126]
Converts function for template output
Tags:
- see - Converter::prepareDocBlock(), parserFunction::getFunctionCall(), Converter::getFormattedConflicts()
Overrides Converter::convertFunction() (Converts function for template output)
Parameters:
- parserFunction &$element -
[ Top ]
convertGlobal
void convertGlobal(
parserGlobal
&$element)
[line 1157]
Converts global variables for template output
Tags:
Overrides Converter::convertGlobal() (Converts global variables for template output)
Parameters:
- parserGlobal &$element -
[ Top ]
convertInclude
void convertInclude(
parserInclude
&$element)
[line 1137]
Converts include elements for template output
Tags:
Overrides Converter::convertInclude() (Converts includes for template output)
Parameters:
- parserInclude &$element -
[ Top ]
convertMethod
void convertMethod(
parserDefine
&$element)
[line 1116]
Converts class methods for template output
Tags:
Overrides Converter::convertMethod() (Converts method for template output)
Parameters:
- parserDefine &$element -
[ Top ]
convertPackagepage
void convertPackagepage(
parserPackagePage
&$element)
[line 1004]
Converts package page and sets its package as used in $package_pages
Parameters:
- parserPackagePage &$element -
[ Top ]
convertPage
void convertPage(
parserData
&$element)
[line 1167]
converts procedural pages for template output
Tags:
Overrides Converter::convertPage() (Default Page Handler)
Parameters:
- parserData &$element -
[ Top ]
ConvertTodoList
void ConvertTodoList(
)
[line 893]
Overrides Converter::ConvertTodoList() (Convert the list of all @todo tags)
Parameters:
[ Top ]
convertTutorial
void convertTutorial(
parserTutorial
&$element)
[line 1034]
Overrides Converter::convertTutorial() (Default Tutorial Handler)
Parameters:
- parserTutorial &$element -
[ Top ]
convertVar
void convertVar(
parserDefine
&$element)
[line 1096]
Converts class variables for template output
Tags:
Overrides Converter::convertVar() (Converts class variables for template output.)
Parameters:
- parserDefine &$element -
[ Top ]
Convert_RIC
void Convert_RIC(
README|INSTALL|CHANGELOG
$name, string
$contents)
[line 872]
Convert README/INSTALL/CHANGELOG file contents to output format
Overrides Converter::Convert_RIC() (Convert README/INSTALL/CHANGELOG file contents to output format)
Parameters:
- README|INSTALL|CHANGELOG $name -
- string $contents - contents of the file
[ Top ]
copyMediaRecursively
void copyMediaRecursively(
$media,
$targetdir, [
$subdir = ''])
[line 1604]
Parameters:
- $media -
- $targetdir -
- $subdir -
[ Top ]
endClass
void endClass(
)
[line 344]
Writes out the template file of $class_data and unsets the template to save memory
Tags:
- see - Converter::endClass()
- see - registerCurrentClass()
Overrides Converter::endClass() (Called by walk() while converting, when the last class element has been parsed.)
Parameters:
[ Top ]
endPage
void endPage(
)
[line 523]
Writes out the template file of $page_data and unsets the template to save memory
Tags:
- see - Converter::endPage()
- see - registerCurrent()
Overrides Converter::endPage() (Called by walk() while converting, when the last procedural page element has been parsed.)
Parameters:
[ Top ]
formatIndex
void formatIndex(
)
[line 642]
HTMLdefaultConverter uses this function to format template index.html and packages.html
This function generates the package list from $all_packages, eliminating any packages that don't have any entries in their package index (no files at all, due to @ignore or other factors). Then it uses the default package name as the first package index to display. It sets the right pane to be either a blank file with instructions on making package-level docs, or the package-level docs for the default package.
Tags:
- global - string $phpDocumentor_DefaultPackageName: Used to set the starting package to display
Overrides Converter::formatIndex() (Called by walk() while converting.)
Parameters:
[ Top ]
formatLeftIndex
void formatLeftIndex(
)
[line 740]
Generate indexes for li_package.html and classtree output files
This function generates the li_package.html files from the template file left.html. It does this by iterating through each of the $page_elements, $class_elements and $function_elements arrays to retrieve the pre-sorted abstractLink descendants needed for index generation. Conversion of these links to text is done by returnSee().
Then it uses generateFormattedClassTrees() to create class trees from the template file classtrees.html. Output filename is classtrees_packagename.html. This function also unsets $elements and $pkg_elements to free up the considerable memory these two class vars use
Tags:
Overrides Converter::formatLeftIndex() (Called by walk() while converting.)
Parameters:
[ Top ]
formatPkgIndex
void formatPkgIndex(
)
[line 606]
HTMLdefaultConverter chooses to format both package indexes and the complete index here
This function formats output for the elementindex.html and pkgelementindex.html template files. It then writes them to the target directory
Tags:
Overrides Converter::formatPkgIndex() (Called by walk() while converting.)
Parameters:
[ Top ]
formatTutorialTOC
string formatTutorialTOC(
array
$toc)
[line 321]
Use the template tutorial_toc.tpl to generate a table of contents for HTML
Tags:
- return - table of contents formatted for use in the current output format
Overrides Converter::formatTutorialTOC() (Creates a table of contents for a {@toc} inline tag in a tutorial)
Parameters:
- array $toc - format: array(array('tagname' => section, 'link' => returnsee link, 'id' => anchor name, 'title' => from title tag),...)
[ Top ]
generateElementIndex
void generateElementIndex(
)
[line 1571]
Generate alphabetical index of all elements
Tags:
Parameters:
[ Top ]
generateFormattedClassTree
array generateFormattedClassTree(
parserClass
$class)
[line 1195]
returns an array containing the class inheritance tree from the root object to the class
Tags:
- return - Format: array(root,child,child,child,...,$class)
- uses - parserClass::getParentClassTree()
Overrides Converter::generateFormattedClassTree() (returns an array containing the class inheritance tree from the root object to the class.)
Parameters:
- parserClass $class - class variable
[ Top ]
generateFormattedClassTrees
void generateFormattedClassTrees(
string
$package)
[line 1259]
returns a template-enabled array of class trees
Tags:
- see - $roots, HTMLConverter::getRootTree()
Parameters:
- string $package - package to generate a class tree for
[ Top ]
generateFormattedInterfaceTrees
void generateFormattedInterfaceTrees(
string
$package)
[line 1313]
returns a template-enabled array of interface inheritance trees
Tags:
- see - $roots, HTMLConverter::getRootTree()
Parameters:
- string $package - package to generate a class tree for
[ Top ]
generatePkgElementIndex
void generatePkgElementIndex(
string
$package)
[line 1669]
Generate alphabetical index of all elements by package and subpackage
Tags:
Parameters:
- string $package - name of a package
[ Top ]
generatePkgElementIndexes
[ Top ]
getCData
[ Top ]
getClassContents
[ Top ]
getClassLeft
[ Top ]
getClassLink
mixed getClassLink(
string
$expr, string
$package, [string
$file = false], [boolean
$text = false], [boolean
$with_a = true])
[line 1759]
Tags:
- return - false if not found, or an html a link to the class's documentation
- see - Converter::getClassLink()
Overrides Converter::getClassLink() (return false or a classLink to $expr)
Parameters:
- string $expr - name of class
- string $package - package name
- string $file - full path to look in (used in index generation)
- boolean $text - deprecated
- boolean $with_a - return just the URL, or enclose it in an html a tag
[ Top ]
getConstLink
mixed getConstLink(
string
$expr, string
$class, string
$package, [string
$file = false], [boolean
$text = false], boolean
5)
[line 1874]
Tags:
- return - false if not found, or an html a link to the var's documentation
- see - Converter::getVarLink()
Overrides Converter::getConstLink() (return false or a constLink to $expr in $class)
Parameters:
- boolean 5 - return just the URL, or enclose it in an html a tag
- string $expr - name of class constant
- string $class - class containing class constant
- string $package - package name
- string $file - full path to look in (used in index generation)
- boolean $text - deprecated
[ Top ]
getCurrentPageLink
void getCurrentPageLink(
)
[line 287]
Overrides Converter::getCurrentPageLink() (parent method not documented)
Parameters:
[ Top ]
getDefineLink
mixed getDefineLink(
string
$expr, string
$package, [string
$file = false], [boolean
$text = false], boolean
4)
[line 1791]
Tags:
- return - false if not found, or an html a link to the define's documentation
- see - Converter::getDefineLink()
Overrides Converter::getDefineLink() (return false or a defineLink to $expr)
Parameters:
- boolean 4 - return just the URL, or enclose it in an html a tag
- string $expr - name of define
- string $package - package name
- string $file - full path to look in (used in index generation)
- boolean $text - deprecated
[ Top ]
getExampleLink
[ Top ]
getFunctionLink
mixed getFunctionLink(
string
$expr, string
$package, [string
$file = false], [boolean
$text = false], boolean
4)
[line 1775]
Tags:
- return - false if not found, or an html a link to the function's documentation
- see - Converter::getFunctionLink()
Overrides Converter::getFunctionLink() (return false or a functionLink to $expr)
Parameters:
- boolean 4 - return just the URL, or enclose it in an html a tag
- string $expr - name of function
- string $package - package name
- string $file - full path to look in (used in index generation)
- boolean $text - deprecated
[ Top ]
getGlobalLink
mixed getGlobalLink(
string
$expr, string
$package, [string
$file = false], [boolean
$text = false], boolean
4)
[line 1807]
Tags:
- return - false if not found, or an html a link to the global variable's documentation
- see - Converter::getGlobalLink()
Overrides Converter::getGlobalLink() (return false or a globalLink to $expr)
Parameters:
- boolean 4 - return just the URL, or enclose it in an html a tag
- string $expr - name of global variable
- string $package - package name
- string $file - full path to look in (used in index generation)
- boolean $text - deprecated
[ Top ]
getId
void getId(
$element, [
$fullpath = true])
[line 814]
Overrides Converter::getId() (take abstractLink descendant and text $eltext and return a)
Parameters:
- $element -
- $fullpath -
[ Top ]
getIndexInformation
array getIndexInformation(
parserElement
$elt)
[line 1453]
Generate indexing information for given element
Tags:
Parameters:
- parserElement $elt - descendant of parserElement
[ Top ]
getMethodLink
mixed getMethodLink(
string
$expr, string
$class, string
$package, [string
$file = false], [boolean
$text = false], boolean
5)
[line 1840]
Tags:
- return - false if not found, or an html a link to the method's documentation
- see - Converter::getMethodLink()
Overrides Converter::getMethodLink() (return false or a methodLink to $expr in $class)
Parameters:
- boolean 5 - return just the URL, or enclose it in an html a tag
- string $expr - name of method
- string $class - class containing method
- string $package - package name
- string $file - full path to look in (used in index generation)
- boolean $text - deprecated
[ Top ]
getPageContents
[ Top ]
getPageLeft
[ Top ]
getPageLink
mixed getPageLink(
string
$expr, string
$package, [string
$path = false], [boolean
$text = false], boolean
4)
[line 1823]
Tags:
- return - false if not found, or an html a link to the procedural page's documentation
- see - Converter::getPageLink()
Overrides Converter::getPageLink() (return false or a pageLink to $expr)
Parameters:
- boolean 4 - return just the URL, or enclose it in an html a tag
- string $expr - name of procedural page
- string $package - package name
- string $path - full path to look in (used in index generation)
- boolean $text - deprecated
[ Top ]
getPageName
[ Top ]
getRootTree
string getRootTree(
array
$tree, string
$package, [
$noparent = false], boolean
$nounknownparent)
[line 1370]
return formatted class tree for the Class Trees page
Tags:
- see - Classes::$definitechild, HTMLSmartyConverter::generateFormattedClassTrees()
Parameters:
- array $tree - output from getSortedClassTreeFromClass()
- string $package - package
- boolean $nounknownparent - if true, an object's parent will not be checked
- $noparent -
[ Top ]
getSourceAnchor
string getSourceAnchor(
string
$sourcefile, string
$anchor, [string
$text = ''], [boolean
$link = false])
[line 211]
Retrieve a Converter-specific anchor to a segment of a source code file parsed via a @filesource tag.
Tags:
- return - link to an anchor, or the anchor
Parameters:
- string $sourcefile - full path to source file
- string $anchor - name of anchor
- string $text - link text, if this is a link
- boolean $link - returns either a link or a destination based on this parameter
[ Top ]
getSourceLink
void getSourceLink(
$path)
[line 195]
Overrides Converter::getSourceLink() (parent method not documented)
Parameters:
- $path -
[ Top ]
getTutorialId
void getTutorialId(
$package,
$subpackage,
$tutorial,
$id)
[line 995]
Overrides Converter::getTutorialId() (Return a converter-specific id to distinguish tutorials and their sections)
Parameters:
- $package -
- $subpackage -
- $tutorial -
- $id -
[ Top ]
getTutorialList
[ Top ]
getTutorialTree
void getTutorialTree(
$tutorial, [
$k = false])
[line 396]
Overrides Converter::getTutorialTree() (Get a tree structure representing the hierarchy of tutorials)
Parameters:
- $tutorial -
- $k -
[ Top ]
getVarLink
mixed getVarLink(
string
$expr, string
$class, string
$package, [string
$file = false], [boolean
$text = false], boolean
5)
[line 1857]
Tags:
- return - false if not found, or an html a link to the var's documentation
- see - Converter::getVarLink()
Overrides Converter::getVarLink() (return false or a varLink to $expr in $class)
Parameters:
- boolean 5 - return just the URL, or enclose it in an html a tag
- string $expr - name of var
- string $class - class containing var
- string $package - package name
- string $file - full path to look in (used in index generation)
- boolean $text - deprecated
[ Top ]
makeLeft
[ Top ]
Output
void Output(
)
[line 1931]
This function is not used by HTMLdefaultConverter, but is required by Converter
Overrides Converter::Output() (do all necessary output)
Parameters:
[ Top ]
postProcess
void postProcess(
$text)
[line 307]
Uses htmlspecialchars() on the input
Overrides Converter::postProcess() (This version does nothing)
Parameters:
- $text -
[ Top ]
ProgramExample
string ProgramExample(
string
$example, [boolean
$tutorial = false], [
$inlinesourceparse = null], [
$class = null], [
$linenum = null], [
$filesourcepath = null])
[line 255]
Used to convert the <code> tag in a docblock
Overrides Converter::ProgramExample() (Used to convert the <code> tag in a docblock)
Parameters:
- string $example -
- boolean $tutorial -
- $inlinesourceparse -
- $class -
- $linenum -
- $filesourcepath -
[ Top ]
rcNatCmp
int rcNatCmp(
mixed
$a, mixed
$b)
[line 1888]
does a nat case sort on the specified second level value of the array
Parameters:
- mixed $a -
- mixed $b -
[ Top ]
rcNatCmp1
int rcNatCmp1(
mixed
$a, mixed
$b)
[line 1904]
does a nat case sort on the specified second level value of the array.
this one puts constructors first
Parameters:
- mixed $a -
- mixed $b -
[ Top ]
returnLink
string returnLink(
string
$link, string
$text)
[line 549]
Tags:
- return - <a href="'.$link.'">'.$text.'</a>
Overrides Converter::returnLink() (take URL $link and text $text and return a link in the format needed for the Converter)
Parameters:
- string $link -
- string $text -
[ Top ]
returnSee
void returnSee(
abstractLink
&$element, [string
$eltext = false], [boolean
$with_a = true], boolean
3)
[line 784]
This function takes an abstractLink descendant and returns an html link
Overrides Converter::returnSee() (take abstractLink descendant and text $eltext and return a link)
Parameters:
- boolean 3 - determines whether the returned text is enclosed in an <a> tag
- abstractLink &$element - a descendant of abstractlink should be passed, and never text
- string $eltext - text to display in the link
- boolean $with_a - this parameter is not used, and is deprecated
[ Top ]
setTargetDir
void setTargetDir(
$dir)
[line 1649]
calls the converter setTargetDir, and then copies any template images and the stylesheet if they haven't been copied
Tags:
Overrides Converter::setTargetDir() (Sets the output directory for generated documentation)
Parameters:
- $dir -
[ Top ]
SmartyInit
[ Top ]
sourceLine
string sourceLine(
integer
$linenumber, string
$line, [false|string
$path = false])
[line 232]
Return a line of highlighted source code with formatted line number
If the $path is a full path, then an anchor to the line number will be added as well
Tags:
- return - formatted source code line with line number
Overrides Converter::sourceLine() (Return a line of highlighted source code with formatted line number)
Parameters:
- integer $linenumber - line number
- string $line - highlighted source code line
- false|string $path - full path to @filesource file this line is a part of, if this is a single line from a complete file.
[ Top ]
TutorialExample
void TutorialExample(
string
$example)
[line 273]
Overrides Converter::TutorialExample() (parent method not documented)
Parameters:
- string $example -
[ Top ]
unmangle
void unmangle(
$sourcecode)
[line 292]
Overrides Converter::unmangle() (Called by parserSourceInlineTag::stringConvert() to allow converters to format the source code the way they'd like.)
Parameters:
- $sourcecode -
[ Top ]
writeExample
void writeExample(
$title,
$path,
$source)
[line 172]
Overrides Converter::writeExample() (Write out the formatted source code for an example php file)
Parameters:
- $title -
- $path -
- $source -
[ Top ]
writeNewPPage
[ Top ]
writeRIC
[ Top ]
writeSource
void writeSource(
$path,
$value)
[line 154]
Overrides Converter::writeSource() (Write out the formatted source code for a php file)
Parameters:
- $path -
- $value -
[ Top ]