Docusaurus 迁移错误：无法读取未定义的属性“doc”

问题描述

我正在尝试将 Docusaurus v1 站点迁移到 Docusaurus v2。当我运行 migrate 命令时，我收到以下错误和堆栈跟踪。不知道是什么问题。

PS C:\docusaurus> npx @docusaurus/migrate migrate c:\docusaurus\old-site\OldSiteName\website c:\docusaurus\test-site

npx：在 46.633 秒内安装了 412 开始从 v1 迁移到 v2... 类型错误：无法读取未定义的属性“doc” 在 createConfigFile (C:\Users\sam.phillips\AppData\Roaming\npm-cache_npx\19476\node_modules@docusaurus\migrate\lib\index.js:170:125) 在 createMigrationContext (C:\Users\sam.phillips\AppData\Roaming\npm-cache_npx\19476\node_modules@docusaurus\migrate\lib\index.js:80:26) 在 migrateDocusaurusProject (C:\Users\sam.phillips\AppData\Roaming\npm-cache_npx\19476\node_modules@docusaurus\migrate\lib\index.js:83:30) 在 C:\Users\sam.phillips\AppData\Roaming\npm-cache_npx\19476\node_modules@docusaurus\migrate\bin\index.js:21:5 在指挥部。 (C:\Users\sam.phillips\AppData\Roaming\npm-cache_npx\19476\node_modules@docusaurus\migrate\bin\index.js:45:42) 在 Command.listener [as _actionHandler] (C:\Users\sam.phillips\AppData\Roaming\npm-cache_npx\19476\node_modules@docusaurus\migrate\node_modules\commander\index.js:413:31) 在 Command._parseCommand (C:\Users\sam.phillips\AppData\Roaming\npm-cache_npx\19476\node_modules@docusaurus\migrate\node_modules\commander\index.js:914:14) 在 Command._dispatchSubcommand (C:\Users\sam.phillips\AppData\Roaming\npm-cache_npx\19476\node_modules@docusaurus\migrate\node_modules\commander\index.js:865:18) 在 Command._parseCommand (C:\Users\sam.phillips\AppData\Roaming\npm-cache_npx\19476\node_modules@docusaurus\migrate\node_modules\commander\index.js:882:12) 在 Command.parse (C:\Users\sam.phillips\AppData\Roaming\npm-cache_npx\19476\node_modules@docusaurus\migrate\node_modules\commander\index.js:717:10) PS C:\docusaurus>

解决方法

您必须在 headerLink 中至少添加一个 siteConfig.js：

  // For no header links in the top nav bar -> headerLinks: [],//headerLinks: [],headerLinks: [
    { doc: 'docs',label: 'Documentation' },],

其他选项是完全删除 headerLinks。