ruby will_paginate的用法

新版本的will_paginate已经抛弃了这样的做法，转而使用gem的方式，本文通过建立一个名为foobar的应用来了解一下will_paginate的用法。

==============================

c:\>rails foobar -d mysql

c:\>cd foobar

c:\foobar>ruby script/generate scaffold article title:string content:text

此时设置一下数据库（c:\foobar\config\database.yml），并且确保相关数据库已经建立好了。

c:\foobar>rake db:migrate

c:\foobar>ruby script/server

此时，http://localhost:3000/articles可以浏览了，添加一些数据（比如十条），为分页做准备。

===============================

plugin形式的旧版will_paginate不用在rails程序里显式的加载，这是因为rails启动时会自动执行插件目录下的init.rb文件，而新版will_pagiante采用的是gem形式，没有这样的机制，所以需要在rails程序里显式的加载：

# c:\foobar\config\environment.rb
rails::initializer.run do |config|
config.gem 'mislav-will_paginate', :version => '~> 2.3.2', :lib => 'will_paginate',
:source => 'http://gems.github.com'
end

此时，重启一下webrick，然后执行如下命令安装相应的gem：

c:\foobar>rake gems:install

安装就完成了。

修改控制器的index方法，加上类似下面的代码：

# c:\foobar\app\controllers\articles_controller.rb
@articles = article.paginate :page => params[:page], :per_page => 2

修改对应的模板文件，加上类似下面的代码：

# c:\foobar\app\views\articles\index.html.erb
<%= will_paginate @articles %>

再次重启一下webrick，然后浏览就可能看到分页效果了。

===============================

will_paginate的最新文档：http://github.com/mislav/will_paginate/wikis