Liquid Error about regexp match when using octopress-tagcloud

Octopress插件：octopress-tagcloud相当nice，不过在使用的时候，若是blog整体采用了非ascii码的编码格式(比如utf-8)就会出现类似这样的错误：

Liquid error: incompatible encoding regexp match (ascii-8bit regexp with utf-8 string)

其实是由于octopress-tagcloud的插件文件：plugins/tag_cloud.rb文件本身是ascii编码所致:

$ chardet tag_cloud.rb
tag_cloud.rb: ascii (confidence: 1.00)

tag_cloud.rb中很多地方用到了ruby的正则表达式，而ruby的正则表达式在匹配的时候，默认是按照“代码源文件”的编码格式(在这里是ascii)进行匹配的，而若我的blog是utf-8编码的话就会出现上述错误。

解决办法有二：

将tag_cloud.rb转成utf-8…
更改tag_cloud.rb中所有的正则表达式声明，加上u选项(根据这里的说明，u的意思就是以utf-8编码格式来进行匹配)，即，若原正则式是：/regexp/, 则改成：/regexp/u

这里是我改好的tag_cloud.rb：

# Tag Cloud for Octopress, modified by pf_miles, for use with utf-8 encoded blogs(all regexp added 'u' option). # ======================= # # Description: # ------------ # Easy output tag cloud and category list. # # Syntax: # ------- # {% tag_cloud [counter:true] %} # {% category_list [counter:true] %} # # Example: # -------- # In some template files, you can add the following markups. # # ### source/_includes/custom/asides/tag_cloud.html ### # # <section> # <h1>Tag Cloud</h1> # <span id="tag-cloud">{% tag_cloud %}</span> # </section> # # ### source/_includes/custom/asides/category_list.html ### # # <section> # <h1>Categories</h1> # <ul id="category-list">{% category_list counter:true %}</ul> # </section> # # Notes: # ------ # Be sure to insert above template files into `default_asides` array in `_config.yml`. # And also you can define styles for 'tag-cloud' or 'category-list' in a `.scss` file. # (ex: `sass/custom/_styles.scss`) # # Licence: # -------- # Distributed under the [MIT License][MIT]. # # [MIT]: http://www.opensource.org/licenses/mit-license.php # module Jekyll class TagCloud < Liquid::Tag def initialize(tag_name, markup, tokens) @opts = {} if markup.strip =~ /\s*counter:(\w+)/iu @opts['counter'] = $1 markup = markup.strip.sub(/counter:\w+/iu,'') end super end def render(context) lists = {} max, min = 1, 1 config = context.registers[:site].config category_dir = config['root'] + config['category_dir'] + '/' categories = context.registers[:site].categories categories.keys.sort_by{ |str| str.downcase }.each do |category| count = categories[category].count lists[category] = count max = count if count > max end html = '' lists.each do | category, counter | url = category_dir + category.gsub(/_|\P{Word}/u, '-').gsub(/-{2,}/u, '-').downcase style = "font-size: #{100 + (60 * Float(counter)/max)}%" html << "<a href='#{url}' style='#{style}'>#{category.capitalize}" if @opts['counter'] html << "(#{categories[category].count})" end html << "</a> " end html end end class CategoryList < Liquid::Tag def initialize(tag_name, markup, tokens) @opts = {} if markup.strip =~ /\s*counter:(\w+)/iu @opts['counter'] = $1 markup = markup.strip.sub(/counter:\w+/iu,'') end super end def render(context) html = "" config = context.registers[:site].config category_dir = config['root'] + config['category_dir'] + '/' categories = context.registers[:site].categories categories.keys.sort_by{ |str| str.downcase }.each do |category| url = category_dir + category.gsub(/_|\P{Word}/u, '-').gsub(/-{2,}/u, '-').downcase html << "<li><a href='#{url}'>#{category.capitalize}" if @opts['counter'] html << " (#{categories[category].count})" end html << "</a></li>" end html end end end Liquid::Template.register_tag('tag_cloud', Jekyll::TagCloud) Liquid::Template.register_tag('category_list', Jekyll::CategoryList)

Meta-Interpretation

Code, better explained.

Liquid Error About Regexp Match When Using Octopress-tagcloud

Comments