Docusaurus 2.0.0-rc.1配置sidebar选项触发构建ValidationError报错

问题原因 #

你使用的Docusaurus 2.0.0-rc.1属于早期候选版本，侧边栏的hideable和autoCollapseCategories配置并不归属于themeConfig.docs.sidebar，而是属于文档内容插件（@docusaurus/plugin-content-docs）的配置项，放在themeConfig里会触发配置校验错误。

解决方案 #

修改docusaurus.config.js，把侧边栏相关配置从themeConfig移到presets下的classic预设的docs配置中：

1. 找到配置中的presets部分，在@docusaurus/preset-classic的docs配置内添加侧边栏参数
2. 删除themeConfig里原有的docs.sidebar配置段

修改后的docusaurus.config.js关键片段：

// @ts-check
// ...（省略其他配置）

const config = {
  // ...（省略其他配置）

  presets: [
    [
      '@docusaurus/preset-classic',
      /** @type {import('@docusaurus/preset-classic').Options} */
      ({
        docs: {
          sidebarPath: require.resolve('./sidebars.js'),
          // 添加侧边栏配置
          sidebar: {
            hideable: true,
            autoCollapseCategories: true,
          },
        },
        // ...（省略其他preset配置）
      }),
    ],
  ],

  themeConfig:
   /** @type {import('@docusaurus/preset-classic').ThemeConfig} */
    ({
      // 移除原来的docs.sidebar配置
      // ...（省略其他theme配置）
    }),
};

module.exports = config;

验证修改 #

保存配置后重新执行docusaurus build，即可正常完成构建。

内容的提问来源于stack exchange，提问作者sincord