Reference from: http://segmentfault.com/a/1190000000372547
Resources:
- NPM on Gulp Components
- Gulp's GitHub homepage
- Official Package.json Documentation
- Gulp Chinese website
This article assumes that you have not previously used any task scripts (task runner) and command-line tools, step by step to teach you to get started gulp. Do not be afraid, it is actually very simple, I will be divided into five steps to introduce you to gulp and help you accomplish some amazing things. Let's go straight to the beginning.
First Step: Install node
First of all, the most basic and most important thing is that we need to build the node environment. Visit http://nodejs.org, then click the Big Green install
button and run the program directly after the download is complete, and everything is ready. NPM will be installed with the installation package and will be used later.
After installation, remember to configure the environment variable node_path= "C:\Users\Gaming\node_modules" (in quotation marks for their own NODE installation path), the configuration method is as follows:
Step two: Use the command line
Maybe now you don't quite understand what a command line--osx in the terminal (Terminal), in Windows command Prompt, but soon you'll know. It doesn't look that simple, but once you get the hang of it, it's easy to execute a lot of command-line programs, such as Sass,yeoman and Git, which are very useful tools.
If you are familiar with the command line, skip directly to step four.
To make sure that node is properly installed, we execute a few simple commands.
Node-v
Enter (enter), if installed correctly, you will see the version number of the node installed, and then see NPM.
Npm-v
This will also get the NPM version number.
If these two lines of command are not returned, the node may not be installed correctly, try restarting the command-line tool, and if not, you can only go back to the first step to reload.
Step three: Navigate to the project
Now that we have an overview of the command line and know how to use it simply, the next two simple commands can be used to locate the file directory and see what files are in the directory.
- CD, navigate to Directory
- LS, listing the file list
It is recommended to tap these two commands to learn more about the file system and to know where the files are.
Accustomed to using these two commands, it is necessary to enter our project directory, this directory is different, for example, this is my command to enter the project directory:
cd /Applications/XAMPP/xamppfiles/htdocs/my-project
After successfully entering the project directory, we started to install Gulp.
Fourth Step: Install Gulp
We already know how to use the command line, now try something new, know NPM and then install Gulp.
NPM is a command-line-based node package management tool that installs node's program module into a project and can view and search all available program modules on its website.
On the command line, enter
- NPM is the tool for installing the node module, executing the install command
-G means installed in the global environment so that any project can use it
- Finally, Gulp is the name of the node module that will be installed
While the runtime is aware that there is no error message on the command line, you can use the following command to view the Gulp version number to ensure that Gulp is installed correctly.
Gulp-v
Next, we need to install the Gulp to the project local
NPM Install--save-dev Gulp
Here, we use —-save-dev
to update the Package.json file, updating the devDependencies
value to indicate that the project needs to rely on gulp.
Dependencies
You can indicate to other participants in the project that the node module in the development environment and production environment is lazy and want to know more about it to see the Package.json documentation.
Fifth step: Create a new Gulpfile file and run the Gulp
After installing gulp we need to tell it what to do for us, first of all we need to figure out what tasks the project needs.
- Check JavaScript
- Compiling sass (or less) files
- Merging JavaScript
- Compress and rename merged JavaScript
Installation dependencies
New Gulpfile File
Now that the components are installed, we need to create a new Gulpfile file to specify what the gulp needs to accomplish for us.
Gulp has only five methods:,,, task
run
watch
src
, and dest
, in the project root, create a new JS file and name it gulpfile.js, and paste the following code in:
Gulpfile.js
//Introduction of GulpvarGulp = require (' Gulp ')); //Introducing ComponentsvarJshint = require (' Gulp-jshint '));varSass = require (' Gulp-sass '));varConcat = require (' Gulp-concat '));varUglify = require (' gulp-uglify '));varRename = require (' Gulp-rename '));//Check ScriptGulp.task (' Jshint ',function() {GULP.SRC ('./js/*.js '). Pipe (Jshint ())//. Pipe (Jshint.reporter (' Default '));//output results by default on the command line. Pipe (Jshint.reporter (' Gulp-jshint-html-reporter ', {filename: ' jshint-report.html '});//output to the custom HTML file});//Compiling sassGulp.task (' sass ',function() {GULP.SRC ('./scss/*.scss '). Pipe (Sass ()). Pipe (Gulp.dest ('./css '));});//merging, compressing filesGulp.task (' Scripts ',function() {GULP.SRC ('./js/*.js '). Pipe (Concat (' All.js '). Pipe (Gulp.dest ('./dist '). Pipe (Rename (' All.min.js ') . Pipe (Uglify ()). Pipe (Gulp.dest ('./dist '));});//Default TaskGulp.task (' Default ',function() {Gulp.run (' Lint ', ' sass ', ' scripts '); //Monitor file ChangesGulp.watch ('./js/*.js ',function() {Gulp.run (' Lint ', ' sass ', ' scripts '); });});
Now, the segment explains the code.
Introducing Components
var gulp = require (' Gulp 'var jshint = require (' Gulp-jshint '); var sass = require (' Gulp-sass '); var concat = require (' Gulp-concat '); var uglify = require (' gulp-uglify '); var rename = require (' Gulp-rename ');
In this step, we introduced the core gulp and other dependent components, and next, create the four different tasks of lint, sass, scripts, and default separately.
Lint Tasks
function () { gulp.src ('./js/*.js '). Pipe (Jshint ()) . Pipe (Jshint.reporter (' default '));});
The link task checks js/
whether the JS file in the directory has an error or warning.
Sass Tasks
function () { gulp.src ('./scss/*.scss '). Pipe (SASS ()) . Pipe (Gulp.dest ('./css '));});
The SASS task compiles the scss/
scss file in the directory and saves the compiled CSS file to the /css
directory.
Scripts Tasks
function () { gulp.src ('./js/*.js ') . Pipe (concat (' all.js ')) . Pipe (Gulp.dest ('./ Dist '). Pipe ( rename (' All.min.js ')). Pipe ( uglify ()) . Pipe (Gulp.dest ('./dist ') ));});
The scripts task merges js/
all the JS files in the directory and outputs them to the dist/
directory, and then gulp renames, compresses the merged files, and outputs them to the dist/
directory.
Default task
function () { gulp.run (' lint ', ' sass ', ' Scripts '); Gulp.watch (function() { gulp.run (' lint ', ' sass ', ' Scripts '); } );
At this point, we create a default task that is based on other tasks. Use .run()
methods to correlate and run the tasks defined above, use the .watch()
method to listen for file changes in the specified directory, and, when there are changes to the file, run other tasks defined by the callback.
Now, back to the command line, you can run the Gulp task directly.
gulp
This will perform the defined default task, in other words, the same meaning as the following command
default
Of course, we can run any task defined in Gulpfile.js, for example, now running the SASS task:
gulp sass
Conclusion
Now that you've done that, set up the gulp task and run them, and now look back to the previous study.
- Learn to install the node environment
- Learn the simple use of the command line
- Learned to use the command line to enter the project directory
- Learned to use NPM and install Gulp
- Learn how to run a gulp task
Front-end build tool Gulp Getting Started tutorial (share)