phpDocumentor Converters
HTMLSmarty
[ class tree: Converters ] [ index: Converters ] [ all elements ]

Class: HTMLSmartyConverter

Source Location: /phpDocumentor/Converters/HTML/Smarty/HTMLSmartyConverter.inc

Class HTMLSmartyConverter

Class Overview

HTML output converter.

This Converter takes output from the Parser and converts it to HTML-ready output for use with Smarty.

Located in /phpDocumentor/Converters/HTML/Smarty/HTMLSmartyConverter.inc [line 54]

Converter
   |
   --HTMLSmartyConverter
Author(s): API Tags:
See:  parserDocBlock, parserInclude, parserPage, parserClass, parserDefine, parserFunction, parserMethod, parserVar

Information Tags:
Version:  $Revision: 318096 $
Since:  1.0rc1

Properties

Methods

[ Top ]
Inherited Properties, Constants, and Methods
Inherited Properties Inherited Methods Inherited Constants

Inherited From 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 From 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 &rdquo; 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

[ Top ]
Property Summary
string   $base_dir   target directory passed on the command-line.
string   $class_dir   output directory for the current class being processed
array   $current   contains all of the template procedural page element loop data needed for the current template
array   $currentclass   contains all of the template class element loop data needed for the current template
boolean   $juststarted   controls formatting of parser informative output
array   $leftindex   indexes of elements by package that need to be generated
string   $name  
string   $outputformat  
array   $package_pages   array of converted package page names.
string   $page_dir   output directory for the current procedural page being processed
boolean   $processSpecialRoots   This converter knows about the new root tree processing
mixed   $ric_set  
boolean   $sort_page_contents_by_type   Smarty Converter wants elements sorted by type as well as alphabetically
mixed   $wrote  

[ Top ]
Method Summary
HTMLSmartyConverter   HTMLSmartyConverter()  
void   convertClass()   Converts class for template output
void   convertConst()   Converts class variables for template output
void   convertDefine()   Converts defines for template output
void   ConvertErrorLog()   Create errors.html template file output
void   convertFunction()   Converts function for template output
void   convertGlobal()   Converts global variables for template output
void   convertInclude()   Converts include elements for template output
void   convertMethod()   Converts class methods for template output
void   convertPackagepage()   Converts package page and sets its package as used in $package_pages
void   convertPage()   converts procedural pages for template output
void   ConvertTodoList()  
void   convertTutorial()  
void   convertVar()   Converts class variables for template output
void   Convert_RIC()   Convert README/INSTALL/CHANGELOG file contents to output format
void   copyMediaRecursively()  
void   endClass()   Writes out the template file of $class_data and unsets the template to save memory
void   endPage()   Writes out the template file of $page_data and unsets the template to save memory
void   formatIndex()   HTMLdefaultConverter uses this function to format template index.html and packages.html
void   formatLeftIndex()   Generate indexes for li_package.html and classtree output files
void   formatPkgIndex()   HTMLdefaultConverter chooses to format both package indexes and the complete index here
string   formatTutorialTOC()   Use the template tutorial_toc.tpl to generate a table of contents for HTML
void   generateElementIndex()   Generate alphabetical index of all elements
array   generateFormattedClassTree()   returns an array containing the class inheritance tree from the root object to the class
void   generateFormattedClassTrees()   returns a template-enabled array of class trees
void   generateFormattedInterfaceTrees()   returns a template-enabled array of interface inheritance trees
void   generatePkgElementIndex()   Generate alphabetical index of all elements by package and subpackage
void   generatePkgElementIndexes()  
void   getCData()  
void   getClassContents()  
void   getClassLeft()  
mixed   getClassLink()  
mixed   getConstLink()  
void   getCurrentPageLink()  
mixed   getDefineLink()  
void   getExampleLink()  
mixed   getFunctionLink()  
mixed   getGlobalLink()  
void   getId()  
array   getIndexInformation()   Generate indexing information for given element
mixed   getMethodLink()  
void   getPageContents()  
void   getPageLeft()  
mixed   getPageLink()  
void   getPageName()  
string   getRootTree()   return formatted class tree for the Class Trees page
string   getSourceAnchor()   Retrieve a Converter-specific anchor to a segment of a source code file parsed via a @filesource tag.
void   getSourceLink()  
void   getTutorialId()  
void   getTutorialList()  
void   getTutorialTree()  
mixed   getVarLink()  
void   makeLeft()  
void   Output()   This function is not used by HTMLdefaultConverter, but is required by Converter
void   postProcess()   Uses htmlspecialchars() on the input
string   ProgramExample()   Used to convert the <code> tag in a docblock
int   rcNatCmp()   does a nat case sort on the specified second level value of the array
int   rcNatCmp1()   does a nat case sort on the specified second level value of the array.
string   returnLink()  
void   returnSee()   This function takes an abstractLink descendant and returns an html link
void   setTargetDir()   calls the converter setTargetDir, and then copies any template images and the stylesheet if they haven't been copied
void   &SmartyInit()  
string   sourceLine()   Return a line of highlighted source code with formatted line number
void   TutorialExample()  
void   unmangle()  
void   writeExample()  
void   writeNewPPage()  
void   writeRIC()  
void   writeSource()  

