天天红玉世界

• 说明
  
  • Excellent是一个针对于Rails的源代码分析工具；
  • Excellent集成了 roodi 和 reek 和 flog ，并且还增加了Rails本身检查；
  • Excellent输出一个源代码的HTML分析文件；
  • Excellent输出HTML分析文件可以说是对代码的一种“评论”，如代码是否太复杂了，能否简化一下，这是工具flog的功能；有时候是代码真的有问题，如 “if x=y”，运行过程没有出现错误，但是结果是错误的 ；
  • 还有另外一个完全类似的工具：metric_fu ，可以参考的。

• 使用方法
  
  1. 安装工具：Excellent。一次性工作；所有人都需要这样做。
     
     • gem sources -a http://gems.github.com
     • sudo gem install simplabs-excellent
  2. 确定分析源代码目标。多次性工作；在Rails根目录下运行，但是这个命令是千变万化的。
     
     • excellent html:doc/out.html app/models
  3. 查看分析结果。完全重复工作；方法是一样的。
     
     • open doc/out.html

• 参考资料
  
  • Excellent首页
  • Excellent Wiki
  • Rails 3.0代码分析结果

rails demo_rest-in-place && cd demo_rest-in-place
ruby script/plugin install git://github.com/janv/rest_in_place.git
wget -O public/javascripts/jquery-1.2.6.min.js http://jqueryjs.googlecode.com/files/jquery-1.2.6.min.js
ruby script/generate scaffold user name:string
vim app/views/layouts/users.html.erb
# 在users.html.erb增加下面所有代码
  <title>Users: <%= controller.action_name %></title>
  <%= stylesheet_link_tag 'scaffold' %>
  <%= javascript_include_tag "jquery-1.2.6.min" , "jquery.rest_in_place" %>
  <script type="text/javascript">
    rails_authenticity_token = '<%= form_authenticity_token %>'
  </script>
vim app/controllers/users_controller.rb
# 在users_controller.rb增加一行代码
  def show
    @user = User.find(params[:id])
    respond_to do |format|
      format.html # show.html.erb
      format.xml  { render :xml => @user }
      format.js   { render :json => @user }
    end
  end
vim app/views/users/show.html.erb
# 在show.html.erb增加下面所有代码
    <div id="<%= dom_id @user %>">
      ID: <%= @user.id %><br />
      Name: <span class="rest_in_place" attribute="name"><%= @user.name %></span>
    </div>
rake db:drop && rake db:migrate && rake db:fixtures:load
ruby script/server
open http://localhost:3000/users/<show_id>

• 参考资料
  
  • REST in Place

rails textile_toolbar_demo && cd textile_toolbar_demo
　
ruby script/plugin install git://github.com/pelargir/textile_toolbar.git
rake textile_toolbar:install 
　
ruby script/generate scaffold post title:string body:text published:boolean
　
vi app/views/posts/edit.html.erb
    <%#= f.text_area :body %>
    <%= f.textile_area :body, :rows => 5, :cols => 20 %>
　
vi app/views/layouts/posts.html.erb 
  <%= stylesheet_link_tag 'scaffold' %>
  <%= javascript_include_tag :defaults %>
  <%= javascript_include_tag "textile_toolbar.js" %>
　
rake db:migrate && rake db:fixtures:load
　
ruby script/server
　
# http://localhost:3000/posts/<post.id>/edit

• 参考资料
  
  • 插件textile_toolbar首页
  • Announcing the textile_toolbar Plugin

• 翻译(English » Chinese):

In its simplest form, a presenter is an object that wraps up several other objects to display, and manipulate them on the front end.

在其最简单的形式，主讲人是一个对象，结束其他几个对象要显示，和操纵他们就前端。—Google

用最简单语言可以这样说明，呈送（presenter）是一个对象，它封装了其它几个对象，以达到在前端显示和处理它们。—天天红玉

• 相关资料收藏
  
  • Introducing_ActivePresenter原文链接
  • Introducing_ActivePresenter PDF文件

• 说明
  
  • 插件class_inputs的作用在于增加标记input的属性class，以便更好地显示页面。这里介绍这个插件的目的是让大家把它作为学习Rails插件的实例。

