Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/kurenn/elasticss-rails


https://github.com/kurenn/elasticss-rails

Last synced: about 2 months ago
JSON representation

Awesome Lists containing this project

README 

        
# ElastiCSS for Rails 3.1 Asset Pipeline

ElastiCSS is a simple css framework to layout web-based interfaces, based on the printed layout techniques of 4 columns but with capabilities to unlimited column combinations. and capacity to make elastic, fixed and liquid layout easily



elasticss-rails project integrates ElastiCSS framework for Rails 3.1 Asset Pipeline (Rails 3.2 supported)



[![Build Status](https://secure.travis-ci.org/kurenn/elasticss-rails.png?branch=master)](http://travis-ci.org/kurenn/elasticss-rails)



## Installing Gem



Include ElastiCSS in Gemfile;



```ruby

gem "elasticss-rails"

```



or you can install from latest build;



```ruby

gem 'elasticss-rails', :git => '[email protected]:kurenn/elasticss-rails.git'

```



Install the gem using the bundle command:



    bundle install



## To add the elasticss CSS and JS assets



You can run the generator command



	rails g elasticss:install



Or you can add them **manually**:



## Add elasticss CSS assets



Add to your `app/assets/stylesheets/application.css`



			*= require elastic



If you need to add the print support you can add it as well



		*= require elastic.print



## Add elasticss JS assets



Add to your `app/assets/javascripts/application.js`



		//= require elastic



## Layout generators



Layout (generates ElastiCSS layout) - (ERB and HAML supported):



You need to first add the haml-rails to the gemfile:



    gem 'haml-rails'



And last but not least if you want HAML to be your default template engine you

need to change your config/application.rb file as shown:



    config.generators do |generator|

      generator.template_engine :haml

    end



Usage:



    rails g elasticss:layout [LAYOUT_NAME] [LAYOUT_TYPE]



Example:



    rails g elasticss:layout application 3_columns



But wait there is more:



    rails g elasticss:layout application right_sidebar



    rails g elasticss:layout application left_sidebar



## Changelog

  - Added a install generator (v0.1.5)

  - Current gem v.0.1.4

  - Full integration with rails asset pipeline

  - Skip inclusion of JS with an argument

  - Release gem v.0.1.0

  - Support for HAML templates

  - Released gem v.0.0.3

  - Released gem v.0.0.2

  - Released gem v.0.0.1



## Contributors & Patches & Forks



  - Abraham Kuri Vargas ([@kurenn](http://twitter.com/kurenn))

  - Ricardo Cruz ([@rkrdo89](http://twitter.com/rkrdo89))



## ElastiCSS author & team

  - Fernando Trasviña ([@azendal](http://twitter.com/azendal))

  - Sergio de la Garza ([@sgarza](http://twitter.com/azendal))

  - Javier Ayala ([@javi_ayala](http://twitter.com/javi_ayala))



## Future

  - Add dinamic columns layout with argument

  - Writing tests (not implemented yet)

  - Provide a stylesheet for templates



## Credits

Abraham Kuri - [email protected]



[Add Me On Twitter](http://twitter.com/kurenn "Follow me")



[Add Me On Linkedin](http://www.linkedin.com/pub/abraham-kuri/26/a21/b41 "Add Me On Linkedin")



[Add Me On Facebook](https://www.facebook.com/kurenn "Add Me On Facebook")



## Score me




You can +K my influence in Ruby on Rails on @klout



http://klout.com/#/kurenn



## License

Copyright (c) 2011 Abraham Kuri Vargas



This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.



This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.



You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/gpl.html.