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 --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'
  • 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".

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.0.tar.gz (4.7 kB view details)

Uploaded Source

Built Distribution

mkdocs_typedoc-1.0.0-py3-none-any.whl (5.2 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for mkdocs-typedoc-1.0.0.tar.gz
Algorithm Hash digest
SHA256 4c5516ea391ad4ef24e77f8bfed35d0271e5941da6979a9827dae331713bf4e4
MD5 bce35838233f89aa8a3afdb090982307
BLAKE2b-256 c95b97f448029e98ea33e755328a382251150f01261e994341c6308f8c4c69dd

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for mkdocs_typedoc-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 7d4c09b6c2ac07f345fee674c91c650e65069d0000b2eb9993bea5f1d138c19c
MD5 3fe590522d8d58126c40092444d622cd
BLAKE2b-256 beaeb01fd62c41bfe9061cf23918008341f466a81282bbf9dc6f2e916d183fa5

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