ueditor_rails4 0.0.5

data/config/routes.rb

@@ -0,0 +1,11 @@
+UeditorRails::Engine.routes.draw do
+
+  %w(swf_image_uploader swf_upload swf_upload_fp9 fclipboard_ueditor).each do |lib|
+    get "libs/#{lib}"
+  end
+
+  %w(attachment image wordimage scrawl).each do |dialog|
+    get "dialogs/#{dialog}"
+  end
+
+end

data/lib/generators/ueditor_rails/USAGE

@@ -0,0 +1,8 @@
+Description:
+    Explain the generator
+
+Example:
+    rails generate ueditor Thing
+
+    This will create:
+        what/will/it/create

data/lib/generators/ueditor_rails/install_generator.rb

@@ -0,0 +1,15 @@
+module UeditorRails
+  class InstallGenerator < Rails::Generators::Base
+    source_root File.expand_path('../templates', __FILE__)
+
+    desc "Mount Engine and copy config file to Rails app."
+
+    def copy_config_file
+      template "ueditor_config.js.erb", "app/assets/javascripts/ueditor_config.js.erb"
+    end
+
+    def mount_engine
+      route "mount UeditorRails::Engine => '/ueditor'"
+    end
+  end
+end

data/lib/generators/ueditor_rails/templates/ueditor_config.js.erb

