Sinatra RDoc 模板

需要引入 ?RDoc? gem/library 以填充 RDoc 模板：

# 需要在你的應(yīng)用中引入rdoc/markup/to_html
require "rdoc"
require "rdoc/markup/to_html"

get '/' do
  rdoc :index
end

這里調(diào)用的是 ?./views/index.rdoc?。

在 rdoc 中是不可以調(diào)用方法的，也不可以傳遞 locals 給它。 你因此一般會(huì)結(jié)合其他的填充引擎來(lái)使用它：

erb :overview, :locals => { :text => rdoc(:introduction) }

請(qǐng)注意你也可以從其他模板中調(diào)用?rdoc?方法：

%h1 Hello From Haml!
%p= rdoc(:greetings)

既然你不能在 RDoc 中調(diào)用 Ruby，你不能使用 RDoc 編寫的布局。 不過，使用其他填充引擎作為模版的布局是可能的， 通過傳遞?:layout_engine?選項(xiàng)：

get '/' do
  rdoc :index, :layout_engine => :erb
end

這將會(huì)調(diào)用 ?./views/index.rdoc? 并使用 ?./views/layout.erb? 作為布局。

請(qǐng)記住你可以全局設(shè)定這個(gè)選項(xiàng)：

set :rdoc, :layout_engine => :haml, :layout => :post

get '/' do
  rdoc :index
end

這將會(huì)調(diào)用 ?./views/index.rdoc? (和任何其他的 RDoc 模版) 并使用? ./views/post.haml ?作為布局。