Skip to main content

MkDocs plugin to generate documentation from TypeScript source code using TypeDoc.

Project description

Mkdocs-Typedoc Plugin

PyPI

The Mkdocs-Typedoc Plugin is designed to integrate TypeDoc documentation with your MkDocs project.

Installation

Install the plugin using pip from PyPI:

pip install mkdocs-typedoc

Ensure that you have Node.js installed in your system. If not, you can download it from the official website.

Also, install TypeDoc using NPM:

npm install typedoc typescript --save-dev

Usage

Add the following lines to your mkdocs.yml:

plugins:
  - typedoc:
      source: './ts-examples/@types/*.d.ts'
      output_dir: 'typedocApi'
      tsconfig: './ts-examples/tsconfig.json'
      options: 'typedoc.json'
      name: 'API Doc'
      disable_system_check: False
  • source (required): The path to your TypeScript source code.
  • output_dir (optional): The directory where you want to output your docs. Default is "typedoc".
  • tsconfig (required): The path to the tsconfig file for your project.
  • options (optional): The path to the typedoc.json options file with more options.
  • name (optional): The name for the generated documentation. Default is "TypeDoc API".
  • disable_system_check (optional): Disable the TypeScript system check. Default is False.

The plugin will generate TypeDoc documentation into the output directory specified.

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Do You Enjoy My Work?

Then definitely consider:

  • supporting me on GitHub Sponsors:

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mkdocs-typedoc-1.0.2.tar.gz (4.9 kB view details)

Uploaded Source

Built Distribution

mkdocs_typedoc-1.0.2-py3-none-any.whl (5.4 kB view details)

Uploaded Python 3

File details

Details for the file mkdocs-typedoc-1.0.2.tar.gz.

File metadata

  • Download URL: mkdocs-typedoc-1.0.2.tar.gz
  • Upload date:
  • Size: 4.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.9.18

File hashes

Hashes for mkdocs-typedoc-1.0.2.tar.gz
Algorithm Hash digest
SHA256 a9be303375f403158a881d969e89e0aed6c0ccdd491de797021ae11e58b5f63f
MD5 e0bf89aa4e90ef984ea5bbead97a7eef
BLAKE2b-256 585280618904e3764ca7e285fd8b86ef3e5612c6a456854315dcbe6f50e86159

See more details on using hashes here.

File details

Details for the file mkdocs_typedoc-1.0.2-py3-none-any.whl.

File metadata

File hashes

Hashes for mkdocs_typedoc-1.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 346014673f23493979fa3a2f8113a8a299f472e274a2ea7d0188148422e1d718
MD5 1fc9cbda537df37a1fb533ceb7833dde
BLAKE2b-256 9dc7607a684cff0c57992317ccd69d58bba028450c7399c258e96c2979cf7cf5

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page