chris-canipe
commented
9 years ago I've handled this by passing the files through Rails (#172) and parsing the HAML like so:
HELPERS_TO_FILTER = [:notification]
HELPERS_TO_FILTER_REGEX = /
(?<==)
\s*
(?=
(?:#{HELPERS_TO_FILTER.join('|')})
\b
)
/x
HELPER_PREFIX = 'view_context.'
protected
def apply_styleguide_filters(html)
apply_example_output_filter(html)
html.to_html
end
def looks_like_haml?(string)
!!(string =~ /\A\s*[=%.#]/m)
end
private
def apply_example_output_filter(html)
html.css('.exampleOutput').each do |example_output|
example_output_content = example_output.content.strip
next unless looks_like_haml?(example_output_content)
example_output_with_prefixed_helpers =
prefix_helpers(example_output_content)
rendered_helper =
render_helper_from_haml(example_output_with_prefixed_helpers)
example_output.children.remove
example_output.add_child rendered_helper
end
end
# Helpers must be called within the controller's view context.
def prefix_helpers(string)
string.gsub(HELPERS_TO_FILTER_REGEX, HELPER_PREFIX)
end
def render_helper_from_haml(string)
begin
rendered_helper = Haml::Engine.new(string).render(binding)
rescue => e
raise "#{h(e)}<br><br>Perhaps this is a custom helper that needs filtering?".html_safe
end
Nokogiri::HTML::fragment(rendered_helper)
end
lovehasnologic
Out of the box, generating documentation that includes a rails helper in a haml_example code block results in the following error...
Does this need to be done with a custom renderer or is it not possible. Specifically, I'm looking at three types of helpers.
1. Common Rails Helpers
= link_to '#', '#'2. Gem Helpers
3. Custom Helpers from application.rb
= custom_icon_helper 'iconName'Thank you in advance. I tried to work through building a custom markdown renderer, but just ended up getting lost in my own head, as Ruby/Rails is not my expertise.