You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
76 lines
3.2 KiB
76 lines
3.2 KiB
12 years ago
|
# grunt-contrib-copy [![Build Status](https://secure.travis-ci.org/gruntjs/grunt-contrib-copy.png?branch=master)](http://travis-ci.org/gruntjs/grunt-contrib-copy)
|
||
|
|
||
|
> Copy files and folders.
|
||
|
|
||
|
|
||
|
|
||
|
## Getting Started
|
||
|
This plugin requires Grunt `~0.4.0`
|
||
|
|
||
|
If you haven't used [Grunt](http://gruntjs.com/) before, be sure to check out the [Getting Started](http://gruntjs.com/getting-started) guide, as it explains how to create a [Gruntfile](http://gruntjs.com/sample-gruntfile) as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:
|
||
|
|
||
|
```shell
|
||
|
npm install grunt-contrib-copy --save-dev
|
||
|
```
|
||
|
|
||
|
Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:
|
||
|
|
||
|
```js
|
||
|
grunt.loadNpmTasks('grunt-contrib-copy');
|
||
|
```
|
||
|
|
||
|
*This plugin was designed to work with Grunt 0.4.x. If you're still using grunt v0.3.x it's strongly recommended that [you upgrade](http://gruntjs.com/upgrading-from-0.3-to-0.4), but in case you can't please use [v0.3.2](https://github.com/gruntjs/grunt-contrib-copy/tree/grunt-0.3-stable).*
|
||
|
|
||
|
|
||
|
|
||
|
## Copy task
|
||
|
_Run this task with the `grunt copy` command._
|
||
|
|
||
|
Task targets, files and options may be specified according to the grunt [Configuring tasks](http://gruntjs.com/configuring-tasks) guide.
|
||
|
### Options
|
||
|
|
||
|
#### processContent
|
||
|
Type: `Function(content, srcpath)`
|
||
|
|
||
|
This option is passed to `grunt.file.copy` as an advanced way to control the file contents that are copied.
|
||
|
|
||
|
#### processContentExclude
|
||
|
Type: `String`
|
||
|
|
||
|
This option is passed to `grunt.file.copy` as an advanced way to control which file contents are processed.
|
||
|
|
||
|
### Usage Examples
|
||
|
|
||
|
```js
|
||
|
copy: {
|
||
|
main: {
|
||
|
files: [
|
||
|
{src: ['path/*'], dest: 'dest/', filter: 'isFile'}, // includes files in path
|
||
|
{src: ['path/**'], dest: 'dest/'}, // includes files in path and its subdirs
|
||
|
{expand: true, cwd: 'path/', src: ['**'], dest: 'dest/'}, // makes all src relative to cwd
|
||
|
{expand: true, flatten: true, src: ['path/**'], dest: 'dest/', filter: 'isFile'} // flattens results to a single level
|
||
|
]
|
||
|
}
|
||
|
}
|
||
|
```
|
||
|
|
||
|
|
||
|
## Release History
|
||
|
|
||
|
* 2013-02-14 v0.4.0 First official release for Grunt 0.4.0.
|
||
|
* 2013-01-22 v0.4.0rc7 Updating grunt/gruntplugin dependencies to rc7. Changing in-development grunt/gruntplugin dependency versions from tilde version ranges to specific versions.
|
||
|
* 2013-01-13 v0.4.0rc5 Updating to work with grunt v0.4.0rc5. Conversion to grunt v0.4 conventions. Replace basePath with cwd. Empty directory support.
|
||
|
* 2012-10-17 v0.3.2 Pass copyOptions on single file copy.
|
||
|
* 2012-10-11 v0.3.1 Rename grunt-contrib-lib dep to grunt-lib-contrib.
|
||
|
* 2012-09-23 v0.3.0 General cleanup and consolidation. Global options depreciated.
|
||
|
* 2012-09-17 v0.2.4 No valid source check.
|
||
|
* 2012-09-16 v0.2.3 Path.sep fallback for node <= 0.7.9.
|
||
|
* 2012-09-16 v0.2.2 Single file copy support. Test refactoring.
|
||
|
* 2012-09-06 v0.2.0 Refactored from grunt-contrib into individual repo.
|
||
|
|
||
|
---
|
||
|
|
||
|
Task submitted by [Chris Talkington](http://christalkington.com/)
|
||
|
|
||
|
*This file was generated on Fri Feb 22 2013 09:26:58.*
|