Giter Club home page Giter Club logo

mkdocs-typedoc's Introduction

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
      title_link: "/" # optional, default: '/'
  • 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.
  • title_link (optional): The link from TypeDoc back to the main page. Default is "/".

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 you can consider:

  • supporting me on GitHub Sponsors:

License

MIT

mkdocs-typedoc's People

Contributors

jakubandrysek avatar justalemon avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar

Forkers

justalemon

mkdocs-typedoc's Issues

`titleLink` provided by `typedoc.json` is always override by `mkdocs-typedoc`

Due to the use of the explicit --titleLink "/" argument being passed to the CLI in the plugin, any value for titleLink provided by the typedoc.json file is ignored

As a user of this plugin, I would like my typedoc.json values to be used when provided instead of overridden by a magic value from the plugin, so that the output from MkDocs is consistent with the output from TypeDoc

Windows uses npx.cmd

Hi! I was taking a look at mkdocs-typedoc and found the Windows problem. I checked my local node executables and found that npx is called npx.cmd on Windows:

image

Looks like the solution is to just call npx.cmd on Windows and npx on all other platforms:

Python 3.11.5 (tags/v3.11.5:cce6ba9, Aug 24 2023, 14:38:34) [MSC v.1936 64 bit (AMD64)] on win32
Type "help", "copyright", "credits" or "license" for more information.
>>> import subprocess
>>> result = subprocess.run(["npx.cmd", "typedoc", "--version"], check=True, capture_output=True, text=True)
>>> result.returncode
0

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.