在 ERB 块中的字符串内包含 ERB 分隔符

我正在编写一个显示代码以及输出的样式指南。目前它的结构使得代码只需要描述一次，并以原始版本和解释版本显示，如下所示：

<% code = <<PLACE_THE_EXAMPLE_CODE_BETWEEN_THESE_TWO_LINES_EXACTLY_AS_YOU_WANT_IT_TO_APPEAR
<div>
  #{ image_tag 'image.png' }
</div>  
PLACE_THE_EXAMPLE_CODE_BETWEEN_THESE_TWO_LINES_EXACTLY_AS_YOU_WANT_IT_TO_APPEAR
%>

<%= raw code %>
<%= content_tag :pre, code, class: "prettyprint linenums" %>

这很棒，而且相当容易维护。问题出在 Rails 助手上，比如image_tag在上面的例子中。视图示例正确显示 div 中的图像，代码示例显示相关 HTML。在这种情况下，相关的 HTML 包含一个锚标记 - 的结果image_tag方法，而不是调用本身。

我更喜欢代码示例来显示辅助方法，而不是它们的结果。我可以通过在文件中指定示例代码并渲染或读取文件来完成这项工作。我更愿意通过在变量中指定代码来完成这项工作，如上所述，但我似乎无法让 ERB 分隔符在 erb 块内的字符串内部工作。即使是最简单的情况<% foo = '<%= bar %>' %>根本不起作用。我尝试过使用语法（<%% %%> and % %例如），使用来自官方文档，但没有取得太大成功。

我能找到的关于此事的唯一信息是here, using <%= "<" + "%=" %> link_to <%= image.css_tag.humanize %> <%= "%" + ">" %> %>，这在此用例中不起作用（如果有的话）。

那么，有没有办法指定包含 ERB 结束分隔符的字符串（%>) 在 ERB 字符串中，或​​者我是否一直使用稍微笨拙的文件读取方法？谢谢！

Edit:

我最终想要的是一个工作版本：

<%# Idealized code - does not work %>
<% code = <<PLACE_THE_EXAMPLE_CODE_BETWEEN_THESE_TWO_LINES_EXACTLY_AS_YOU_WANT_IT_TO_APPEAR
<div>
  <% image_tag 'image.png' %>
</div>  
PLACE_THE_EXAMPLE_CODE_BETWEEN_THESE_TWO_LINES_EXACTLY_AS_YOU_WANT_IT_TO_APPEAR
%>

So that <%= raw code %>将（继续）输出：

<div>
  <img src="/images/image.png" alt="Image" />
</div>

And <%= content_tag :pre, code, class: "prettyprint linenums" %>会输出：

<pre class="prettyprint linenums">
  <div>
    <% image_tag 'image.png' %>
  </div>  
</pre>

而不是它当前使用变量时所做的事情，即：

<pre class="prettyprint linenums">
  <div>
    <img src="/images/image.png" alt="Image" />
  </div>
</pre>

我希望用户能够复制代码示例并将其粘贴到新视图中，而无需将 HTML 翻译回生成它们的帮助程序。我认为我基本上需要的是一个替代的 ERB 分隔符，就像' and "（甚至%q{}) 因字符串而异。看起来，即使最终的 ERB 分隔符出现在字符串内部，它实际上也是作为块的末尾进行处理的。最简单的情况是<% foo = '<%= bar %>' %>在某种程度上展示了我想要实现的目标。在生成器中，您可以使用<% foo = '<%%= bar %>' %>（或类似的东西），告诉它不要当场作为 ERB 进行处理。从文件读取时，甚至在纯 rb 文件（如助手）中读取时，这一切都可以正常工作，但在这种情况下，将其放入视图中是最有意义的，因为它的目的是让我们可以轻松操作设计师。

如果我理解正确，那么您真正的问题是，就插值而言，heredocs 的行为类似于双引号。因此，您所需要的只是一个行为类似于单引号的引用机制。 Ruby 有很多字符串引用机制，特别是我们有%q{...}:

