If you want to easily create custom gh-pages for your application, and want to use for that sass-compass/haml/coffee/something
THIS GEM TOTALY FOR YOU
Because make html as html is too mainstream. Now you should know all benefits of using haml, coffee and sass. And of course other template engines for other or the same purposes. You should know and I think you love it.
There a lot of cool static site generators, from jekyll to this one :) But no one give to you so simple ui (maybe middleman, but tonic knows how to do gh-pages branch right;)
You can choose with what template you want to develop your site: tonic, middleman or jekyll (jekyll support not ready yet)
This gem have two functions inside:
- tonic for gh-pages
Tonic-template it is that thing for easy developing. Tonic-template uses for it's work several gems, like template engines, rake and sprockets. Sprockets make this template look like rails assets folder.
You don't need every time run some command in terminal or push somewhere.
You need just write
Tonic for gh-pages is simplier, because it uses only ruby-lang libraries like open3 and pathname and dependent on jekyll and middleman,
and it's general purpose - is create new branch
gh-pages, init there choosen template and run bundler if it's needed.
You should be in your repo, for which you want to create gh-pages. You shouldn't have in this repo this branch already. So you just run:
$ gem install tonic $ tonic [middleman|jekyll]
Will be created branch gh-pages, then tonic checkout you there and remove from there all (not dot-) files. Then it will copy choosen template to this branch and run bundle install if it's needed.
And you can work with this template.
When you want to push your gh-pages branch to github, just write:
$ tonic push
$ git push -f origin gh-pages
Example you can see on gh-pages for tonic
And what inside template in gh-pages branch
For create template for one-page static application you need to do this:
$ gem install tonic $ tonic new my_app
This will create for you directory with template files, gemfile and rakefile. And it will run bundler for you.
Then you can do two things:
build template files:
bundle exec rake build
watch your assets directory for rebuilding on changes:
bundle exec rake watch
In tonic used next gems for make it work:
Lot of code for rakefile of template and for octocat in test page I get from one-page project of my friend @ai easings.net
I did it myself, but use some advices of people and code from their repos:
@ai for his almost ready template and cool 3d transformations in easings.net
@defunkt with his github-gem, which I plan to use in future for do things right and from which I get Shell class for sh command
@brainopia for style advices
The MIT License
Copyright (c) 2012 gazay
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.