59022c5eea
* docs: add advanced guides * complete * fix link * Create architecture * use png * explanations * more text * process.env.NODE_ENV * typo * Add image zoom * nit * nit * reorganize * fix links * fix links * reorganize * elaborate on presets * fix * routing docs * ssr section * more content * complete SSR guide * pathname:// * improvements * document executionenvironment * reformat * final tweaks! * avoid slug * oops
2.7 KiB
| sidebar_position | id | title | slug |
|---|---|---|---|
| 5 | plugin-debug | 📦 plugin-debug | /api/plugins/@docusaurus/plugin-debug |
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
The debug plugin will display useful debug information at http://localhost:3000/__docusaurus/debug.
It is mostly useful for plugin authors, that will be able to inspect more easily the content of the .docusaurus folder (like the creates routes), but also be able to inspect data structures that are never written to disk, like the plugin data loaded through the contentLoaded lifecycle.
:::info
If you use the plugin via the classic preset, the preset will enable the plugin in development and disable it in production by default (debug: undefined) to avoid exposing potentially sensitive information. You can use debug: true to always enable it or debug: false to always disable it.
If you use a standalone plugin, you may need to achieve the same effect by checking the environment:
module.exports = {
plugins: [
// highlight-next-line
process.env.NODE_ENV === 'production' && '@docusaurus/plugin-debug',
].filter(Boolean),
};
:::
:::note
If you report a bug, we will probably ask you to have this plugin turned on in the production, so that we can inspect your deployment config more easily.
If you don't have any sensitive information, you can keep it on in production like we do.
:::
Installation
npm install --save @docusaurus/plugin-debug
:::tip
If you use the preset @docusaurus/preset-classic, you don't need to install this plugin as a dependency.
You can configure this plugin through the preset options.
:::
Configuration
This plugin currently has no options.
Example configuration
You can configure this plugin through preset options or plugin options.
:::tip
Most Docusaurus users configure this plugin through the preset options.
:::
If you use a preset, configure this plugin through the preset options:
module.exports = {
presets: [
[
'@docusaurus/preset-classic',
{
// highlight-next-line
debug: true, // This will enable the plugin in production
},
],
],
};
If you are using a standalone plugin, provide options directly to the plugin:
module.exports = {
// highlight-next-line
plugins: ['@docusaurus/plugin-debug'],
};