parcel-plugin-consci v1.0.1
Parcel-plugin-consci
安装
npm install parcel-plugin-consci --save-dev
使用
Parcel 会自动检测和加载以 parcel-plugin-
为前缀命名的插件,任何在 package.json
中被列出的带有此前缀的依赖,都会在初始化的时候被自动加载。
包含功能
跳过不需要打包的文件
Parcel 是基于资源的,当它基于 html
文件进行打包编译时,会自动识别 html 中的引用,如果是 http://
就不会进行打包处理,如果是本地文件,就会识别成 Assets 对象,进行打包。
如果我们需要跳过本地文件的打包,在 html
文件中使用 <!--[if parcel_plugin]> your code <![endif]-->
:
<body>
<!--[if parcel_plugin]>
<script src="./static/ie8.js"></script>
<![endif]-->
</body>
开发环境下执行代码与加载资源
如果我们希望在开发环境行执行某些代码或加载某些资源,正式打包发布的时候而不包含这些部分,可以在 html
文件中使用 <!--| your code |-->
:
<body>
<!--|
<script src="http://localhost/static/debug.js"></script>
<script>
var DEVELOPMENT = true;
</script>
|-->
</body>
对html文件进行修改
例如我们打算根据 package.json
中的配置替换 index.html
的 title
,首先需要在 package.json
中配置替换的内容:
{
"parcel-plugin-consci": {
"replacement": ["Parcel插件"]
}
}
然后在 index.html
中添加 <!-- parcel-plugin-i -->
,其中 i
对应 replacement
中的下标:
<body>
<title><!-- parcel-plugin-0 --></title>
</body>
静态资源拷贝
打包的时候,我们常常需要将未加入打包的静态资源同时拷贝到发布文件夹中去, parcel-plugin-consci
默认执行的静态资源文件夹为 static
,如果为其它路径,可以在 package.json
中进行配置:
{
"parcel-plugin-consci": {
"staticPath": [
"site/doc",
"site/vendor"
]
}
}
静态资源监听
静态资源监听是与静态资源拷贝功能和 Parcel 的 Watch
功能绑定的,当你启动静态资源监听功能后,监听的是 staticPath
下的文件。监听的文件通过 watcherGlob
进行配置(使用 Minimatch Library 匹配):
{
"parcel-plugin-consci": {
"staticPath": [
"site/doc",
"site/vendor"
],
"watcherGlob": "**"
}
}