@@ -0,0 +1,216 @@
+//= require_self
+//= require ueditor_rails/init
+
+window.MY_UEDITOR_CONFIG = {
+  imageUrl: ""            //图片上传提交地址
+  , imagePath: ""                     //图片修正地址，引用了fixedImagePath,如有特殊需求，可自行配置
+  //,imageFieldName:"upfile"                   //图片数据的key,若此处修改，需要在后台对应文件修改对应参数
+  //,compressSide:0                            //等比压缩的基准，确定maxImageSideLength参数的参照对象。0为按照最长边，1为按照宽度，2为按照高度
+  //,maxImageSideLength:900                    //上传图片最大允许的边长，超过会自动等比缩放,不缩放就设置一个比较大的值，更多设置在image.html中
+
+  //涂鸦图片配置区
+  , scrawlUrl: ""           //涂鸦上传地址
+  , scrawlPath: ""                            //图片修正地址，同imagePath
+
+  //附件上传配置区
+  , fileUrl: ""               //附件上传提交地址
+  , filePath: ""                   //附件修正地址，同imagePath
+  //,fileFieldName:"upfile"                    //附件提交的表单名，若此处修改，需要在后台对应文件修改对应参数
+  //远程抓取配置区
+  //,catchRemoteImageEnable:true               //是否开启远程图片抓取,默认开启
+  , catcherUrl: ""   //处理远程图片抓取的地址
+  , catcherPath: ""                  //图片修正地址，同imagePath
+  //,catchFieldName:"upfile"                   //提交到后台远程图片uri合集，若此处修改，需要在后台对应文件修改对应参数
+  //,separater:'ue_separate_ue'               //提交至后台的远程图片地址字符串分隔符
+  //,localDomain:[]                            //本地顶级域名，当开启远程图片抓取时，除此之外的所有其它域名下的图片都将被抓取到本地,默认不抓取127.0.0.1和localhost
+
+  //图片在线管理配置区
+  , imageManagerUrl: ""       //图片在线管理的处理地址
+  , imageManagerPath: ""                                    //图片修正地址，同imagePath
+
+  //屏幕截图配置区
+  , snapscreenHost: ""                                  //屏幕截图的server端文件所在的网站地址或者ip，请不要加http://
+  , snapscreenServerUrl: "" //屏幕截图的server端保存程序，UEditor的范例代码为“URL +"server/upload/php/snapImgUp.php"”
+  , snapscreenPath: ""
+  //,snapscreenServerPort: 80                                    //屏幕截图的server端端口
+  //,snapscreenImgAlign: 'center'                                //截图的图片默认的排版方式
+
+  //word转存配置区
+  , wordImageUrl: ""             //word转存提交地址
+  , wordImagePath: ""                       //
+  //,wordImageFieldName:"upfile"                     //word转存表单名若此处修改，需要在后台对应文件修改对应参数
+
+  //获取视频数据的地址
+  , getMovieUrl: ""                   //视频数据获取地址
+
+  //工具栏上的所有的功能按钮和下拉框，可以在new编辑器的实例时选择自己需要的从新定义
+  , toolbars: [
+    ['fullscreen', 'source', '|', 'undo', 'redo', '|',
+      'bold', 'italic', 'underline', 'strikethrough', 'superscript', 'subscript', 'removeformat', 'formatmatch', 'autotypeset', 'blockquote', 'pasteplain', '|', 'forecolor', 'backcolor', 'insertorderedlist', 'insertunorderedlist', 'selectall', 'cleardoc', '|',
+      'rowspacingtop', 'rowspacingbottom', 'lineheight', '|',
+      'customstyle', 'paragraph', 'fontfamily', 'fontsize', '|',
+      'directionalityltr', 'directionalityrtl', 'indent', '|',
+      'justifyleft', 'justifycenter', 'justifyright', 'justifyjustify', '|', 'touppercase', 'tolowercase', '|',
+      'link', 'unlink', 'anchor', '|', 'imagenone', 'imageleft', 'imageright', 'imagecenter', '|',
+      'insertimage', 'emotion', 'scrawl', 'insertvideo', 'music', 'attachment', 'map', 'gmap', 'insertframe', 'highlightcode', 'webapp', 'pagebreak', 'template', 'background', '|',
+      'horizontal', 'date', 'time', 'spechars', 'snapscreen', 'wordimage', '|',
+      'inserttable', 'deletetable', 'insertparagraphbeforetable', 'insertrow', 'deleterow', 'insertcol', 'deletecol', 'mergecells', 'mergeright', 'mergedown', 'splittocells', 'splittorows', 'splittocols', '|',
+      'print', 'preview', 'searchreplace', 'help']
+  ]
+  //当鼠标放在工具栏上时显示的tooltip提示,留空支持自动多语言配置，否则以配置值为准
+  , labelMap: {
+    'anchor': '', 'undo': ''
+  }
+  //webAppKey
+  //百度应用的APIkey，每个站长必须首先去百度官网注册一个key后方能正常使用app功能
+  , webAppKey: ""
+
+
+  //语言配置项,默认是zh-cn。有需要的话也可以使用如下这样的方式来自动多语言切换，当然，前提条件是lang文件夹下存在对应的语言文件：
+  //lang值也可以通过自动获取 (navigator.language||navigator.browserLanguage ||navigator.userLanguage).toLowerCase()
+  //,lang:'zh-cn'
+
+  //,langPath:URL +"lang/"
+
+  //主题配置项,默认是default。有需要的话也可以使用如下这样的方式来自动多主题切换，当然，前提条件是themes文件夹下存在对应的主题文件：
+  //现有如下皮肤:default,modern,gorgeous
+  //,theme:'default'
+  //,themePath:URL +"themes/"
+
+  //若实例化编辑器的页面手动修改的domain，此处需要设置为true
+  //,customDomain:false
+
+  //针对getAllHtml方法，会在对应的head标签中增加该编码设置。
+  //,charset:"utf-8"
+
+  //常用配置项目
+  //,isShow : true    //默认显示编辑器
+
+  , initialContent: ''    //初始化编辑器的内容,也可以通过textarea/script给值，看官网例子
+
+  //,initialFrameWidth:1000  //初始化编辑器宽度,默认1000
+  //,initialFrameHeight:320  //初始化编辑器高度,默认320
+
+  //,autoClearinitialContent:true //是否自动清除编辑器初始内容，注意：如果focus属性设置为true,这个也为真，那么编辑器一上来就会触发导致初始化的内容看不到了
+
+  //,iframeCssUrl: URL + '/themes/iframe.css' //给编辑器内部引入一个css文件
+  //,textarea:'editorValue' // 提交表单时，服务器获取编辑器提交内容的所用的参数，多实例时可以给容器name属性，会将name给定的值最为每个实例的键值，不用每次实例化的时候都设置这个值
+  //,focus:true //初始化时，是否让编辑器获得焦点true或false
+
+  //,autoClearEmptyNode : true //getContent时，是否删除空的inlineElement节点（包括嵌套的情况）
+
+  //,fullscreen : false //是否开启初始化时即全屏，默认关闭
+
+  //,readonly : false /编辑器初始化结束后,编辑区域是否是只读的，默认是false
+
+  //,zIndex : 900     //编辑器层级的基数,默认是900
+
+  //,imagePopup:true      //图片操作的浮层开关，默认打开
+
+  //,initialStyle:'body{font-size:18px}'   //编辑器内部样式,可以用来改变字体等
+
+  //,emotionLocalization:false //是否开启表情本地化，默认关闭。若要开启请确保emotion文件夹下包含官网提供的images表情文件夹
+
+  //,pasteplain:false  //是否纯文本粘贴。false为不使用纯文本粘贴，true为使用纯文本粘贴
+
+  //,allHtmlEnabled:false //提交到后台的数据是否包含整个html字符串
+  //iframeUrlMap
+  //dialog内容的路径 ～会被替换成URL,垓属性一旦打开，将覆盖所有的dialog的默认路径
+  //,iframeUrlMap:{
+  // 'anchor':'~/dialogs/anchor/anchor.html',
+  // }
+  //insertorderedlist
+  //有序列表的下拉配置,值留空时支持多语言自动识别，若配置值，则以此值为准
+//        ,'insertorderedlist':{
+//             'decimal' : '' ,         //'1,2,3...'
+//             'lower-alpha' : '' ,    // 'a,b,c...'
+//             'lower-roman' : '' ,    //'i,ii,iii...'
+//             'upper-alpha' : '' , lang   //'A,B,C'
+//             'upper-roman' : ''      //'I,II,III...'
+//        }
+  //insertunorderedlist
+  //无序列表的下拉配置，值留空时支持多语言自动识别，若配置值，则以此值为准
+  //,insertunorderedlist : {
+  //    'circle' : '',  // '○ 小圆圈'
+  //    'disc' : '',    // '● 小圆点'
+  //    'square' : ''   //'■ 小方块'
+  //}
+
+  //customstyle
+  //自定义样式，不支持国际化，此处配置值即可最后显示值
+  //block的元素是依据设置段落的逻辑设置的，inline的元素依据BIU的逻辑设置
+  //尽量使用一些常用的标签
+  //参数说明
+  //tag 使用的标签名字
+  //label 显示的名字也是用来标识不同类型的标识符，注意这个值每个要不同，
+  //style 添加的样式
+  //每一个对象就是一个自定义的样式
+  //,'customstyle':[
+  //      {tag:'h1', name:'tc', label:'', style:'border-bottom:#ccc 2px solid;padding:0 4px 0 0;text-align:center;margin:0 0 20px 0;'},
+  //      {tag:'h1', name:'tl',label:'', style:'border-bottom:#ccc 2px solid;padding:0 4px 0 0;margin:0 0 10px 0;'},
+  //      {tag:'span',name:'im', label:'', style:'font-style:italic;font-weight:bold'},
+  //      {tag:'span',name:'hi', label:'', style:'font-style:italic;font-weight:bold;color:rgb(51, 153, 204)'}
+  //  ]
+
+  //右键菜单的内容，可以参考plugins/contextmenu.js里边的默认菜单的例子，label留空支持国际化，否则以此配置为准
+//        ,contextMenu:[
+//            {
+//                label:'',       //显示的名称
+//                cmdName:'selectall',//执行的command命令，当点击这个右键菜单时
+//                //exec可选，有了exec就会在点击时执行这个function，优先级高于cmdName
+//                exec:function () {
+//                    //this是当前编辑器的实例
+//                    //this.ui._dialogs['inserttableDialog'].open();
+//                }
+//            }
+//           ]
+  //wordCount
+  //,wordCount:1          //是否开启字数统计
+  //,maximumWords:10000       //允许的最大字符数
+  //字数统计提示，{#count}代表当前字数，{#leave}代表还可以输入多少字符数,留空支持多语言自动切换，否则按此配置显示
+  //,wordCountMsg:''   //当前已输入 {#count} 个字符，您还可以输入{#leave} 个字符
+  //超出字数限制提示  留空支持多语言自动切换，否则按此配置显示
+  //,wordOverFlowMsg:''    //<span style="color:red;">你输入的字符个数已经超出最大允许值，服务器可能会拒绝保存！</span>
+
+  //elementPathEnabled
+  //是否启用元素路径，默认是显示
+  //,elementPathEnabled : true
+  //removeFormat
+  //清除格式时可以删除的标签和属性
+  //removeForamtTags标签
+  //,removeFormatTags:'b,big,code,del,dfn,em,font,i,ins,kbd,q,samp,small,span,strike,strong,sub,sup,tt,u,var'
+  //removeFormatAttributes属性
+  //,removeFormatAttributes:'class,style,lang,width,height,align,hspace,valign'
+  //autoHeightEnabled
+  // 是否自动长高,默认true
+  //,autoHeightEnabled:true
+  //,minFrameWidth:800    //编辑器拖动时最小宽度,默认800
+  //,minFrameHeight:220  //编辑器拖动时最小高度,默认220
+  //autoFloatEnabled
+  //是否保持toolbar的位置不动,默认true
+  //,autoFloatEnabled:true
+  //浮动时工具栏距离浏览器顶部的高度，用于某些具有固定头部的页面
+  //,topOffset:30
+  //indentValue
+  //首行缩进距离,默认是2em
+  //,indentValue:'2em'
+
+  //autotypeset
+  //  //自动排版参数
+  //  ,autotypeset:{
+  //      mergeEmptyline : true,         //合并空行
+  //      removeClass : true,           //去掉冗余的class
+  //      removeEmptyline : false,      //去掉空行
+  //      textAlign : "left" ,           //段落的排版方式，可以是 left,right,center,justify 去掉这个属性表示不执行排版
+  //      imageBlockLine : 'center',      //图片的浮动方式，独占一行剧中,左右浮动，默认: center,left,right,none 去掉这个属性表示不执行排版
+  //      pasteFilter : false,            //根据规则过滤没事粘贴进来的内容
+  //      clearFontSize : false,          //去掉所有的内嵌字号，使用编辑器默认的字号
+  //      clearFontFamily : false,        //去掉所有的内嵌字体，使用编辑器默认的字体
+  //      removeEmptyNode : false ,       // 去掉空节点
+  //      //可以去掉的标签
+  //      removeTagNames : {标签名字:1},
+  //      indent : false,                 // 行首缩进
+  //      indentValue : '2em'             //行首缩进的大小
+  //  }
+
+};

