Kendo UI Labs projects are experimental and largely built and supported by the community. As such Telerik does not provide official support for any of the Kendo UI Labs projects via Telerik support agreements. We do encourage you to open an issue or visit Stack Overflow.
Kendo UI For Rails!
This gem provides:
- Kendo UI Styles (Common Styles and All themes)
Compatibility and Requirements
kendo-rails is designed to help developers work with Kendo UI Web in Rails applications. It currently depends on the following libraries:
kendo-rails has not been tested against any other versions of these libraries. You may find that versions other than these are compatible with [Project Name], but we make no claims to support those version, nor can we troubleshoot issues that arise when using those versions.
Installation and Usage
In your Gemfile, add this line:
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:
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
//= require kendo/kendo.web.min
Appropriate styles will also be added to the asset pipeline, with the following two lines added to
*= 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, or use the
--theme switch in the generate command (see below for details).
Rails 3.0, Previous or Asset Pipeline Disabled
public folder for your application. After running
rails generate kendoui:install you'll see the following in your public folder:
Once these files are in place, you can add them to your layouts like so:
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
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
For Non-Asset Pipeline Environments, you can pass "all" into the theme switch, which will copy all available themes into your
How to Contribute
If you would like to contribute to kendo-rails's source code, please read the guidelines for pull requests and contributions. Following these guidelines will help make your contributions easier to bring in to the next release.
Use this section to list ways that a developer can obtain help or support for this project, for instance, Stack Overflow. Make sure to also leave the following section:
As a part of Kendo UI Labs, [Project Name] is intended to be a community-run project, and not an official part of any Kendo UI SKU (Web, DataViz, Mobile or Complete). As such, this project is not a supported part of Kendo UI, and is not covered under the support agreements for Kendo UI license holders. Please do not create support requests for this project, as these will be immediately closed and you'll be directed to post your question on a community forum.
For change logs and release notes, see the changelog file.
You can also find Kendo UI on:
This project has been released under the Apache License, version 2.0, the text of which is included below. This license applies ONLY to the project-specific source of each repository and does not extend to Kendo UI itself, or any other 3rd party libraries used in a repository. For licensing information about Kendo UI, see the License Agreements page at KendoUI.com.
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 page.
Copyright © 2013 Telerik
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.