Typedoc-plugin-extras NPM

typedoc-plugin-extras

This plugin only works for HTML documentation.

A TypeDoc plugin to add extras to the output documentation.

It allows you to:

Set a custom favicon.
Add the date/time of generation after "Generated using TypeDoc" in the footer. (cf. the example below)
Set a custom top-most title name (without changing the package name, like --name would do).
- For example, you could have --customTitle "Go back" --titleLink <url-of-your-parent-documentation>
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

You also can view an example documentation using the plugin here:

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

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

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
--customDescription Specify a custom <meta name="description" property. Example: An example 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".