[ Top ]
Properties
string   $base_dir [line 89]

target directory passed on the command-line.

$targetDir is malleable, always adding package/ and package/subpackage/ subdirectories onto it.


[ Top ]
string   $class_dir [line 95]

output directory for the current class being processed


[ Top ]
array   $current [line 120]

contains all of the template procedural page element loop data needed for the current template


[ Top ]
array   $currentclass [line 126]

contains all of the template class element loop data needed for the current template


[ Top ]
boolean   $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


[ Top ]
array   $leftindex = array('classes' => true, 'pages' => true, 'functions' => true, 'defines' => false, 'globals' => false) [line 76]

indexes of elements by package that need to be generated


Redefinition of:
Converter::$leftindex
Controls which of the one-element-only indexes are generated.

[ Top ]
string   $name = 'Smarty' [line 71]

[ Top ]
string   $outputformat = 'HTML' [line 69]

Redefinition of:
Converter::$outputformat
output format of this converter

[ Top ]
array   $package_pages = array() [line 102]

array of converted package page names.

Used to link to the package page in the left index


[ Top ]
string   $page_dir [line 82]

output directory for the current procedural page being processed


[ Top ]
boolean   $processSpecialRoots = true [line 61]

This converter knows about the new root tree processing

In order to fix PEAR Bug #6389


Redefinition of:
Converter::$processSpecialRoots
This converter knows about the new root tree processing

[ Top ]
mixed   $ric_set = array() [line 128]

[ Top ]
boolean   $sort_page_contents_by_type = true [line 67]

Smarty Converter wants elements sorted by type as well as alphabetically

API Tags:
See:  Converter::$sort_page_contents_by_type


Redefinition of:
Converter::$sort_page_contents_by_type
This determines whether the $page_contents array should be sorted by element type as well as alphabetically by name

[ Top ]
mixed   $wrote = false [line 127]

[ Top ]
Methods
Constructor HTMLSmartyConverter  [line 148]

  HTMLSmartyConverter HTMLSmartyConverter( &$allp, &$packp, &$classes, &$procpages, $po, $pp, $qm, $targetDir, $templateDir, $title  )

Parameters:
   &$allp: 
   &$packp: 
   &$classes: 
   &$procpages: 
   $po: 
   $pp: 
   $qm: 
   $targetDir: 
   $templateDir: 
   $title: 


[ Top ]
convertClass  [line 1078]

  void convertClass( parserClass &$element  )

Converts class for template output

Parameters:
parserClass   &$element: 

API Tags:
See:  Converter::getFormattedInheritedMethods(), Converter::getFormattedInheritedVars()
See:  Converter::prepareDocBlock(), Converter::generateChildClassList(), HTMLSmartyConverter::generateFormattedClassTree(), Converter::getFormattedConflicts()


Redefinition of:
Converter::convertClass()
Default Class Handler

[ Top ]
convertConst  [line 1106]

  void convertConst( parserDefine &$element  )

Converts class variables for template output

Parameters:
parserDefine   &$element: 

API Tags:
See:  Converter::prepareDocBlock(), Converter::getFormattedConflicts()


Redefinition of:
Converter::convertConst()
Converts class constants for template output.

[ Top ]
convertDefine  [line 1147]

  void convertDefine( parserDefine &$element  )

Converts defines for template output

Parameters:
parserDefine   &$element: 

API Tags:
See:  Converter::prepareDocBlock(), Converter::getFormattedConflicts()


