wpage

注意：1.x版本与当前版本用法不同。如需使用1.x版本，请前往历史发布版本进行查看，或直接执行 npm install -g wpage-cli

Usage no npm install needed!

<script type="module">
  import wpage from 'https://cdn.skypack.dev/wpage';
</script>

README

注意：1.x版本与当前版本用法不同。如需使用1.x版本，请前往历史发布版本进行查看，或直接执行 npm install -g wpage-cli

这是一个能让你开发静态页面时，搭建本地服务器和及时刷新浏览器预览功能的包

安装：

npm install -g wpage

功能：

开启一个本地服务器
对文件进行监听，如有变动刷新浏览器
scss和babel后缀的文件会生成编译后的同名不同后缀的新文件

使用方法：

在当前目录下启动服务：

命令行内开启服务：wpage start

代码内开启服务：wpage.start()
开启服务根目录下创建配置文件.wpagerc.json：
```
{
 "ignore": [],
 "sass_style": "",
 "dir": "",
 "sourceContentType": {}
}
```
- ignore
  
  如果不想让部分文件发生变化时浏览器刷新，可以在这里配置不刷新文件。遵循ignore文件配置规则，比如：
```
"ignore": [
   "node_modules/",
    ".git/",
    ".wpagerc.json"
]
```
  以上配置项已经添加到wpage的默认配置里了，我们无需在配置文件中添加他们。
- sass_style
  
  这个配置项决定了.scss后缀文件编译后的代码格式，与sass的代码格式配置相同：
```
nested
expanded
compact
compressed
```
  默认值是nested。
- dir
  
  这个配置项允许我们对任意目录开启服务，而不是在当前目录。
- sourceContentType
  
  由于系统的原因，在开发过程中需要设置不同格式文件的Content-Type。wpage已经对大多数格式做了处理，如果设置的不对或者使用其他格式的文件时，需要在sourceContentType中添加对应格式的Content-Type，例如：
```
"sourceContentType": {
   ".svg": "image/svg+xml"
}
```
  当然上面的值也是默认配置，我们无需再次添加。
CLI：

wpage start

开启wpage服务

wpage init [project name]

创建一个文件夹，并自动添加.wpagerc.json规则文件

机制（与1.x相比）：
1. 系统对在浏览器中打开的html后缀的文件追加websocket代码，而其他后缀的文件没有。
2. 增加了可排除刷新的文件设置 ignore。
3. sass和babel后缀文件因为有扩展功能，所以他们的文件变化并不会通知给浏览器。
4. 现在可以开启多个wpage服务了，端口号并不会提示占用。
5. favicon.ico 文件不设置时在命令行中会有文件不存在的提示，现在已经排除了这个提示
6. 系统提示信息已改为中文

2.0.9更新：

增加了字体文件ttf格式的content-type默认配置

2.0.8更新：

修复了ignore在过滤时，在监听到项目文件夹本身的变化时意外出错的情况

2.0.7更新：

我们在实际应用中发现，在.wpagerc.json中添加了ignore后无效果，在此版本修复了这个bug。
在实际开发中如果有大量文件同时更新，浏览器中会多次刷新，这个版本修改了不多次刷新。

2.0.6更新：

修改.svg文件的默认Content-type=image/svg+xml

2.0.3更新：

修复bug，增加模块内调用wpage.start()，等效于cli：wpage start