DocumentationSetDescriptor
in package
implements
Descriptor, CompilableSubject
uses
HasName, HasDescription
Table of Contents
Interfaces
- Descriptor
- Base class for descriptors containing the most used options.
- CompilableSubject
Properties
- $description : DescriptionDescriptor|null
- $name : string
- $outputLocation : string
- $source : Source
- $files : Collection<string|int, FileInterface>
- $indexes : Collection<string|int, Collection<string|int, ElementInterface>>
- $tocs : Collection<string|int, TocDescriptor>
Methods
- __construct() : mixed
- addTableOfContents() : void
- getDescription() : DescriptionDescriptor
- Returns the description for this element.
- getFiles() : Collection<string|int, FileInterface>
- Returns the list of files that is in this documentation set.
- getIndex() : Collection<string|int, ElementInterface>
- Returns an index with the given name.
- getIndexes() : Collection<string|int, Collection<string|int, ElementInterface>>
- Returns all indexes in this documentation set.
- getName() : string
- Returns the name for this element.
- getOutputLocation() : string
- getSource() : Source
- Returns the source location for this set of documentation.
- getTableOfContents() : Collection<string|int, TocDescriptor>
- setDescription() : void
- Sets a description or none to inherit from a parent.
- setFiles() : void
- Sets the list of files that is in this documentation set.
- setIndexes() : void
- Sets all indexes for this documentation set.
Properties
$description
protected
DescriptionDescriptor|null
$description
= null
$name
protected
string
$name
= ''
$outputLocation
protected
string
$outputLocation
= '.'
$source
protected
Source
$source
$files
private
Collection<string|int, FileInterface>
$files
$indexes
private
Collection<string|int, Collection<string|int, ElementInterface>>
$indexes
$tocs read-only
private
Collection<string|int, TocDescriptor>
$tocs
Methods
__construct()
public
__construct() : mixed
addTableOfContents()
public
addTableOfContents(TocDescriptor $descriptor) : void
Parameters
- $descriptor : TocDescriptor
getDescription()
Returns the description for this element.
public
getDescription() : DescriptionDescriptor
This method will automatically attempt to inherit the parent's description if this one has none.
Return values
DescriptionDescriptorgetFiles()
Returns the list of files that is in this documentation set.
public
getFiles() : Collection<string|int, FileInterface>
Return values
Collection<string|int, FileInterface>getIndex()
Returns an index with the given name.
public
getIndex(string $name) : Collection<string|int, ElementInterface>
If the index does not exist yet, it will dynamically be added to the list of indexes.
Parameters
- $name : string
Return values
Collection<string|int, ElementInterface>getIndexes()
Returns all indexes in this documentation set.
public
getIndexes() : Collection<string|int, Collection<string|int, ElementInterface>>
Tags
Return values
Collection<string|int, Collection<string|int, ElementInterface>>getName()
Returns the name for this element.
public
getName() : string
Return values
stringgetOutputLocation()
public
getOutputLocation() : string
Return values
stringgetSource()
Returns the source location for this set of documentation.
public
getSource() : Source
Tags
Return values
SourcegetTableOfContents()
public
getTableOfContents() : Collection<string|int, TocDescriptor>
Return values
Collection<string|int, TocDescriptor>setDescription()
Sets a description or none to inherit from a parent.
public
setDescription(DescriptionDescriptor|null $description) : void
Parameters
- $description : DescriptionDescriptor|null
setFiles()
Sets the list of files that is in this documentation set.
public
setFiles(Collection<string|int, FileInterface> $files) : void
Parameters
- $files : Collection<string|int, FileInterface>
setIndexes()
Sets all indexes for this documentation set.
public
setIndexes(Collection<string|int, Collection<string|int, ElementInterface>> $indexes) : void
An index is a compilation of references to elements, usually constructed in a compiler step, that aids template generation by providing a conveniently assembled list. An example of such an index is the 'marker' index where a list of TODOs and FIXMEs are located in a central location for reporting.
Parameters
- $indexes : Collection<string|int, Collection<string|int, ElementInterface>>