gulp编译scss时调整url引用路径

广告位招租
扫码页面底部二维码联系

在我们的开发中,我们经常会使用打包工具,【转载请注明来源】【转载请注明来源】对css进行打包,在scss中,我们还经【版权所有】唐霜 www.tangshuang.net本文作者:唐霜,转载请注明出处。常把模块放在一个单独的文件夹内,这样就会【访问 www.tangshuang.net 获取更多精彩内容】【本文首发于唐霜的博客】有路径问题(这个问题本文暂时也不解决),【版权所有,侵权必究】【转载请注明来源】比如我们把scss文件放在src/sty【本文受版权保护】【原创不易,请尊重版权】le目录中,但是编译打包完之后的css放未经授权,禁止复制转载。【作者:唐霜】在dist目录下,这样就会导致原本样式中【本文首发于唐霜的博客】本文作者:唐霜,转载请注明出处。的url路径在最终的css中不正确。本文【原创不易,请尊重版权】本文作者:唐霜,转载请注明出处。就试图写一个插件来调整这个引用路径。

【本文首发于唐霜的博客】【版权所有】唐霜 www.tangshu本文版权归作者所有,未经授权不得转载。原创内容,盗版必究。ang.net

gulp的插件怎么写?

gulp的插件,其实是放在pipe中作为【转载请注明来源】【版权所有】唐霜 www.tangshuang.net参数的函数,它处理的要么是stream要未经授权,禁止复制转载。【原创内容,转载请注明出处】么是buffer,在我们这个场景里面,s本文作者:唐霜,转载请注明出处。【原创不易,请尊重版权】tream就是所有的整个流程里面的信息,【版权所有】唐霜 www.tangshuang.net【未经授权禁止转载】buffer就是当前正在处理的这个文件的【本文首发于唐霜的博客】【转载请注明来源】信息,所以我们要处理的,是buffer,【访问 www.tangshuang.net 获取更多精彩内容】转载请注明出处:www.tangshuang.net可以简单(而不正确)的理解为,一个buf【作者:唐霜】转载请注明出处:www.tangshuang.netfer就对应一个文件。

【作者:唐霜】【原创不易,请尊重版权】【作者:唐霜】

理解这点之后,在继续往下看。我们通过在p【本文首发于唐霜的博客】【作者:唐霜】ipe中截获文件信息,包括文件的内容,通【关注微信公众号:wwwtangshuangnet】【作者:唐霜】过我们自己的代码,修改内容或文件信息(比【原创内容,转载请注明出处】本文作者:唐霜,转载请注明出处。如文件名),把修改过的buffer返回给【本文首发于唐霜的博客】【未经授权禁止转载】pipe,这样就达到了我们gulp插件的【本文首发于唐霜的博客】本文作者:唐霜,转载请注明出处。目的。

【访问 www.tangshuang.n【原创不易,请尊重版权】【转载请注明来源】et 获取更多精彩内容】【版权所有,侵权必究】

基于这种思想,我写了一个gulp插件的模【本文受版权保护】原创内容,盗版必究。块,你如果以后要自己写,可以方便的使用这【本文首发于唐霜的博客】【访问 www.tangshuang.net 获取更多精彩内容】个模块:

本文作者:唐霜,转载请注明出处。未经授权,禁止复制转载。【关注微信公众号:wwwtangshua【版权所有,侵权必究】【本文首发于唐霜的博客】ngnet】
// modifyStreamContent.js
import through from "through2"
import {log} from "../loader"
export default function modifyStreamContent(modify) {
    return through.obj(function(file, endcoding, callback) {
        if(file.isNull()) {
            this.push(file)
            return callback()
        }
        if(file.isStream()) {
            log("streaming not supported", "error")
            return callback()
        }
        var content = file.contents.toString()
        content = modify(content, file.path) || content
        file.contents = new Buffer(content)
        this.push(file)
        callback()
    })
}

上面就是专门用来修改文件内容的一个模块,【关注微信公众号:wwwtangshuangnet】【关注微信公众号:wwwtangshuangnet】下面开始利用这个模块,撰写你自己的gul【未经授权禁止转载】本文版权归作者所有,未经授权不得转载。p插件:

【本文受版权保护】本文版权归作者所有,未经授权不得转载。【原创内容,转载请注明出处】【版权所有】唐霜 www.tangshu【原创内容,转载请注明出处】未经授权,禁止复制转载。ang.net
// replaceName.js
import modify from "./modifyStreamContent"
export default function() {
  return modify((content, filePath) => {
    content = content.replace("{{name}}", "my name")
    return content
  })
}

上面就是最最简单的一个gulp插件了,它【版权所有】唐霜 www.tangshuang.net转载请注明出处:www.tangshuang.net的作用是将文件内容里面的{{name}}【版权所有,侵权必究】本文作者:唐霜,转载请注明出处。替换为”my name【原创不易,请尊重版权】未经授权,禁止复制转载。221;(第一个)。

【版权所有】唐霜 www.tangshu原创内容,盗版必究。【原创内容,转载请注明出处】ang.net本文版权归作者所有,未经授权不得转载。

接下来看下在gulpfile里面怎么使用【版权所有,侵权必究】转载请注明出处:www.tangshuang.net这个插件:

未经授权,禁止复制转载。【访问 www.tangshuang.n【版权所有】唐霜 www.tangshuang.net【版权所有,侵权必究】et 获取更多精彩内容】
import rename from "./replaceName"
gulp.task("default", () => {
  gulp.src("my.md").pipe(rename()).pipe(gulp.dest("."))
})

如果在replaceName里面加入参数【版权所有,侵权必究】【原创内容,转载请注明出处】,你还可以实现更负责的选项。

【原创内容,转载请注明出处】未经授权,禁止复制转载。【本文首发于唐霜的博客】【关注微信公众号:wwwtangshua【本文受版权保护】【本文首发于唐霜的博客】ngnet】

gulp编译scss

写完scss之后,当然是想着把它转换为c转载请注明出处:www.tangshuang.net【关注微信公众号:wwwtangshuangnet】ss,放到浏览器下面去看看效果。但是不要【原创不易,请尊重版权】未经授权,禁止复制转载。急,既然是我们用scss写的源码,所以不【版权所有,侵权必究】【作者:唐霜】需要一个可以修改的css,所以我们就mi【版权所有,侵权必究】【本文受版权保护】nify一下好了,而且生成一个sourc【本文受版权保护】转载请注明出处:www.tangshuang.netemap文件方便调试吧。

【关注微信公众号:wwwtangshua著作权归作者所有,禁止商业用途转载。未经授权,禁止复制转载。ngnet】【版权所有】唐霜 www.tangshu本文版权归作者所有,未经授权不得转载。本文版权归作者所有,未经授权不得转载。ang.net
import sass from "gulp-sass"
import cssmin from "gulp-cssmin"
import sourcemaps from "gulp-sourcemaps"
gulp.task("scss", () => {
  gulp.src("src/style/*.scss")
  .pipe(sorucemaps.init())
  .pipe(sass())
  .pipe(cssmin())
  .pipe(sroucemaps.write("./"))
  .pipe(gulp.dest("dist"))
})

OK,这样当运行scss任务的时候,机会转载请注明出处:www.tangshuang.net【本文受版权保护】把style目录下的scss文件进行编译本文作者:唐霜,转载请注明出处。本文版权归作者所有,未经授权不得转载。合并和压缩,在dist目录下会生成一个c【本文首发于唐霜的博客】著作权归作者所有,禁止商业用途转载。ss文件,当然是经过压缩的。注意,不要直【版权所有】唐霜 www.tangshuang.net转载请注明出处:www.tangshuang.net接在style目录下相互引用。

【访问 www.tangshuang.n【未经授权禁止转载】【转载请注明来源】et 获取更多精彩内容】【访问 www.tangshuang.n【原创不易,请尊重版权】【访问 www.tangshuang.net 获取更多精彩内容】et 获取更多精彩内容】【原创不易,请尊重版权】转载请注明出处:www.tangshua【访问 www.tangshuang.net 获取更多精彩内容】【访问 www.tangshuang.net 获取更多精彩内容】ng.net

调整css里面的url相对路径

