Skip to content
This repository
Browse code

Added getting_started code, updated guide with link to rails github r…

…epo and path to code
  • Loading branch information...
commit d7154d483269fc25d771d5b8b7b8a2c889e4b3f5 1 parent 4bcacc8
James Gifford authored September 12, 2011

Showing 89 changed files with 1,417 additions and 0 deletions. Show diff stats Hide diff stats

  1. 0  assets/.gitkeep b/railties/guides/code/getting_started/lib/assets/.gitkeep
  2. 32  railties/guides/code/getting_started/Gemfile
  3. 261  railties/guides/code/getting_started/README
  4. 7  railties/guides/code/getting_started/Rakefile
  5. BIN  railties/guides/code/getting_started/app/assets/images/rails.png
  6. 9  railties/guides/code/getting_started/app/assets/javascripts/application.js
  7. 3  railties/guides/code/getting_started/app/assets/javascripts/comments.js.coffee
  8. 3  railties/guides/code/getting_started/app/assets/javascripts/home.js.coffee
  9. 3  railties/guides/code/getting_started/app/assets/javascripts/posts.js.coffee
  10. 7  railties/guides/code/getting_started/app/assets/stylesheets/application.css
  11. 3  railties/guides/code/getting_started/app/assets/stylesheets/comments.css.scss
  12. 3  railties/guides/code/getting_started/app/assets/stylesheets/home.css.scss
  13. 3  railties/guides/code/getting_started/app/assets/stylesheets/posts.css.scss
  14. 56  railties/guides/code/getting_started/app/assets/stylesheets/scaffolds.css.scss
  15. 3  railties/guides/code/getting_started/app/controllers/application_controller.rb
  16. 16  railties/guides/code/getting_started/app/controllers/comments_controller.rb
  17. 5  railties/guides/code/getting_started/app/controllers/home_controller.rb
  18. 84  railties/guides/code/getting_started/app/controllers/posts_controller.rb
  19. 2  railties/guides/code/getting_started/app/helpers/application_helper.rb
  20. 2  railties/guides/code/getting_started/app/helpers/comments_helper.rb
  21. 2  railties/guides/code/getting_started/app/helpers/home_helper.rb
  22. 5  railties/guides/code/getting_started/app/helpers/posts_helper.rb
  23. 0  railties/guides/code/getting_started/app/mailers/.gitkeep
  24. 0  railties/guides/code/getting_started/app/models/.gitkeep
  25. 3  railties/guides/code/getting_started/app/models/comment.rb
  26. 11  railties/guides/code/getting_started/app/models/post.rb
  27. 3  railties/guides/code/getting_started/app/models/tag.rb
  28. 15  railties/guides/code/getting_started/app/views/comments/_comment.html.erb
  29. 13  railties/guides/code/getting_started/app/views/comments/_form.html.erb
  30. 2  railties/guides/code/getting_started/app/views/home/index.html.erb
  31. 2  railties/guides/code/getting_started/app/views/home/index.html.erb~
  32. 14  railties/guides/code/getting_started/app/views/layouts/application.html.erb
  33. 32  railties/guides/code/getting_started/app/views/posts/_form.html.erb
  34. 6  railties/guides/code/getting_started/app/views/posts/edit.html.erb
  35. 27  railties/guides/code/getting_started/app/views/posts/index.html.erb
  36. 5  railties/guides/code/getting_started/app/views/posts/new.html.erb
  37. 31  railties/guides/code/getting_started/app/views/posts/show.html.erb
  38. 12  railties/guides/code/getting_started/app/views/tags/_form.html.erb
  39. 4  railties/guides/code/getting_started/config.ru
  40. 48  railties/guides/code/getting_started/config/application.rb
  41. 6  railties/guides/code/getting_started/config/boot.rb
  42. 25  railties/guides/code/getting_started/config/database.yml
  43. 5  railties/guides/code/getting_started/config/environment.rb
  44. 30  railties/guides/code/getting_started/config/environments/development.rb
  45. 60  railties/guides/code/getting_started/config/environments/production.rb
  46. 42  railties/guides/code/getting_started/config/environments/test.rb
  47. 7  railties/guides/code/getting_started/config/initializers/backtrace_silencers.rb
  48. 10  railties/guides/code/getting_started/config/initializers/inflections.rb
  49. 5  railties/guides/code/getting_started/config/initializers/mime_types.rb
  50. 7  railties/guides/code/getting_started/config/initializers/secret_token.rb
  51. 8  railties/guides/code/getting_started/config/initializers/session_store.rb
  52. 14  railties/guides/code/getting_started/config/initializers/wrap_parameters.rb
  53. 5  railties/guides/code/getting_started/config/locales/en.yml
  54. 64  railties/guides/code/getting_started/config/routes.rb
  55. 60  railties/guides/code/getting_started/config/routes.rb~
  56. 11  railties/guides/code/getting_started/db/migrate/20110901012504_create_posts.rb
  57. 12  railties/guides/code/getting_started/db/migrate/20110901012815_create_comments.rb
  58. 11  railties/guides/code/getting_started/db/migrate/20110901013701_create_tags.rb
  59. 43  railties/guides/code/getting_started/db/schema.rb
  60. 7  railties/guides/code/getting_started/db/seeds.rb
  61. 2  railties/guides/code/getting_started/doc/README_FOR_APP
  62. 26  railties/guides/code/getting_started/public/404.html
  63. 26  railties/guides/code/getting_started/public/422.html
  64. 26  railties/guides/code/getting_started/public/500.html
  65. 0  railties/guides/code/getting_started/public/favicon.ico
  66. 5  railties/guides/code/getting_started/public/robots.txt
  67. 6  railties/guides/code/getting_started/script/rails
  68. 0  railties/guides/code/getting_started/test/fixtures/.gitkeep
  69. 11  railties/guides/code/getting_started/test/fixtures/comments.yml
  70. 11  railties/guides/code/getting_started/test/fixtures/posts.yml
  71. 9  railties/guides/code/getting_started/test/fixtures/tags.yml
  72. 0  railties/guides/code/getting_started/test/functional/.gitkeep
  73. 7  railties/guides/code/getting_started/test/functional/comments_controller_test.rb
  74. 9  railties/guides/code/getting_started/test/functional/home_controller_test.rb
  75. 49  railties/guides/code/getting_started/test/functional/posts_controller_test.rb
  76. 0  railties/guides/code/getting_started/test/integration/.gitkeep
  77. 12  railties/guides/code/getting_started/test/performance/browsing_test.rb
  78. 13  railties/guides/code/getting_started/test/test_helper.rb
  79. 0  railties/guides/code/getting_started/test/unit/.gitkeep
  80. 7  railties/guides/code/getting_started/test/unit/comment_test.rb
  81. 4  railties/guides/code/getting_started/test/unit/helpers/comments_helper_test.rb
  82. 4  railties/guides/code/getting_started/test/unit/helpers/home_helper_test.rb
  83. 4  railties/guides/code/getting_started/test/unit/helpers/posts_helper_test.rb
  84. 7  railties/guides/code/getting_started/test/unit/post_test.rb
  85. 7  railties/guides/code/getting_started/test/unit/tag_test.rb
  86. 0  railties/guides/code/getting_started/vendor/assets/stylesheets/.gitkeep
  87. 0  railties/guides/code/getting_started/vendor/plugins/.gitkeep
  88. 3  railties/guides/source/getting_started.textile
  89. 0  tasks/.gitkeep b/railties/guides/code/getting_started/lib/tasks/.gitkeep
