module Haml::Filters::Base

def self.included(base)

Parameters:
  • base (Module, Class) -- The module that this is included in
def self.included(base)
  Filters.defined[base.name.split("::").last.downcase] = base
  base.extend(base)
end

def compile(compiler, text)

Raises:
  • (Haml::Error) - if none of \{#compile}, \{#render}, and

Parameters:
  • text (String) -- The text of the filter
  • compiler (Haml::Compiler) -- The compiler instance
def compile(compiler, text)
  filter = self
  compiler.instance_eval do
    if contains_interpolation?(text)
      return if options[:suppress_eval]
      text = unescape_interpolation(text).gsub(/(\\+)n/) do |s|
        escapes = $1.size
        next s if escapes % 2 == 0
        ("\\" * (escapes - 1)) + "\n"
      end
      # We need to add a newline at the beginning to get the
      # filter lines to line up (since the Haml filter contains
      # a line that doesn't show up in the source, namely the
      # filter name). Then we need to escape the trailing
      # newline so that the whole filter block doesn't take up
      # too many.
      text = "\n" + text.sub(/\n"\Z/, "\\n\"")
      push_script <<RUBY.rstrip, :escape_html => false
nd_preserve(#{filter.inspect}.render_with_options(#{text}, _hamlout.options))
      return
    end
    rendered = Haml::Helpers::find_and_preserve(filter.render_with_options(text, compiler.options), compiler.options[:preserve])
    if options[:ugly]
      push_text(rendered.rstrip)
    else
      push_text(rendered.rstrip.gsub("\n", "\n#{'  ' * @output_tabs}"))
    end
  end
end

def internal_compile(*args)

Other tags:
    See: #compile -
def internal_compile(*args)
  compile(*args)
end

def render(text)

Raises:
  • (Haml::Error) - if it's not overridden

Returns:
  • (String) - The filtered result

Parameters:
  • text (String) -- The source text for the filter to process
def render(text)
  raise Error.new("#{self.inspect}#render not defined!")
end

def render_with_options(text, options)

Raises:
  • (Haml::Error) - if it or \{#render} isn't overridden

Returns:
  • (String) - The filtered result

Parameters:
  • text (String) -- The source text for the filter to process

Other tags:
    See: #render -
def render_with_options(text, options)
  render(text)
end