typedoc-plugin-sphinx
v0.1.0
Published
A plugin for TypeDoc that enables TypeScript API documentation to be generated in Sphinx's reStructuredText.
Downloads
3
Maintainers
Readme
typedoc-plugin-markdown
A plugin for TypeDoc that renders TypeScript API documentation as Sphinx.
What it does?
The plugin replaces the default HTML theme with a built-in Sphinx theme and exposes some additional options.
Useful if documentation is required to be included in project README files, Wikis and static site generators.
Installation
npm install --save-dev typedoc typedoc-plugin-markdown
Usage
Usage is the same as documented at TypeDoc.
typedoc --plugin typedoc-plugin-markdown --out docs src/index.ts
The plugin switches the default html theme to the in-built markdown theme as default. If using with the default html theme, use
--plugin none
to switch the plugin off.
Options
The following options can be used in addition to relevant TypeDoc options (please note that TypeDoc options specific to the html theme will be ignored).
--entryDocument<string>
The file name of the entry document. Defaults toREADME.md
.--hideBreadcrumbs<boolean>
Do not render breadcrumbs in template header. Defaults tofalse
.--hideInPageTOC<boolean>
Do not render in-page table of contents items. Defaults tofalse
.--hideMembersSymbol<boolean>
Do not add special symbols for class members. Defaults tofalse
.--publicPath<string>
Specify the base path for all urls. If undefined urls will be relative. Defaults to.
.--namedAnchors<boolean>
Use HTML named anchors tags for implementations that do not assign header ids. Defaults tofalse
.--preserveAnchorCasing<boolean>
Preserve anchor id casing for implementations where original case is desirable. Defaults tofalse
.