0  assets/.gitkeep b/railties/guides/code/getting_started/lib/assets/.gitkeep
No changes.
32  railties/guides/code/getting_started/Gemfile
... ...
@@ -0,0 +1,32 @@
  1
+source 'http://rubygems.org'
  2
+
  3
+gem 'rails', '3.1.0'
  4
+# Bundle edge Rails instead:
  5
+# gem 'rails',     :git => 'git://github.com/rails/rails.git'
  6
+
  7
+gem 'sqlite3'
  8
+
  9
+
  10
+# Gems used only for assets and not required
  11
+# in production environments by default.
  12
+group :assets do
  13
+  gem 'sass-rails', "  ~> 3.1.0"
  14
+  gem 'coffee-rails', "~> 3.1.0"
  15
+  gem 'uglifier'
  16
+end
  17
+
  18
+gem 'jquery-rails'
  19
+
  20
+# Use unicorn as the web server
  21
+# gem 'unicorn'
  22
+
  23
+# Deploy with Capistrano
  24
+# gem 'capistrano'
  25
+
  26
+# To use debugger
  27
+# gem 'ruby-debug19', :require => 'ruby-debug'
  28
+
  29
+group :test do
  30
+  # Pretty printed test output
  31
+  gem 'turn', :require => false
  32
+end
261  railties/guides/code/getting_started/README
... ...
@@ -0,0 +1,261 @@
  1
+== Welcome to Rails
  2
+
  3
+Rails is a web-application framework that includes everything needed to create
  4
+database-backed web applications according to the Model-View-Control pattern.
  5
+
  6
+This pattern splits the view (also called the presentation) into "dumb"
  7
+templates that are primarily responsible for inserting pre-built data in between
  8
+HTML tags. The model contains the "smart" domain objects (such as Account,
  9
+Product, Person, Post) that holds all the business logic and knows how to
  10
+persist themselves to a database. The controller handles the incoming requests
  11
+(such as Save New Account, Update Product, Show Post) by manipulating the model
  12
+and directing data to the view.
  13
+
  14
+In Rails, the model is handled by what's called an object-relational mapping
  15
+layer entitled Active Record. This layer allows you to present the data from
  16
+database rows as objects and embellish these data objects with business logic
  17
+methods. You can read more about Active Record in
  18
+link:files/vendor/rails/activerecord/README.html.
  19
+
  20
+The controller and view are handled by the Action Pack, which handles both
  21
+layers by its two parts: Action View and Action Controller. These two layers
  22
+are bundled in a single package due to their heavy interdependence. This is
  23
+unlike the relationship between the Active Record and Action Pack that is much
  24
+more separate. Each of these packages can be used independently outside of
  25
+Rails. You can read more about Action Pack in
  26
+link:files/vendor/rails/actionpack/README.html.
  27
+
  28
+
  29
+== Getting Started
  30
+
  31
+1. At the command prompt, create a new Rails application:
  32
+       <tt>rails new myapp</tt> (where <tt>myapp</tt> is the application name)
  33
+
  34
+2. Change directory to <tt>myapp</tt> and start the web server:
  35
+       <tt>cd myapp; rails server</tt> (run with --help for options)
  36
+
  37
+3. Go to http://localhost:3000/ and you'll see:
  38
+       "Welcome aboard: You're riding Ruby on Rails!"
  39
+
  40
+4. Follow the guidelines to start developing your application. You can find
  41
+the following resources handy:
  42
+
  43
+* The Getting Started Guide: http://guides.rubyonrails.org/getting_started.html
  44
+* Ruby on Rails Tutorial Book: http://www.railstutorial.org/
  45
+
  46
+
  47
+== Debugging Rails
  48
+
  49
+Sometimes your application goes wrong. Fortunately there are a lot of tools that
  50
+will help you debug it and get it back on the rails.
  51
+
  52
+First area to check is the application log files. Have "tail -f" commands
  53
+running on the server.log and development.log. Rails will automatically display
  54
+debugging and runtime information to these files. Debugging info will also be
  55
+shown in the browser on requests from 127.0.0.1.
  56
+
  57
+You can also log your own messages directly into the log file from your code
  58
+using the Ruby logger class from inside your controllers. Example:
  59
+
  60
+  class WeblogController < ActionController::Base
  61
+    def destroy
  62
+      @weblog = Weblog.find(params[:id])
  63
+      @weblog.destroy
  64
+      logger.info("#{Time.now} Destroyed Weblog ID ##{@weblog.id}!")
  65
+    end
  66
+  end
  67
+
  68
+The result will be a message in your log file along the lines of:
  69
+
  70
+  Mon Oct 08 14:22:29 +1000 2007 Destroyed Weblog ID #1!
  71
+
  72
+More information on how to use the logger is at http://www.ruby-doc.org/core/
  73
+
  74
