# 介绍
webpack-website (opens new window) 是一个前台模板前端模块化方案,它基于 Webpack (opens new window) 构建的多页面项目。
# 功能
- 自动导入页面功能
- 新增环境变量功能
- 代码提取与压缩功能
- 图片处理功能
- Mock Data 功能
2
3
4
5
# 前序准备
在开始之前,推荐先学习 Webpack (opens new window) 、 ES2015+ (opens new window) 、 TypeScript (opens new window) , 了解 Mock.js (opens new window) ,提前了解和学习这些知识会对使用本项目有很大的帮助,因为本项目技术栈都是基于它们。
# 目录结构
本项目已经为你生成了一个完整的开发框架,下面是整个项目的目录结构。
# JavaScript 版
├── dist # 生产项目目录
├── mock # Mock文件目录
├── public # 静态资源目录,此目录下内容会直接复制到生产目录
├── src # 源代码
│ ├── assets # 静态资源
│ │ ├── css # 项目公用 CSS 样式
│ │ └── img # 项目图片目录
│ ├── config # 配置
│ │ │── webpack.common.js # webpack 公共配置
│ │ │── webpack.dev.js # webpack 开发配置
│ │ └── webpack.prod.js # webpack 生产配置
│ ├── modules # 全局 模块目录
│ └── pages # 页面目录(所有页面放在这里)
│ └── contact # 页面-联系(这里作为说明样例)
│ ├── modules # 当前页面 模块目录(可选)
│ ├── main.html # 当前页面html入口(必须)
│ ├── main.js # 当前页面js入口(必须)
│ └── main.scss # 当前页面css文件(可选)
├── .babelrc # babel配置
├── .env.development # 开发环境变量配置
├── .env.production # 生产环境变量配置
├── .eslintignore # eslint 忽略文件配置
├── .eslintrc.js # eslint 配置项
├── .gitignore # Git忽略文件配置
├── package.json # 项目信息
├── postcss.config.js # postcss 配置
└── README.md # readme
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
# TypeScript 版
├── dist # 生产项目目录
├── mock # Mock文件目录
├── public # 静态资源目录,此目录下内容会直接复制到生产目录
├── src # 源代码
│ ├── assets # 静态资源
│ │ ├── css # 项目公用 CSS 样式
│ │ └── img # 项目图片目录
│ ├── config # 配置
│ │ │── webpack.common.js # webpack 公共配置
│ │ │── webpack.dev.js # webpack 开发配置
│ │ └── webpack.prod.js # webpack 生产配置
│ ├── modules # 全局 模块目录
│ └── pages # 页面目录(所有页面放在这里)
│ └── contact # 页面-联系(这里作为说明样例)
│ ├── modules # 当前页面 模块目录(可选)
│ ├── data.d.ts # 当前页面 TS 类型定义文件(可选)
│ ├── main.html # 当前页面html入口(必须)
│ ├── main.ts # 当前页面ts入口(必须)
│ └── main.scss # 当前页面css文件(可选)
├── .babelrc # babel配置
├── .env.development # 开发环境变量配置
├── .env.production # 生产环境变量配置
├── .eslintignore # eslint 忽略文件配置
├── .eslintrc.js # eslint 配置项
├── .gitignore # Git忽略文件配置
├── package.json # 项目信息
├── postcss.config.js # postcss 配置
├── README.md # readme
├── tsconfig.json # typescript 配置
└── typings.d.ts # 全局 TS 类型定义文件
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
# 安装
# 克隆项目
git clone -b typescript https://github.com/lqsong/webpack-website.git
# or
# git clone -b javascript https://github.com/lqsong/webpack-website.git
# 进入项目目录
cd webpack-website
# 复制文件
copy .env.development .env.development.local # 启用或修改里面的参数
# 安装依赖,推荐使用 yarn
yarn
# or
npm install
# 本地开发 启动项目
yarn serve
# or
npm run serve
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
推荐使用 yarn , yarn安装与常用命令 (opens new window) 。
启动完成后会,打开浏览器访问 http://localhost:8000 (opens new window), 你会看到项目默认基于 jquery
、 bootstrap
实现的 Demo。
接下来你可以按照规则开发自己的项目了,你可以继续阅读和探索左侧的其它文档。
# Contribution
本文档项目地址 webpack-website-docs (opens new window) 基于 vuepress (opens new window)开发。
有任何修改和建议都可以该项目 pr 和 issue
webpack-website (opens new window) 还在持续迭代中,逐步沉淀和总结出更多功能和相应的实现代码,总结中后台产品模板/组件/业务场景的最佳实践。本项目也十分期待你的参与和反馈 (opens new window)。
# 捐赠
如果你觉得这个项目帮助到了你,请帮助 (opens new window),你也可以请作者喝咖啡表示鼓励.
ALIPAY | |
---|---|
![]() | ![]() |
配置 →