Skip to content

linjonh/linjonh.github.io

Repository files navigation

#Installing the CLI Using Grunt 0.3? Please see Grunt 0.3 Notes

In order to get started, you'll want to install Grunt's command line interface (CLI) globally. You may need to use sudo (for OSX, *nix, BSD etc) or run your command shell as Administrator (for Windows) to do this.

  • npm install -g grunt-cli This will put the grunt command in your system path, allowing it to be run from any directory.

Note that installing grunt-cli does not install the Grunt task runner! The job of the Grunt CLI is simple: run the version of Grunt which has been installed next to a Gruntfile. This allows multiple versions of Grunt to be installed on the same machine simultaneously.

Install grunt.

the following command is to add grunt to your system path so that you can run grunt commod anywhere. (This will put the grunt command in your system path, allowing it to be run from anywhere.)

  • npm install -g grunt

#Working with an existing Grunt project Assuming that the Grunt CLI has been installed and that the project has already been configured with a

package.json
and a
Gruntfile
, it's very easy to start working with Grunt:

  • Change to the project's root directory.
  • Install project dependencies with
    npm install
    .
  • Run Grunt with
    grunt
    .

That's really all there is to it. Installed Grunt tasks can be listed by running grunt --help but it's usually a good idea to start with the project's documentation.

Install grunt-init.

grunt-init could create some templated files such as Guntfile.js and package.json into your project root diretory.

  • npm install -g grunt-init

Use grunt-init to install init template file.

clone a exits templated file from github. On windows:

On Linux:

run "grunt-init gruntfile" command to init project with Gruntfile.js and package.json.

Edit Gruntfile.js to add your grunt tasks.

Configurate Gruntfile.js

Add watch & connect grunt-plugin to refresh pages realtime.

  • npm install grunt-contrib-connect --save-dev
  • npm install grunt-contrib-watch --save-dev

In Gruntfile.js file, we regiter a task to run grunt serve:

	grunt.initConfig({
		connect:{
			options:{
				port:8080,
				livereload:35729,
				hostname:'localhost',
			}

		},
		server:{
			options:{
				open:true,
			}
		},
		
		watch:{
			page_refresh:{
				options:{
					livereload:'<%= connect.options.livereload%>'
				}
				files: ['**/*.js', '**/*.html','**/*.css'],
			}
		}

	});
	grunt.registerTask('serve',[
		'connect:server',
		'watch'
	]);

Intall Jekyil

jekyil depend on ruby gem, so first of all, you must ensure that your windows has been installed ruby gem.

	~$: gem install jekyll

if you encounter a problem like this:

ERROR:  Could not find a valid gem 'jekyll' (>= 0), here is why:
          Unable to download data from https://rubygems.org/ - SSL_connect returned=1 errno=0 state=SSLv3 read 
          server certificate B: certificate verify failed (https://api.rubygems.org/latest_specs.4.8.gz)

you may should run the command:

 
~$: curl -o `ruby -ropenssl -e 'p OpenSSL::X509::DEFAULT_CERT_FILE' |tr -d \"` http://curl.haxx.se/ca/cacert.pem

or

	~$: curl http://curl.haxx.se/ca/cacert.pem -o cacert.pem

if above commands dosen't work, you may change gem mirror like this:

	~$:sudo gem sources -r https://rubygems.org
	~$:sudo gem sources -a http://rubygems.org  

for more detail information about that, reference this site: http://stackoverflow.com/a/19179835/1227911