+Also, Ruby documentation can be found at http://www.ruby-lang.org/. There are
  75
+several books available online as well:
  76
+
  77
+* Programming Ruby: http://www.ruby-doc.org/docs/ProgrammingRuby/ (Pickaxe)
  78
+* Learn to Program: http://pine.fm/LearnToProgram/ (a beginners guide)
  79
+
  80
+These two books will bring you up to speed on the Ruby language and also on
  81
+programming in general.
  82
+
  83
+
  84
+== Debugger
  85
+
  86
+Debugger support is available through the debugger command when you start your
  87
+Mongrel or WEBrick server with --debugger. This means that you can break out of
  88
+execution at any point in the code, investigate and change the model, and then,
  89
+resume execution! You need to install ruby-debug to run the server in debugging
  90
+mode. With gems, use <tt>sudo gem install ruby-debug</tt>. Example:
  91
+
  92
+  class WeblogController < ActionController::Base
  93
+    def index
  94
+      @posts = Post.all
  95
+      debugger
  96
+    end
  97
+  end
  98
+
  99
+So the controller will accept the action, run the first line, then present you
  100
+with a IRB prompt in the server window. Here you can do things like:
  101
+
  102
+  >> @posts.inspect
  103
+  => "[#<Post:0x14a6be8
  104
+          @attributes={"title"=>nil, "body"=>nil, "id"=>"1"}>,
  105
+       #<Post:0x14a6620
  106
+          @attributes={"title"=>"Rails", "body"=>"Only ten..", "id"=>"2"}>]"
  107
+  >> @posts.first.title = "hello from a debugger"
  108
+  => "hello from a debugger"
  109
+
  110
+...and even better, you can examine how your runtime objects actually work:
  111
+
  112
+  >> f = @posts.first
  113
+  => #<Post:0x13630c4 @attributes={"title"=>nil, "body"=>nil, "id"=>"1"}>
  114
+  >> f.
  115
+  Display all 152 possibilities? (y or n)
  116
+
  117
+Finally, when you're ready to resume execution, you can enter "cont".
  118
+
  119
+
  120
+== Console
  121
+
  122
+The console is a Ruby shell, which allows you to interact with your
  123
+application's domain model. Here you'll have all parts of the application
  124
+configured, just like it is when the application is running. You can inspect
  125
+domain models, change values, and save to the database. Starting the script
  126
+without arguments will launch it in the development environment.
  127
+
  128
+To start the console, run <tt>rails console</tt> from the application
  129
+directory.
  130
+
  131
+Options:
  132
+
  133
+* Passing the <tt>-s, --sandbox</tt> argument will rollback any modifications
  134
+  made to the database.
  135
+* Passing an environment name as an argument will load the corresponding
  136
+  environment. Example: <tt>rails console production</tt>.
  137
+
  138
+To reload your controllers and models after launching the console run
  139
+<tt>reload!</tt>
  140
+
  141
+More information about irb can be found at:
  142
+link:http://www.rubycentral.org/pickaxe/irb.html
  143
+
  144
+
  145
+== dbconsole
  146
+
  147
+You can go to the command line of your database directly through <tt>rails
  148
+dbconsole</tt>. You would be connected to the database with the credentials
  149
+defined in database.yml. Starting the script without arguments will connect you
  150
+to the development database. Passing an argument will connect you to a different
  151
+database, like <tt>rails dbconsole production</tt>. Currently works for MySQL,
  152
+PostgreSQL and SQLite 3.
  153
+
  154
+== Description of Contents
  155
+
  156
+The default directory structure of a generated Ruby on Rails application:
  157
+
  158
+  |-- app
  159
+  |   |-- assets
  160
+  |       |-- images
  161
+  |       |-- javascripts
  162
+  |       `-- stylesheets
  163
+  |   |-- controllers
  164
+  |   |-- helpers
  165
+  |   |-- mailers
  166
+  |   |-- models
  167
+  |   `-- views
  168
+  |       `-- layouts
  169
+  |-- config
  170
+  |   |-- environments
  171
+  |   |-- initializers
  172
+  |   `-- locales
  173
+  |-- db
  174
+  |-- doc
  175
+  |-- lib
  176
+  |   `-- tasks
  177
+  |-- log
  178
+  |-- public
  179
+  |-- script
  180
+  |-- test
  181
+  |   |-- fixtures
  182
+  |   |-- functional
  183
+  |   |-- integration
  184
+  |   |-- performance
  185
+  |   `-- unit
  186
+  |-- tmp
  187
+  |   |-- cache
  188
+  |   |-- pids
  189
+  |   |-- sessions
  190
+  |   `-- sockets
  191
+  `-- vendor
  192
+      |-- assets
  193
+          `-- stylesheets
  194
+      `-- plugins
  195
+
  196
+app
  197
+  Holds all the code that's specific to this particular application.
  198
+
  199
+app/assets
  200
+  Contains subdirectories for images, stylesheets, and JavaScript files.
  201
+
  202
+app/controllers
  203
+  Holds controllers that should be named like weblogs_controller.rb for
  204
+  automated URL mapping. All controllers should descend from
  205
+  ApplicationController which itself descends from ActionController::Base.
  206
+
  207
+app/models
  208
+  Holds models that should be named like post.rb. Models descend from
  209
+  ActiveRecord::Base by default.
  210
+
  211
+app/views
  212
+  Holds the template files for the view that should be named like
  213
+  weblogs/index.html.erb for the WeblogsController#index action. All views use
  214
+  eRuby syntax by default.
  215
+
  216
+app/views/layouts
  217
+  Holds the template files for layouts to be used with views. This models the
  218
+  common header/footer method of wrapping views. In your views, define a layout
  219
+  using the <tt>layout :default</tt> and create a file named default.html.erb.
  220
+  Inside default.html.erb, call <% yield %> to render the view using this
  221
+  layout.
  222
+
  223
+app/helpers
  224
+  Holds view helpers that should be named like weblogs_helper.rb. These are
  225
+  generated for you automatically when using generators for controllers.
  226
+  Helpers can be used to wrap functionality for your views into methods.
  227
+
  228
+config
  229
+  Configuration files for the Rails environment, the routing map, the database,
  230
+  and other dependencies.
  231
+
  232
