Skip to content

Latest commit

 

History

History
105 lines (58 loc) · 2.38 KB

README.md

File metadata and controls

105 lines (58 loc) · 2.38 KB

generator-craftcms Build Status

![Gitter](https://badges.gitter.im/Join Chat.svg)

Yeoman generator

Workflow for Craft with Gulp

Requires Nodejs and Gulp

Getting started

Install the generator

$ npm install -g yo

To install generator-craftcms from npm, run:

$ npm install -g generator-craftcms

Finally, initiate the generator:

$ yo craftcms

Compass needs the compass ruby gem. If you don't already have it: gem update --system and gem install compass

Tasks

note: Don't touch the templates folder in /craft it will be overwritten on build. Work on the ones in app/templates

  • gulp watch to start the watch task, at the moment you will have to use a browser extention for live reload.

  • gulp to build for production, all the magic happens and template files will be moved to craft/templates, resources (images/js/css) will be concatinated, minified and wrapped in silk before they end up in /public.

  • gulp bower Injects bower dependencies into _layout.html. This task will run on gulp watch as well. Remember to --save when installing components.

Set /app as server root on development and /public for production.

Gulp Plugins

  • compass - Css compiler

  • autoprefixer - So we don't have to write -moz-, -webkit-, -ms-, -o-, -all-, -the-, -time-

  • concat - Merging css and js to single files

  • uglify - Javascript minifyer

  • jshint - A tool that helps to detect errors and potential problems in your JavaScript code.

  • watch - The thing that tells us when a file has changed

  • livereload - Updates our browsers when js or css changes

  • usemin - Reads the html to know what files to concat and stuff

  • util - Logs stuff. And it can gutil.beep(); too :o

  • del - Our garbage guy

  • cache - A temp file based caching proxy task for Gulp.

  • imagemin - Optimizes images for you.

  • wiredep - Injects script and link tags when you install something with bower.