$definition
$definition : \phpDocumentor\Plugin\Scrybe\Converter\Definition\Definition
Class used to convert one or more RestructuredText documents to their HTML representation.
This class uses a two-phase process to interpret and parse the RestructuredText documents, namely Discovery and Creation.
$definition : \phpDocumentor\Plugin\Scrybe\Converter\Definition\Definition
$assets : \phpDocumentor\Plugin\Scrybe\Converter\Metadata\Assets
$toc : \phpDocumentor\Plugin\Scrybe\Converter\Metadata\TableOfContents
$glossary : \phpDocumentor\Plugin\Scrybe\Converter\Metadata\Glossary
__construct(\phpDocumentor\Plugin\Scrybe\Converter\Definition\Definition $definition, \phpDocumentor\Plugin\Scrybe\Converter\Metadata\Assets $assets, \phpDocumentor\Plugin\Scrybe\Converter\Metadata\TableOfContents $tableOfContents, \phpDocumentor\Plugin\Scrybe\Converter\Metadata\Glossary $glossary)
Initializes this converter and sets the definition.
getAssets() : \phpDocumentor\Plugin\Scrybe\Converter\Metadata\Assets
Returns the AssetManager that keep track of which assets are used.
getTableOfContents() : \phpDocumentor\Plugin\Scrybe\Converter\Metadata\TableOfContents
Returns the table of contents object that keeps track of all headings and their titles.
getGlossary() : \phpDocumentor\Plugin\Scrybe\Converter\Metadata\Glossary
Returns the glossary object that keeps track of all the glossary terms that have been provided.
getDefinition() : \phpDocumentor\Plugin\Scrybe\Converter\Definition\Definition
Returns the definition for this Converter.
convert(\phpDocumentor\Fileset\Collection $source, \phpDocumentor\Plugin\Scrybe\Template\TemplateInterface $template) : array<mixed,string>|null
Converts the given $source using the formats that belong to this converter.
This method will return null unless the 'scrybe://result' is used.
\phpDocumentor\Fileset\Collection | $source | Collection of input files. |
\phpDocumentor\Plugin\Scrybe\Template\TemplateInterface | $template | Template used to decorate the output with. |
discover() : void
Discovers the data that is spanning all files.
This method tries to find any data that needs to be collected before the actual creation and substitution phase begins.
Examples of data that needs to be collected during an initial phase is a table of contents, list of document titles for references, assets and more.
create(\phpDocumentor\Plugin\Scrybe\Template\TemplateInterface $template) : array<mixed,string>|null
Converts the input files into one or more output files in the intended format.
This method reads the files, converts them into the correct format and returns the contents of the conversion.
The template is provided using the $template parameter and is used to decorate the individual files. It can be
obtained using the \phpDocumentor\Plugin\Scrybe\Template\Factory
class.
\phpDocumentor\Plugin\Scrybe\Template\TemplateInterface | $template |
The contents of the resulting file(s) or null if the files are written directly to file.
addTemplateAssets(\phpDocumentor\Plugin\Scrybe\Template\TemplateInterface $template) : void
Adds the assets of the template to the Assets manager.
\phpDocumentor\Plugin\Scrybe\Template\TemplateInterface | $template |
setDestinationRoot(string $destination) : void
Sets the relative path to the root of the generated contents.
Basically this method takes the depth of the given destination and replaces it with ..
unless the destination
directory name is .
.
string | $destination | The destination path relative to the target folder. |