为什么只调相对路径呢?因为绝对路径没有必【未经授权禁止转载】【原创内容,转载请注明出处】要调,撰写的时候如果把http都加进去了转载请注明出处:www.tangshuang.net【版权所有】唐霜 www.tangshuang.net,肯定是考虑从cdn使用图片,这种情况下【原创不易,请尊重版权】转载请注明出处:www.tangshuang.net就没必要考虑我们本文的这个问题。但是如果【转载请注明来源】【访问 www.tangshuang.net 获取更多精彩内容】是我文章开头提到的那种情况,就有必要,举【原创内容,转载请注明出处】【转载请注明来源】一个例子:

本文作者:唐霜,转载请注明出处。【本文受版权保护】转载请注明出处:www.tangshua本文版权归作者所有,未经授权不得转载。著作权归作者所有,禁止商业用途转载。ng.net【版权所有,侵权必究】
// in src/style/icons.scss
.icon {
  background-image: url(../images/icons.png)
}

当我们进行上面的编译任务之后

【本文受版权保护】本文作者:唐霜,转载请注明出处。【原创内容,转载请注明出处】【原创不易,请尊重版权】
// in dist/icons.css
.icon {
  background-image: url(../images/icons.png)
}

这就有问题了,url里面的图片根本找不到本文作者:唐霜,转载请注明出处。著作权归作者所有,禁止商业用途转载。,应该是

著作权归作者所有,禁止商业用途转载。转载请注明出处:www.tangshua【原创内容,转载请注明出处】本文版权归作者所有,未经授权不得转载。ng.net【作者:唐霜】本文作者:唐霜,转载请注明出处。
background-image: url(../src/images/icons.png)

才对。因为在scss编译的时候,并没有对转载请注明出处:www.tangshuang.net著作权归作者所有,禁止商业用途转载。里面的文件路径进行处理。我们现在要做的,转载请注明出处:www.tangshuang.net转载请注明出处:www.tangshuang.net就是写一个gulp插件,在scss编译之【关注微信公众号:wwwtangshuangnet】【关注微信公众号:wwwtangshuangnet】前,对图片路径进行修正。

著作权归作者所有,禁止商业用途转载。【原创内容,转载请注明出处】【本文受版权保护】本文作者:唐霜,转载请注明出处。
import {path} from "../loader"
import {modifyStreamContent} from "./index"
function matchAll(str, reg) {
  var res = []
  var match
  while(match = reg.exec(str)) {
    res.push(match)
  }
  return res
}
export default function AssetsRelativePath(distPath) {
  return modifyStreamContent((content, filePath) => {
    if(!distPath) { 
     return content
    }
    var matches = matchAll(content, /url\((\S+?)\)/gi)
    var currentDir = path.dirname(filePath)
    if(matches instanceof Array) {
      matches.forEach(match => {
        let url = match[1]
        // only relative path supported
        if(url.toString().substr(0, 1) !== ".") {
          return
        }
        let file = url.replace("'", "").replace('"', "")
        let originalPath = path.resolve(currentDir, file)
        let relative = path.relative(distPath, originalPath)
        let res = relative.replace(/\\/g, "/")
        content = content.replace(url, res)
      })
    }
    return content
  })
}

在gulpfile中这样去用:

【原创不易,请尊重版权】【本文受版权保护】
import sass from "gulp-sass"
import cssmin from "gulp-cssmin"
import sourcemaps from "gulp-sourcemaps"
import AssetsRelativePath from "./AssetsRelativePath"
gulp.task("scss", () => {
  gulp.src("src/style/*.scss")
  .pipe(AssetsRelativePath("dist"))
  .pipe(sorucemaps.init())
  .pipe(sass())
  .pipe(cssmin())
  .pipe(sroucemaps.write("./"))
  .pipe(gulp.dest("dist"))
})

为什么要放在sass()前面呢?因为当s本文版权归作者所有,未经授权不得转载。未经授权,禁止复制转载。ass()执行完毕之后,我们无法通过源文本文版权归作者所有,未经授权不得转载。原创内容,盗版必究。件的路径,找出与目标文件夹之间的相对路径【版权所有】唐霜 www.tangshuang.net【本文受版权保护】
本文版权归作者所有,未经授权不得转载。 这样就可以实现相对路径替换了。不过这个【本文首发于唐霜的博客】【本文首发于唐霜的博客】方案还是有很多欠缺,主要是:

