New Case Study:See how Anthropic automated 95% of dependency reviews with Socket.Learn More
Socket
Sign inDemoInstall
Socket

typedoc-plugin-extras

Package Overview
Dependencies
Maintainers
1
Versions
27
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

typedoc-plugin-extras

A plugin for TypeDoc which adds extras to the generated documentation

  • 2.3.0
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
4.5K
decreased by-23.73%
Maintainers
1
Weekly downloads
 
Created
Source

typedoc-plugin-extras

This plugin only works for HTML documentation.

A plugin for TypeDoc which adds extras to the generated documentation.

  • It can set a custom top-most title name and/or link.
  • It can find the <head> of the documents and append a favicon to it.
  • It can also add date/time of generation after "Generated using TypeDoc" in the footer. (cf. the example below)
  • And more... (cf. the list of arguments below)

No date/time will be added if --hideGenerator is set (because the footer wouldn't exist).

Feel free to ask for another extra or to make a PR 😉

npm

Example

You can view an example documentation using this plugin here: https://drarig29.github.io/typedoc-plugin-extras/

Installation

npm install --save-dev typedoc-plugin-extras

Usage

$ npx typedoc --plugin typedoc-plugin-extras [args]

Arguments

The following arguments can be used in addition to the default TypeDoc arguments.

  • --customTitle
    Specify a custom title, for the top-most title only.
    Example: foo

  • --customTitleLink
    Specify a custom link for the top-most title.
    Example: https://parent-docs-site.com

  • --customDescription
    Specify a custom meta description.
    Example: A test description

  • --favicon
    Specify the name or URL of the favicon file.
    Example: public/favicon.ico

  • --footerTypedocVersion
    Appends the TypeDoc version in the footer.
    Default: false

  • --footerDate
    Appends the date of generation in the footer.
    Default: false

  • --footerTime
    Appends the time of generation in the footer.
    Default: false

Note:

  • All extras are disabled by default, they are now opt-in.
  • When favicon is enabled, its file is copied into the documentation's output directory (--out).

Testing

To test this plugin, you can generate TypeDoc documentation for this plugin.

To do this, you'll first need to build the plugin:

npm run build

You can now generate the documentation with the plugin (from the source):

npm test

License

MIT

Keywords

FAQs

Package last updated on 29 Jul 2022

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc