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