data/lib/tasks/ueditor_rails_tasks.rake

@@ -0,0 +1,4 @@
+# desc "Explaining what the task does"
+# task :ueditor_rails do
+#   # Task goes here
+# end

data/lib/ueditor_rails/engine.rb

@@ -0,0 +1,17 @@
+module UeditorRails
+  class Engine < ::Rails::Engine
+    isolate_namespace UeditorRails
+
+    initializer "ueditor_rails.assets_precompile", :group => :all do |app|
+      app.config.assets.precompile += UeditorRails.assets
+    end
+
+    initializer "ueditor_rails.helpers" do
+      ActiveSupport.on_load :action_view do
+        ActionView::Base.send :include, UeditorRails::Helpers::ViewHelper
+        ActionView::Base.send :include, UeditorRails::Helpers::FormHelper
+        ActionView::Helpers::FormBuilder.send :include, UeditorRails::Helpers::FormBuilder
+      end
+    end
+  end
+end

data/lib/ueditor_rails/helpers/form_builder.rb

@@ -0,0 +1,11 @@
+module UeditorRails
+  module Helpers
+    module FormBuilder
+      extend ActiveSupport::Concern
+
+      def ueditor_text(method, options = {})
+        @template.send('ueditor_text', @object_name, method, objectify_options(options))
+      end
+    end
+  end
+end

