使用说明

第一次使用

# 当前目录执行，安装文档系统依赖。（文档系统使用的webpack3.）
$ npm i
# 进入webpack4目录，安装webpack4环境，打jar包使用的webpack4.
$ cd webpack4 && npm i

为了独立安装webpack4，webpack4打包的代码在f12的sources面板是模块化的形式(不是很多代码在一整页的js里)，方便调试。

开发

npm run start idea中也可以在package.json里点运行按钮。

发包

在IDEA中点开gradle面板，双击publish(发到公共库),或publishToMavenLocal(发本地)。

本地SpringBoot运行

先deploySite(gradle task),在启动SpringBoot项目。

打war包

双击war.

脚本说明

Scripts in package.json

• site 将文档打包成静态文件。
• start 启动文档开发模式。

Gradle task

• clearStatic 清理src/main/resources/static.
• clearWebpack 清理dist.
• generateSite 重新打包文档静态文件。
• deploySite 重新打包文档静态文件并拷贝到src/main/resources/static.

特性

• 🍭文档中的demo“在codepen中打开”的功能。
• 🚀gradle一键打包发布。
• ⏱开发时，开发文档(使用bisheng)热切换。
• 🐈使用gradle的war task将开发文档打war包，可部署到tomcat.

注意事项

webpack offline plugin 通过service worker给doc提供离线体验，有时会产生两个service worker， 造成图片资源错误，在chrome中，通过 chrome://serviceworker-internals/ 地址注销service worker，再刷新网页即可。