jsdocp

jsdocp

The namespace used by publicize for the Conf

Source:

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 title of the generated HTML 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)

Source:
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 grep options for breaking changes

Source:
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 grep options for features

Source:
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 grep options for fixes

Source:
Type:
  • Object

ChangeLogSectionGrep

Section grep options

Properties:
Name Type Attributes Description
regexp String <optional>

The regular expression used as filter in the git log -grep=

ignoreCase String <optional>

true for case-insensitive git log -i

extendedRegexp String <optional>

true for extended regular expressions git log -E

allMatch String <optional>

true to limit all regular expressions in the grep

Source:
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 grep options for merges

Source:
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

Source:
Type:
  • Object

Conf

The configuration used by jsdocp

Source:
Type:
  • JSDocConf | JSDocpConf

Deploy

The documentation deployment options

Properties:
Name Type Attributes Description
message Object <optional>

The commit message used when deploying the documentation

branch Object <optional>

The branch that where documentation will be pushed during deployment

path Object <optional>

The path where the branch will be cloned to and pushed from during deployment

host String <optional>

The host name that will be used when cloning/pushing during deployment (e.g. github.com)

user User <optional>

The user options that will be used when deploying the documentation pages

Source:
Type:
  • Object

JSDocConf

Placeholder for JSDoc Configuration Options

Source:
Type:
  • Object

JSDocpConf

The configuration used by jsdocp

Properties:
Name Type Attributes Description
opts Options <optional>

The configuration options

Source:
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>

true to remove the jsdoc assigned Options destination prior to publishing

links Array.<Object> <optional>

The definitions used to generate link tags in the head element. Each object can have any number of properties/values that will get translated to an attribute on the link tag matching the property name and an attribute value for the value.

metas Array.<Object> <optional>

The definitions used to generate meta tags in the head element. Each object can have any number of properties/values that will get translated to an attribute on the meta tag matching the property name and an attribute value for the value.

scripts Array.<Object> <optional>

The definitions used to generate script tags in the head element. Each object can have any number of properties/values that will get translated to an attribute on the script tag matching the property name and an attribute value for the value.

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

Source:
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 head section

nav String <optional>

The path to the template fragment that will be inserted at the beginning of the body section

foot String <optional>

The path to the template fragment that will be inserted at the end of the body section

layoutCheckTemplateDirs Array.<String> <optional>

The directories that the required conf.templates.default.layoutFile will be searched for in the order they are defined. Unfortunately, template implementations may store the conf.templates.default.layoutFile in different locations. By default, the most likley/typlical directories will be checked.

head String <optional>

The path to the template/*.tmpl file used for the header at the top of the documentation page

nav String <optional>

The path to the template/*.tmpl file used for the navigation bar

footer String <optional>

The path to the template/*.tmpl file used for the footer at the bottom of the documenation page

Source:
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 logo)

package MenuPackage <optional>

The options for the npm package icon that will appear in the navigation menu

changelog MenuIcon <optional>

The options for the CHANGELOG icon that will appear in the navigation menu

sourceCode MenuIcon <optional>

The options for the source code icon that will appear in the navigation menu

versions MenuIcon <optional>

The options for the documentation version selection icon that will appear in the navigation menu

Source:
Type:
  • Object

MenuIcon

The options for an icon that will appear in the navigation menu

Properties:
Name Type Attributes Description
title String <optional>

The title set on the icon

src String <optional>

The src used on the img in the navigation menu that links to the icon (omit to use the default icon)

className String <optional>

The CSS class name assigned to the icon

Source:
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 logo)

Source:
Type:
  • Object

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)

inlineSvgPath String <optional>

A path to an svg logo that will be inserted inline within the navigation menu display. Will override the logo src, but if present will fall back on the src when the svg content cannot be extracted.

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 src

Source:
Type:
  • Object

MenuOptions

The navigation menu options

Properties:
Name Type Attributes Description
position String <optional>

The navigation menu position (top, left, bottom, right)

matchMedia String <optional>

The CSS segment that will be passed into window.matchMedia in the client's browser

autoHide String <optional>

true to auto hide while vertically scrolling down, show when scrolling up

Source:
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 title set on the npm package icon

src String <optional>

The src used on the img in the navigation menu that links to the npm package (omit to use the default icon)

className String <optional>

The CSS class name assigned to the npm package icon

Source:
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 jsdocp options

Source:
Type:
  • Object

User

The user options

Properties:
Name Type Attributes Description
name String <optional>

The git user name

email String <optional>

The git email

Source:
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 major will only show versions that have been released for major_ version tags (i.e. the first number in the version). A designation of minor will only show versions that have been released for minor version tags (i.e. the second number in the version). undefined will cause the default value to be used. Any other value, or blank value will cause all versions to be included.

Source:
Type:
  • Object

1.3.0 (2021-08-20)

Full Changelog

Features: