kendoui-rails 0.0.3 → 0.0.4

data/CHANGELOG.md

@@ -5,4 +5,8 @@
 ## 0.0.3 (26 February 2012)
 
   - Added install generator for automatically adding kendoui JS and CSS files to projects
-  - Added generator option to specify theme (default is default)
+  - Added generator option to specify theme (default is default)
+
+## 0.0.4 (27 February 2012)
+
+  - Modified install generator to auto-add asset declarations to `application.js` and `application.css` for Rails 3.1+ apps with the asset pipeline enabled. Pre 3.1 apps, as well as those with `config.assets.enabled = false` will have the appropriate files copied over to `public/javascripts` and `public/stylesheets`

data/README.md

@@ -1,34 +1,70 @@
 # kendoui-rails
 
-Kendo UI For Rails!
+[Kendo UI](http://www.kendoui.com) For Rails!
 
 This gem provides:
 
-* Kendo UI JavaScript (Minified Version of the Complete Web Suite)
+* Kendo UI JavaScript (Minified Version of the Web Suite)
 * Kendo UI Styles (Common Styles and the Default Theme)
 
-## Rails 3.1
+## Installation
 
-For Rails 3.1 and greater, the files will be added to the asset pipeline and available for you to use. These two lines will be added to the file `app/assets/javascripts/application.js` by default:
+In your Gemfile, add this line:
+
+    gem "kendoui-rails"
+
+Then, run `bundle install`. 
+
+After bundler completes, you can install the appropriate scripts by running the following command:
+
+    `rails generate kendoui:install` 
+
+Depending on your Rails version and environment, this command will either:
+ a) add javascripts and stylesheets to your asset pipeline (Rails 3.1+);
+or, b) add javascripts and stylesheets to your `public/javascripts` and `public\stylesheets` folders (Rails < 3.1 and Rails 3.1+ with asset pipeline disabled).
+
+### Rails 3.1 (Asset Pipeline)
+
+For Rails 3.1 and greater, Kendo UI will be added to the asset pipeline and available for you to use. This line will be added to the file `app/assets/javascripts/application.js` by default:
 
-    //= require jquery
-	//= require kendo/kendo.all.min
+    //= require kendo/kendo.all.min
 
-To work with Kendo UI Themes, you'll need to add the following to `app\assets\stylesheets\application.css`:
+Appropriate styles will also be added to the asset pipeline, with the following two lines added to `app\assets\stylesheets\application.css`:
 
 	*= require kendo/kendo.common.min
 	*= require kendo/kendo.default.min 
 
-If you prefer another theme (metro, silver, etc) replace the second line with the name of that theme
+If you prefer another theme (metro, silver, etc) replace the second line with the name of that theme, or use the `--theme` switch in the generate command (see below for details).
 
-### Installation
+### Rails 3.0, Previous or Asset Pipeline Disabled
 
-In your Gemfile, add this line:
+For other environments, Kendo UI javascripts and styles will be added to the `public` folder for your application. After running `rails generate kendoui:install` you'll see the following in your public folder:
 
-    gem "kendoui-rails"
+    + public
+        + javascripts
+            - kendo.all.min.js
+        + stylesheets
+            - kendo.common.min.css
+            - kendo.default.min.css
+            
+As with Rails 3.1 environments, the install generator will add the `kendo.default.min.css` stylesheet by default, and you can customize the installed theme with the `--theme` switch
 
-Then, run `bundle install`. 
+### Customizing the Installed Theme
+
+As mentioned above, the install generator will install the default (also named default) theme for Kendo UI, unless you specify an alternate with the generator command. This is done using the `--theme` switch. For example, if you wanted to install the 'metro' theme, you can run the following:
+
+    rails generate kendoui:install --theme:metro
+
+### Learn more about [Kendo UI](http://kendoui.com)!
+
+Kendo UI is an end-to-end HTML5, CSS3 and JavaScript solution for modern client-side development, developed by [Telerik](http://www.telerik.com). For more information about Kendo UI, including documentation, support, and additional Kendo UI libraries like DataViz and Mobile, visit http://KendoUI.com and http://demos.kendoui.com/. Also, be sure to check out the [Kendo UI Blog](http://www.kendoui.com/blogs.aspx) for breaking Kendo UI news as well as mobile development tips and commentary.
+
+You can also find Kendo UI on:
+
+* [Twitter](https://twitter.com/#!/KendoUI)
+* [Facebook](http://www.facebook.com/KendoUI)
+* [Google+](https://plus.google.com/117798269023828336983/posts)
 
-That's all you need to start using Kendo UI. 
+Note: This gem provides a GPLv3 Licensed version of Kendo UI Core with full source code and access to major updates. For more information about commercial licenses for Kendo UI, as well as access to DataViz and Mobile suites, head over to the [Get Kendo UI](http://www.kendoui.com/blogs.aspx) page.
 
-Note: This gem provides a GPLv3 Licensed version of Kendo UI Core. For more information about Kendo UI, including documentation, support, and additional Kendo UI libraries like DataViz and Mobile, visit http://KendoUI.com
+This gem was created by [Brandon Satrom](http://twitter.com/brandonsatrom). Find me online at [userinexperince.com](http://userinexperince.com) or on Twitter as [@BrandonSatrom](http://twitter.com/brandonsatrom). You can also email me at [brandon@kendoui.com](mailto:brandon@kendoui.com).

data/kendoui-rails.gemspec

@@ -7,7 +7,7 @@ Gem::Specification.new do |s|
   s.version     = Kendoui::Rails::VERSION
   s.authors     = ["Brandon Satrom"]
   s.email       = ["brandon@kendoui.com"]
-  s.homepage    = "http://github.com/bsatrom/kendoui-rails"
+  s.homepage    = "http://github.com/bsatrom/kendoui_rails"
   s.summary     = %q{Gem for Adding Kendo UI to Ruby Applications}
   s.description = %q{Adds GPLv3 Portions of Kendo UI (http://kendoui.com) to javascripts and styles folders}
 

data/lib/kendoui-rails/version.rb

@@ -1,6 +1,6 @@
 module Kendoui
 	module Rails
-		VERSION = "0.0.3"
+		VERSION = "0.0.4"
   		KENDOUI_VERSION = "2011.3.1129"
   	end
 end

data/lib/rails/generators/kendoui/install/install_generator.rb

@@ -1,25 +1,51 @@
 require 'rails'
 require File.expand_path('../../../../../../lib/kendoui-rails/version', __FILE__)
 
-module Kendoui
-  module Generators
-    class InstallGenerator < ::Rails::Generators::Base
+if ::Rails.version < "3.1" || !::Rails.application.config.assets.enabled
+  module Kendoui
+    module Generators
+      class InstallGenerator < ::Rails::Generators::Base
 
-      desc "This generator installs KendoUI #{Kendoui::Rails::KENDOUI_VERSION}"
-      class_option :theme, :type => :string, :default => "default", :desc => "Kendo UI Theme to install"
-      source_root File.expand_path('../../../../../../vendor/assets/', __FILE__)
-      
-      def copy_kendoui
-        say_status("copying", "Kendo UI (#{Kendoui::Rails::KENDOUI_VERSION}) javascripts", :green)
+        desc "This generator installs KendoUI #{Kendoui::Rails::KENDOUI_VERSION}"
+        class_option :theme, :type => :string, :default => "default", :desc => "Kendo UI Theme to install"
         
-        copy_file "javascripts/kendo/kendo.all.min.js", "public/javascripts/kendo.all.min.js"
+        source_root File.expand_path('../../../../../../vendor/assets/', __FILE__)
+        
+        def copy_kendoui_scripts
+          say_status("copying", "Kendo UI (#{Kendoui::Rails::KENDOUI_VERSION}) javascripts", :green)
+          
+          copy_file "javascripts/kendo/kendo.all.min.js", "public/javascripts/kendo.all.min.js"
+        end
+              
+        def copy_kendoui_styles
+          say_status("copying", "Kendo UI (#{Kendoui::Rails::KENDOUI_VERSION}) stylesheets", :green)
+          
+          copy_file "stylesheets/kendo/kendo.common.min.css", "public/stylesheets/kendo.common.min.css"
+          copy_file "stylesheets/kendo/kendo.#{options.theme}.min.css", "public/stylesheets/kendo.#{options.theme}.min.css"
+        end
       end
-            
-      def copy_kendoui_styles
-        say_status("copying", "Kendo UI (#{Kendoui::Rails::KENDOUI_VERSION}) stylesheets", :green)
+    end
+  end
+else
+  module Kendoui
+    module Generators
+      class InstallGenerator < ::Rails::Generators::Base
+        desc "This generator installs KendoUI #{Kendoui::Rails::KENDOUI_VERSION}"
+        class_option :theme, :type => :string, :default => "default", :desc => "Kendo UI Theme to install"
+        
+        source_root File.expand_path("../../../../../../vendor/assets/", __FILE__)
         
-        copy_file "stylesheets/kendo/kendo.common.min.css", "public/stylesheets/kendo.common.min.css"
-        copy_file "stylesheets/kendo/kendo.#{options.theme}.min.css", "public/stylesheets/kendo.#{options.theme}.min.css"
+        def add_kendoui_scripts
+          say_status("adding", "Kendo UI (#{Kendoui::Rails::KENDOUI_VERSION}) to javascripts pipeline", :green)
+          
+          insert_into_file "app/assets/javascripts/application.js", "//= require kendo/kendo.all.min\n", :before => "//= require_tree ."
+        end
+              
+        def add_kendoui_styles
+          say_status("adding", "Kendo UI (#{Kendoui::Rails::KENDOUI_VERSION}) to styles pipeline", :green)
+          
+          insert_into_file "app/assets/stylesheets/application.css", "*= require kendo/kendo.common.min\n *= require kendo/kendo.#{options.theme}.min\n ", :before => "*= require_self"
+        end
       end
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kendoui-rails
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.0.4
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-02-26 00:00:00.000000000 Z
+date: 2012-02-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jquery-rails
-  requirement: &70138515171260 !ruby/object:Gem::Requirement
+  requirement: &70302667368560 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70138515171260
+  version_requirements: *70302667368560
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &70138515175380 !ruby/object:Gem::Requirement
+  requirement: &70302667367500 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +32,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70138515175380
+  version_requirements: *70302667367500
 - !ruby/object:Gem::Dependency
   name: rails
-  requirement: &70138514834820 !ruby/object:Gem::Requirement
+  requirement: &70302667366580 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,7 +43,7 @@ dependencies:
         version: 3.1.1
   type: :development
   prerelease: false
-  version_requirements: *70138514834820
+  version_requirements: *70302667366580
 description: Adds GPLv3 Portions of Kendo UI (http://kendoui.com) to javascripts and
   styles folders
 email:
@@ -499,7 +499,7 @@ files:
 - vendor/assets/stylesheets/kendo/kendo.silver.min.css
 - vendor/assets/stylesheets/kendo/textures/glass.png
 - vendor/assets/stylesheets/kendo/textures/highlight.png
-homepage: http://github.com/bsatrom/kendoui-rails
+homepage: http://github.com/bsatrom/kendoui_rails
 licenses: []
 post_install_message: 
 rdoc_options: []