【本文首发于唐霜的博客】【关注微信公众号:wwwtangshua本文版权归作者所有,未经授权不得转载。【转载请注明来源】ngnet】【版权所有】唐霜 www.tangshu转载请注明出处:www.tangshuang.net转载请注明出处:www.tangshuang.netang.net未经授权,禁止复制转载。
  1. 在scss中写url时,考虑的是当前写的未经授权,禁止复制转载。转载请注明出处:www.tangshuang.net这个文件与图片之间的相对关系,而不是生成未经授权,禁止复制转载。【转载请注明来源】的css文件与图片之间的相对路径。这一点【访问 www.tangshuang.net 获取更多精彩内容】本文作者:唐霜,转载请注明出处。其实也要从两面看,如果编写的时候就从后者【关注微信公众号:wwwtangshuangnet】本文作者:唐霜,转载请注明出处。去考虑,那本文就没有必要去写了。但是如果【作者:唐霜】本文作者:唐霜,转载请注明出处。考虑的是编写的文件与图片之间的相对关系的【版权所有,侵权必究】原创内容,盗版必究。话,又要考虑生成文件与图片之间的路径合理【访问 www.tangshuang.net 获取更多精彩内容】转载请注明出处:www.tangshuang.net性,比如上面我的例子中,dist里面的文【版权所有】唐霜 www.tangshuang.net著作权归作者所有,禁止商业用途转载。件引用了src里面的图片,感觉不是很好,【访问 www.tangshuang.net 获取更多精彩内容】【本文受版权保护】最好是在dist同级目录中放置静态文件夹原创内容,盗版必究。【版权所有】唐霜 www.tangshuang.net,这样src和dist都是使用相同的一份【未经授权禁止转载】【关注微信公众号:wwwtangshuangnet】静态文件,更有利于发布。
  2. 著作权归作者所有,禁止商业用途转载。著作权归作者所有,禁止商业用途转载。
  3. 本文的方法,只能处理gulp.src中接本文版权归作者所有,未经授权不得转载。【版权所有】唐霜 www.tangshuang.net收的文件,不在这个匹配列表中的文件中的u【原创内容,转载请注明出处】【版权所有】唐霜 www.tangshuang.netrl路径也无法处理,比如写一个_sett原创内容,盗版必究。【本文受版权保护】ings.scss放到settings目转载请注明出处:www.tangshuang.net原创内容,盗版必究。录下,因为没有被gulp.src到,所以未经授权,禁止复制转载。【版权所有,侵权必究】里面的路径也没有办法替换到。
  4. 转载请注明出处:www.tangshua转载请注明出处:www.tangshuang.net著作权归作者所有,禁止商业用途转载。ng.net著作权归作者所有,禁止商业用途转载。【关注微信公众号:wwwtangshua【关注微信公众号:wwwtangshuangnet】【转载请注明来源】ngnet】

小结

这篇文件只是给出了一个方案,由于欠缺还是【版权所有】唐霜 www.tangshuang.net本文版权归作者所有,未经授权不得转载。很大,所以也只能当做启发用的思考,它可以【版权所有,侵权必究】本文作者:唐霜,转载请注明出处。帮助你思考怎么来写gulp,怎么通过gu著作权归作者所有,禁止商业用途转载。本文版权归作者所有,未经授权不得转载。lp的buffer去修改输出的内容。有了未经授权,禁止复制转载。【关注微信公众号:wwwtangshuangnet】这些技巧,一旦你想到了新的方案,就可以更【转载请注明来源】著作权归作者所有,禁止商业用途转载。好的去实践。

【原创不易,请尊重版权】著作权归作者所有,禁止商业用途转载。

2017-01-24 13071 ,

为价值买单,打赏一杯咖啡

本文价值130.71RMB
已有2条评论
  1. 山茶树和葡萄树 2017-12-28 17:24

    -src\n -img\n -font\n -js\n -page\n  -*.html\n -tpl\n  -*.html\n打包出来是这样目录:\n-dist\n -img\n -font\n -js\n -*.html\n而不是指向原来的src目录,img里的文件也是要用插件打包优化的。