markapi
v1.0.0
Published
[文档](https://github.com/yubin-code/webpc)
Downloads
5
Readme
webpc
主要解决纯静态多页页面的webpack配置问题
在往常需要写一堆配置现在有了webpc安装好就能马上开发
版本要求 node >= v10.0.0
webpc 核心是插件驱动代码分为三层
1.核心层 @webpc/core 提供插件核心原动力目前是参考umi实现的想学习的可以看下
2.插件层 @webpc/plug 提供webpack内置插件方便快速开发脚手架
3.应用层 webpc webpc 就属于应用层
这么分的目的是为了以后还能开发别的脚手架
特点
1.自动监控 html 文件变化并加入到
webpack编译中
2.使用ejs可以直接引入让公用的html代码让代码更简洁
3.支持webpack自定义配置如果目前功能帮助不了可以自行添加新的配置
4.支持rem只要配置一个基准值就能直接把px转成rem让移动开发更简单
目前已支持的功能
1.支持多页面开发
2.支持less语法
3.支持es6与ts语法
4.支持代码热更新
5.支持ejs 模版
6.支持代码压缩
7.支持公共代码抽离
8.支持rem
9.支持webpack 自定义配置
如果您还有别的需要可以在这里提交给我
使用方式也很简单 直接安装webpc
# 安装
$ yarn global add webpc
# or
$ npm i webpc -g初始化项目
$ mkdir myapp && cd myapp
# and
$ webpc init生成成功目录结构
src
- assets
- css
- js
- viwe
.webcof.js
README.md
package.json 安装依赖
$ yarn
# or
$ npm i启动项目
$ yarn run dev
# or
$ npm run dev启动成功界面
✔ Webpack
Compiled successfully in 4.72s
DONE Compiled successfully in 4718ms
▍ ★∴
s ．t ．▍▍a．..r．█▍ ☆ ★∵t ..../
◥█▅▅██▅▅██▅▅▅▅▅███◤
．◥███████████████◤
～～～～◥█████████████◤～～～～准备起航
～～～～～～～～～～～～～～～～～～～～～～～～
服务运行成功:
- 地址: http://localhost:8000
- 内网地址: http://192.168.00.00:8000打包项目
$ yarn run build
# or
$ npm run build其他命令
# 查看版本
$ webpc -v
# 显示帮助
$ webpc -h使用说明html引入
使用@require直接引入公用的html
ejs 是模版引擎最终编译html可以配置压缩或不压缩
<body>
@require('./common/header.ejs')
<h1>webpc</h1>
<p>👏 大白菜等你摘，欢迎使用webpc让web开发变得更便捷</p>
@require('./common/footer.ejs')
</body>css 直接引入公用的css
@import "./common.less";
body {
padding: 50px;
margin: 0;
font: 14px "Lucida Grande", Helvetica, Arial, sans-serif;
}css问题注意⚠️
如果需要使用css需要在js中引入它
最终打包的时候可以选择是分离出来还是直接打包到html页面中去
// index.js 中引入css
import '@/css/index.less'
配置说明
根目录下提供了 .webcof.js 配置文件以下是默认配置
const path = require('path');
// 判断是否开发环境
const isDev = process.env.NODE_ENV === "development"
module.exports = {
// 视图文件入口
viewPath: "./src/view",
// 打包后静态文件存放的目录
staticPath: "./static",
// pages 页面配置
pages: [
{
template: "index",
/**
* index 就是下面入口文件引入的index值是key
* commons 是抽取的公用js查看以下配置
*/
chunks:['index', 'commons']
}
],
// webpack 配置
webpack: {
resolve: {
alias: {
/**
* 配置别名在js中就能使用以下方式引入文件
* import '@/css/index.less'
*/
'@': path.resolve(__dirname, './src')
}
},
/**
* 服务器配置
* 因为使用的是官网的所以配置很丰富诸如代理自动打开浏览器等
* 参考 https://www.webpackjs.com/configuration/dev-server/
*/
devServer: {},
/**
* 配置参考
* https://webpack.js.org/configuration/optimization/#root
*/
optimization: {
// 是否压缩js开发环境不压缩
minimize: !isDev,
splitChunks: {
cacheGroups: {
// 抽离第三方插件
vendor: {
// 指定是node_modules下的第三方包
test: /[\\/]node_modules[\\/]/,
// 打包后的文件名，任意命名
chunks: 'initial',
//共用字节大于0即抽离
minSize:0,
//引用2次就打包
minChunks:2
},
// 抽离自己写的公共代码，common这个名字可以随意起
commons: {
chunks: 'initial',
// 只要超出0字节就生成一个新包
minSize: 0,
//引用2次就打包
minChunks: 2
}
}
}
},
/**
* 这里使用的是 webpack-html-plugin 配置需要结合上面pages页面配置使用
* 每一个 pages 就是一个 new HtmlWebpackPlugin()
* 而这里html就是 pages公用属性所以一般pages配置模版就行了剩下交给html把
* 主要注意的是 html 属性不支持 template 与 filename 设置
* 参考 https://github.com/jantimon/html-webpack-plugin
*/
html: {
// 给包含的脚本和CSS文件后面附加哈希
hash: true,
// 页面的ico设置
favicon: './src/assets/favicon.ico',
/**
* html 压缩配置
* 参考 https://github.com/DanielRuf/html-minifier-terser
*/
// 判断如果开发环境就不压缩html
minify: isDev ? {} : {
removeComments: true,
collapseWhitespace: true,
removeAttributeQuotes: true
}
},
/**
* 是否使用rem编写代码
* 设置了rem请把html页面的 <meta name="viewport" content="width=device-width, initial-scale=1.0">
* !一定要删除,!一定要删除,!一定要删除
* 标签不去除去会导致页面的rem值错乱
* 设计图是750就设置 75
* 设计图是375就设置37.5
* 支持json 详细配置请查阅 https://www.npmjs.com/package/postcss-plugin-px2rem
* 不填写则不启用rem
*/
// rem: 75,
/**
* css 配置
*/
css: {
// 是否把样式直接插入到页面中而不生成css文件
styleLoader: false,
name: "css/[name].ui.css",
// 是否压缩css
uglify: !isDev
},
// js 入口
entry: {
index: "./src/js/index.js",
},
// 打包出口配置
output: {
path: path.resolve(__dirname, './dist'),
filename: 'js/[name].[hash].index.js',
},
},
}微信群学习群
您的支持是我最大的动力
关于作者
作者： 大斌
Github：https://github.com/yubin-code
个人网站： 没钱买不起服务器部署不起来 - -
对内容有任何疑问，欢迎联系我。
其他
如果有问题与建议可以在这里提交