Redefinition of:
Converter::convertDefine()
Converts defines for template output

[ Top ]
ConvertErrorLog  [line 928]

  void ConvertErrorLog( )

Create errors.html template file output

This method takes all parsing errors and warnings and spits them out ordered by file and line number.


API Tags:
Global:  ErrorTracker $phpDocumentor_errors: We'll be using it's output facility


Redefinition of:
Converter::ConvertErrorLog()
Convert the phpDocumentor parsing/conversion error log

[ Top ]
convertFunction  [line 1126]

  void convertFunction( parserFunction &$element  )

Converts function for template output

Parameters:
parserFunction   &$element: 

API Tags:
See:  Converter::prepareDocBlock(), parserFunction::getFunctionCall(), Converter::getFormattedConflicts()


Redefinition of:
Converter::convertFunction()
Converts function for template output

[ Top ]
convertGlobal  [line 1157]

  void convertGlobal( parserGlobal &$element  )

Converts global variables for template output

Parameters:
parserGlobal   &$element: 

API Tags:
See:  Converter::prepareDocBlock(), Converter::getFormattedConflicts()


Redefinition of:
Converter::convertGlobal()
Converts global variables for template output

[ Top ]
convertInclude  [line 1137]

  void convertInclude( parserInclude &$element  )

Converts include elements for template output

Parameters:
parserInclude   &$element: 

API Tags:
See:  Converter::prepareDocBlock()


Redefinition of:
Converter::convertInclude()
Converts includes for template output

[ Top ]
convertMethod  [line 1116]

  void convertMethod( parserDefine &$element  )

Converts class methods for template output

Parameters:
parserDefine   &$element: 

API Tags:
See:  Converter::prepareDocBlock(), Converter::getFormattedConflicts()


Redefinition of:
Converter::convertMethod()
Converts method for template output

[ Top ]
convertPackagepage  [line 1004]

  void convertPackagepage( parserPackagePage &$element  )

Converts package page and sets its package as used in $package_pages

Parameters:
parserPackagePage   &$element: 


[ Top ]
convertPage  [line 1167]

  void convertPage( parserData &$element  )

converts procedural pages for template output

Parameters:
parserData   &$element: 

API Tags:
See:  Converter::prepareDocBlock(), Converter::getClassesOnPage()


Redefinition of:
Converter::convertPage()
Default Page Handler

[ Top ]
ConvertTodoList  [line 893]

  void ConvertTodoList( )



Redefinition of:
Converter::ConvertTodoList()
Convert the list of all @todo tags

[ Top ]
convertTutorial  [line 1034]

  void convertTutorial( parserTutorial &$element  )

Parameters:
parserTutorial   &$element: 


Redefinition of:
Converter::convertTutorial()
Default Tutorial Handler

[ Top ]
convertVar  [line 1096]

  void convertVar( parserDefine &$element  )

Converts class variables for template output

Parameters:
parserDefine   &$element: 

API Tags:
See:  Converter::prepareDocBlock(), Converter::getFormattedConflicts()


Redefinition of:
Converter::convertVar()
Converts class variables for template output.

[ Top ]
Convert_RIC  [line 872]

  void Convert_RIC( README|INSTALL|CHANGELOG $name, string $contents  )

Convert README/INSTALL/CHANGELOG file contents to output format

Parameters:
README|INSTALL|CHANGELOG   $name: 
string   $contents:  contents of the file


Redefinition of:
Converter::Convert_RIC()
Convert README/INSTALL/CHANGELOG file contents to output format

[ Top ]
copyMediaRecursively  [line 1604]

  void copyMediaRecursively( $media, $targetdir, [ $subdir = '']  )

Parameters:
   $media: 
   $targetdir: 
   $subdir: 


[ Top ]
endClass  [line 344]

  void endClass( )

Writes out the template file of $class_data and unsets the template to save memory


API Tags:
See:  Converter::endClass()
See:  registerCurrentClass()


Redefinition of:
Converter::endClass()
Called by walk() while converting, when the last class element has been parsed.

[ Top ]
endPage  [line 523]

  void endPage( )

Writes out the template file of $page_data and unsets the template to save memory


API Tags:
See:  Converter::endPage()
See:  registerCurrent()


Redefinition of:
Converter::endPage()
Called by walk() while converting, when the last procedural page element has been parsed.