data/lib/ueditor_rails/helpers/form_helper.rb

@@ -0,0 +1,37 @@
+module UeditorRails
+  module Helpers
+    module FormHelper
+      extend ActiveSupport::Concern
+
+      include ActionView::Helpers::TagHelper
+      include ActionView::Helpers::JavaScriptHelper
+      include ActionView::Helpers::Tags
+
+      def ueditor_text(object_name, method = nil, options = {})
+        if defined?(ActionView::Base::InstanceTag)
+          instance_tag = ActionView::Base::InstanceTag.new(object_name, method, self, options.delete('object'))
+        else
+          instance_tag = ActionView::Helpers::Tags::TextArea.new(object_name, method, self, options)
+        end
+        # instance_tag = ActionView::Helpers::Tags::TextArea.new(object_name, method, self, options)
+        instance_tag.send(:add_default_name_and_id, options) if options[:id].blank?
+
+        element_id = options.delete('id')
+        ue_tag_attributes = {:type => 'text/plain', :id => element_id, :name => options.delete('name')}
+        options[:initialFrameWidth] = options.delete(:width) unless options[:width].blank?
+        options[:initialFrameHeight] = options.delete(:height) unless options[:height].blank?
+
+        output_buffer = ActiveSupport::SafeBuffer.new
+        #output_buffer << instance_tag.to_content_tag(:script, ue_tag_attributes)
+        if defined?(ActionView::Base::InstanceTag)
+          output_buffer << instance_tag.to_text_area_tag(ue_tag_attributes)
+        else
+          output_buffer << instance_tag.render
+        end
+        # output_buffer << instance_tag.to_text_area_tag(ue_tag_attributes)
+        output_buffer << javascript_tag {Util.js_replace(element_id, options.stringify_keys)}
+        output_buffer
+      end
+    end
+  end
+end

