微信公众号搜"智元新知"关注
微信扫一扫可直接关注哦!

如何解决Docusaurus中的版本错误?

如何解决如何解决Docusaurus中的版本错误?

我们已经成功地通过yarn start运行了9个月的Docusaurus开发版本。今天,我将这些文件上传到了GitLab,并将它们拉到一个新位置,以便我们可以完成我们的配置的完整构建。我在以开发模式再次验证站点时遇到问题,以便可以正确构建它。最终目标是我们可以从GitLab进行常规构建,并且用户可以在那里更新其文档。

我完成以下步骤:

这些都成功了。

  • 尝试运行yarn start来检查网站是否正在运行

开发服务器将无法启动。

PS I:\DocsBuild\docs> yarn run start
yarn run v1.21.1
$ docusaurus start
Starting the development server...
Error: It is not possible to use docs without any version. Please check the configuration of these options: includeCurrentVersion=undefined disabLeversioning=undefined
    at readVersionNames (I:\DocsBuild\docs\node_modules\@docusaurus\plugin-content-docs\lib\versions.js:83:15)
    at Object.readVersionsMetadata (I:\DocsBuild\docs\node_modules\@docusaurus\plugin-content-docs\lib\versions.js:188:36)
    at pluginContentDocs (I:\DocsBuild\docs\node_modules\@docusaurus\plugin-content-docs\lib\index.js:27:41)
    at I:\DocsBuild\docs\node_modules\@docusaurus\core\lib\server\plugins\init.js:33:54
    at Array.map (<anonymous>)
    at Object.initPlugins (I:\DocsBuild\docs\node_modules\@docusaurus\core\lib\server\plugins\init.js:15:60)
    at Object.loadplugins (I:\DocsBuild\docs\node_modules\@docusaurus\core\lib\server\plugins\index.js:40:28)
    at Object.load (I:\DocsBuild\docs\node_modules\@docusaurus\core\lib\server\index.js:56:62)
    at start (I:\DocsBuild\docs\node_modules\@docusaurus\core\lib\commands\start.js:46:34)
    at I:\DocsBuild\docs\node_modules\@docusaurus\core\bin\docusaurus.js:29:5
    at Command.<anonymous> (I:\DocsBuild\docs\node_modules\@docusaurus\core\bin\docusaurus.js:75:23)
    at Command.listener (I:\DocsBuild\docs\node_modules\commander\index.js:370:29)
    at Command.emit (events.js:210:5)
    at Command.parseArgs (I:\DocsBuild\docs\node_modules\commander\index.js:892:12)
    at Command.parse (I:\DocsBuild\docs\node_modules\commander\index.js:642:21)
    at Object.<anonymous> (I:\DocsBuild\docs\node_modules\@docusaurus\core\bin\docusaurus.js:97:5)
error Command Failed with exit code 1.
info Visit https://yarnpkg.com/en/docs/cli/run for documentation about this command.

错误:无法使用没有任何版本的文档。请检查以下选项的配置:includeCurrentVersion = undefined disabLeversioning = undefined

我已经阅读了有关文档版本here的指南,但我们从未使用过它,甚至不知道所引用的选项(includeCurrentVersiondisabLeversioning在哪里被定义或设置。在Visual Studio Code中搜索这些值不会突出显示任何结果。

我已经对文档进行了一些搜索,在GitHub上以及在整个网络上都进行了搜索,但是找不到任何有助于此目的的东西。

如果有帮助,这是我的应用程序package.json文件

{
  "name": "docs","version": "0.0.0","private": true,"scripts": {
    "start": "docusaurus start","build": "docusaurus build","swizzle": "docusaurus swizzle","deploy": "docusaurus deploy","build-sidebars": "@powershell -noprofile -ExecutionPolicy Unrestricted -File ./Build-DocusaurusIndex.ps1","build-index": "node ./generate-index.js"
  },"dependencies": {
    "@docusaurus/core": "^2.0.0-alpha.40","@docusaurus/preset-classic": "^2.0.0-alpha.40","@docusaurus/theme-live-codeblock": "^2.0.0-alpha.39","classnames": "^2.2.6","elasticlunr": "^0.9.5","firstline": "^2.0.2","lunr": "^2.3.8","react": "^16.8.4","react-dom": "^16.8.4","react-js-pagination": "^3.0.2","react-trend": "^1.2.5","react-youtube": "^7.9.0","remove-markdown": "^0.3.0","replace-in-file": "^5.0.2"
  },"browserslist": {
    "production": [
      ">0.2%","not dead","not op_mini all"
    ],"development": [
      "last 1 chrome version","last 1 firefox version","last 1 safari version"
    ]
  }
}

如果有类似问题的人或项目中的某人可以在此处提供一些指导,请务必感谢。

解决方法

最新yarn install之后的许多文件与最初创建的文件有很大不同。我更新了package.json以使用最新版本的Docusaurus,并运行了yarn upgrade。网站开始并立即构建。我希望没有必要进行升级,但是整理更改的影响不会太差。

期待v2的完整发布!

版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。