+db
  233
+  Contains the database schema in schema.rb. db/migrate contains all the
  234
+  sequence of Migrations for your schema.
  235
+
  236
+doc
  237
+  This directory is where your application documentation will be stored when
  238
+  generated using <tt>rake doc:app</tt>
  239
+
  240
+lib
  241
+  Application specific libraries. Basically, any kind of custom code that
  242
+  doesn't belong under controllers, models, or helpers. This directory is in
  243
+  the load path.
  244
+
  245
+public
  246
+  The directory available for the web server. Also contains the dispatchers and the
  247
+  default HTML files. This should be set as the DOCUMENT_ROOT of your web
  248
+  server.
  249
+
  250
+script
  251
+  Helper scripts for automation and generation.
  252
+
  253
+test
  254
+  Unit and functional tests along with fixtures. When using the rails generate
  255
+  command, template test files will be generated for you and placed in this
  256
+  directory.
  257
+
  258
+vendor
  259
+  External libraries that the application depends on. Also includes the plugins
  260
+  subdirectory. If the app has frozen rails, those gems also go here, under
  261
+  vendor/rails/. This directory is in the load path.
7  railties/guides/code/getting_started/Rakefile
... ...
@@ -0,0 +1,7 @@
  1
+#!/usr/bin/env rake
  2
+# Add your own tasks in files placed in lib/tasks ending in .rake,
  3
+# for example lib/tasks/capistrano.rake, and they will automatically be available to Rake.
  4
+
  5
+require File.expand_path('../config/application', __FILE__)
  6
+
  7
+Blog::Application.load_tasks
BIN  railties/guides/code/getting_started/app/assets/images/rails.png
9  railties/guides/code/getting_started/app/assets/javascripts/application.js
... ...
@@ -0,0 +1,9 @@
  1
+// This is a manifest file that'll be compiled into including all the files listed below.
  2
+// Add new JavaScript/Coffee code in separate files in this directory and they'll automatically
  3
+// be included in the compiled file accessible from http://example.com/assets/application.js
  4
+// It's not advisable to add code directly here, but if you do, it'll appear at the bottom of the
  5
+// the compiled file.
  6
+//
  7
+//= require jquery
  8
+//= require jquery_ujs
  9
+//= require_tree .
3  railties/guides/code/getting_started/app/assets/javascripts/comments.js.coffee
... ...
@@ -0,0 +1,3 @@
  1
+# Place all the behaviors and hooks related to the matching controller here.
  2
+# All this logic will automatically be available in application.js.
  3
+# You can use CoffeeScript in this file: http://jashkenas.github.com/coffee-script/
3  railties/guides/code/getting_started/app/assets/javascripts/home.js.coffee
... ...
@@ -0,0 +1,3 @@
  1
+# Place all the behaviors and hooks related to the matching controller here.
  2
+# All this logic will automatically be available in application.js.
  3
+# You can use CoffeeScript in this file: http://jashkenas.github.com/coffee-script/
3  railties/guides/code/getting_started/app/assets/javascripts/posts.js.coffee
... ...
@@ -0,0 +1,3 @@
  1
+# Place all the behaviors and hooks related to the matching controller here.
  2
+# All this logic will automatically be available in application.js.
  3
+# You can use CoffeeScript in this file: http://jashkenas.github.com/coffee-script/
7  railties/guides/code/getting_started/app/assets/stylesheets/application.css
... ...
@@ -0,0 +1,7 @@
  1
+/*
  2
+ * This is a manifest file that'll automatically include all the stylesheets available in this directory
  3
+ * and any sub-directories. You're free to add application-wide styles to this file and they'll appear at
  4
+ * the top of the compiled file, but it's generally better to create a new file per style scope.
  5
+ *= require_self
  6
+ *= require_tree . 
  7
+*/
3  railties/guides/code/getting_started/app/assets/stylesheets/comments.css.scss
... ...
@@ -0,0 +1,3 @@
  1
+// Place all the styles related to the Comments controller here.
  2
+// They will automatically be included in application.css.
  3
+// You can use Sass (SCSS) here: http://sass-lang.com/
3  railties/guides/code/getting_started/app/assets/stylesheets/home.css.scss
... ...
@@ -0,0 +1,3 @@
  1
+// Place all the styles related to the home controller here.
  2
+// They will automatically be included in application.css.
  3
+// You can use Sass (SCSS) here: http://sass-lang.com/
3  railties/guides/code/getting_started/app/assets/stylesheets/posts.css.scss
... ...
@@ -0,0 +1,3 @@
  1
+// Place all the styles related to the Posts controller here.
  2
+// They will automatically be included in application.css.
  3
+// You can use Sass (SCSS) here: http://sass-lang.com/
56  railties/guides/code/getting_started/app/assets/stylesheets/scaffolds.css.scss
... ...
@@ -0,0 +1,56 @@
  1
+body {
  2
+  background-color: #fff;
  3
+  color: #333;
  4
+  font-family: verdana, arial, helvetica, sans-serif;
  5
+  font-size: 13px;
  6
+  line-height: 18px; }
  7
+
  8
+p, ol, ul, td {
  9
+  font-family: verdana, arial, helvetica, sans-serif;
  10
+  font-size: 13px;
  11
+  line-height: 18px; }
  12
+
  13
+pre {
  14
+  background-color: #eee;
  15
+  padding: 10px;
  16
+  font-size: 11px; }
  17
+
  18
