theme_support: 为Rails应用添加theme支持

theme_support: 为Rails应用添加theme支持

from LetRails by yuanyi

theme_support是Matt McCray 写的一个为Rails应用增加类似Typo的theme管理的插件，功能类似于Typo，支持liquid 和erb模板。

安装

$ script/plugin install http://mattmccray.com/svn/rails/plugins/theme_support

使用

1. 生成主题

$ script/generate theme [theme_name]

这将在你的Rails应用的跟目录下创建一个themes文件夹：

app_root
  themes/
    [theme_name]
      layouts/ <- layout .rhtml or .liquid templates
      images/
      stylesheets/
      javascripts/
      views/ <- you can override application views
      about.markdown
      preview.png

2. 然后你需要将原本在app/views目录下的模板文件移到themes/[theme_name]/views下，同时将layouts下的文件也移到模板中去，当然还有相关的CSS，JS以及图片等等。

3. 同时你需要将主题中的JS，CSS以及Images引用改为如下路径：

Image: /theme/:theme_name/images/:image_file
JS: /theme/:theme_name/javascripts/:image_file
CSS: /theme/:theme_name/stylesheets/:image_file

如果使用erb，你可以使用下面的helper：

• theme_image_tag(filename)
• theme_image_path(filename)
• theme_javascript_include_tag(filename)
• theme_javascript_path(filename)
• theme_stylesheet_link_tag(filename)
• theme_stylesheet_path(filename)

liquid也有一个helper：themeitem

<link rel=”StyleSheet” href=”{% themeitem %} default.css {% endthemeitem %}” />

它被转换为：

<link rel=”StyleSheet” href=”/themes/[current_theme]/stylesheets/default.css” />

4. 指定要使用的主题：


class ApplicationController
  layout 'fire'
  theme 'demo'
end

你也可以在filter中根据当前用户的设置来动态决定使用那个theme：


class ApplicationController
  before_filter :set_theme
  def set_theme
    theme current_user.theme
  end
end

Rails 2.1

如果你使用Rails 2.1，那么你还得多做一点工作:

1. 首先修改routeset_ex.rb，将draw和create_theme_routes改为如下定义：


def draw
  old_routes = @routes
  @routes = []
  begin
    create_theme_routes
    yield Mapper.new(self)
    install_helpers
  rescue
    @routes = old_routes
    raise
  end
end
def create_theme_routes
  # Added patch from D.J. Vogel that changes :filename to *filename … allowing sub-folders
  add_named_route ‘theme_images’, “/themes/:theme/images/*filename”, :controller=>’theme’, :action=>’images’
  add_named_route ‘theme_stylesheets’, “/themes/:theme/stylesheets/*filename”, :controller=>’theme’, :action=>’stylesheets’
  add_named_route ‘theme_javascript’, “/themes/:theme/javascript/*filename”, :controller=>’theme’, :action=>’javascript’
  add_route “/themes/*whatever”, :controller=>’theme’, :action=>’error’
end

2. 然后修改actionview_ex.rb，将render_file改为如下定义：


def render_file(template_path, use_full_path = true, local_assigns = {})
  ["#{RAILS_ROOT}/themes/#{controller.current_theme}/views", # for normal views
    "#{RAILS_ROOT}/themes/#{controller.current_theme}" # for layouts
   ].each do |prefix|
    @finder.prepend_view_path(prefix)
  end
  __render_file(template_path, use_full_path, local_assigns)
end

3. 如果还有问题，欢迎留言，可能我漏掉了什么。