@mattetti/custom-api-documenter
v0.3.3
Published
Read JSON files from api-extractor, generate documentation pages
Downloads
8
Readme
@mattetti/custom-api-documenter a fork of @microsoft/api-documenter
This tool can be used to generate an online API reference manual for your TypeScript library. It reads the *.api.json data files produced by API Extractor, and then generates files in Markdown format with some HTML.
For usage information, see the Generating Docs article from the API Extractor documentation.
Customization
The markdown renderer was customized to better render API docs using hugo and to allow for a different file structure.
Custom json options not available in the original api-documenter markdown:
- uriRoot: so the doc can generate links for api docs not hosted at the root of the domain.
- onlyPackagesStartingWith: a string used to filter packages to document, useful when you want to publish only document some packages.
{
"outputTarget": "markdown",
"newlineKind": "lf",
"uriRoot": "/apis",
"onlyPackagesStartingWith": "@mything"
}