# gulp-html-merge
> merge html to html
Latest version **1.0.4** (published 2017-03-16) · ISC license · 0 weekly downloads
## Install
```sh
npm install gulp-html-merge
pnpm add gulp-html-merge
yarn add gulp-html-merge
bun add gulp-html-merge
```
## Health
**Score 15/100 (F)** — status: abandoned.
Positive: no vulnerabilities.
Warnings: low downloads; no types; no esm support.
Negative: abandoned; low maintenance score.
## Facts
| | |
|---|---|
| Version | 1.0.4 |
| Published | 2017-03-16 |
| First published | 2017-03-09 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | yyman001 |
| Maintainers | yyman001 |
## Links
- npm: https://www.npmjs.com/package/gulp-html-merge
- Repository: https://github.com/yyman001/gulp-html-merge
- Homepage: https://github.com/yyman001/gulp-html-merge#readme
- Issues: https://github.com/yyman001/gulp-html-merge/issues
- npm.io page: https://npm.io/package/gulp-html-merge
## Recent versions
- 1.0.4 (latest) — 2017-03-16
- 1.0.2 — 2017-03-09
- 1.0.3 — 2017-03-09
- 1.0.1 — 2017-03-09
- 1.0.0 — 2017-03-09
## README
# gulp-html-merge
用于html文件标记范围内容进行指定位置标识填充
依赖`through-gulp`
## 安装
```js
npm install through-gulp --save
npm install gulp-html-merge --save
//如果无法安装,可以换cnpm 安装
```
## 使用方法
###1.占位符
`name`为自定义名称,跟@block:`name`对应
```html
eg:
```
###2.需要填充的内容
注意:建议填充内容不要包含``,不然可能会出错
```html
这里是填充内容范围
eg:
我是tag1,我是填充内容
```
###3.调用方法
```javascript
var gulp = require('gulp');
var htmlMerge = require('gulp-html-merge');
gulp.task('demo',function(){
return gulp.src(['demo.html','tag.html'])
.pipe(htmlMerge())
.pipe(gulp.dest('out/'));
})
```
在test目录下有测试文件
####4.demo文件例子
demo.html
```html
Title
这里是demo测试页
```
tag.html
```html
Title
我是tag1,我是填充内容
我是tag2,我是填充内容
```
编译后的文件结果
demo.html
```html
Title
这里是demo测试页
我是tag1
我是tag2
```
tag.html
```html
Title
tag.html
我也可以在这里插入哦
我是tag1
我是tag2
我是tag1
我是tag2
```
####过滤不合并的标签
```javascript
let filterTag = ["tag2"]; //过滤标签添加到一个数组,必须的数组
var htmlMerge = require('gulp-html-merge');
gulp.task('demo',function(){
return gulp.src(['demo.html','tag.html'])
.pipe(htmlMerge())
.pipe(gulp.dest('out/'));
})
```
结果:
demo.html
```html
Title
这里是demo测试页
我是tag1
```
一般用于多页面分部开发,这样可以把想要的合并到需要的地方
---
_Source: https://npm.io/package/gulp-html-merge · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._