data/lib/ueditor_rails/helpers/view_helper.rb

@@ -0,0 +1,21 @@
+module UeditorRails
+  module Helpers
+    module ViewHelper
+      extend ActiveSupport::Concern
+
+      def ueditor_text_tag(name, content = nil, options = {})
+        element_id = sanitize_to_id(options.delete(:id) || name)
+        input_html = { :id => element_id, :name => name, :type => 'text/plain' }
+
+        options['initialFrameWidth'] = options.delete(:width) unless options[:width].blank?
+        options['initialFrameHeight'] = options.delete(:height) unless options[:height].blank?
+
+        output_buffer = ActiveSupport::SafeBuffer.new
+        #output_buffer << content_tag(:script, content, input_html.stringify_keys)
+        output_buffer << content_tag(:script, content, input_html.stringify_keys)
+        output_buffer << javascript_tag { Util.js_replace(element_id, options.stringify_keys) }
+        output_buffer
+      end
+    end
+  end
+end

data/lib/ueditor_rails/util.rb

@@ -0,0 +1,42 @@
+# encoding: utf-8
+require 'active_support/json/encoding'
+
+module UeditorRails
+  module Util
+    class << self
+      ASSET_FORMAT = '*.{coffee,scss,sass,png,jpeg,jpg,gif,js,css,erb,swf,exe}'
+      NEED_TO_COMPILE_STYLESHEET_EXT = %w(.scss .sass .coffee .erb)
+
+      def js_replace(dom_id, options = nil)
+        js_options = (options && !options.keys.empty?)? ActiveSupport::JSON.encode(options) : '{}'
+        js = <<-JS
+          if(window.UEDITOR_FIELDS === undefined) {
+            window.UEDITOR_FIELDS = [];
+          }
+          window.UEDITOR_FIELDS.push({id: '#{dom_id}', opt: #{js_options}})
+        JS
+        js.html_safe
+      end
+
+      def precompile_assets
+        assets = []
+
+        %w(app vendor).each do |source|
+          %w(images javascripts stylesheets).each do |kind|
+            Dir[UeditorRails.root_path.join("#{source}/assets/#{kind}/**", ASSET_FORMAT)].each do |path|
+              next if File.basename(path)[0] == '_'
+
+              ext = File.extname(path)
+              path = path[0..-ext.length-1] if NEED_TO_COMPILE_STYLESHEET_EXT.include? ext
+
+              assets << Pathname.new(path).relative_path_from(UeditorRails.root_path.join("#{source}/assets/#{kind}"))
+            end
+          end
+        end
+
+        assets
+      end
+
+    end
+  end
+end

data/lib/ueditor_rails/version.rb

@@ -0,0 +1,3 @@
+module UeditorRails
+  VERSION = '0.0.5'
+end

data/lib/ueditor_rails4.rb

@@ -0,0 +1,32 @@
+require "ueditor_rails/engine"
+
+module UeditorRails
+  autoload :Util, 'ueditor_rails/util'
+
+  module Helpers
+    autoload :ViewHelper, 'ueditor_rails/helpers/view_helper'
+    autoload :FormHelper, 'ueditor_rails/helpers/form_helper'
+    autoload :FormBuilder, 'ueditor_rails/helpers/form_builder'
+  end
+
+  mattr_accessor :enable_cross_domain
+
+  class<< self
+
+    def enable_cross_domain
+      @@enable_cross_domain ||= false
+    end
+
+    def root_path
+      @root_path ||= Pathname.new(File.dirname(File.expand_path('../', __FILE__)))
+    end
+
+    def assets
+      @assets ||= Util.precompile_assets
+    end
+
+    def ueditor_base_path
+      @ueditor_base_path ||= self.root_path.join('vendor/assets/javascripts/ueditor')
+    end
+  end
+end

data/test/dummy/README.rdoc

@@ -0,0 +1,261 @@
+== Welcome to Rails
+
+Rails is a web-application framework that includes everything needed to create
+database-backed web applications according to the Model-View-Control pattern.
+
+This pattern splits the view (also called the presentation) into "dumb"
+templates that are primarily responsible for inserting pre-built data in between
+HTML tags. The model contains the "smart" domain objects (such as Account,
+Product, Person, Post) that holds all the business logic and knows how to
+persist themselves to a database. The controller handles the incoming requests
+(such as Save New Account, Update Product, Show Post) by manipulating the model
+and directing data to the view.
+
+In Rails, the model is handled by what's called an object-relational mapping
+layer entitled Active Record. This layer allows you to present the data from
+database rows as objects and embellish these data objects with business logic
+methods. You can read more about Active Record in
+link:files/vendor/rails/activerecord/README.html.
+
+The controller and view are handled by the Action Pack, which handles both
+layers by its two parts: Action View and Action Controller. These two layers
+are bundled in a single package due to their heavy interdependence. This is
+unlike the relationship between the Active Record and Action Pack that is much
+more separate. Each of these packages can be used independently outside of
+Rails. You can read more about Action Pack in
+link:files/vendor/rails/actionpack/README.html.
+
+
+== Getting Started
+
+1. At the command prompt, create a new Rails application:
+       <tt>rails new myapp</tt> (where <tt>myapp</tt> is the application name)
+
+2. Change directory to <tt>myapp</tt> and start the web server:
+       <tt>cd myapp; rails server</tt> (run with --help for options)
+
+3. Go to http://localhost:3000/ and you'll see:
+       "Welcome aboard: You're riding Ruby on Rails!"
+
+4. Follow the guidelines to start developing your application. You can find
+the following resources handy:
+
+* The Getting Started Guide: http://guides.rubyonrails.org/getting_started.html
+* Ruby on Rails Tutorial Book: http://www.railstutorial.org/
+
+
+== Debugging Rails
+
+Sometimes your application goes wrong. Fortunately there are a lot of tools that
+will help you debug it and get it back on the rails.
+
+First area to check is the application log files. Have "tail -f" commands
+running on the server.log and development.log. Rails will automatically display
+debugging and runtime information to these files. Debugging info will also be
+shown in the browser on requests from 127.0.0.1.
+
+You can also log your own messages directly into the log file from your code
+using the Ruby logger class from inside your controllers. Example:
+
+  class WeblogController < ActionController::Base
+    def destroy
+      @weblog = Weblog.find(params[:id])
+      @weblog.destroy
+      logger.info("#{Time.now} Destroyed Weblog ID ##{@weblog.id}!")
+    end
+  end
+
+The result will be a message in your log file along the lines of:
+
+  Mon Oct 08 14:22:29 +1000 2007 Destroyed Weblog ID #1!
+
+More information on how to use the logger is at http://www.ruby-doc.org/core/
+
+Also, Ruby documentation can be found at http://www.ruby-lang.org/. There are
+several books available online as well:
+
+* Programming Ruby: http://www.ruby-doc.org/docs/ProgrammingRuby/ (Pickaxe)
+* Learn to Program: http://pine.fm/LearnToProgram/ (a beginners guide)
+
+These two books will bring you up to speed on the Ruby language and also on
+programming in general.
+
+
+== Debugger
+
+Debugger support is available through the debugger command when you start your
+Mongrel or WEBrick server with --debugger. This means that you can break out of
+execution at any point in the code, investigate and change the model, and then,
+resume execution! You need to install ruby-debug to run the server in debugging
+mode. With gems, use <tt>sudo gem install ruby-debug</tt>. Example:
+
+  class WeblogController < ActionController::Base
+    def index
+      @posts = Post.all
+      debugger
+    end
+  end
+
+So the controller will accept the action, run the first line, then present you
+with a IRB prompt in the server window. Here you can do things like:
+
+  >> @posts.inspect
+  => "[#<Post:0x14a6be8
+          @attributes={"title"=>nil, "body"=>nil, "id"=>"1"}>,
+       #<Post:0x14a6620
+          @attributes={"title"=>"Rails", "body"=>"Only ten..", "id"=>"2"}>]"
+  >> @posts.first.title = "hello from a debugger"
+  => "hello from a debugger"
+
+...and even better, you can examine how your runtime objects actually work:
+
+  >> f = @posts.first
+  => #<Post:0x13630c4 @attributes={"title"=>nil, "body"=>nil, "id"=>"1"}>
+  >> f.
+  Display all 152 possibilities? (y or n)
+
+Finally, when you're ready to resume execution, you can enter "cont".
+
+
+== Console
+
+The console is a Ruby shell, which allows you to interact with your
+application's domain model. Here you'll have all parts of the application
+configured, just like it is when the application is running. You can inspect
+domain models, change values, and save to the database. Starting the script
+without arguments will launch it in the development environment.
+
+To start the console, run <tt>rails console</tt> from the application
+directory.
+
+Options:
+
+* Passing the <tt>-s, --sandbox</tt> argument will rollback any modifications
+  made to the database.
+* Passing an environment name as an argument will load the corresponding
+  environment. Example: <tt>rails console production</tt>.
+
+To reload your controllers and models after launching the console run
+<tt>reload!</tt>
+
+More information about irb can be found at:
+link:http://www.rubycentral.org/pickaxe/irb.html
+
+
+== dbconsole
+
+You can go to the command line of your database directly through <tt>rails
+dbconsole</tt>. You would be connected to the database with the credentials
+defined in database.yml. Starting the script without arguments will connect you
+to the development database. Passing an argument will connect you to a different
+database, like <tt>rails dbconsole production</tt>. Currently works for MySQL,
+PostgreSQL and SQLite 3.
+
+== Description of Contents
+
+The default directory structure of a generated Ruby on Rails application:
+
+  |-- app
+  |   |-- assets
+  |   |   |-- images
+  |   |   |-- javascripts
+  |   |   `-- stylesheets
+  |   |-- controllers
+  |   |-- helpers
+  |   |-- mailers
+  |   |-- models
+  |   `-- views
+  |       `-- layouts
+  |-- config
+  |   |-- environments
+  |   |-- initializers
+  |   `-- locales
+  |-- db
+  |-- doc
+  |-- lib
+  |   |-- assets
+  |   `-- tasks
+  |-- log
+  |-- public
+  |-- script
+  |-- test
+  |   |-- fixtures
+  |   |-- functional
+  |   |-- integration
+  |   |-- performance
+  |   `-- unit
+  |-- tmp
+  |   `-- cache
+  |       `-- assets
+  `-- vendor
+      |-- assets
+      |   |-- javascripts
+      |   `-- stylesheets
+      `-- plugins
+
+app
+  Holds all the code that's specific to this particular application.
+
+app/assets
+  Contains subdirectories for images, stylesheets, and JavaScript files.
+
+app/controllers
+  Holds controllers that should be named like weblogs_controller.rb for
+  automated URL mapping. All controllers should descend from
+  ApplicationController which itself descends from ActionController::Base.
+
+app/models
+  Holds models that should be named like post.rb. Models descend from
+  ActiveRecord::Base by default.
+
+app/views
+  Holds the template files for the view that should be named like
+  weblogs/index.html.erb for the WeblogsController#index action. All views use
+  eRuby syntax by default.
+
+app/views/layouts
+  Holds the template files for layouts to be used with views. This models the
+  common header/footer method of wrapping views. In your views, define a layout
+  using the <tt>layout :default</tt> and create a file named default.html.erb.
+  Inside default.html.erb, call <% yield %> to render the view using this
+  layout.
+
+app/helpers
+  Holds view helpers that should be named like weblogs_helper.rb. These are
+  generated for you automatically when using generators for controllers.
+  Helpers can be used to wrap functionality for your views into methods.
+
+config
+  Configuration files for the Rails environment, the routing map, the database,
+  and other dependencies.
+
+db
+  Contains the database schema in schema.rb. db/migrate contains all the
+  sequence of Migrations for your schema.
+
+doc
+  This directory is where your application documentation will be stored when
+  generated using <tt>rake doc:app</tt>
+
+lib
+  Application specific libraries. Basically, any kind of custom code that
+  doesn't belong under controllers, models, or helpers. This directory is in
+  the load path.
+
+public
+  The directory available for the web server. Also contains the dispatchers and the
+  default HTML files. This should be set as the DOCUMENT_ROOT of your web
+  server.
+
+script
+  Helper scripts for automation and generation.
+
+test
+  Unit and functional tests along with fixtures. When using the rails generate
+  command, template test files will be generated for you and placed in this
+  directory.
+
+vendor
+  External libraries that the application depends on. Also includes the plugins
+  subdirectory. If the app has frozen rails, those gems also go here, under
+  vendor/rails/. This directory is in the load path.