From abd94a7f5a50f43c797a11b53549ae48fff667c3 Mon Sep 17 00:00:00 2001 From: Florian Dold Date: Mon, 10 Oct 2016 03:43:44 +0200 Subject: add node_modules to address #4364 --- node_modules/gulp-concat/README.md | 108 +++++++++++++++++++++++++++++++++++++ 1 file changed, 108 insertions(+) create mode 100644 node_modules/gulp-concat/README.md (limited to 'node_modules/gulp-concat/README.md') diff --git a/node_modules/gulp-concat/README.md b/node_modules/gulp-concat/README.md new file mode 100644 index 000000000..eac59cdde --- /dev/null +++ b/node_modules/gulp-concat/README.md @@ -0,0 +1,108 @@ +![status](https://secure.travis-ci.org/wearefractal/gulp-concat.svg?branch=master) + +## Information + + + + + + + + + + + + + +
Packagegulp-concat
DescriptionConcatenates files
Node Version>= 0.10
+ +## Usage + +```js +var concat = require('gulp-concat'); + +gulp.task('scripts', function() { + return gulp.src('./lib/*.js') + .pipe(concat('all.js')) + .pipe(gulp.dest('./dist/')); +}); +``` + +This will concat files by your operating systems newLine. It will take the base directory from the first file that passes through it. + +Files will be concatenated in the order that they are specified in the `gulp.src` function. For example, to concat `./lib/file3.js`, `./lib/file1.js` and `./lib/file2.js` in that order, the following code will create a task to do that: + +```js +var concat = require('gulp-concat'); + +gulp.task('scripts', function() { + return gulp.src(['./lib/file3.js', './lib/file1.js', './lib/file2.js']) + .pipe(concat('all.js')) + .pipe(gulp.dest('./dist/')); +}); +``` + +To change the newLine simply pass an object as the second argument to concat with newLine being whatever (\r\n if you want to support any OS to look at it) + +For instance: + +```js +.pipe(concat('main.js', {newLine: ';'})) +``` + +To specify `cwd`, `path` and other [vinyl](https://github.com/wearefractal/vinyl) properties, gulp-concat accepts `Object` as first argument: + +```js +var concat = require('gulp-concat'); + +gulp.task('scripts', function() { + return gulp.src(['./lib/file3.js', './lib/file1.js', './lib/file2.js']) + .pipe(concat({ path: 'new.js', stat: { mode: 0666 }})) + .pipe(gulp.dest('./dist')); +}); +``` + +This will concat files into `./dist/new.js`. + +### Source maps + +Source maps can be generated by using [gulp-sourcemaps](https://www.npmjs.org/package/gulp-sourcemaps): + +```js +var gulp = require('gulp'); +var concat = require('gulp-concat'); +var sourcemaps = require('gulp-sourcemaps'); + +gulp.task('javascript', function() { + return gulp.src('src/**/*.js') + .pipe(sourcemaps.init()) + .pipe(concat('all.js')) + .pipe(sourcemaps.write()) + .pipe(gulp.dest('dist')); +}); +``` + +## LICENSE + +(MIT License) + +Copyright (c) 2014 Fractal + +Permission is hereby granted, free of charge, to any person obtaining +a copy of this software and associated documentation files (the +"Software"), to deal in the Software without restriction, including +without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Software, and to +permit persons to whom the Software is furnished to do so, subject to +the following conditions: + +The above copyright notice and this permission notice shall be +included in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND +NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE +LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION +OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION +WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. -- cgit v1.2.3