Skip to content

mattetti/custom-api-documenter

Repository files navigation

@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"
}

About

Customized version of https://api-extractor.com/pages/setup/generating_docs/ allowing for more custom HTML/markdown API generation

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 3

  •  
  •  
  •