新版本的will_paginate已經(jīng)拋棄了這樣的做法，轉(zhuǎn)而使用gem的方式，本文通過建立一個名為foobar的應(yīng)用來了解一下will_paginate的用法。

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

C:\>rails foobar -d mysql

C:\>cd foobar

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

此時設(shè)置一下數(shù)據(jù)庫（C:\foobar\config\database.yml），并且確保相關(guān)數(shù)據(jù)庫已經(jīng)建立好了。

C:\foobar>rake db:migrate

C:\foobar>ruby script/server

此時，http://localhost:3000/articles可以瀏覽了，添加一些數(shù)據(jù)（比如十條），為分頁做準備。

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

plugin形式的舊版will_paginate不用在rails程序里顯式的加載，這是因為rails啟動時會自動執(zhí)行插件目錄下的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，然后執(zhí)行如下命令安裝相應(yīng)的gem：

C:\foobar>rake gems:install

安裝就完成了。

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

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

修改對應(yīng)的模板文件，加上類似下面的代碼：

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

再次重啟一下WEBrick，然后瀏覽就可能看到分頁效果了。

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

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