This plugin only works for HTML documentation.
A plugin for TypeDoc that adds extras to the generated documentation (favicon and date/time of generation).
- It can find the
<head>
of the document and append a favicon to it. - It can also add date/time of generation after "Generated using TypeDoc" in the footer (see Example).
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 😉
Example
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.
-
--favicon
Specify the name 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
Then, link the package to have it in the local node_modules
:
npm link
You can now generate the documentation with the plugin (from the source):
npm run test
License
MIT