Hook useDoc is called outside the <DocProvider>.

[kenrobbins]

Hi, I need some help.

I keep getting Hook useDoc is called outside the <DocProvider>. and I don't know why. I built the mdx files, but when I try to go to one of the pages, I get this error. I don't even know where to begin.

Any help would be appreciated. Thanks.

  presets: [
    [
      'classic',
      /** @type {import('@docusaurus/preset-classic').Options} */
      ({
        docs: {
          sidebarPath: require.resolve('./sidebars.js'),
          docLayoutComponent: "@theme/DocPage",
        },
        theme: {
          customCss: require.resolve('./src/css/custom.css'),
        },
      }),
    ]
  ],
  plugins: [
    [
      '@docusaurus/plugin-content-docs',
      {
        id: "pan",
        docLayoutComponent: "@theme/DocPage",
        docItemComponent: "@theme/ApiItem", // Derived from docusaurus-theme-openapi-docs
        path: "pan",
        routeBasePath: "pan",
      },
    ],
    [
      'docusaurus-plugin-openapi-docs',
      {
        id: "pan",
        docsPluginId: "pan",
        config: {
          api: {
            specPath: 'openapi.yaml',
            outputDir: "pan", // Output directory for generated .mdx docs
            sidebarOptions: {
            },
          },
        }
      },
    ]
  ],
  themes: ["docusaurus-theme-openapi-docs"], // Allows use of @theme/ApiItem and other components

Docusaurus version: 2.3.1
Node version: v19.4.0

[sserrata]

Hi @kenrobbins, what version of the plugin are you attempting to use?

[kenrobbins]

@sserrata: Thanks for replying. It's version 1.6.1.

├── [email protected]
├── [email protected]

[sserrata]

To upgrade to Docusaurus 2.3.0+ you'll need to install 2.0.0-beta.1. Release v1.6.1 is only compatible with >=2.0.1 <2.3.0.

[kenrobbins]

Thanks. That was it.

[bgravenorst]

Hi, I'm getting the same error.

Could you please help? Here is my package.json

{
  "name": "tmpName",
  "version": "0.0.0",
  "private": true,
  "scripts": {
    "docusaurus": "docusaurus",
    "start": "docusaurus start",
    "build": "docusaurus build",
    "swizzle": "docusaurus swizzle",
    "deploy": "docusaurus deploy",
    "clear": "docusaurus clear",
    "serve": "docusaurus serve",
    "write-translations": "docusaurus write-translations",
    "write-heading-ids": "docusaurus write-heading-ids",
    "build:gitlab": "GITLAB_BUILD=true docusaurus build --out-dir public",
  },
  "dependencies": {
    "@docusaurus/core": "2.4.0",
    "@docusaurus/preset-classic": "2.4.0",
    "@mdx-js/react": "^1.6.21",
    "@svgr/webpack": "^5.5.0",
    "clsx": "^1.1.1",
    "docusaurus-lunr-search": "^2.1.15",
    "docusaurus-plugin-openapi-docs": "2.0.0-beta.4",
    "docusaurus-theme-openapi-docs": "2.0.0-beta.4",
    "file-loader": "^6.2.0",
    "jsdoc-to-markdown": "^8.0.0",
    "prism-react-renderer": "^1.2.1",
    "react": "^17.0.1",
    "react-dom": "^17.0.1",
    "redocusaurus": "^0.6.0",
    "swagger-ui-react": "^4.10.3",
    "url-loader": "^4.1.1"
  },
  "browserslist": {
    "production": [
      ">0.5%",
      "not dead",
      "not op_mini all"
    ],
    "development": [
      "last 1 chrome version",
      "last 1 firefox version",
      "last 1 safari version"
    ]
  },
  "packageManager": "[email protected]",
  "devDependencies": {
    "@babel/cli": "^7.22.9",
    "@babel/core": "^7.22.9",
    "@babel/plugin-proposal-class-properties": "^7.18.6",
    "@babel/plugin-proposal-object-rest-spread": "^7.20.7",
    "@babel/preset-env": "^7.22.9",
    "@babel/preset-typescript": "^7.22.5",
    "jsdoc-babel": "^0.5.0",
    "typedoc": "^0.24.8",
    "typescript": "^5.1.6"
  }
}