Custom theme which extends the typedoc-plugin-markdown to format the output to be compatible with the Polymesh SDK documentation used in a Docusaurus site.
Generates static TypeDoc pages in Markdown with frontmatter suitable for a Docusaurus documentation site. Output documentation is in a hierarchial folder structure and makes use of the docusausaurus autogenerated sidebar.
yarn add --dev typedoc typedoc-plugin-markdown @polymeshassociation/typedoc-theme
or
npm install --save-dev typedoc typedoc-plugin-markdown @polymeshassociation/typedoc-theme
Usage is the same as documented at TypeDoc and typedoc-plugin-markdown.
Typedoc configuration should via a typedoc.json should include "theme": "polymesh-docs"
.
This plugin provides additional options beyond the normal options that are provided by typedoc-plugin-markdown, which are listed below. Note that any vanilla TypeDoc options that customize the HTML theme will be ignored.
--readmeTitle<string>
Frontmatter title for Readme file--readmeLabel<string>
Sidebar label for the readme file--indexLabel<string>
Sidebar label for the index file
--indexTitle<string>
Frontmatter title for the index file--hideBreadcrumbs<boolean>
Do not render breadcrumbs in template header. Modified to default totrue
.--hideInPageTOC<boolean>
Do not render in-page table of contents items. Modified to default totrue
.--hidePageTitle<boolean>
Do not render title in-page contents. Modified to default totrue
. Page titles are always included in the page frontmatter.