module ActionView module Helpers #:nodoc: # Provides a set of methods for working with text strings that can help unburden the level of inline Ruby code in the # templates. In the example below we iterate over a collection of posts provided to the template and prints each title # after making sure it doesn't run longer than 20 characters: # <% for post in @posts %> # Title: <%= truncate(post.title, 20) %> # <% end %> module TextHelper # The regular puts and print are outlawed in eRuby. It's recommended to use the <%= "hello" %> form instead of print "hello". # If you absolutely must use a method-based output, you can use concat. It's use like this <% concat "hello", binding %>. Notice that # it doesn't have an equal sign in front. Using <%= concat "hello" %> would result in a double hello. def concat(string, binding) eval("_erbout", binding).concat(string) end # Truncates +text+ to the length of +length+ and replaces the last three characters with the +truncate_string+ # if the +text+ is longer than +length+. def truncate(text, length = 30, truncate_string = "...") if text.nil? then return end if text.length > length then text[0..(length - 3)] + truncate_string else text end end # Highlights the +phrase+ where it is found in the +text+ by surrounding it like # I'm a highlight phrase. The highlighter can be specialized by # passing +highlighter+ as single-quoted string with \1 where the phrase is supposed to be inserted. # N.B.: The +phrase+ is sanitized to include only letters, digits, and spaces before use. def highlight(text, phrase, highlighter = '\1') if text.nil? || phrase.nil? then return end text.gsub(/(#{escape_regexp(phrase)})/i, highlighter) unless text.nil? end # Extracts an excerpt from the +text+ surrounding the +phrase+ with a number of characters on each side determined # by +radius+. If the phrase isn't found, nil is returned. Ex: # excerpt("hello my world", "my", 3) => "...lo my wo..." def excerpt(text, phrase, radius = 100, excerpt_string = "...") if text.nil? || phrase.nil? then return end phrase = escape_regexp(phrase) if found_pos = text =~ /(#{phrase})/i start_pos = [ found_pos - radius, 0 ].max end_pos = [ found_pos + phrase.length + radius, text.length ].min prefix = start_pos > 0 ? excerpt_string : "" postfix = end_pos < text.length ? excerpt_string : "" prefix + text[start_pos..end_pos].strip + postfix else nil end end # Attempts to pluralize the +singular+ word unless +count+ is 1. See source for pluralization rules. def pluralize(count, singular, plural = nil) "#{count} " + if count == 1 singular elsif plural plural elsif Object.const_defined?("Inflector") Inflector.pluralize(singular) else singular + "s" end end begin require "redcloth" # Returns the text with all the Textile codes turned into HTML-tags. # This method is only available if RedCloth can be required. def textilize(text) text.blank? ? "" : RedCloth.new(text, [ :hard_breaks ]).to_html end # Returns the text with all the Textile codes turned into HTML-tags, but without the regular bounding

tag. # This method is only available if RedCloth can be required. def textilize_without_paragraph(text) textiled = textilize(text) if textiled[0..2] == "

" then textiled = textiled[3..-1] end if textiled[-4..-1] == "

" then textiled = textiled[0..-5] end return textiled end rescue LoadError # We can't really help what's not there end begin require "bluecloth" # Returns the text with all the Markdown codes turned into HTML-tags. # This method is only available if BlueCloth can be required. def markdown(text) text.blank? ? "" : BlueCloth.new(text).to_html end rescue LoadError # We can't really help what's not there end # Returns +text+ transformed into html using very simple formatting rules # Surrounds paragraphs with <p> tags, and converts line breaks into <br /> # Two consecutive newlines(\n\n) are considered as a paragraph, one newline (\n) is # considered a linebreak, three or more consecutive newlines are turned into two newlines def simple_format(text) text.gsub!(/(\r\n|\n|\r)/, "\n") # lets make them newlines crossplatform text.gsub!(/\n\n+/, "\n\n") # zap dupes text.gsub!(/\n\n/, '

\0

') # turn two newlines into paragraph text.gsub!(/([^\n])(\n)([^\n])/, '\1\2
\3') # turn single newline into
return '

' + text + '

' # wrap the first and last line in paragraphs before we're done end # Turns all urls and email addresses into clickable links. The +link+ parameter can limit what should be linked. # Options are :all (default), :email_addresses, and :urls. # # Example: # auto_link("Go to http://www.rubyonrails.com and say hello to david@loudthinking.com") => # Go to http://www.rubyonrails.com and # say hello to david@loudthinking.com def auto_link(text, link = :all) case link when :all then auto_link_urls(auto_link_email_addresses(text)) when :email_addresses then auto_link_email_addresses(text) when :urls then auto_link_urls(text) end end # Turns all links into words, like "else" to "else". def strip_links(text) text.gsub(/(.*)<\/a>/m, '\1') end # Returns a formatted-for-humans file size. # # Examples: # human_size(123) => 123 Bytes # human_size(1234) => 1.2 KB # human_size(12345) => 12.1 KB # human_size(1234567) => 1.2 MB # human_size(1234567890) => 1.1 GB def human_size(size) begin return "%d Bytes" % size if size < 1.kilobytes return "%.1f KB" % (size/1.0.kilobytes) if size < 1.megabytes return "%.1f MB" % (size/1.0.megabytes) if size < 1.gigabytes return "%.1f GB" % (size/1.0.gigabytes) if size < 1.terabytes return "%.1f TB" % (size/1.0.terabytes) rescue # just return nothing end end private # Returns a version of the text that's safe to use in a regular expression without triggering engine features. def escape_regexp(text) text.gsub(/([\\|?+*\/\)\(])/) { |m| "\\#{$1}" } end # Turns all urls into clickable links. def auto_link_urls(text) text.gsub(/([^=>\3\4\5\6\7') end # Turns all email addresses into clickable links. def auto_link_email_addresses(text) text.gsub(/([\w\.!#\$%\-+.]+@[A-Za-z0-9\-]+(\.[A-Za-z0-9\-]+)+)/, '\1') end end end end