Action View Atom Feed 帮助器

使用 Builder 模板引擎轻松添加 Atom feed 的默认值（这在 ERB 或任何其他模板语言中不起作用）。

完整用法示例

config/routes.rb:
  Rails.application.routes.draw do
    resources :posts
    root to: "posts#index"
  end

app/controllers/posts_controller.rb:
  class PostsController < ApplicationController
    # GET /posts.html
    # GET /posts.atom
    def index
      @posts = Post.all

      respond_to do |format|
        format.html
        format.atom
      end
    end
  end

app/views/posts/index.atom.builder:
  atom_feed do |feed|
    feed.title("My great blog!")
    feed.updated(@posts[0].created_at) if @posts.length > 0

    @posts.each do |post|
      feed.entry(post) do |entry|
        entry.title(post.title)
        entry.content(post.body, type: 'html')

        entry.author do |author|
          author.name("DHH")
        end
      end
    end
  end

atom_feed 的选项为

• :language：默认为“en-US”。

• :root_url：此 feed 所替代的 HTML 备选方案。默认为当前主机上的 /。

• :url：此 feed 的 URL。默认为当前 URL。

• :id：此 feed 的 id。在本例中，默认为“tag:localhost,2005:/posts”。

• :schema_date：首次使用 feed 的标签方案的日期。一个好的默认值是创建 feed 的年份。有关更多信息，请参阅 feedvalidator.org/docs/error/InvalidTAG.html。如果未指定，则使用 2005（作为“我不关心”值）。

• :instruct：形式为 {target => {attribute => value, }} 或 {target => [{attribute => value, }, ]} 的 XML 处理指令的 Hash

可以将其他命名空间添加到根元素

app/views/posts/index.atom.builder:
  atom_feed({'xmlns:app' => 'http://www.w3.org/2007/app',
      'xmlns:openSearch' => 'http://a9.com/-/spec/opensearch/1.1/'}) do |feed|
    feed.title("My great blog!")
    feed.updated((@posts.first.created_at))
    feed.tag!('openSearch:totalResults', 10)

    @posts.each do |post|
      feed.entry(post) do |entry|
        entry.title(post.title)
        entry.content(post.body, type: 'html')
        entry.tag!('app:edited', Time.now)

        entry.author do |author|
          author.name("DHH")
        end
      end
    end
  end

Atom 规范定义了五个元素（内容权利标题副标题摘要），如果将 type: ‘xhtml’ 指定为属性，则这些元素可能直接包含 XHTML 内容。如果是这样，此帮助器将负责封闭的 div 和 XHTML 命名空间声明。示例用法

entry.summary type: 'xhtml' do |xhtml|
  xhtml.p pluralize(order.line_items.count, "line item")
  xhtml.p "Shipped to #{order.address}"
  xhtml.p "Paid by #{order.pay_type}"
end

atom_feed 会生成一个 AtomFeedBuilder 实例。嵌套元素会生成一个 AtomBuilder 实例。