A grunt task that makes working with release branches (aka gh-pages) a breeze"
A grunt task that makes working with release branches (aka gh-pages) a breeze
This plugin requires Grunt
If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:
npm install grunt-release-branch --save-dev
When developing for the web, we usually have bunch of build steps which take care of concatenation, minification, inlining templates, generating html snapshots and so on and so on...
After running through all those steps, the final output is usually placed into an output directory that is not commited into version control. Following the
release branch pattern we take this output and place it on an
orphan branch, were some other mechanism can kick in and e.g. publish it as a website. That's exactly how it works with github as well.
This grunt plugin consits of two tasks to assist you for those scenarios.
This task should be run before all other build steps. It simply does
git branch -D gh-pages and
git checkout -b gh-pages under the covers. Please note that the branch name can be configured with the
This task should run as the last command in your build orchestration. It erases everything it moves all the files from your output directory to the root level of your working directory while deleting all other stuff except your .git folder. It than optionally commits and pushs using the
var releaseBranchOptions = app:options://the name of the orphan branch. Default is gh-pagesreleaseBranch: 'gh-pages'//the name of the remote repository. Default is originremoteRepository: 'origin'//the name of the output directory. Default is distdistDir: 'dist'//the commit message to be used for the optional commitcommitMessage: 'RELEASE'//should files be automatically commited on the orphan branchcommit: true//should the orphan branch be pushed to the remote repository//default is falsepush: true//a blacklist of things to keep on the root level. By default only//the .git folder will be kept.blacklist:'.git';gruntinitConfigreleaseBranchPre: releaseBranchOptionsreleaseBranch: releaseBranchOptions;