{"_id":"gulp-svg-symbols","_rev":"3874776","name":"gulp-svg-symbols","description":"Convert SVG files to symbols with gulp","dist-tags":{"latest":"3.2.3"},"maintainers":[{"name":"hiswe","email":""}],"time":{"modified":"2025-09-01T00:57:32.000Z","created":"2014-06-16T04:45:56.998Z","3.2.3":"2018-11-27T04:26:11.361Z","3.2.0":"2018-07-25T07:15:24.157Z","3.1.1":"2018-05-07T11:59:18.097Z","3.1.0":"2018-02-10T06:56:30.115Z","3.0.2":"2018-02-08T10:28:12.180Z","3.0.1":"2018-02-08T10:22:20.034Z","3.0.0":"2018-01-06T06:50:44.727Z","2.0.2":"2016-11-05T08:41:11.991Z","2.0.1":"2016-10-27T10:03:24.759Z","2.0.0":"2016-08-16T05:56:50.907Z","1.0.0":"2015-09-30T13:35:00.505Z","0.3.2":"2015-09-22T13:21:12.833Z","0.3.1":"2014-10-03T13:25:25.204Z","0.3.0":"2014-10-03T13:08:30.524Z","0.2.1":"2014-09-26T09:12:54.155Z","0.1.5":"2014-08-05T14:14:40.080Z","0.1.2":"2014-06-22T04:35:23.722Z","0.1.1":"2014-06-18T13:20:41.778Z","0.1.0":"2014-06-18T10:36:37.057Z","0.0.2":"2014-06-16T04:45:56.998Z"},"users":{},"author":{"name":"Yannick Aïvayan","email":"yannick.aivayan@hiswe.net","url":"http://hiswe.net"},"repository":{"type":"git","url":"git+https://github.com/Hiswe/gulp-svg-symbols.git"},"versions":{"3.2.3":{"name":"gulp-svg-symbols","version":"3.2.3","description":"Convert SVG files to symbols with gulp","main":"index.js","scripts":{"test":"ava test/*.js","lint":"prettier --write \"{{lib,test}/*,index,examples/gulpfile}.js\"","toc":"doctoc README.md TEMPLATES.md --github","release":"np --no-yarn"},"repository":{"type":"git","url":"git+https://github.com/Hiswe/gulp-svg-symbols.git"},"keywords":["gulpplugin","svg","symbols"],"author":{"name":"Yannick Aïvayan","email":"yannick.aivayan@hiswe.net","url":"http://hiswe.net"},"license":"MIT","bugs":{"url":"https://github.com/Hiswe/gulp-svg-symbols/issues"},"homepage":"https://github.com/Hiswe/gulp-svg-symbols","dependencies":{"ansi-grey":"^0.1.1","ansi-yellow":"^0.1.1","cheerio":"^1.0.0-rc.2","consolidate":"^0.15.1","fancy-log":"^1.3.2","lodash":"^4.17.11","plugin-error":"^1.0.1","speakingurl":"^14.0.1","through2":"^3.0.0","vinyl":"^2.2.0"},"devDependencies":{"ava":"^1.0.0-rc.2","doctoc":"^1.4.0","event-stream":"^4.0.1","gulp":"^4.0.0","intercept-stdout":"^0.1.2","prettier":"^1.15.2"},"gitHead":"a12136902d37a1073aaadd3fd5d4b354b6e8c361","_id":"gulp-svg-symbols@3.2.3","_npmVersion":"6.4.1","_nodeVersion":"10.13.0","_npmUser":{"name":"hiswe","email":"hiswehalya@gmail.com"},"dist":{"shasum":"62f18c13e38394d5fb10290c3d0886c29d7b9d09","size":68464,"noattachment":false,"key":"/gulp-svg-symbols/-/gulp-svg-symbols-3.2.3.tgz","tarball":"http://registry.cnpm.dingdandao.com/gulp-svg-symbols/download/gulp-svg-symbols-3.2.3.tgz"},"maintainers":[{"name":"hiswe","email":""}],"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/gulp-svg-symbols_3.2.3_1543292771114_0.056357401082503644"},"_hasShrinkwrap":false,"publish_time":1543292771361,"_cnpm_publish_time":1543292771361,"_cnpmcore_publish_time":"2021-12-16T22:30:59.247Z"},"3.2.0":{"name":"gulp-svg-symbols","version":"3.2.0","description":"Convert SVG files to symbols with gulp","main":"index.js","scripts":{"test":"ava test/*.js","lint":"prettier --write \"{{lib,test}/*,index,examples/gulpfile}.js\"","toc":"doctoc README.md TEMPLATES.md --github","release":"np"},"repository":{"type":"git","url":"git+https://github.com/Hiswe/gulp-svg-symbols.git"},"keywords":["gulpplugin","svg","symbols"],"author":{"name":"Yannick Aïvayan","email":"yannick.aivayan@hiswe.net","url":"http://hiswe.net"},"license":"MIT","bugs":{"url":"https://github.com/Hiswe/gulp-svg-symbols/issues"},"homepage":"https://github.com/Hiswe/gulp-svg-symbols","dependencies":{"ansi-grey":"^0.1.1","ansi-yellow":"^0.1.1","cheerio":"^1.0.0-rc.2","consolidate":"^0.15.1","fancy-log":"^1.3.2","lodash":"^4.17.10","plugin-error":"^1.0.1","speakingurl":"^14.0.1","through2":"^2.0.1","vinyl":"^2.2.0"},"devDependencies":{"ava":"^1.0.0-beta.6","doctoc":"^1.3.1","event-stream":"^3.3.2","gulp":"^4.0.0","intercept-stdout":"^0.1.2","prettier":"^1.13.7"},"gitHead":"48b305c114f2c831b66218f623e6c9e964c1aebd","_id":"gulp-svg-symbols@3.2.0","_npmVersion":"5.6.0","_nodeVersion":"8.11.3","_npmUser":{"name":"hiswe","email":"hiswehalya@gmail.com"},"dist":{"shasum":"a6b8c8b0bebcf6040be10da2dede25e31bb9f371","size":59770,"noattachment":false,"key":"/gulp-svg-symbols/-/gulp-svg-symbols-3.2.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/gulp-svg-symbols/download/gulp-svg-symbols-3.2.0.tgz"},"maintainers":[{"name":"hiswe","email":""}],"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/gulp-svg-symbols_3.2.0_1532502924042_0.7055189984060113"},"_hasShrinkwrap":false,"publish_time":1532502924157,"_cnpm_publish_time":1532502924157,"_cnpmcore_publish_time":"2021-12-16T22:30:59.611Z"},"3.1.1":{"name":"gulp-svg-symbols","version":"3.1.1","description":"Convert SVG files to symbols with gulp","main":"index.js","scripts":{"lint":"gulp lint","test":"ava test/*.js","watch":"gulp watch","toc":"gulp toc","release":"np"},"repository":{"type":"git","url":"git+https://github.com/Hiswe/gulp-svg-symbols.git"},"keywords":["gulpplugin","svg","symbols"],"author":{"name":"Yannick Aïvayan","email":"yannick.aivayan@hiswe.net","url":"http://hiswe.net"},"license":"MIT","bugs":{"url":"https://github.com/Hiswe/gulp-svg-symbols/issues"},"homepage":"https://github.com/Hiswe/gulp-svg-symbols","dependencies":{"ansi-grey":"^0.1.1","ansi-yellow":"^0.1.1","cheerio":"^0.22.0","consolidate":"^0.15.1","fancy-log":"^1.3.2","lodash":"^4.17.10","plugin-error":"^1.0.1","speakingurl":"^14.0.1","through2":"^2.0.1","vinyl":"^2.1.0"},"devDependencies":{"ava":"^1.0.0-beta.4","event-stream":"^3.3.2","gulp":"^4.0.0","gulp-cached":"^1.1.1","gulp-doctoc":"^0.1.4","gulp-eslint":"^4.0.2","intercept-stdout":"^0.1.2"},"gitHead":"e9ef46f21f0e3cffb656c03ee3e8d7177f6519a7","_id":"gulp-svg-symbols@3.1.1","_npmVersion":"5.6.0","_nodeVersion":"8.10.0","_npmUser":{"name":"hiswe","email":"hiswehalya@gmail.com"},"dist":{"shasum":"5653ba9685479e0d2518d0823ba1d83e299f757a","size":70055,"noattachment":false,"key":"/gulp-svg-symbols/-/gulp-svg-symbols-3.1.1.tgz","tarball":"http://registry.cnpm.dingdandao.com/gulp-svg-symbols/download/gulp-svg-symbols-3.1.1.tgz"},"maintainers":[{"name":"hiswe","email":""}],"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/gulp-svg-symbols_3.1.1_1525694357938_0.06675419699749785"},"_hasShrinkwrap":false,"publish_time":1525694358097,"_cnpm_publish_time":1525694358097,"_cnpmcore_publish_time":"2021-12-16T22:30:59.932Z"},"3.1.0":{"name":"gulp-svg-symbols","version":"3.1.0","description":"Convert SVG files to symbols with gulp","main":"index.js","scripts":{"lint":"gulp lint","test":"ava test/*.js","watch":"gulp watch","toc":"gulp toc","publish":"npx np"},"repository":{"type":"git","url":"https://github.com/Hiswe/gulp-svg-symbols.git"},"keywords":["gulpplugin","svg","symbols"],"author":{"name":"Yannick Aïvayan","email":"yannick.aivayan@hiswe.net","url":"http://hiswe.net"},"license":"WTFPL","bugs":{"url":"https://github.com/Hiswe/gulp-svg-symbols/issues"},"homepage":"https://github.com/Hiswe/gulp-svg-symbols","dependencies":{"ansi-grey":"^0.1.1","ansi-yellow":"^0.1.1","cheerio":"^0.22.0","consolidate":"^0.15.0","fancy-log":"^1.3.2","lodash":"^4.11.1","plugin-error":"^0.1.2","speakingurl":"^14.0.1","through2":"^2.0.1","vinyl":"^2.1.0"},"devDependencies":{"ava":"^1.0.0-beta.1","event-stream":"^3.3.2","gulp":"gulpjs/gulp.git#4.0","gulp-cached":"^1.1.1","gulp-doctoc":"^0.1.4","gulp-eslint":"^4.0.0","intercept-stdout":"^0.1.2"},"_id":"gulp-svg-symbols@3.1.0","dist":{"shasum":"9869d78e8e93acac84c4818d1622c076a9748e98","size":15809,"noattachment":false,"key":"/gulp-svg-symbols/-/gulp-svg-symbols-3.1.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/gulp-svg-symbols/download/gulp-svg-symbols-3.1.0.tgz"},"maintainers":[{"name":"hiswe","email":""}],"_npmUser":{"name":"hiswe","email":"hiswehalya@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/gulp-svg-symbols_3.1.0_1518245790058_0.3201283847016154"},"_hasShrinkwrap":false,"publish_time":1518245790115,"_cnpm_publish_time":1518245790115,"_cnpmcore_publish_time":"2021-12-16T22:31:00.577Z"},"3.0.2":{"name":"gulp-svg-symbols","version":"3.0.2","description":"Convert SVG files to symbols with gulp","main":"index.js","scripts":{"lint":"gulp lint","test":"gulp test","watch":"gulp watch","toc":"gulp toc","publish":"npx np"},"repository":{"type":"git","url":"https://github.com/Hiswe/gulp-svg-symbols.git"},"keywords":["gulpplugin","svg","symbols"],"author":{"name":"Yannick Aïvayan","email":"yannick.aivayan@hiswe.net","url":"http://hiswe.net"},"license":"WTFPL","bugs":{"url":"https://github.com/Hiswe/gulp-svg-symbols/issues"},"homepage":"https://github.com/Hiswe/gulp-svg-symbols","dependencies":{"ansi-grey":"^0.1.1","ansi-yellow":"^0.1.1","cheerio":"^0.22.0","consolidate":"^0.15.0","fancy-log":"^1.3.2","lodash":"^4.11.1","plugin-error":"^0.1.2","speakingurl":"^14.0.1","through2":"^2.0.1","vinyl":"^2.1.0"},"devDependencies":{"event-stream":"^3.3.2","gulp":"gulpjs/gulp.git#4.0","gulp-cached":"^1.1.1","gulp-doctoc":"^0.1.4","gulp-eslint":"^4.0.0","gulp-jasmine":"^3.0.0"},"_id":"gulp-svg-symbols@3.0.2","dist":{"shasum":"cafb37c81dac353bf67ccfdb4c8a2fc41fff4088","size":14878,"noattachment":false,"key":"/gulp-svg-symbols/-/gulp-svg-symbols-3.0.2.tgz","tarball":"http://registry.cnpm.dingdandao.com/gulp-svg-symbols/download/gulp-svg-symbols-3.0.2.tgz"},"maintainers":[{"name":"hiswe","email":""}],"_npmUser":{"name":"hiswe","email":"hiswehalya@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/gulp-svg-symbols_3.0.2_1518085691938_0.04706800349823448"},"_hasShrinkwrap":false,"publish_time":1518085692180,"_cnpm_publish_time":1518085692180,"_cnpmcore_publish_time":"2021-12-16T22:31:01.173Z"},"3.0.1":{"name":"gulp-svg-symbols","version":"3.0.1","description":"Convert SVG files to symbols with gulp","main":"index.js","scripts":{"lint":"gulp lint","test":"gulp test","watch":"gulp watch","toc":"gulp toc","publish":"np"},"repository":{"type":"git","url":"https://github.com/Hiswe/gulp-svg-symbols.git"},"keywords":["gulpplugin","svg","symbols"],"author":{"name":"Yannick Aïvayan","email":"yannick.aivayan@hiswe.net","url":"http://hiswe.net"},"license":"WTFPL","bugs":{"url":"https://github.com/Hiswe/gulp-svg-symbols/issues"},"homepage":"https://github.com/Hiswe/gulp-svg-symbols","dependencies":{"ansi-grey":"^0.1.1","ansi-yellow":"^0.1.1","cheerio":"^0.22.0","consolidate":"^0.15.0","fancy-log":"^1.3.2","lodash":"^4.11.1","plugin-error":"^0.1.2","speakingurl":"^14.0.1","through2":"^2.0.1","vinyl":"^2.1.0"},"devDependencies":{"event-stream":"^3.3.2","gulp":"gulpjs/gulp.git#4.0","gulp-cached":"^1.1.1","gulp-doctoc":"^0.1.4","gulp-eslint":"^4.0.0","gulp-jasmine":"^3.0.0","np":"^2.19.0"},"_id":"gulp-svg-symbols@3.0.1","dist":{"shasum":"4fcafd3a30b75e5d7e0b1ea35a7cd04694ffc85c","size":14886,"noattachment":false,"key":"/gulp-svg-symbols/-/gulp-svg-symbols-3.0.1.tgz","tarball":"http://registry.cnpm.dingdandao.com/gulp-svg-symbols/download/gulp-svg-symbols-3.0.1.tgz"},"maintainers":[{"name":"hiswe","email":""}],"_npmUser":{"name":"hiswe","email":"hiswehalya@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/gulp-svg-symbols_3.0.1_1518085339954_0.7780297481248919"},"_hasShrinkwrap":false,"publish_time":1518085340034,"_cnpm_publish_time":1518085340034,"_cnpmcore_publish_time":"2021-12-16T22:31:01.443Z"},"3.0.0":{"name":"gulp-svg-symbols","version":"3.0.0","description":"Convert SVG files to symbols with gulp","main":"index.js","scripts":{"lint":"gulp lint","test":"gulp test","watch":"gulp watch","toc":"gulp toc"},"repository":{"type":"git","url":"git+https://github.com/Hiswe/gulp-svg-symbols.git"},"keywords":["gulpplugin","svg","symbols"],"author":{"name":"Yannick Aïvayan","email":"yannick.aivayan@hiswe.net","url":"http://hiswe.net"},"license":"WTFPL","bugs":{"url":"https://github.com/Hiswe/gulp-svg-symbols/issues"},"homepage":"https://github.com/Hiswe/gulp-svg-symbols","dependencies":{"ansi-grey":"^0.1.1","ansi-yellow":"^0.1.1","cheerio":"^0.22.0","consolidate":"^0.15.0","fancy-log":"^1.3.2","lodash":"^4.11.1","plugin-error":"^0.1.2","speakingurl":"^14.0.1","through2":"^2.0.1","vinyl":"^2.1.0"},"devDependencies":{"event-stream":"^3.3.2","gulp":"github:gulpjs/gulp#4.0","gulp-cached":"^1.1.1","gulp-doctoc":"^0.1.4","gulp-eslint":"^4.0.0","gulp-jasmine":"^3.0.0"},"gitHead":"545de7d416bf12b8643d3c25f1098afa725756bd","_id":"gulp-svg-symbols@3.0.0","_npmVersion":"5.5.1","_nodeVersion":"8.9.2","_npmUser":{"name":"hiswe","email":"hiswehalya@gmail.com"},"maintainers":[{"name":"hiswe","email":""}],"dist":{"shasum":"d8e27256754f3538e3cf1248d85fa428e0eaf50e","size":53317,"noattachment":false,"key":"/gulp-svg-symbols/-/gulp-svg-symbols-3.0.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/gulp-svg-symbols/download/gulp-svg-symbols-3.0.0.tgz"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/gulp-svg-symbols-3.0.0.tgz_1515221444644_0.06767590437084436"},"directories":{},"publish_time":1515221444727,"_hasShrinkwrap":false,"_cnpm_publish_time":1515221444727,"_cnpmcore_publish_time":"2021-12-16T22:31:01.746Z"},"2.0.2":{"name":"gulp-svg-symbols","version":"2.0.2","description":"Convert SVG files to symbols with gulp","main":"index.js","scripts":{"hint":"gulp hint","test":"gulp test"},"repository":{"type":"git","url":"git+https://github.com/Hiswe/gulp-svg-symbols.git"},"keywords":["gulpplugin","svg","symbols"],"author":{"name":"Yannick Aïvayan","email":"yannick.aivayan@hiswe.net","url":"http://hiswe.net"},"license":"WTFPL","bugs":{"url":"https://github.com/Hiswe/gulp-svg-symbols/issues"},"homepage":"https://github.com/Hiswe/gulp-svg-symbols","dependencies":{"bluebird":"^3.3.5","cheerio":"^0.22.0","consolidate":"^0.14.1","gulp-util":"^3.0.7","lodash":"^4.11.1","speakingurl":"^10.0.0","through2":"^2.0.1"},"devDependencies":{"event-stream":"^3.3.2","gulp":"^3.9.1","gulp-doctoc":"^0.1.4","gulp-jasmine":"^2.3.0","gulp-jsbeautifier":"^2.0.3","gulp-jscs":"^4.0.0","gulp-jshint":"^2.0.2","jshint":"^2.9.4","jshint-stylish":"^2.1.0"},"gitHead":"520fcbcb874d1c5f65353aa5ac25921fac71bad4","_id":"gulp-svg-symbols@2.0.2","_shasum":"1dc9867fbd1842e543d5510e947914cb24295f9d","_from":".","_npmVersion":"3.10.8","_nodeVersion":"6.9.1","_npmUser":{"name":"hiswe","email":"hiswehalya@gmail.com"},"maintainers":[{"name":"hiswe","email":""}],"dist":{"shasum":"1dc9867fbd1842e543d5510e947914cb24295f9d","size":9923,"noattachment":false,"key":"/gulp-svg-symbols/-/gulp-svg-symbols-2.0.2.tgz","tarball":"http://registry.cnpm.dingdandao.com/gulp-svg-symbols/download/gulp-svg-symbols-2.0.2.tgz"},"_npmOperationalInternal":{"host":"packages-12-west.internal.npmjs.com","tmp":"tmp/gulp-svg-symbols-2.0.2.tgz_1478335271759_0.16658800863660872"},"directories":{},"publish_time":1478335271991,"_hasShrinkwrap":false,"_cnpm_publish_time":1478335271991,"_cnpmcore_publish_time":"2021-12-16T22:31:01.944Z"},"2.0.1":{"name":"gulp-svg-symbols","version":"2.0.1","description":"Convert SVG files to symbols with gulp","main":"index.js","scripts":{"hint":"gulp hint","test":"gulp test"},"repository":{"type":"git","url":"git+https://github.com/Hiswe/gulp-svg-symbols.git"},"keywords":["gulpplugin","svg","symbols"],"author":{"name":"Yannick Aïvayan","email":"yannick.aivayan@hiswe.net","url":"http://hiswe.net"},"license":"WTFPL","bugs":{"url":"https://github.com/Hiswe/gulp-svg-symbols/issues"},"homepage":"https://github.com/Hiswe/gulp-svg-symbols","dependencies":{"bluebird":"^3.3.5","cheerio":"^0.22.0","consolidate":"^0.14.1","gulp-util":"^3.0.7","lodash":"^4.11.1","speakingurl":"^10.0.0","through2":"^2.0.1"},"devDependencies":{"event-stream":"^3.3.2","gulp":"^3.9.1","gulp-doctoc":"^0.1.4","gulp-jasmine":"^2.3.0","gulp-jsbeautifier":"^2.0.3","gulp-jscs":"^4.0.0","gulp-jshint":"^2.0.2","jshint":"^2.9.4","jshint-stylish":"^2.1.0"},"gitHead":"69760019e14c4f48113182c72e042816c58dd542","_id":"gulp-svg-symbols@2.0.1","_shasum":"552e727f2de7d5fef2d17d3ab606a753e5558739","_from":".","_npmVersion":"3.10.8","_nodeVersion":"6.9.1","_npmUser":{"name":"hiswe","email":"hiswehalya@gmail.com"},"maintainers":[{"name":"hiswe","email":""}],"dist":{"shasum":"552e727f2de7d5fef2d17d3ab606a753e5558739","size":9869,"noattachment":false,"key":"/gulp-svg-symbols/-/gulp-svg-symbols-2.0.1.tgz","tarball":"http://registry.cnpm.dingdandao.com/gulp-svg-symbols/download/gulp-svg-symbols-2.0.1.tgz"},"_npmOperationalInternal":{"host":"packages-18-east.internal.npmjs.com","tmp":"tmp/gulp-svg-symbols-2.0.1.tgz_1477562600777_0.2855465654283762"},"directories":{},"publish_time":1477562604759,"_hasShrinkwrap":false,"_cnpm_publish_time":1477562604759,"_cnpmcore_publish_time":"2021-12-16T22:31:02.210Z"},"2.0.0":{"name":"gulp-svg-symbols","version":"2.0.0","description":"Convert SVG files to symbols with gulp","main":"index.js","scripts":{"hint":"gulp hint","test":"gulp test"},"repository":{"type":"git","url":"git+https://github.com/Hiswe/gulp-svg-symbols.git"},"keywords":["gulpplugin","svg","symbols"],"author":{"name":"Yannick Aïvayan","email":"yannick.aivayan@hiswe.net","url":"http://hiswe.net"},"license":"WTFPL","bugs":{"url":"https://github.com/Hiswe/gulp-svg-symbols/issues"},"homepage":"https://github.com/Hiswe/gulp-svg-symbols","dependencies":{"bluebird":"^3.3.5","cheerio":"^0.20.0","consolidate":"^0.14.1","gulp-util":"^3.0.7","lodash":"^4.11.1","speakingurl":"^9.0.0","through2":"^2.0.1"},"devDependencies":{"event-stream":"^3.3.2","gulp":"^3.9.1","gulp-doctoc":"^0.1.4","gulp-jasmine":"^2.3.0","gulp-jsbeautifier":"^2.0.3","gulp-jscs":"^4.0.0","gulp-jshint":"^2.0.0","jshint":"^2.9.2","jshint-stylish":"^2.1.0"},"gitHead":"a03d3f084bed35a2e050db4ed1c8e6d793e47cba","_id":"gulp-svg-symbols@2.0.0","_shasum":"91feacc3598613c729acac313a03bb292fa5b4c1","_from":".","_npmVersion":"3.8.6","_nodeVersion":"5.12.0","_npmUser":{"name":"hiswe","email":"hiswehalya@gmail.com"},"maintainers":[{"name":"hiswe","email":""}],"dist":{"shasum":"91feacc3598613c729acac313a03bb292fa5b4c1","size":9855,"noattachment":false,"key":"/gulp-svg-symbols/-/gulp-svg-symbols-2.0.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/gulp-svg-symbols/download/gulp-svg-symbols-2.0.0.tgz"},"_npmOperationalInternal":{"host":"packages-12-west.internal.npmjs.com","tmp":"tmp/gulp-svg-symbols-2.0.0.tgz_1471327010644_0.9101686726789922"},"directories":{},"publish_time":1471327010907,"_hasShrinkwrap":false,"_cnpm_publish_time":1471327010907,"_cnpmcore_publish_time":"2021-12-16T22:31:02.432Z"},"1.0.0":{"name":"gulp-svg-symbols","version":"1.0.0","description":"Convert SVG files to symbols with gulp","main":"index.js","scripts":{"hint":"gulp hint","test":"gulp test"},"repository":{"type":"git","url":"https://github.com/Hiswe/gulp-svg-symbols.git"},"keywords":["gulpplugin","svg","symbols"],"author":{"name":"Yannick Aïvayan","email":"yannick.aivayan@hiswe.net","url":"http://hiswe.net"},"license":"WTFPL","bugs":{"url":"https://github.com/Hiswe/gulp-svg-symbols/issues"},"homepage":"https://github.com/Hiswe/gulp-svg-symbols","dependencies":{"bluebird":"^2.3.2","cheerio":"^0.19.0","consolidate":"^0.13.1","gulp-util":"^3.0.1","lodash":"^3.10.1","slug":"^0.9.1","through2":"^2.0.0"},"devDependencies":{"event-stream":"^3.1.7","gulp":"^3.8.5","gulp-jasmine":"^2.1.0","gulp-jsbeautifier":"^1.0.1","gulp-jscs":"^3.0.0","gulp-jshint":"^1.8.4","jshint-stylish":"^2.0.1"},"gitHead":"f9b9891c85468cd3a78394fb0b86002d28122bc6","_id":"gulp-svg-symbols@1.0.0","_shasum":"b4cd57c6ad22dc7e5c2e5690ed563237fe20cf43","_from":".","_npmVersion":"2.7.1","_nodeVersion":"0.12.0","_npmUser":{"name":"hiswe","email":"hiswehalya@gmail.com"},"maintainers":[{"name":"hiswe","email":""}],"dist":{"shasum":"b4cd57c6ad22dc7e5c2e5690ed563237fe20cf43","size":8461,"noattachment":false,"key":"/gulp-svg-symbols/-/gulp-svg-symbols-1.0.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/gulp-svg-symbols/download/gulp-svg-symbols-1.0.0.tgz"},"directories":{},"publish_time":1443620100505,"_hasShrinkwrap":false,"_cnpm_publish_time":1443620100505,"_cnpmcore_publish_time":"2021-12-16T22:31:02.674Z"},"0.3.2":{"name":"gulp-svg-symbols","version":"0.3.2","description":"Convert SVG files to symbols with gulp","main":"index.js","scripts":{"test":"gulp test"},"repository":{"type":"git","url":"https://github.com/Hiswe/gulp-svg-symbols.git"},"keywords":["gulpplugin","svg","symbols"],"author":{"name":"Yannick Aïvayan","email":"yannick.aivayan@hiswe.net","url":"http://hiswe.net"},"license":"WTFPL","bugs":{"url":"https://github.com/Hiswe/gulp-svg-symbols/issues"},"homepage":"https://github.com/Hiswe/gulp-svg-symbols","dependencies":{"bluebird":"^2.3.2","consolidate":"^0.13.1","gulp-util":"^3.0.1","lodash":"^3.10.1","mathjs":"^2.3.0","svgo":"^0.5.6","through2":"^2.0.0"},"devDependencies":{"event-stream":"^3.1.7","gulp":"^3.8.5","gulp-jasmine":"^2.1.0","gulp-jshint":"^1.8.4","jshint-stylish":"^2.0.1"},"gitHead":"85f4ca728e99a172da1acabcc3cf68e9be62512d","_id":"gulp-svg-symbols@0.3.2","_shasum":"a17fc3d5d7e3b094e32d20e0df995f4ef24f78b2","_from":".","_npmVersion":"2.7.1","_nodeVersion":"0.12.0","_npmUser":{"name":"hiswe","email":"hiswehalya@gmail.com"},"maintainers":[{"name":"hiswe","email":""}],"dist":{"shasum":"a17fc3d5d7e3b094e32d20e0df995f4ef24f78b2","size":7475,"noattachment":false,"key":"/gulp-svg-symbols/-/gulp-svg-symbols-0.3.2.tgz","tarball":"http://registry.cnpm.dingdandao.com/gulp-svg-symbols/download/gulp-svg-symbols-0.3.2.tgz"},"directories":{},"publish_time":1442928072833,"_hasShrinkwrap":false,"_cnpm_publish_time":1442928072833,"_cnpmcore_publish_time":"2021-12-16T22:31:02.871Z"},"0.3.1":{"name":"gulp-svg-symbols","version":"0.3.1","description":"Convert SVG files to symbols with gulp","main":"index.js","scripts":{"test":"gulp test"},"repository":{"type":"git","url":"https://github.com/Hiswe/gulp-svg-symbols.git"},"keywords":["gulpplugin","svg","symbols"],"author":{"name":"Yannick Aïvayan","email":"yannick.aivayan@hiswe.net","url":"http://hiswe.net"},"license":"WTFPL","bugs":{"url":"https://github.com/Hiswe/gulp-svg-symbols/issues"},"homepage":"https://github.com/Hiswe/gulp-svg-symbols","dependencies":{"consolidate":"^0.10.0","lodash":"^2.4.1","through2":"^0.6.1","svgo":"^0.4.5","gulp-util":"^3.0.1","bluebird":"^2.3.2","mathjs":"^1.0.0"},"devDependencies":{"gulp":"^3.8.5","gulp-jasmine":"^1.0.0","event-stream":"^3.1.7","gulp-jshint":"^1.8.4","jshint-stylish":"^0.4.0"},"_id":"gulp-svg-symbols@0.3.1","dist":{"shasum":"83e15fc1580df177ad1f45e7966412067749e615","size":5882,"noattachment":false,"key":"/gulp-svg-symbols/-/gulp-svg-symbols-0.3.1.tgz","tarball":"http://registry.cnpm.dingdandao.com/gulp-svg-symbols/download/gulp-svg-symbols-0.3.1.tgz"},"_from":".","_npmVersion":"1.4.3","_npmUser":{"name":"hiswe","email":"hiswehalya@gmail.com"},"maintainers":[{"name":"hiswe","email":""}],"directories":{},"publish_time":1412342725204,"_hasShrinkwrap":false,"_cnpm_publish_time":1412342725204,"_cnpmcore_publish_time":"2021-12-16T22:31:03.073Z"},"0.3.0":{"name":"gulp-svg-symbols","version":"0.3.0","description":"Convert SVG files to symbols with gulp","main":"index.js","scripts":{"test":"gulp test"},"repository":{"type":"git","url":"https://github.com/Hiswe/gulp-svg-symbols.git"},"keywords":["gulpplugin","svg","symbols"],"author":{"name":"Yannick Aïvayan","email":"yannick.aivayan@hiswe.net","url":"http://hiswe.net"},"license":"WTFPL","bugs":{"url":"https://github.com/Hiswe/gulp-svg-symbols/issues"},"homepage":"https://github.com/Hiswe/gulp-svg-symbols","dependencies":{"consolidate":"^0.10.0","lodash":"^2.4.1","through2":"^0.6.1","svgo":"^0.4.5","gulp-util":"^3.0.1","bluebird":"^2.3.2","mathjs":"^1.0.0"},"devDependencies":{"gulp":"^3.8.5","gulp-jasmine":"^1.0.0","event-stream":"^3.1.7","gulp-jshint":"^1.8.4","jshint-stylish":"^0.4.0"},"_id":"gulp-svg-symbols@0.3.0","dist":{"shasum":"1f163258db53b24e210533ffe80428dbaaa9d858","size":21587,"noattachment":false,"key":"/gulp-svg-symbols/-/gulp-svg-symbols-0.3.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/gulp-svg-symbols/download/gulp-svg-symbols-0.3.0.tgz"},"_from":".","_npmVersion":"1.4.3","_npmUser":{"name":"hiswe","email":"hiswehalya@gmail.com"},"maintainers":[{"name":"hiswe","email":""}],"directories":{},"publish_time":1412341710524,"_hasShrinkwrap":false,"_cnpm_publish_time":1412341710524,"_cnpmcore_publish_time":"2021-12-16T22:31:03.378Z"},"0.2.1":{"name":"gulp-svg-symbols","version":"0.2.1","description":"Convert SVG files to symbols with gulp","main":"index.js","scripts":{"test":"gulp test"},"repository":{"type":"git","url":"https://github.com/Hiswe/gulp-svg-symbols.git"},"keywords":["gulpplugin","svg","symbols"],"author":{"name":"Yannick Aïvayan","email":"yannick.aivayan@hiswe.net","url":"http://hiswe.net"},"license":"WTFPL","bugs":{"url":"https://github.com/Hiswe/gulp-svg-symbols/issues"},"homepage":"https://github.com/Hiswe/gulp-svg-symbols","dependencies":{"consolidate":"^0.10.0","lodash":"^2.4.1","through2":"^0.6.1","svgo":"^0.4.5","gulp-util":"^3.0.1","bluebird":"^2.3.2","mathjs":"^1.0.0"},"devDependencies":{"gulp":"^3.8.5","gulp-jasmine":"^1.0.0","event-stream":"^3.1.7","gulp-jshint":"^1.8.4","jshint-stylish":"^0.4.0"},"_id":"gulp-svg-symbols@0.2.1","dist":{"shasum":"074c358c4473522ce3894005eab17bd4a9ff1d99","size":21056,"noattachment":false,"key":"/gulp-svg-symbols/-/gulp-svg-symbols-0.2.1.tgz","tarball":"http://registry.cnpm.dingdandao.com/gulp-svg-symbols/download/gulp-svg-symbols-0.2.1.tgz"},"_from":".","_npmVersion":"1.4.3","_npmUser":{"name":"hiswe","email":"hiswehalya@gmail.com"},"maintainers":[{"name":"hiswe","email":""}],"directories":{},"publish_time":1411722774155,"_hasShrinkwrap":false,"_cnpm_publish_time":1411722774155,"_cnpmcore_publish_time":"2021-12-16T22:31:03.610Z"},"0.1.5":{"name":"gulp-svg-symbols","version":"0.1.5","description":"Convert SVG files to symbols with gulp","main":"index.js","scripts":{"test":"gulp test"},"repository":{"type":"git","url":"https://github.com/Hiswe/gulp-svg-symbols.git"},"keywords":["gulpplugin","svg","symbols"],"author":{"name":"Yannick Aïvayan","email":"yannick.aivayan@hiswe.net","url":"http://hiswe.net"},"license":"WTFPL","bugs":{"url":"https://github.com/Hiswe/gulp-svg-symbols/issues"},"homepage":"https://github.com/Hiswe/gulp-svg-symbols","dependencies":{"consolidate":"^0.10.0","lodash":"^2.4.1","through2":"^0.5.1","svgo":"^0.4.4","gulp-util":"^2.2.17","bluebird":"^2.1.3","mathjs":"^0.25.0"},"devDependencies":{"gulp":"^3.8.1","gulp-jasmine":"^0.2.0","event-stream":"^3.1.5","gulp-jshint":"^1.6.3","jshint-stylish":"^0.2.0"},"_id":"gulp-svg-symbols@0.1.5","dist":{"shasum":"e5f59483e9d46c6ba2da57858051ae89e839ba6b","size":15413,"noattachment":false,"key":"/gulp-svg-symbols/-/gulp-svg-symbols-0.1.5.tgz","tarball":"http://registry.cnpm.dingdandao.com/gulp-svg-symbols/download/gulp-svg-symbols-0.1.5.tgz"},"_from":".","_npmVersion":"1.4.3","_npmUser":{"name":"hiswe","email":"hiswehalya@gmail.com"},"maintainers":[{"name":"hiswe","email":""}],"directories":{},"publish_time":1407248080080,"_hasShrinkwrap":false,"_cnpm_publish_time":1407248080080,"_cnpmcore_publish_time":"2021-12-16T22:31:04.145Z"},"0.1.2":{"name":"gulp-svg-symbols","version":"0.1.2","description":"Convert SVG files to symbols with gulp","main":"index.js","scripts":{"test":"gulp test"},"repository":{"type":"git","url":"https://github.com/Hiswe/gulp-svg-symbols.git"},"keywords":["gulpplugin","svg","symbols"],"author":{"name":"Yannick Aïvayan","email":"yannick.aivayan@hiswe.net","url":"http://hiswe.net"},"license":"WTFPL","bugs":{"url":"https://github.com/Hiswe/gulp-svg-symbols/issues"},"homepage":"https://github.com/Hiswe/gulp-svg-symbols","dependencies":{"consolidate":"^0.10.0","lodash":"^2.4.1","through2":"^0.5.1","svgo":"^0.4.4","gulp-util":"^2.2.17","bluebird":"^2.1.3"},"devDependencies":{"gulp":"^3.8.1","gulp-jasmine":"^0.2.0","event-stream":"^3.1.5","gulp-jshint":"^1.6.3","jshint-stylish":"^0.2.0"},"_id":"gulp-svg-symbols@0.1.2","dist":{"shasum":"0e44b7ee45f2d493a71dc4cf05f24319fe526837","size":8687,"noattachment":false,"key":"/gulp-svg-symbols/-/gulp-svg-symbols-0.1.2.tgz","tarball":"http://registry.cnpm.dingdandao.com/gulp-svg-symbols/download/gulp-svg-symbols-0.1.2.tgz"},"_from":".","_npmVersion":"1.4.3","_npmUser":{"name":"hiswe","email":"hiswehalya@gmail.com"},"maintainers":[{"name":"hiswe","email":""}],"directories":{},"publish_time":1403411723722,"_hasShrinkwrap":false,"_cnpm_publish_time":1403411723722,"_cnpmcore_publish_time":"2021-12-16T22:31:04.728Z"},"0.1.1":{"name":"gulp-svg-symbols","version":"0.1.1","description":"Convert SVG files to symbols with gulp","main":"index.js","scripts":{"test":"gulp test"},"repository":{"type":"git","url":"https://github.com/Hiswe/gulp-svg-symbols.git"},"keywords":["gulpplugin","svg","symbols"],"author":{"name":"Yannick Aïvayan","email":"yannick.aivayan@hiswe.net","url":"http://hiswe.net"},"license":"WTFPL","bugs":{"url":"https://github.com/Hiswe/gulp-svg-symbols/issues"},"homepage":"https://github.com/Hiswe/gulp-svg-symbols","dependencies":{"consolidate":"^0.10.0","lodash":"^2.4.1","through2":"^0.5.1","svgo":"^0.4.4","gulp-util":"^2.2.17","bluebird":"^2.1.2"},"devDependencies":{"gulp":"^3.8.0","gulp-jasmine":"^0.2.0","event-stream":"^3.1.5","gulp-jshint":"^1.6.3","jshint-stylish":"^0.2.0"},"_id":"gulp-svg-symbols@0.1.1","dist":{"shasum":"0a1a4e503fe6828a3ca46cf025cbc8011a87880a","size":8461,"noattachment":false,"key":"/gulp-svg-symbols/-/gulp-svg-symbols-0.1.1.tgz","tarball":"http://registry.cnpm.dingdandao.com/gulp-svg-symbols/download/gulp-svg-symbols-0.1.1.tgz"},"_from":".","_npmVersion":"1.4.3","_npmUser":{"name":"hiswe","email":"hiswehalya@gmail.com"},"maintainers":[{"name":"hiswe","email":""}],"directories":{},"publish_time":1403097641778,"_hasShrinkwrap":false,"_cnpm_publish_time":1403097641778,"_cnpmcore_publish_time":"2021-12-16T22:31:04.963Z"},"0.1.0":{"name":"gulp-svg-symbols","version":"0.1.0","description":"Convert SVG files to symbols with gulp","main":"index.js","scripts":{"test":"gulp test"},"repository":{"type":"git","url":"https://github.com/Hiswe/gulp-svg-symbols.git"},"keywords":["gulpplugin","svg","symbols"],"author":{"name":"Yannick Aïvayan","email":"yannick.aivayan@hiswe.net","url":"http://hiswe.net"},"license":"WTFPL","bugs":{"url":"https://github.com/Hiswe/gulp-svg-symbols/issues"},"homepage":"https://github.com/Hiswe/gulp-svg-symbols","dependencies":{"consolidate":"^0.10.0","lodash":"^2.4.1","through2":"^0.5.1","svgo":"^0.4.4","gulp-util":"^2.2.17","bluebird":"^2.1.2"},"devDependencies":{"gulp":"^3.8.0","gulp-jasmine":"^0.2.0","event-stream":"^3.1.5"},"_id":"gulp-svg-symbols@0.1.0","dist":{"shasum":"328b997c0cd91fab3dbebd7d8e855f2216cec3df","size":8112,"noattachment":false,"key":"/gulp-svg-symbols/-/gulp-svg-symbols-0.1.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/gulp-svg-symbols/download/gulp-svg-symbols-0.1.0.tgz"},"_from":".","_npmVersion":"1.4.3","_npmUser":{"name":"hiswe","email":"hiswehalya@gmail.com"},"maintainers":[{"name":"hiswe","email":""}],"directories":{},"publish_time":1403087797057,"_hasShrinkwrap":false,"_cnpm_publish_time":1403087797057,"_cnpmcore_publish_time":"2021-12-16T22:31:05.178Z"},"0.0.2":{"name":"gulp-svg-symbols","version":"0.0.2","description":"Convert SVG files to symbols with gulp","main":"index.js","scripts":{"test":"gulp test"},"repository":{"type":"git","url":"https://github.com/Hiswe/gulp-svg-symbols.git"},"keywords":["gulpplugin","svg","symbols"],"author":{"name":"Yannick Aïvayan","email":"yannick.aivayan@hiswe.net","url":"http://hiswe.net"},"license":"WTFPL","bugs":{"url":"https://github.com/Hiswe/gulp-svg-symbols/issues"},"homepage":"https://github.com/Hiswe/gulp-svg-symbols","dependencies":{"consolidate":"^0.10.0","lodash":"^2.4.1","through2":"^0.5.1","svgo":"^0.4.4","gulp-util":"^2.2.17"},"devDependencies":{"gulp":"^3.8.0","gulp-jasmine":"^0.2.0"},"_id":"gulp-svg-symbols@0.0.2","dist":{"shasum":"cbc7e350b17193005e502556adb7bdacd3ee3668","size":7402,"noattachment":false,"key":"/gulp-svg-symbols/-/gulp-svg-symbols-0.0.2.tgz","tarball":"http://registry.cnpm.dingdandao.com/gulp-svg-symbols/download/gulp-svg-symbols-0.0.2.tgz"},"_from":".","_npmVersion":"1.4.3","_npmUser":{"name":"hiswe","email":"hiswehalya@gmail.com"},"maintainers":[{"name":"hiswe","email":""}],"directories":{},"publish_time":1402893956998,"_hasShrinkwrap":false,"_cnpm_publish_time":1402893956998,"_cnpmcore_publish_time":"2021-12-16T22:31:05.464Z"}},"readme":"# gulp-svg-symbols\n\n[![npm version](https://badge.fury.io/js/gulp-svg-symbols.svg)](https://badge.fury.io/js/gulp-svg-symbols) [![Build Status](https://travis-ci.org/Hiswe/gulp-svg-symbols.svg?branch=master)](https://travis-ci.org/Hiswe/gulp-svg-symbols)\n\n_gulp-svg-symbols_ is a minimal plugin for [gulp](http://gulpjs.com).  \nIt converts a bunch of svg files to a single svg file containing each one as a symbol.  \nSee [css-trick](http://css-tricks.com/svg-symbol-good-choice-icons/) for more details.\n\n<!-- START doctoc generated TOC please keep comment here to allow auto update -->\n<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->\n\n\n- [Install](#install)\n- [Example](#example)\n- [Options](#options)\n  - [Basics](#basics)\n    - [id and class](#id-and-class)\n    - [fontSize](#fontsize)\n    - [title](#title)\n    - [svgAttrs](#svgattrs)\n    - [slug](#slug)\n    - [templates](#templates)\n      - [CSS generation](#css-generation)\n    - [warn](#warn)\n  - [Advanced](#advanced)\n    - [templates](#templates-1)\n    - [transformData](#transformdata)\n  - [Other observations](#other-observations)\n- [Other stuff](#other-stuff)\n  - [Rendering caveats](#rendering-caveats)\n  - [Migrating](#migrating)\n  - [More examples](#more-examples)\n  - [Usefull frontend lib](#usefull-frontend-lib)\n  - [Thanks](#thanks)\n  - [Credits](#credits)\n  - [Alternatives](#alternatives)\n\n<!-- END doctoc generated TOC please keep comment here to allow auto update -->\n\n## Install\n\n```\nnpm install --save-dev gulp-svg-symbols\n```\n\n## Example\n\nIn your gulpfile.js:\n\n```js\nconst gulp = require('gulp')\nconst svgSymbols = require('gulp-svg-symbols')\n\ngulp.task(`sprites`, function() {\n  return gulp\n    .src(`assets/svg/*.svg`)\n    .pipe(svgSymbols())\n    .pipe(gulp.dest(`assets`))\n})\n```\n\nIn your HTML, you first have to [reference the SVG](http://css-tricks.com/svg-sprites-use-better-icon-fonts/)  \nthen:\n\n```html\n<svg role=\"img\" class=\"github\">\n  <use xlink:href=\"#github\"></use>\n</svg>\n```\n\n- **class** is the one generated in the CSS file\n- **xlink:href** is the symbol id in the SVG file\n\n## Options\n\nYou can override the [default options](https://github.com/Hiswe/gulp-svg-symbols/blob/master/lib/default-config.js) by passing an object as an argument to `svgSymbols()`\n\n### Basics\n\n#### id and class\n\n**type:** `function` or `string`  \n**default:** `'%f'` and `'.%f'`\n\nText templates for generating symbols id & icon class  \n`%f` is the [speakingurled](https://www.npmjs.com/package/speakingurl) file name placeholder.  \nSee more about the name in the [slug option](#slug)\n\n#### fontSize\n\n**type:** `number`  \n**default:** `0`\n\nThis option lets you define a base font.  \nIf it's superior to 0, then the sizes in your CSS file will be in **em** else sizes are provided with **px**.\n\n#### title\n\n**type:** `boolean` or `function` or `string`  \n**default:** `false`\n\nSpecify whether or not you want to add a missing `title` tag in your SVG symbols.  \nIt should be better for _accessibility_.  \nIt takes a text template (like for [id/classname](https://github.com/Hiswe/gulp-svg-symbols#id--classname)):\n\n```js\ntitle: `%f icon`\n```\n\n#### svgAttrs\n\n**type:** `object`  \n**default:** `{class: null, xmlns: 'http://www.w3.org/2000/svg'}`\n\nSpecify attributes for the `<svg>` container tag in the default SVG template.\n\n```js\n{\n  class: `svg-icon-lib`,\n  'aria-hidden': `true`,\n  style: `position: absolute;`,\n  'data-enabled': true,\n}\n```\n\noutput:\n\n```html\n<svg xmlns=\"http://www.w3.org/2000/svg\" class=\"svg-icon-lib\" aria-hidden=\"true\" style=\"position: absolute;\" data-enabled>\n```\n\n_notes:_\n\n- this is how you can add a `class` to the generated SVG\n- any string or numeric attribute will be rendered\n- boolean attributes will just toggle the attribute without any value. If you need to render the boolean as a value just pass it as a string\n- the attribute `xmlns:xlink=\"http://www.w3.org/1999/xlink\"` will be added automatically if any `xlink:` is found in the SVG content\n\n#### slug\n\n**type:** `object` or `function`  \n**default:** `{}`\n\nIn order to have nice ids in the template and to keep the gulp task quite simple, gulp-svg-symbols use [speakingurl](https://www.npmjs.com/package/speakingurl).\n\nYou can pass a [speakingurl's config](https://www.npmjs.com/package/speakingurl#getsluginput-options) here:\n\n```js\ngulp.src(`*.svg`).pipe(\n  svgSymbols({\n    slug: {\n      separator: `_`,\n    },\n  })\n)\n```\n\nYou can also provide a custom function which should return a `string`:\n\n```js\ngulp.src(`*.svg`).pipe(\n  svgSymbols({\n    slug: function(name) {\n      return name.replace(/\\s/g, `-`)\n    },\n  })\n)\n```\n\nOr if you want to use [gulp-rename](https://www.npmjs.com/package/gulp-rename):\n\n```js\ngulp\n  .src(`*.svg`)\n  .pipe(rename(/* gulp rename options*/))\n  .pipe(\n    svgSymbols({\n      slug: name => name,\n    })\n  )\n```\n\n#### templates\n\n**type:** `array of string`  \n**default:** `['default-svg', 'default-css']`\n\n_gulp-svg-symbols_ comes with some default templates.\n\nYou can control which file are generated by specifying only the templates to keep:\n\n```js\ntemplates: [`default-svg`]\n```\n\nwill output **only** the SVG file.\n\nHere is the list of all provided templates:\n\n- [**default-svg**](https://github.com/Hiswe/gulp-svg-symbols/blob/master/TEMPLATES.md#default-svg): the bundle of SVG\n- [**default-css**](https://github.com/Hiswe/gulp-svg-symbols/blob/master/TEMPLATES.md#default-css): a CSS file gathering all sizes and additional styles\n- [**default-demo**](https://github.com/Hiswe/gulp-svg-symbols/blob/master/TEMPLATES.md#default-demo): a demo page which provide an overview of every symbols + a way to copy/paste easily the symbol SVG code\n- [**default-vue**](https://github.com/Hiswe/gulp-svg-symbols/blob/master/TEMPLATES.md#default-vue): a vue component\n- [**default-css-var**](https://github.com/Hiswe/gulp-svg-symbols/blob/master/TEMPLATES.md#default-css-var): same as the CSS, but all sizes will be also declared as CSS Custom Properties\n- [**default-scss**](https://github.com/Hiswe/gulp-svg-symbols/blob/master/TEMPLATES.md#default-scss): same as the CSS, but sizes will be declared as SCSS variables\n- [**default-stylus**](https://github.com/Hiswe/gulp-svg-symbols/blob/master/TEMPLATES.md#default-stylus): same as the CSS, but sizes will be declared as Stylus variables\n\nMore details about the build-in templates can be found in the [TEMPLATES.md](https://github.com/Hiswe/gulp-svg-symbols/blob/master/TEMPLATES.md) file\n\n##### CSS generation\n\nYou can deactivate CSS output by removing the CSS template from the template array.  \nSee [templates option](https://github.com/Hiswe/gulp-svg-symbols#templates) for more details.\n\n#### warn\n\n**default:** `true`\n\nDisable plugin warn messages (like: missing viewBox & depreciation warnings).\n\n### Advanced\n\n#### templates\n\nSpecify your own templates by providing an absolute path:\n\n```js\ntemplates: [\n  path.join(__dirname, `path/to/my/template.less`),\n  path.join(__dirname, `path/to/another/template.js`),\n  // You can still access to default templates by providing:\n  `default-svg`,\n  `default-css`,\n  `default-demo`,\n]\n```\n\n- template engine is [lodash](http://lodash.com/docs#template).\n- the output files will have the same name & extension as your files.\n- every template will have acces to those datas:\n\n```js\n{\n  svgAttrs: {/*  the same object you can pass in configuration */ },\n  defs: `string`,\n  icons: [{\n    id: `string`,\n    class: `.string`,\n    width: `a number as a string with a unit`,\n    height: `a number as a string with a unit`,\n    style: `string if exists`,\n    svg: {\n      name: `string (svg filename without extension)`,\n      id: `string`,\n      width: `number`,\n      height: `number`,\n      content: `the svg markup as a string`,\n      viewBox: `string`,\n      originalAttributes: {\n        /* every attributes before processing them */\n      },\n    },\n  }, {/*…*/}, ],\n}\n```\n\n- and also 2 helpers functions\n  - `attributesToString( object )` render an object as a string of attributes\n  - `svgdataToSymbol( iconData )` render an icon data object to a stringed symbol\n\n#### transformData\n\nWith the ability to provide custom templates, you also have the ability to configure custom data.\n\n```js\ntransformData: function(svg, defaultData, options) {\n  /******\n  svg is same object as the one passed to the templates (see above)\n\n  defaultData are the ones needed by default templates\n  see /lib/get-default-data.js\n\n  options are the one you have set in your gulpfile,\n    minus templates & transformData\n  *******/\n\n  return {\n    // Return every datas you need\n    id:         defaultData.id,\n    class:      defaultData.class,\n    width:      `${svg.width}em`,\n    height:     `${svg.height}em`\n  };\n}\n```\n\nIn your templates, svg original data are accessible in `icon.svg`.  \nOf course default templates need `defaultData`.\n\n### Other observations\n\n- If you want to manipulate your icons files, use [gulp-cheerio](https://www.npmjs.com/package/gulp-cheerio)\n- If you want to optimize your icons files or the SVG output, use [gulp-svgmin](https://www.npmjs.org/package/gulp-svgmin) (using SVGO)\n- If you want to change the generated files name, again use [gulp-rename](https://www.npmjs.org/package/gulp-rename)\n- If you want different destination for the files, use [gulp-if](https://www.npmjs.org/package/gulp-if)\n- Unlike [gulp-svg-sprites](https://www.npmjs.org/package/gulp-svg-sprites) there is no way to add padding to SVG files.\n\nIf you want to include the SVG symbols directly in the DOM (i.e. no external reference) and mask it, a secure way of hiding it could be achieved in this way:\n\n```css\n.svg-icon-lib {\n  border: 0 !important;\n  clip: rect(0 0 0 0) !important;\n  height: 1px !important;\n  margin: -1px !important;\n  overflow: hidden !important;\n  padding: 0 !important;\n  position: absolute !important;\n  width: 1px !important;\n}\n```\n\nA simple `display: none` will mess with defs rendering (gradients and so on…)\n\n## Other stuff\n\n### Rendering caveats\n\nSVG can have rendering issues if:\n\n- multiple `<defs>` have the same ids.  \n  Use [gulp-svgmin](https://github.com/ben-eb/gulp-svgmin#per-file-options) to fix that.\n- `<clipPath>` and `<mask>` aren't staying inside `<defs>` tags.  \n  Move those tags **inside** the `<defs>` tags. Manually or programmatically (easy to do with [gulp-cheerio](https://www.npmjs.com/package/gulp-cheerio))\n\nAn example has been made to show all those issues resolved inside the [svgContainingIdenticalId](https://github.com/Hiswe/gulp-svg-symbols/blob/master/examples/gulpfile.js#L198-L282).\n\n`npm run svg-containing-identical-id` to test.\n\n### Migrating\n\nSee [MIGRATING.md](https://github.com/Hiswe/gulp-svg-symbols/blob/master/MIGRATING.md)\n\n### More examples\n\nGo in the [examples folder](https://github.com/Hiswe/gulp-svg-symbols/blob/master/examples), then `npm install && npm run list`.  \nYou will have a list of all task examples there\n\n### Usefull frontend lib\n\n- [svg4everybody](https://www.npmjs.com/package/svg4everybody) leverage external SVG for browser which doesn't support it\n\n### Thanks\n\n- [Florens Verschelde](https://github.com/fvsch) for the usefull insights and PR\n\n### Credits\n\n- [Chris Coyier](http://css-tricks.com/) for the [trick](http://css-tricks.com/svg-symbol-good-choice-icons/)\n- [Shaky Shane](https://www.npmjs.org/~shakyshane) for the [gulp-svg-sprites](https://www.npmjs.org/package/gulp-svg-sprites) plugin\n- [FWeinb](https://github.com/FWeinb) for the [grunt-svgstore](https://github.com/FWeinb/grunt-svgstore) plugin\n\n### Alternatives\n\n- [gulp-svg-sprite](https://www.npmjs.com/package/gulp-svg-sprite)\n- [gulp-svg-store](https://www.npmjs.com/package/gulp-svgstore)\n- [gulp-svg-sprites](https://www.npmjs.org/package/gulp-svg-sprites)\n","_attachments":{},"homepage":"https://github.com/Hiswe/gulp-svg-symbols","bugs":{"url":"https://github.com/Hiswe/gulp-svg-symbols/issues"},"license":"MIT"}