新版本的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