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 TypeDoc plugin to add extras (favicon, generation date, Google Analytics...) to the output documentation

  • 2.3.3
  • Source
  • npm
  • Socket score

Version published
Maintainers
1
Created
Source

typedoc-plugin-extras

npm

This plugin only works for HTML documentation.

A TypeDoc plugin to add extras to the output 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).

All extras are disabled by default: they are opt-in.

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

Example

example

You also can view an example documentation using the 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 path or URL of the favicon file.
    Example: public/favicon.ico
    Note: If given a path, the favicon file is copied into the documentation's output directory (--out).

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

  • --footerLastModified
    Appends a "Last Modified" text in the footer (e.g. "Last modified 6 min. ago").
    Default: false
    Note: If specified, the --footerDate and --footerTime options are ignored.

  • --footerDate (deprecated)
    Appends the date of generation in the footer (e.g. "Jul 29, 2022").
    Default: false
    Note: If combined with --footerTime, it will append "Jul 29, 2022, 3:44:42 PM GMT+2".

  • --footerTime (deprecated)
    Appends the time of generation in the footer (e.g. "3:44:42 PM GMT+2").
    Default: false
    Note: If combined with --footerDate, it will append "Jul 29, 2022, 3:44:42 PM GMT+2".

  • --gaMeasurementId
    Specify a Google Analytics measurement ID to insert in a gtag.js snippet.
    Example: abc123

Testing

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

To do so, you'll first need to build it:

npm run build

Then, you can generate the documentation with the plugin (from source):

npm test

License

MIT

Keywords

FAQs

Package last updated on 12 Apr 2023

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