[ Top ]
formatIndex  [line 642]

  void formatIndex( )

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.


API Tags:
Global:  string $phpDocumentor_DefaultPackageName: Used to set the starting package to display


Redefinition of:
Converter::formatIndex()
Called by walk() while converting.

[ Top ]
formatLeftIndex  [line 740]

  void formatLeftIndex( )

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


API Tags:
See:  Converter::$page_elements, Converter::$class_elements, Converter::$function_elements


Redefinition of:
Converter::formatLeftIndex()
Called by walk() while converting.

[ Top ]
formatPkgIndex  [line 606]

  void formatPkgIndex( )

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


API Tags:
See:  HTMLSmartyConverter::generateElementIndex(), HTMLSmartyConverter::generatePkgElementIndex()


Redefinition of:
Converter::formatPkgIndex()
Called by walk() while converting.

[ Top ]
formatTutorialTOC  [line 321]

  string formatTutorialTOC( array $toc  )

Use the template tutorial_toc.tpl to generate a table of contents for HTML

Parameters:
array   $toc:  format: array(array('tagname' => section, 'link' => returnsee link, 'id' => anchor name, 'title' => from title tag),...)

API Tags:
Return:  table of contents formatted for use in the current output format


Redefinition of:
Converter::formatTutorialTOC()
Creates a table of contents for a {@toc} inline tag in a tutorial

[ Top ]
generateElementIndex  [line 1571]

  void generateElementIndex( )

Generate alphabetical index of all elements


API Tags:
See:  Converter::$elements, Converter::walk()


[ Top ]
generateFormattedClassTree  [line 1195]

  array generateFormattedClassTree( parserClass $class  )

returns an array containing the class inheritance tree from the root object to the class

Parameters:
parserClass   $class:  class variable

API Tags:
Return:  Format: array(root,child,child,child,...,$class)
Uses:  parserClass::getParentClassTree()


Redefinition of:
Converter::generateFormattedClassTree()
returns an array containing the class inheritance tree from the root object to the class.

[ Top ]
generateFormattedClassTrees  [line 1259]

  void generateFormattedClassTrees( string $package  )

returns a template-enabled array of class trees

Parameters:
string   $package:  package to generate a class tree for

API Tags:
See:  $roots, HTMLConverter::getRootTree()


[ Top ]
generateFormattedInterfaceTrees  [line 1313]

  void generateFormattedInterfaceTrees( string $package  )

returns a template-enabled array of interface inheritance trees

Parameters:
string   $package:  package to generate a class tree for

API Tags:
See:  $roots, HTMLConverter::getRootTree()


[ Top ]
generatePkgElementIndex  [line 1669]

  void generatePkgElementIndex( string $package  )

Generate alphabetical index of all elements by package and subpackage

Parameters:
string   $package:  name of a package

API Tags:
See:  Converter::$pkg_elements, Converter::walk(), HTMLSmartyConverter::generatePkgElementIndexes()


[ Top ]
generatePkgElementIndexes  [line 1719]

  void generatePkgElementIndexes( )


API Tags:
See:  HTMLSmartyConverter::generatePkgElementIndex()


[ Top ]
getCData  [line 990]

  void getCData( $value  )

Parameters:
   $value: 


[ Top ]
getClassContents  [line 466]

  void getClassContents( )



[ Top ]
getClassLeft  [line 436]

  void getClassLeft( )



[ Top ]
getClassLink  [line 1759]

  mixed getClassLink( string $expr, string $package, [string $file = false], [boolean $text = false], [boolean $with_a = true]  )

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

API Tags:
Return:  false if not found, or an html a link to the class's documentation
See:  Converter::getClassLink()


Redefinition of:
Converter::getClassLink()
return false or a classLink to $expr

[ Top ]
getConstLink  [line 1874]

  mixed getConstLink( string $expr, string $class, string $package, [string $file = false], [boolean $text = false], boolean 5  )

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

API Tags:
Return:  false if not found, or an html a link to the var's documentation
See:  Converter::getVarLink()


Redefinition of:
Converter::getConstLink()
return false or a constLink to $expr in $class

[ Top ]
getCurrentPageLink  [line 287]

  void getCurrentPageLink( )



Redefinition of:
Converter::getCurrentPageLink()

[ Top ]
getDefineLink  [line 1791]

  mixed getDefineLink( string $expr, string $package, [string $file = false], [boolean $text = false], boolean 4  )

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

API Tags:
Return:  false if not found, or an html a link to the define's documentation
See:  Converter::getDefineLink()


Redefinition of:
Converter::getDefineLink()
return false or a defineLink to $expr

[ Top ]
getExampleLink  [line 190]

  void getExampleLink( $path, $title  )

Parameters:
   $path: 
   $title: 


[ Top ]
getFunctionLink  [line 1775]

  mixed getFunctionLink( string $expr, string $package, [string $file = false], [boolean $text = false], boolean 4  )

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

API Tags:
Return:  false if not found, or an html a link to the function's documentation
See:  Converter::getFunctionLink()


Redefinition of:
Converter::getFunctionLink()
return false or a functionLink to $expr

[ Top ]
getGlobalLink  [line 1807]

  mixed getGlobalLink( string $expr, string $package, [string $file = false], [boolean $text = false], boolean 4  )

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

API Tags:
Return:  false if not found, or an html a link to the global variable's documentation
See:  Converter::getGlobalLink()


Redefinition of:
Converter::getGlobalLink()
return false or a globalLink to $expr

[ Top ]
getId  [line 814]

  void getId( $element, [ $fullpath = true]  )

Parameters:
   $element: 
   $fullpath: 


Redefinition of:
Converter::getId()
take abstractLink descendant and text $eltext and return a

[ Top ]
getIndexInformation  [line 1453]

  array getIndexInformation( parserElement $elt  )

Generate indexing information for given element

Parameters:
parserElement   $elt:  descendant of parserElement

API Tags:
See:  HTMLSmartyConverter::generateElementIndex()


[ Top ]
getMethodLink  [line 1840]

  mixed getMethodLink( string $expr, string $class, string $package, [string $file = false], [boolean $text = false], boolean 5  )

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

API Tags:
Return:  false if not found, or an html a link to the method's documentation
See:  Converter::getMethodLink()


Redefinition of:
Converter::getMethodLink()
return false or a methodLink to $expr in $class

[ Top ]
getPageContents  [line 482]

  void getPageContents( )



[ Top ]
getPageLeft  [line 499]

  void getPageLeft( )



[ Top ]
getPageLink  [line 1823]

  mixed getPageLink( string $expr, string $package, [string $path = false], [boolean $text = false], boolean 4  )

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

API Tags:
Return:  false if not found, or an html a link to the procedural page's documentation
See:  Converter::getPageLink()


Redefinition of:
Converter::getPageLink()
return false or a pageLink to $expr

[ Top ]
getPageName  [line 1181]

  void getPageName( &$element  )

Parameters:
   &$element: 


[ Top ]
getRootTree  [line 1370]

  string getRootTree( array $tree, string $package, [ $noparent = false], boolean $nounknownparent  )

return formatted class tree for the Class Trees page

Parameters:
array   $tree:  output from getSortedClassTreeFromClass()
string   $package:  package
boolean   $nounknownparent:  if true, an object's parent will not be checked
   $noparent: 

API Tags:
See:  Classes::$definitechild, HTMLSmartyConverter::generateFormattedClassTrees()


[ Top ]
getSourceAnchor  [line 211]

  string getSourceAnchor( string $sourcefile, string $anchor, [string $text = ''], [boolean $link = false]  )

Retrieve a Converter-specific anchor to a segment of a source code file parsed via a @filesource tag.

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

API Tags:
Return:  link to an anchor, or the anchor


[ Top ]
getSourceLink  [line 195]

  void getSourceLink( $path  )

Parameters:
   $path: 


Redefinition of:
Converter::getSourceLink()

[ Top ]
getTutorialId  [line 995]

  void getTutorialId( $package, $subpackage, $tutorial, $id  )

Parameters:
   $package: 
   $subpackage: 
   $tutorial: 
   $id: 


Redefinition of:
Converter::getTutorialId()
Return a converter-specific id to distinguish tutorials and their sections

[ Top ]
getTutorialList  [line 369]

  void getTutorialList( )



[ Top ]
getTutorialTree  [line 396]

  void getTutorialTree( $tutorial, [ $k = false]  )

Parameters:
   $tutorial: 
   $k: 


Redefinition of:
Converter::getTutorialTree()
Get a tree structure representing the hierarchy of tutorials

