Type Definitions
ChangeLog
The change log options used to generate the change log file and link
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
title |
Object
|
<optional> |
The change log page |
line |
String
|
<optional> |
The format for individual commit lines produced in the change log markdown. |
header |
String
|
<optional> |
The markdown that will be pre-pended to the change log. |
sections |
ChangeLogSections
|
<optional> |
The sections within the change log which organize changes (omit output a list without sections) |
Type:
-
Object
ChangeLogSectionBreak
Section options for breaking changes
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
header |
String
|
<optional> |
Markdown used as a header when there are change log entries for breaking changes |
grep |
ChangeLogSectionGrep
|
<optional> |
Section |
Type:
-
Object
ChangeLogSectionFeatures
Section options for features
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
header |
String
|
<optional> |
Markdown used as a header when there are change log entries for features |
grep |
ChangeLogSectionGrep
|
<optional> |
Section |
Type:
-
Object
ChangeLogSectionFixes
Section options for fixes
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
header |
String
|
<optional> |
Markdown used as a header when there are change log entries for fixes |
grep |
ChangeLogSectionGrep
|
<optional> |
Section |
Type:
-
Object
ChangeLogSectionGrep
Section grep
options
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
regexp |
String
|
<optional> |
The regular expression used as filter in the |
ignoreCase |
String
|
<optional> |
|
extendedRegexp |
String
|
<optional> |
|
allMatch |
String
|
<optional> |
|
Type:
-
Object
ChangeLogSectionMerges
Section options for merged/pull requests
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
header |
String
|
<optional> |
Markdown used as a header when there are change log entries for merges |
grep |
ChangeLogSectionGrep
|
<optional> |
Section |
Type:
-
Object
ChangeLogSections
The sections within the change log which organize changes (omit output a list without sections)
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
breaks |
ChangeLogSectionBreak
|
<optional> |
Section options for breaking changes |
features |
ChangeLogSectionFeatures
|
<optional> |
Section options for features |
fixes |
ChangeLogSectionFixes
|
<optional> |
Section options for fixes |
merges |
ChangeLogSectionMerges
|
<optional> |
Section options for merged/pull requests |
Type:
-
Object
Deploy
The documentation deployment options
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
message |
Object
|
<optional> |
The |
branch |
Object
|
<optional> |
The branch that where documentation will be pushed during deployment |
path |
Object
|
<optional> |
The path where the |
host |
String
|
<optional> |
The host name that will be used when cloning/pushing during deployment (e.g. |
user |
User
|
<optional> |
The user options that will be used when deploying the documentation pages |
Type:
-
Object
JSDocpConf
The configuration used by jsdocp
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
opts |
Options
|
<optional> |
The configuration options |
Type:
-
Object
JSDocpOptions
The jsdocp
options
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
changelog |
ChangeLog
|
<optional> |
The change log options used to generate the change log file and link |
menu |
Menu
|
<optional> |
The options for the generated pages naviagation menu |
versions |
Versions
|
<optional> |
The versions options used to generate links to previously published version docs |
cleanDestination |
Boolean
|
<optional> |
|
links |
Array.<Object>
|
<optional> |
The definitions used to generate |
metas |
Array.<Object>
|
<optional> |
The definitions used to generate |
scripts |
Array.<Object>
|
<optional> |
The definitions used to generate |
layoutFrags |
LayoutFrags
|
<optional> |
The layout fragments used. Typically, none of the fragment values will be overridden since they are handled internally |
deploy |
Deploy
|
<optional> |
The documentation deployment options |
Type:
-
Object
LayoutFrags
The layout fragments used. Typically, none of the fragment values will be overridden since they are handled internally
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
head |
String
|
<optional> |
The path to the template fragment that will be inserted at the end of the |
nav |
String
|
<optional> |
The path to the template fragment that will be inserted at the beginning of the |
foot |
String
|
<optional> |
The path to the template fragment that will be inserted at the end of the |
layoutCheckTemplateDirs |
Array.<String>
|
<optional> |
The directories that the required |
head |
String
|
<optional> |
The path to the |
nav |
String
|
<optional> |
The path to the |
footer |
String
|
<optional> |
The path to the |
Type:
-
Object
Menu
The options for the generated pages naviagation menu
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
SM |
MenuOptions
|
<optional> |
The navigation menu options for small displays |
MD |
MenuOptions
|
<optional> |
The navigation menu options for medium displays |
LG |
MenuOptions
|
<optional> |
The navigation menu options for large displays |
className |
String
|
<optional> |
The CSS class applied to the main menu |
logo |
MenuLogo
|
<optional> |
The options for the logo displayed in the navigation menu |
icons |
MenuIcons
|
<optional> |
The options that apply to all of the navigation menu icons (excluding the |
package |
MenuPackage
|
<optional> |
The options for the |
changelog |
MenuIcon
|
<optional> |
The options for the |
sourceCode |
MenuIcon
|
<optional> |
The options for the source |
versions |
MenuIcon
|
<optional> |
The options for the documentation version selection icon that will appear in the navigation menu |
Type:
-
Object
MenuIcon
The options for an icon that will appear in the navigation menu
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
title |
String
|
<optional> |
The |
src |
String
|
<optional> |
The |
className |
String
|
<optional> |
The CSS class name assigned to the icon |
Type:
-
Object
MenuIcons
The options that apply to all of the navigation menu icons (excluding the logo
)
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
className |
String
|
<optional> |
The CSS class name applied to all of the icons in the navigation menu (excluding the |
Type:
-
Object
MenuLogo
The options for the logo displayed in the navigation menu
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
src |
String
|
<optional> |
The source URL for the logo icon dsiplayed in the navigation menu (if not overridden by |
inlineSvgPath |
String
|
<optional> |
A path to an |
anchorclassName |
String
|
<optional> |
The CSS class name assigned to the logo icon's anchor tag |
className |
String
|
<optional> |
The CSS class name assigned to the logo icon loaded from the |
Type:
-
Object
MenuOptions
The navigation menu options
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
position |
String
|
<optional> |
The navigation menu position ( |
matchMedia |
String
|
<optional> |
The CSS segment that will be passed into |
autoHide |
String
|
<optional> |
|
Type:
-
Object
MenuPackage
The options for the npm
package icon that will appear in the navigation menu
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
title |
String
|
<optional> |
The |
src |
String
|
<optional> |
The |
className |
String
|
<optional> |
The CSS class name assigned to the |
Type:
-
Object
Options
The configuration options
Properties:
Name | Type | Attributes | Default | Description |
---|---|---|---|---|
destination |
String
|
<optional> |
./docs | The destination directory where the documentation will be generated in |
jsdocp |
JSDocpOptions
|
<optional> |
The |
Type:
-
Object
User
The user options
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
name |
String
|
<optional> |
The |
email |
String
|
<optional> |
The |
Type:
-
Object
Versions
The versions options used to generate links to previously published version docs
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
from |
String
|
<optional> |
A Semantic Versioning compliant version that designates the first version to show in the version drop-down selection for different docs (omit to list all of them) |
type |
String
|
<optional> |
A designation that inidcates what doc versions to show in the drop-down selection.
A designation of |
Type:
-
Object