A Typescript handler for mkdocstrings.
Still in prototyping phase!
Feedback is welcome.
Installationยคpip install mkdocstrings-typescript
Usageยค
Add these TypeDoc configuration files to your repository:
๐ ./
โโโ ๐ src/
โ โโโ ๐ package1/
โโโ typedoc.base.json
โโโ typedoc.json
typedoc.base.json
{
"$schema": "https://typedoc.org/schema.json",
"includeVersion": true
}
typedoc.json
{
"extends": ["./typedoc.base.json"],
"entryPointStrategy": "packages",
"entryPoints": ["./src/*"]
}
Update the entrypoints to match your file layout so that TypeDoc can find your packages. See TypeDoc's configuration documentation.
Then in each of your package, add this TypeDoc configuration file:
๐ ./
โโโ ๐ src/
โ โโโ ๐ package1/
โ โโโ typedoc.json
โโโ typedoc.base.json
โโโ typedoc.json
typedoc.json
{
"extends": ["../../typedoc.base.json"],
"entryPointStrategy": "expand",
"entryPoints": ["src/index.d.ts"]
}
Again, update entrypoints to match your file and package layout. See TypeDoc's configuration documentation.
Your packages must be built for TypeDoc to work.
You are now able to use the TypeScript handler to inject API docs in your Markdown pages by referencing package names:
::: @owner/packageName
handler: typescript
You can set the Typescript handler as default handler:
plugins:
- mkdocstrings:
default_handler: typescript
By setting it as default handler you can omit it when injecting documentation:
2025-03-24 2023-11-17RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4