[ Top ]
getVarLink  [line 1857]

  mixed getVarLink( string $expr, string $class, string $package, [string $file = false], [boolean $text = false], boolean 5  )

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

API Tags:
Return:  false if not found, or an html a link to the var's documentation
See:  Converter::getVarLink()


Redefinition of:
Converter::getVarLink()
return false or a varLink to $expr in $class

[ Top ]
makeLeft  [line 554]

  void makeLeft( )



[ Top ]
Output  [line 1931]

  void Output( )

This function is not used by HTMLdefaultConverter, but is required by Converter



Redefinition of:
Converter::Output()
do all necessary output

[ Top ]
postProcess  [line 307]

  void postProcess( $text  )

Uses htmlspecialchars() on the input

Parameters:
   $text: 


Redefinition of:
Converter::postProcess()
This version does nothing

[ Top ]
ProgramExample  [line 255]

  string ProgramExample( string $example, [boolean $tutorial = false], [ $inlinesourceparse = null], [ $class = null], [ $linenum = null], [ $filesourcepath = null]  )

Used to convert the <code> tag in a docblock

Parameters:
string   $example: 
boolean   $tutorial: 
   $inlinesourceparse: 
   $class: 
   $linenum: 
   $filesourcepath: 


Redefinition of:
Converter::ProgramExample()
Used to convert the <code> tag in a docblock

[ Top ]
rcNatCmp  [line 1888]

  int rcNatCmp( mixed $a, mixed $b  )

does a nat case sort on the specified second level value of the array

Parameters:
mixed   $a: 
mixed   $b: 


[ Top ]
rcNatCmp1  [line 1904]

  int rcNatCmp1( mixed $a, mixed $b  )

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  [line 549]

  string returnLink( string $link, string $text  )

Parameters:
string   $link: 
string   $text: 

API Tags:
Return:  &lt;a href="'.$link.'">'.$text.'</a&gt;


Redefinition of:
Converter::returnLink()
take URL $link and text $text and return a link in the format needed for the Converter

[ Top ]
returnSee  [line 784]

  void returnSee( abstractLink &$element, [string $eltext = false], [boolean $with_a = true], boolean 3  )

This function takes an abstractLink descendant and returns an html link

Parameters:
boolean   3:  determines whether the returned text is enclosed in an &lt;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


Redefinition of:
Converter::returnSee()
take abstractLink descendant and text $eltext and return a link

[ Top ]
setTargetDir  [line 1649]

  void setTargetDir( $dir  )

calls the converter setTargetDir, and then copies any template images and the stylesheet if they haven't been copied

Parameters:
   $dir: 

API Tags:
See:  Converter::setTargetDir()


Redefinition of:
Converter::setTargetDir()
Sets the output directory for generated documentation

[ Top ]
SmartyInit  [line 328]

  void &SmartyInit( &$templ  )

Parameters:
   &$templ: 


[ Top ]
sourceLine  [line 232]

  string sourceLine( integer $linenumber, string $line, [false|string $path = false]  )

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

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.

API Tags:
Return:  formatted source code line with line number


Redefinition of:
Converter::sourceLine()
Return a line of highlighted source code with formatted line number

[ Top ]
TutorialExample  [line 273]

  void TutorialExample( string $example  )

Parameters:
string   $example: 


Redefinition of:
Converter::TutorialExample()

[ Top ]
unmangle  [line 292]

  void unmangle( $sourcecode  )

Parameters:
   $sourcecode: 


Redefinition of:
Converter::unmangle()
Called by parserSourceInlineTag::stringConvert() to allow converters to format the source code the way they'd like.

[ Top ]
writeExample  [line 172]

  void writeExample( $title, $path, $source  )

Parameters:
   $title: 
   $path: 
   $source: 


Redefinition of:
Converter::writeExample()
Write out the formatted source code for an example php file

[ Top ]
writeNewPPage  [line 706]

  void writeNewPPage( $key  )

Parameters:
   $key: 


[ Top ]
writeRIC  [line 878]

  void writeRIC( )



[ Top ]
writeSource  [line 154]

  void writeSource( $path, $value  )

Parameters:
   $path: 
   $value: 


Redefinition of:
Converter::writeSource()
Write out the formatted source code for a php file

[ Top ]

Documentation generated on Tue, 06 Dec 2011 07:19:51 -0600 by phpDocumentor 1.4.4