# ls-webpack-starter-kit

**Repository Path**: linesoft/ls-webpack-starter-kit

## Basic Information

- **Project Name**: ls-webpack-starter-kit
- **Description**: 基于webpack构建的多页脚手架；
ES6 ES7
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2017-11-29
- **Last Updated**: 2020-12-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# pure web page

> pure scaffold for developing web page

## Usage

``` bash
# install dependencies
npm install

# serve with hot reload at localhost:8080
npm run dev

# build for production with minification
npm run build

# build for production and view the bundle analyzer report
npm run build --report
```

## Configuration

`config/index.js`:

- `layout`
  - `html`: 默认的html模板文件
  - `entry`: 模板文件对应的入口js，所有页面公共的js也可以在此文件中写入。如不需要，可以删除此配置。

- `assetsVersionMode`: 静态资源版本控制模式。设为`hash`则采用文件哈希值；或者直接写后端的对应的版本变量名；或者直接写 `+new Date()`则每次发布更新资源时间戳。另外，这仅对html内引入的静态资源有效，css内链的图片依旧采用哈希值来控制版本。

其他配置可参考 [guide](http://vuejs-templates.github.io/webpack/)

## Convention

1. `entries`： 入口文件的目录。一个入口html，必须被包含在一个文件中，以该文件夹名为入口名，并在文件夹内建立一个`index.html`与一个`index.js`文件。`index.html`为页面html，`index.js`为页面js入口。入口支持多级目录嵌套，如项目源码中的示例。
2. `layout`：模版文件目录。此目录放置项目的模版文件。如果一个html入口文件需要加载其他的模版文件，采用装饰器语法，如`entries/detail/user/index.html`文件中的示例：`@layout(../../../layout/detail.html)`。也可以参考[html-layout-loader](https://github.com/wuomzfx/html-layout-loader)。
3. 其他资源文件夹没有强制约定，可自行根据喜好设定。