@tylerbu/custom-api-documenter
TypeScript icon, indicating that this package has built-in type declarations

0.3.4-7 • Public • Published

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

Readme

Keywords

none

Package Sidebar

Install

npm i @tylerbu/custom-api-documenter

Weekly Downloads

1

Version

0.3.4-7

License

MIT

Unpacked Size

1.16 MB

Total Files

252

Last publish

Collaborators

  • tylerbutler