Getting Started
Writing content
API Documentation
Customization
Recipes
API References Develop
@ng-doc/builder / Interface

NgDocConfiguration

NgDoc configuration interface, that configure NgDoc library

Properties

NameTypeDescription
cache
boolean | undefined

Determines whether to use the cache or not. (enabled by default)

docsPath
string | undefined

Paths to your documentation location (e.g. "src/app")

guide
NgDocGuideConfiguration | undefined

The configuration for the guides

keywords
NgDocKeywordsConfiguration | undefined

The configuration for the global keywords.

outDir
string | undefined

The path to the output directory, where the documentation will be generated. (e.g. 'src')

Remember that if you change this path, you also need to change the following:

  • Change the path to the @ng-doc/generated directory in tsconfig.json
  • Change the path to the ng-doc/app-name/assets folder in angular.json
repoConfig
NgDocRepoConfig | undefined

The repository configuration. If it is defined, Ngoc will use it to display the "Suggest edits" button, and "View source" button, on each page.

routePrefix
string | undefined

Route prefix uses to add some additional route segment before documentation pages, you can use it e.g. to wrap documentation with additional route like "docs".

shiki
{ themes: { light: string; dark: string; }; } | undefined

Shiki configuration

tsConfig
string | undefined

The path to the tsconfig file (NgDoc uses tsconfig of your application by default, but you can override it)