+a {
  19
+  color: #000;
  20
+  &:visited {
  21
+    color: #666; }
  22
+  &:hover {
  23
+    color: #fff;
  24
+    background-color: #000; } }
  25
+
  26
+div {
  27
+  &.field, &.actions {
  28
+    margin-bottom: 10px; } }
  29
+
  30
+#notice {
  31
+  color: green; }
  32
+
  33
+.field_with_errors {
  34
+  padding: 2px;
  35
+  background-color: red;
  36
+  display: table; }
  37
+
  38
+#error_explanation {
  39
+  width: 450px;
  40
+  border: 2px solid red;
  41
+  padding: 7px;
  42
+  padding-bottom: 0;
  43
+  margin-bottom: 20px;
  44
+  background-color: #f0f0f0;
  45
+  h2 {
  46
+    text-align: left;
  47
+    font-weight: bold;
  48
+    padding: 5px 5px 5px 15px;
  49
+    font-size: 12px;
  50
+    margin: -7px;
  51
+    margin-bottom: 0px;
  52
+    background-color: #c00;
  53
+    color: #fff; }
  54
+  ul li {
  55
+    font-size: 12px;
  56
+    list-style: square; } }
3  railties/guides/code/getting_started/app/controllers/application_controller.rb
... ...
@@ -0,0 +1,3 @@
  1
+class ApplicationController < ActionController::Base
  2
+  protect_from_forgery
  3
+end
16  railties/guides/code/getting_started/app/controllers/comments_controller.rb
... ...
@@ -0,0 +1,16 @@
  1
+class CommentsController < ApplicationController
  2
+	http_basic_authenticate_with :name => "dhh", :password => "secret", :only => :destroy
  3
+  def create
  4
+    @post = Post.find(params[:post_id])
  5
+    @comment = @post.comments.create(params[:comment])
  6
+    redirect_to post_path(@post)
  7
+  end
  8
+ 
  9
+  def destroy
  10
+    @post = Post.find(params[:post_id])
  11
+    @comment = @post.comments.find(params[:id])
  12
+    @comment.destroy
  13
+    redirect_to post_path(@post)
  14
+  end
  15
+ 
  16
+end
5  railties/guides/code/getting_started/app/controllers/home_controller.rb
... ...
@@ -0,0 +1,5 @@
  1
+class HomeController < ApplicationController
  2
+  def index
  3
+  end
  4
+
  5
+end
84  railties/guides/code/getting_started/app/controllers/posts_controller.rb
... ...
@@ -0,0 +1,84 @@
  1
+class PostsController < ApplicationController
  2
+  http_basic_authenticate_with :name => "dhh", :password => "secret", :except => :index
  3
+  # GET /posts
  4
+  # GET /posts.json
  5
+  def index
  6
+    @posts = Post.all
  7
+
  8
+    respond_to do |format|
  9
+      format.html # index.html.erb
  10
+      format.json { render json: @posts }
  11
+    end
  12
+  end
  13
+
  14
+  # GET /posts/1
  15
+  # GET /posts/1.json
  16
+  def show
  17
+    @post = Post.find(params[:id])
  18
+
  19
+    respond_to do |format|
  20
+      format.html # show.html.erb
  21
+      format.json { render json: @post }
  22
+    end
  23
+  end
  24
+
  25
+  # GET /posts/new
  26
+  # GET /posts/new.json
  27
+  def new
  28
+    @post = Post.new
  29
+
  30
+    respond_to do |format|
  31
+      format.html # new.html.erb
  32
+      format.json { render json: @post }
  33
+    end
  34
+  end
  35
+
  36
+  # GET /posts/1/edit
  37
+  def edit
  38
+    @post = Post.find(params[:id])
  39
+  end
  40
+
  41
+  # POST /posts
  42
+  # POST /posts.json
  43
+  def create
  44
+    @post = Post.new(params[:post])
  45
+
  46
+    respond_to do |format|
  47
+      if @post.save
  48
+        format.html { redirect_to @post, notice: 'Post was successfully created.' }
  49
+        format.json { render json: @post, status: :created, location: @post }
  50
+      else
  51
+        format.html { render action: "new" }
  52
+        format.json { render json: @post.errors, status: :unprocessable_entity }
  53
+      end
  54
+    end
  55
+  end
  56
+
  57
+  # PUT /posts/1
  58
+  # PUT /posts/1.json
  59
+  def update
  60
+    @post = Post.find(params[:id])
  61
+
  62
+    respond_to do |format|
  63
+      if @post.update_attributes(params[:post])
  64
+        format.html { redirect_to @post, notice: 'Post was successfully updated.' }
  65
+        format.json { head :ok }
  66
+      else
  67
+        format.html { render action: "edit" }
  68
+        format.json { render json: @post.errors, status: :unprocessable_entity }
  69
+      end
  70
+    end
  71
+  end
  72
+
  73
+  # DELETE /posts/1
  74
+  # DELETE /posts/1.json
  75
+  def destroy
  76
+    @post = Post.find(params[:id])
  77
+    @post.destroy
  78
+
  79
+    respond_to do |format|
  80
+      format.html { redirect_to posts_url }
  81
+      format.json { head :ok }
  82
+    end
  83
+  end
  84
+end
2  railties/guides/code/getting_started/app/helpers/application_helper.rb
... ...
@@ -0,0 +1,2 @@
  1
+module ApplicationHelper
  2
+end
2  railties/guides/code/getting_started/app/helpers/comments_helper.rb
... ...
@@ -0,0 +1,2 @@
  1
+module CommentsHelper
  2
+end
2  railties/guides/code/getting_started/app/helpers/home_helper.rb
... ...
@@ -0,0 +1,2 @@
  1
+module HomeHelper
  2
+end
5  railties/guides/code/getting_started/app/helpers/posts_helper.rb
... ...
@@ -0,0 +1,5 @@
  1
+module PostsHelper
  2
+  def join_tags(post)
  3
+    post.tags.map { |t| t.name }.join(", ")
  4
+  end
  5
+end
0  railties/guides/code/getting_started/app/mailers/.gitkeep
No changes.
0  railties/guides/code/getting_started/app/models/.gitkeep
No changes.
3  railties/guides/code/getting_started/app/models/comment.rb
... ...
@@ -0,0 +1,3 @@
  1
+class Comment < ActiveRecord::Base
  2
+  belongs_to :post
  3
+end
11  railties/guides/code/getting_started/app/models/post.rb
... ...
@@ -0,0 +1,11 @@
  1
+class Post < ActiveRecord::Base
  2
+  validates :name,  :presence => true
  3
+  validates :title, :presence => true,
  4
+                    :length => { :minimum => 5 }
  5
+ 
  6
+  has_many :comments, :dependent => :destroy
  7
+  has_many :tags
  8
+ 
  9
+  accepts_nested_attributes_for :tags, :allow_destroy => :true,
  10
+    :reject_if => proc { |attrs| attrs.all? { |k, v| v.blank? } }
  11
+end
3  railties/guides/code/getting_started/app/models/tag.rb
... ...
@@ -0,0 +1,3 @@
  1
+class Tag < ActiveRecord::Base
  2
+  belongs_to :post
  3
+end
15  railties/guides/code/getting_started/app/views/comments/_comment.html.erb
... ...
@@ -0,0 +1,15 @@
  1
+<p>
  2
+  <b>Commenter:</b>
  3
+  <%= comment.commenter %>
  4
+</p>
  5
+ 
  6
+<p>
  7
+  <b>Comment:</b>
  8
+  <%= comment.body %>
  9
+</p>
  10
+ 
  11
+<p>
  12
+  <%= link_to 'Destroy Comment', [comment.post, comment],
  13
+               :confirm => 'Are you sure?',
  14
+               :method => :delete %>
  15
+</p>
13  railties/guides/code/getting_started/app/views/comments/_form.html.erb
... ...
@@ -0,0 +1,13 @@
  1
+<%= form_for([@post, @post.comments.build]) do |f| %>
  2
+  <div class="field">
  3
+    <%= f.label :commenter %><br />
  4
+    <%= f.text_field :commenter %>
  5
+  </div>
  6
+  <div class="field">
  7
+    <%= f.label :body %><br />
  8
+    <%= f.text_area :body %>
  9
+  </div>
  10
+  <div class="actions">
  11
+    <%= f.submit %>
  12
+  </div>
  13
+<% end %>
2  railties/guides/code/getting_started/app/views/home/index.html.erb
... ...
@@ -0,0 +1,2 @@
  1
+<h1>Hello, Rails!</h1>
  2
+<%= link_to "My Blog", posts_path %>
2  railties/guides/code/getting_started/app/views/home/index.html.erb~
... ...
@@ -0,0 +1,2 @@
  1
+<h1>Home#index</h1>
  2
+<p>Find me in app/views/home/index.html.erb</p>
14  railties/guides/code/getting_started/app/views/layouts/application.html.erb
... ...
@@ -0,0 +1,14 @@
  1
+<!DOCTYPE html>
  2
+<html>
  3
+<head>
  4
+  <title>Blog</title>
  5
+  <%= stylesheet_link_tag    "application" %>
  6
+  <%= javascript_include_tag "application" %>
  7
+  <%= csrf_meta_tags %>
  8
+</head>
  9
+<body style="background: #EEEEEE;">
  10
+
  11
+<%= yield %>
  12
+
  13
+</body>
  14
+</html>
32  railties/guides/code/getting_started/app/views/posts/_form.html.erb
... ...
@@ -0,0 +1,32 @@
  1
+<% @post.tags.build %>
  2
+<%= form_for(@post) do |post_form| %>
  3
+  <% if @post.errors.any? %>
  4
+  <div id="errorExplanation">
  5
+    <h2><%= pluralize(@post.errors.count, "error") %> prohibited this post from being saved:</h2>
  6
+    <ul>
  7
+    <% @post.errors.full_messages.each do |msg| %>
  8
+      <li><%= msg %></li>
  9
+    <% end %>
  10
+    </ul>
  11
+  </div>
  12
+  <% end %>
  13
+ 
  14
+  <div class="field">
  15
+    <%= post_form.label :name %><br />
  16
+    <%= post_form.text_field :name %>
  17
+  </div>
  18
+  <div class="field">
  19
+    <%= post_form.label :title %><br />
  20
+    <%= post_form.text_field :title %>
  21
+  </div>
  22
+  <div class="field">
  23
+    <%= post_form.label :content %><br />
  24
+    <%= post_form.text_area :content %>
  25
+  </div>
  26
+  <h2>Tags</h2>
  27
+  <%= render :partial => 'tags/form',
  28
+             :locals => {:form => post_form} %>
  29
+  <div class="actions">
  30
+    <%= post_form.submit %>
  31
+  </div>
  32
+<% end %>
6  railties/guides/code/getting_started/app/views/posts/edit.html.erb
... ...
@@ -0,0 +1,6 @@
  1
+<h1>Editing post</h1>
  2
+
  3
+<%= render 'form' %>
  4
+
  5
+<%= link_to 'Show', @post %> |
  6
+<%= link_to 'Back', posts_path %>
27  railties/guides/code/getting_started/app/views/posts/index.html.erb
... ...
@@ -0,0 +1,27 @@
  1
+<h1>Listing posts</h1>
  2
+
  3
+<table>
  4
+  <tr>
  5
+    <th>Name</th>
  6
+    <th>Title</th>
  7
+    <th>Content</th>
  8
+    <th></th>
  9
+    <th></th>
  10
+    <th></th>
  11
+  </tr>
  12
+
  13
+<% @posts.each do |post| %>
  14
+  <tr>
  15
+    <td><%= post.name %></td>
  16
+    <td><%= post.title %></td>
  17
+    <td><%= post.content %></td>
  18
+    <td><%= link_to 'Show', post %></td>
  19
+    <td><%= link_to 'Edit', edit_post_path(post) %></td>
  20
+    <td><%= link_to 'Destroy', post, confirm: 'Are you sure?', method: :delete %></td>
  21
+  </tr>
  22
+<% end %>
  23
+</table>
  24
+
  25
+<br />
  26
+
  27
+<%= link_to 'New Post', new_post_path %>
5  railties/guides/code/getting_started/app/views/posts/new.html.erb
... ...
@@ -0,0 +1,5 @@
  1
+<h1>New post</h1>
  2
+
  3
+<%= render 'form' %>
  4
+
  5
+<%= link_to 'Back', posts_path %>
31  railties/guides/code/getting_started/app/views/posts/show.html.erb
... ...
@@ -0,0 +1,31 @@
  1
+<p class="notice"><%= notice %></p>
  2
+ 
  3
+<p>
  4
+  <b>Name:</b>
  5
+  <%= @post.name %>
  6
+</p>
  7
+ 
  8
+<p>
  9
+  <b>Title:</b>
  10
+  <%= @post.title %>
  11
+</p>
  12
+ 
  13
+<p>
  14
+  <b>Content:</b>
  15
+  <%= @post.content %>
  16
+</p>
  17
+ 
  18
+<p>
  19
+  <b>Tags:</b>
  20
+  <%= join_tags(@post) %>
  21
+</p>
  22
+ 
  23
+<h2>Comments</h2>
  24
+<%= render @post.comments %>
  25
+ 
  26
+<h2>Add a comment:</h2>
  27
+<%= render "comments/form" %>
  28
+ 
  29
+ 
  30
+<%= link_to 'Edit Post', edit_post_path(@post) %> |
  31
+<%= link_to 'Back to Posts', posts_path %> |
12  railties/guides/code/getting_started/app/views/tags/_form.html.erb
... ...
@@ -0,0 +1,12 @@
  1
+<%= form.fields_for :tags do |tag_form| %>
  2
+  <div class="field">
  3
+    <%= tag_form.label :name, 'Tag:' %>
  4
+    <%= tag_form.text_field :name %>
  5
+  </div>
  6
+  <% unless tag_form.object.nil? || tag_form.object.new_record? %>
  7
+    <div class="field">
  8
+      <%= tag_form.label :_destroy, 'Remove:' %>
  9
+      <%= tag_form.check_box :_destroy %>
  10
+    </div>
  11
+  <% end %>
  12
+<% end %>
4  railties/guides/code/getting_started/config.ru
... ...
@@ -0,0 +1,4 @@
  1
+# This file is used by Rack-based servers to start the application.
  2
+
  3
+require ::File.expand_path('../config/environment',  __FILE__)
  4
+run Blog::Application
48  railties/guides/code/getting_started/config/application.rb
... ...
@@ -0,0 +1,48 @@
  1
+require File.expand_path('../boot', __FILE__)
  2
+
  3
+require 'rails/all'
  4
+
  5
+if defined?(Bundler)
  6
+  # If you precompile assets before deploying to production, use this line
  7
+  Bundler.require *Rails.groups(:assets => %w(development test))
  8
+  # If you want your assets lazily compiled in production, use this line
  9
+  # Bundler.require(:default, :assets, Rails.env)
  10
+end
  11
+
  12
+module Blog
  13
+  class Application < Rails::Application
  14
+    # Settings in config/environments/* take precedence over those specified here.
  15
+    # Application configuration should go into files in config/initializers
  16
+    # -- all .rb files in that directory are automatically loaded.
  17
+
  18
+    # Custom directories with classes and modules you want to be autoloadable.
  19
+    # config.autoload_paths += %W(#{config.root}/extras)
  20
+
  21
+    # Only load the plugins named here, in the order given (default is alphabetical).
  22
+    # :all can be used as a placeholder for all plugins not explicitly named.
  23
+    # config.plugins = [ :exception_notification, :ssl_requirement, :all ]
  24
+
  25
+    # Activate observers that should always be running.
  26
+    # config.active_record.observers = :cacher, :garbage_collector, :forum_observer
  27
+
  28
+    # Set Time.zone default to the specified zone and make Active Record auto-convert to this zone.
  29
+    # Run "rake -D time" for a list of tasks for finding time zone names. Default is UTC.
  30
+    # config.time_zone = 'Central Time (US & Canada)'
  31
+
  32
+    # The default locale is :en and all translations from config/locales/*.rb,yml are auto loaded.
  33
+    # config.i18n.load_path += Dir[Rails.root.join('my', 'locales', '*.{rb,yml}').to_s]
  34
+    # config.i18n.default_locale = :de
  35
+
  36
+    # Configure the default encoding used in templates for Ruby 1.9.
  37
+    config.encoding = "utf-8"
  38
+
  39
+    # Configure sensitive parameters which will be filtered from the log file.
  40
+    config.filter_parameters += [:password]
  41
+
  42
+    # Enable the asset pipeline
  43
+    config.assets.enabled = true
  44
+
  45
+    # Version of your assets, change this if you want to expire all your assets
  46
+    config.assets.version = '1.0'
  47
+  end
  48
+end
6  railties/guides/code/getting_started/config/boot.rb
... ...
@@ -0,0 +1,6 @@
  1
+require 'rubygems'
  2
+
  3
+# Set up gems listed in the Gemfile.
  4
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../../Gemfile', __FILE__)
  5
+
  6
+require 'bundler/setup' if File.exists?(ENV['BUNDLE_GEMFILE'])
25  railties/guides/code/getting_started/config/database.yml
... ...
@@ -0,0 +1,25 @@
  1
+# SQLite version 3.x
  2
+#   gem install sqlite3
  3
+#
  4
+#   Ensure the SQLite 3 gem is defined in your Gemfile
  5
+#   gem 'sqlite3'
  6
+development:
  7
+  adapter: sqlite3
  8
+  database: db/development.sqlite3
  9
+  pool: 5
  10
+  timeout: 5000
  11
+
  12
+# Warning: The database defined as "test" will be erased and
  13
+# re-generated from your development database when you run "rake".
  14
+# Do not set this db to the same as development or production.
  15
+test:
  16
+  adapter: sqlite3
  17
+  database: db/test.sqlite3
  18
+  pool: 5
  19
+  timeout: 5000
  20
+
  21
+production:
  22
+  adapter: sqlite3
  23
+  database: db/production.sqlite3
  24
+  pool: 5
  25
+  timeout: 5000
5  railties/guides/code/getting_started/config/environment.rb
... ...
@@ -0,0 +1,5 @@
  1
+# Load the rails application
  2
+require File.expand_path('../application', __FILE__)
  3
+
  4
+# Initialize the rails application
  5
+Blog::Application.initialize!
30  railties/guides/code/getting_started/config/environments/development.rb
... ...
@@ -0,0 +1,30 @@
  1
+Blog::Application.configure do
  2
+  # Settings specified here will take precedence over those in config/application.rb
  3
+
  4
+  # In the development environment your application's code is reloaded on
  5
+  # every request.  This slows down response time but is perfect for development
  6
+  # since you don't have to restart the web server when you make code changes.
  7
+  config.cache_classes = false
  8
+
  9
+  # Log error messages when you accidentally call methods on nil.
  10
+  config.whiny_nils = true
  11
+
  12
+  # Show full error reports and disable caching
  13
+  config.consider_all_requests_local       = true
  14
+  config.action_controller.perform_caching = false
  15
+
  16
+  # Don't care if the mailer can't send
  17
+  config.action_mailer.raise_delivery_errors = false
  18
+
  19
+  # Print deprecation notices to the Rails logger
  20
+  config.active_support.deprecation = :log
  21
+
  22
+  # Only use best-standards-support built into browsers
  23
+  config.action_dispatch.best_standards_support = :builtin
  24
+
  25
+  # Do not compress assets
  26
+  config.assets.compress = false
  27
+
  28
+  # Expands the lines which load the assets
  29
+  config.assets.debug = true
  30
+end
60  railties/guides/code/getting_started/config/environments/production.rb
... ...
@@ -0,0 +1,60 @@
  1
+Blog::Application.configure do
  2
+  # Settings specified here will take precedence over those in config/application.rb
  3
+
  4
+  # Code is not reloaded between requests
  5
+  config.cache_classes = true
  6
+
  7
+  # Full error reports are disabled and caching is turned on
  8
+  config.consider_all_requests_local       = false
  9
+  config.action_controller.perform_caching = true
  10
+
  11
+  # Disable Rails's static asset server (Apache or nginx will already do this)
  12
+  config.serve_static_assets = false
  13
+
  14
+  # Compress JavaScripts and CSS
  15
+  config.assets.compress = true
  16
+
  17
+  # Don't fallback to assets pipeline if a precompiled asset is missed
  18
+  config.assets.compile = false
  19
+
  20
+  # Generate digests for assets URLs
  21
+  config.assets.digest = true
  22
+
  23
+  # Defaults to Rails.root.join("public/assets")
  24
+  # config.assets.manifest = YOUR_PATH
  25
+
  26
+  # Specifies the header that your server uses for sending files
  27
+  # config.action_dispatch.x_sendfile_header = "X-Sendfile" # for apache
  28
+  # config.action_dispatch.x_sendfile_header = 'X-Accel-Redirect' # for nginx
  29
+
  30
+  # Force all access to the app over SSL, use Strict-Transport-Security, and use secure cookies.
  31
+  # config.force_ssl = true
  32
+
  33
+  # See everything in the log (default is :info)
  34
+  # config.log_level = :debug
  35
+
  36
+  # Use a different logger for distributed setups
  37
+  # config.logger = SyslogLogger.new
  38
+
  39
+  # Use a different cache store in production
  40
+  # config.cache_store = :mem_cache_store
  41
+
  42
+  # Enable serving of images, stylesheets, and JavaScripts from an asset server
  43
+  # config.action_controller.asset_host = "http://assets.example.com"
  44
+
  45
+  # Precompile additional assets (application.js, application.css, and all non-JS/CSS are already added)
  46
+  # config.assets.precompile += %w( search.js )
  47
+
  48
+  # Disable delivery errors, bad email addresses will be ignored
  49
+  # config.action_mailer.raise_delivery_errors = false
  50
+
  51
+  # Enable threaded mode
  52
+  # config.threadsafe!
  53
+
  54
+  # Enable locale fallbacks for I18n (makes lookups for any locale fall back to
  55
+  # the I18n.default_locale when a translation can not be found)
  56
+  config.i18n.fallbacks = true
  57
+
  58
+  # Send deprecation notices to registered listeners
  59
+  config.active_support.deprecation = :notify
  60
+end
42  railties/guides/code/getting_started/config/environments/test.rb
... ...
@@ -0,0 +1,42 @@
  1
+Blog::Application.configure do
  2
+  # Settings specified here will take precedence over those in config/application.rb
  3
+
  4
+  # The test environment is used exclusively to run your application's
  5
+  # test suite.  You never need to work with it otherwise.  Remember that
  6
+  # your test database is "scratch space" for the test suite and is wiped
  7
+  # and recreated between test runs.  Don't rely on the data there!
  8
+  config.cache_classes = true
  9
+
  10
+  # Configure static asset server for tests with Cache-Control for performance
  11
+  config.serve_static_assets = true
  12
+  config.static_cache_control = "public, max-age=3600"
  13
+
  14
+  # Log error messages when you accidentally call methods on nil
  15
+  config.whiny_nils = true
  16
+
  17
+  # Show full error reports and disable caching
  18
+  config.consider_all_requests_local       = true
  19
+  config.action_controller.perform_caching = false
  20
+
  21
+  # Raise exceptions instead of rendering exception templates
  22
+  config.action_dispatch.show_exceptions = false
  23
+
  24
+  # Disable request forgery protection in test environment
  25
+  config.action_controller.allow_forgery_protection    = false
  26
+
  27
+  # Tell Action Mailer not to deliver emails to the real world.
  28
+  # The :test delivery method accumulates sent emails in the
  29
+  # ActionMailer::Base.deliveries array.
  30
+  config.action_mailer.delivery_method = :test
  31
+
  32
+  # Use SQL instead of Active Record's schema dumper when creating the test database.
  33
+  # This is necessary if your schema can't be completely dumped by the schema dumper,
  34
+  # like if you have constraints or database-specific column types
  35
+  # config.active_record.schema_format = :sql
  36
+
  37
+  # Print deprecation notices to the stderr
  38
+  config.active_support.deprecation = :stderr
  39
+
  40
+  # Allow pass debug_assets=true as a query parameter to load pages with unpackaged assets
  41
+  config.assets.allow_debugging = true
  42
+end
7  railties/guides/code/getting_started/config/initializers/backtrace_silencers.rb
... ...
@@ -0,0 +1,7 @@
  1
+# Be sure to restart your server when you modify this file.
  2
+
  3
+# You can add backtrace silencers for libraries that you're using but don't wish to see in your backtraces.
  4
+# Rails.backtrace_cleaner.add_silencer { |line| line =~ /my_noisy_library/ }
  5
+
  6
+# You can also remove all the silencers if you're trying to debug a problem that might stem from framework code.
  7
+# Rails.backtrace_cleaner.remove_silencers!
10  railties/guides/code/getting_started/config/initializers/inflections.rb
... ...
@@ -0,0 +1,10 @@
  1
+# Be sure to restart your server when you modify this file.
  2
+
  3
+# Add new inflection rules using the following format