<% code = %q{
<div>
  #{ image_tag 'image.png' }
</div>  
} %>

如果您愿意，可以使用其他分隔符：%q|...|, %q(...)当然还是有变化，但至少你不用担心插值问题。

如果你确实想使用heredoc，你可以指定带引号的定界符终止符并且相应的引用样式将应用于内容：

<% code = <<'PLACE_THE_EXAMPLE_CODE_BETWEEN_THESE_TWO_LINES_EXACTLY_AS_YOU_WANT_IT_TO_APPEAR'
<div>
  #{ image_tag 'image.png' }
</div>  
PLACE_THE_EXAMPLE_CODE_BETWEEN_THESE_TWO_LINES_EXACTLY_AS_YOU_WANT_IT_TO_APPEAR
%>

中的单引号<<'PLACE...'指定单引号规则（即无插值）适用于此处文档的内容。

当然，这些东西都不适用于嵌入式 ERB，如下所示：

<% code = %q{
<div>
  <% ... %>
</div>  
} %>

因为 ERB 解析器会看到第一个%>作为外部的结束分隔符<% code...部分。不用担心，我想我有一个计划，可以在不涉及严重黑客攻击或太多工作的情况下发挥作用。

一些预备知识:

• 导轨用途Erubis用于 ERB 处理。
• Erubis 让您能够更改分隔符:pattern option到它的构造函数。
• 导轨用途Tilt and 链轮处理模板处理管道，这些允许您做出正确的事情pancakes.js.coffee.erb以正确的顺序。

使用上面的内容，您可以添加自己的模板格式，即具有不同分隔符的 ERB，并且您可以让 Rails 使用这种新格式来处理您的“特殊”部分，然后正常的 ERB 处理会造成混乱。

首先你需要连接Tilt。如果你看一下lib/tilt/erb.rb在你的 Tilt 安装中，你会看到 Erubis 的东西Tilt::ErubisTemplate在底部。你应该能够子类化Tilt::ErubisTemplate并提供一个prepare覆盖添加，比如说，:pattern => '<!--% %-->'选项和弃踢到超类。然后在 Rails 初始化程序中使用 Tilt 和 Sprockets 注册它，如下所示：

Tilt.register(Your::Template::Subclass, 'klerb') # "kl" for "kludge" :)
Rails.application.assets.register_engine('.klerb', Your::Template::Subclass)

现在您的应用程序应该能够处理.klerb文件与<!--% ... %-->作为模板分隔符。您还可以使用以下名称将您的 klerb 与 erb 链接起来pancakes.html.erb.klerb文件将在 ERB 之前经过 klerb；这意味着像这样的模板（在一个名为whatever.html.erb.klerb):

<!--% code = <<PLACE_THE_EXAMPLE_CODE_BETWEEN_THESE_TWO_LINES_EXACTLY_AS_YOU_WANT_IT_TO_APPEAR
<div>
  <% image_tag 'image.png' %>
</div>  
PLACE_THE_EXAMPLE_CODE_BETWEEN_THESE_TWO_LINES_EXACTLY_AS_YOU_WANT_IT_TO_APPEAR
%-->
<!--%= "code = escape_the_erb_as_needed(%q{#{code}})" %-->
<% do_normal_erb_stuff %>

会做正确的事。

你需要一个帮助者来实现escape_the_erb_as_needed当然是功能性；一些小实验应该可以帮助你弄清楚什么需要逃避以及以什么方式逃避。

所有这些可能看起来有点复杂，但实际上非常简单。我使用 Tilt 和 Sprockets 添加了自定义模板处理步骤，最终结果非常简单；弄清楚要做哪些简单的事情需要一些工作，但我已经为您完成了这项工作：

1. Tilt::Template子类，你可以通过小猪支持来得到这个Tilt::ErubisTemplate.
2. 通过拨打电话注册 TiltTilt.register.
3. 通过致电注册 SprocketsRails.application.assets.register_engine.
4. ...
5. Profit.