官网

https://docsite.js.org/zh-cn/index.html

问题

docsite start启动报错

1
2
3
fs.js:40 } = primordials; ^

ReferenceError: primordials is not defined at fs.js:40:5 at req_ (/Users/quziwei/Documents/code/web/test/node_modules/natives/index.js:143:24) at Object.req [as require] (/Users/quziwei/Documents/code/web/test/node_modules/natives/index.js:55:10) at Object.<anonymous> (/Users/quziwei/Documents/code/web/test/node_modules/vinyl-fs/node_modules/graceful-fs/fs.js:1:37) at Module._compile (internal/modules/cjs/loader.js:1201:30) at Module._extensions..js (internal/modules/cjs/loader.js:1221:10) at Object.require.extensions.<computed> [as .js] (/Users/quziwei/Documents/code/web/test/node_modules/babel-register/lib/node.js:152:7) at Module.load (internal/modules/cjs/loader.js:1050:32) at Function.Module._load (internal/modules/cjs/loader.js:938:14) at Module.require

解决：

docsite 中 node 12.x 及以上版本和 gulp3.x 兼容的不是很好 ，需要这样修改

第一步 通过两个命令 npm uninstall gulp ,npm install gulp 升级 gulp 到版本 4

第二步 修改 gulpfile.js 搜索 gulp.task (‘default’ 和 gulp.task (‘build’, 注释掉

1
2
3
4
5
// The development server (the recommended option for development)
//gulp.task('default', ['webpack-dev-server']);

// Production build
//gulp.task('build', ['webpack:build']);

然后在 gulpfile.js 文件末尾增加如下代码

1
2
3
4
5
// The development server (the recommended option for development)
gulp.task('default', gulp.series( 'webpack-dev-server'));

// Production build
gulp.task('build', gulp.series( 'webpack:build'));