Ruby and Rails Configuration

Overview

Notes on installing Ruby and Rails, and creating and configuring new Rails projects.

Ruby and Rails installation

• Getting Started with Rails (RailsGuides)
• Ruby Intsaller for Windows
  Download the Windows Installer and run it. Make sure the option to update the environment path is selected.
• SQLite Download Page
  The Rails tutorials use SQLite3.
• Install Rails:

  > gem install rails

New project from the command line

N.B. All of this can be accomplished from within the RubyMine IDE.

Create a new app.

> rails new project_name

Generate a model within the app.

Article is the name of the new model. title, teaser, and body are fields on the model. string and text are the data types.

This doesn't create a table on the database, just creates definitions of the model within the app.

> rails generate model Article title:string teaser:text body:text

Run rake to apply the changes to the database.

Detailed documentation on migrations

> rake db:migrate

Add some data in the db/seeds.rb file.

# db/seeds.rb

Article.create!(title: 'first title', teaser: 'sample teaser', body: 'sample body text.')
Article.create!(title: 'second title', body: 'Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.')
Article.create!(title: 'third title', teaser: '3rd article teaser', body: 'Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. ')

Commit the seeding.

> rake db:seed

Set up a simple route.

# config/routes.db

Rails.application.routes.draw do
  resources :articles
  route 'articles#index'

Run the server

> rails s

The address for the server is http://localhost:3000

IDE

• RubyMine (JetBrains)

Rails and Twitter Bootstrap

Bootstrap is written in LESS, but there is an official port to SASS that is maintained by the Bootstrap team.

Integrating Bootstrap with Rails

Install the Ruby Gems for Boostrap

# Gemfile

...

gem 'bootstrap-sass', '~> 3.2.0'
gem 'autoprefixer-rails'

# NOTE: The sass-rails gem is included with new Rails applications by default.
#       Please make sure that it is not already in your Gemfile before uncommenting it.
# gem 'sass-rails'

Autoprefixer (autoprefixer-rails) is optional, but recommended. It automatically adds the proper vendor prefixes to your CSS code when it is compiled.

To install the gems, run:

> bundle install

Import Bootstrap CSS assets

Rename app/assets/stylesheets/application.css to app/assets/stylesheets/application.css.sass.

Import the Bootstrap assets in the newly renamed application.css.sass file.

// app/assets/stylesheets/application.css.sass

...

@import "bootstrap-sprockets"
@import "bootstrap"

When you compile, imported assets render a compiled version of their contents where the @import statement was found.

Import Bootstrap JavaScript assets

Add directive to app/assets/javascripts/application.js.

//= require bootstrap-sprockets

This must come after

//= require jquery

The file should look like this

// app/assets/javascripts/application.js

...

//= require jquery
//= require jquery_ujs
//= require turbolinks
//= require bootstrap-sprockets
//= require_tree .

It's important this this is the last thing to be required:

//= require_tree .

//= require_tree . complies each of the other JavaScript files in the javascripts directory and any subdirectories.

• Boostrap Tutorial on Rails, Installation