0.2.0 • Published 6 years ago

ts-docs-gen v0.2.0

Weekly downloads
87
License
-
Repository
github
Last release
6 years ago

ts-docs-gen

Readme is WIP.

Generates documentation from TypeScript files.

Get started

npm install ts-docs-gen -g

CLI usage

ts-docs-gen -h

Examples

Without config

If you want to use ts-docs-gen without config file, entryFile flag is required.

ts-docs-gen --entryFile ./src/index.ts

Multiple entry files:

ts-docs-gen --entryFile ./src/index.ts --entryFile ./src/internal.ts
# Or
ts-docs-gen --entryFile ./src/index.ts ./src/internal.ts

With config

ts-docs-gen --config ./docs-gen.json

Configuration

JSON config properties and CLI flags.

PropertyCLI FlagRequiredTypeDefaultDescription
--configoptionalstringRelative path to config json file.
entryFile--entryFilerequiredstring[]TypeScript project entry files.
project--project, -poptionalstringcwdFull path to TypeScript project directory.
output--output, -ooptionalstring./docs/api/Documentation output directory.
plugin--pluginoptionalstring[]Package name or path to plugin.
exclude--excludeoptionalstring[]File locations that should not be included generated documentation.
externalPackage--externalPackageoptionalstring[]External package names to include in extracted data.
excludePrivateApi--excludePrivateApioptionalbooleantrueExcludes api items that has access modifier set to "private" or JSDoc tag "@private".
verbosity--verbosityoptional"None", "Critical", "Error", "Warning", "Information", "Debug", "Trace""Information"Verbosity of output.
dryRun--dryRunoptionalbooleanGenerates markdown files but not writes them. Outputs generated data in Debug log level.