• 安装方法

ruby script/plugin install http://svn.jcoglan.com/classyinputs/trunk/classy_inputs

• Rails重要插件系列教程
  
  • Plugins I’ve Known and Loved #3: Ultrasphinx
  • Plugins I’ve Known and Loved #2: has_finder
  • Introducing AttributeFu: Multi-Model Forms Made Easy

• 相关资料
  10 Ruby On Rails Plugins You Should Be Using

• 说明
  
  • 看看什么时候Rails应用程序的根目录下面的目录components开始被使用？还是一直让它空着？

• 参考资料
  
  • 插件Cells
  • http://rubyforge.org/projects/cells/
  • Ruby Component Web Frameworks
  • Cells: Bringing Components Back Into Rails
  • mailing list cell

• 说明
  
  • Rails插件Geokit提供了地理编码（geocoding），路线寻找和距离计算等功能。这个插件不仅提供Google地图API还提供Yahoo地图和Geocoder.us 等其他地图。
  • Geokit项目首页：http://geokit.rubyforge.org/
  • 图中链接是借助于Google 地图 API 实现瑞士火车实时运行网站。

• 参考资料
  
  • GeoKit: Geocoding mit Ruby on Rails leicht gemacht

• 参考文献
  
  • http://trix.pl/blog/ruby-on-rails/running-long-background-tasks-in-ruby-on-rails-made-dead-simple
  • http://wiki.rubyonrails.org/rails/pages/HowToRunBackgroundJobsInRails
  • http://agilewebdevelopment.com/plugins/backgroundfu

• 说明
  
  • BackgroundFu是Rails框架插件；
  • BackgroundFu是后台任务执行工具；
  • BackgroundFu是执行任意的长时间运行的任务工具；

• Rails框架插件：
  
  • has_wfid
  • acts_as_urlnameable

• 说明
  
  • 如何使得网络链接成为更为可读的网址？
  • 如何使得网络链接成为中文的可读网址？

Rails框架技术：如何处理Rails框架的日期显示

• 参考资料
  
  1. 定义自己的日期格式
  2. Rails框架日期插件 CalendarDateSelect
  3. Rails框架ActionView的日期功能

• 说明
  
  • 上面的图是利用这里列出的参考资料3实现的。

Rails框架插件：文件上传大全

• UploadColumn 资料比较详细
• attachment_fu Rails框架核心人员开发，该插件是acts_as_attachment的重写版本
• FlexImage
• File Column 最早的这类插件
• acts_as_attachment
• ActiveUpload

• 说明：
  
  • 上面插图是该图所链接的文章内容结果。
  • 上面插件的前面两个是比较新的。
  • 一般这些插件都依赖两个图形软件： ImageMagick 及其 Ruby接口软件包RMagick 和 FreeImage 及其 Ruby接口软件包ImageScience 。而前者在Ruby语言内应用更加广泛一些。注意像文件 RMagick-1.14.1_IM-6.3.0-7-Q8.zip 已经包含了软件ImageMagick，软件ImageMagick也要安装。
  • Windows安装RMagick说明
  • Ubuntu安装RMagick说明
  • 相关资料：
    
    • 一
    • 二
    • 三
    • ActiveUpload
    • Three Ruby on Rails File Upload Plugins reviewed
• 致谢：感谢bd7lx提供的信息。

• 项目bleak_house
  
  • 项目说明
  • 相关资料

• 项目Rounded Corners
  
  • 项目首页

• 项目说明
• 相关资料

• 软件包cmdparse首页：http://cmdparse.rubyforge.org

• 说明：软件包cmdparse可以被用来创建命令行内包含命令的接口。如RubyGems软件，其命令“gem『软件包命令』 install『这是软件包内的命令』 cmdparse『这是命令install要求的参数』”。

• 插件Smooth Migration首页

• 说明：在Rails框架中要是在我们执行迁移命令时出现错误时，该插件能够不会因为有错而停止你的命令执行。这样能够在再次执行你的迁移命令时保证能再顺利执行。要是没有它，你就会有麻烦了。