Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A grunt task for creating symlinks between files/directories
JavaScript
branch: master
Failed to load latest commit information.
docs
tasks add support for grunt 0.4
test fixing the way paths are created, bump version
.gitignore
.npmignore
.travis.yml
AUTHORS Inital grunt-contrib-symlink release
CHANGELOG
Gruntfile.js add support for grunt 0.4
LICENSE-MIT Inital grunt-contrib-symlink release
README.md
package.json bumping the minor version number

README.md

grunt-symbolic-link Build Status

Create symlinks between files/directories

Overview

This task can be used to create symlinks between files/directories in your project. It is a multitask and so can be used to create multiple links.

Getting Started

Install this grunt plugin next to your project's grunt.js gruntfile with: npm install grunt-symbolic-link

Then add this line to your project's grunt.js gruntfile:

grunt.loadNpmTasks('grunt-symbolic-link');

Usage

Inside your grunt.js file add a section named symlink. This section specifies the target and link path, and optionally any options you want to use. Once the section has been added you can run the task with grunt symlink.

Parameters

target string

Path to the file/directory you want to link to. Paths will be relative to the grunt.js file unless an absolute path is used.

link string

Path to the new file/directory link location. Paths will be relative to the grunt.js file unless an absolute path is used.

type string

options object

A hash of options to configure the symlink and tasks behaviour

overwrite boolean

Choose whether or not to overwrite existing symlink/files, default is false.

force boolean

Force can be used to create the directory structure for the link path if it has not previously been created, default is false

type boolean

To specifically set the type of symlink to be created, default type will be inferred from the target type. Values can be 'dir', 'file', or 'junction'. see node.js - fs for more info

Usage Examples

symlink: {
  docroot: {
    target: 'path/to/target',
    link: path/to/link
  },
  another: {
    target: 'path/to/target',
    link: path/to/link,
    options: {
      overwrite: true,
      force: true
    }
  }
}

Release History

  • 2012-12-20   v0.1.0   Initial Release

Task submitted by Paul Dixon.

Something went wrong with that request. Please try again.