Втеча з подвійних фігурних дужок всередині блоку коду розмітки в Джекіллі

Я використовую Jekyll для створення документаційного сайту, де я намагаюся задокументувати якийсь код, що містить синтаксис, схожий на рулі. Наприклад {{foo}}. Проблема в тому, що Jekyll використовує рідкі мітки, і що б я не робив, мої подвійні кучері вириваються процесором рідини.

До речі, я використовую kramdown як процесор націнки.

Ось те, що я спробував:

{% highlight html linenos %}
  Hello, my name is {{name}}.
{% endhighlight %}

Цей повністю видаляє розділ {{name}}, оскільки вважає, що це посилання на змінну рідини.

Я також спробував це:

{% highlight html linenos %}
  Hello, my name is \{\{name\}\}.
{% endhighlight %}

У цьому випадку я намагаюся уникнути фігурних дужок, але результат полягає в тому, що косі риси відображаються на сторінці.

Я навіть спробував це:

{% highlight html linenos %}
  Hello, my name is <span>{</span>{name}}.
{% endhighlight %}

Слід визнати, що цей був досить німий. У цьому випадку, оскільки я вказав синтаксис як html (яким він повинен бути), тег span відображається на сторінці.

То як у світі я можу це вирішити?

Ви шукаєте {% raw %}мітку.

{% raw %}
Hello, my name is {{name}}.
{% endraw %}

Ви можете використовувати, {% raw %}щоб забезпечити незмінний зміст Jekyll:

{% raw %}
This is inserted literally: {{foo}}
{% endraw %}

Однак зауважте, що це не блок коду . Вам буде потрібно додаткове форматування коду, щоб ваш вміст відображався як код:

{% raw %}
    I'm a code block, because I'm indented by 4 spaces
{% endraw %}

{% raw %}
```handlebars
I'm a code block that contains {{handlebars}}
with highlighting.
```
{% endraw %}

З jekyll код:

{% highlight html%}
{% raw %}
     <h2> {{ user.name.first | uppercase }}</h2>
     <p> {{ user.email }}</p>
{% endraw %}
{% endhighlight %}

Для подальших довідок: використання простої {% raw %}та {% endraw %}є лише другим найкращим рішенням, оскільки вони показані, якщо ви шукаєте Націнку на звичайному github.com.

Кращий спосіб це поставити {% raw %}і {% endraw %}в коментарях HTML:

<!-- {% raw %} -->
something with curlky brackets like { this } and { that }
<!-- {% endraw %} -->

Завдяки коментарям HTML, Github розглядає їх як коментар. На сторінках Github сирі теги запобігають синтаксичному аналізу фігурних дужок між тегами.

Це працює в jekyll :

{%raw%}{{thing}}{%endraw%}