Jekyll'de bir markdown kod bloğu içinde çift küme parantezinden kaçış

Gidon benzeri sözdizimi içeren bazı kodları belgelemeye çalıştığım bir dokümantasyon sitesi oluşturmak için Jekyll kullanıyorum. Örneğin {{foo}}. Sorun şu ki, Jekyll sıvı etiketler kullanıyor ve ne yaparsam yapayım, çift kıvrımlarım sıvı işlemci tarafından koparılıyor.

Bu arada, markdown işlemcisi olarak kramdown kullanıyorum.

İşte denediğim bir şey:

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

Bu, {{isim}} bölümünü tamamen kaldırır çünkü bunun bir likit değişkene referans olduğunu düşünür.

Bunu da denedim:

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

Bu durumda, küme parantezlerinden kaçmaya çalışıyorum, ancak sonuç olarak eğik çizgiler sayfaya işleniyor.

Bunu bile denedim:

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

Kuşkusuz bu oldukça aptalcaydı. Bu durumda, sözdizimini html (olması gereken) olarak belirlediğim için, span etiketi sayfada işleniyor.

Peki bunu nasıl çözebilirim?

{% raw %}Etiketi arıyorsunuz .

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

{% raw %}İçeriğin Jekyll tarafından değiştirilmediğinden emin olmak için kullanabilirsiniz :

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

Ancak, bunun bir kod bloğu olmadığını unutmayın . İçeriğinizin kod olarak işlenmesini sağlamak için ek kod biçimlendirmesine ihtiyacınız olacak:

{% 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 ile kod:

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

Gelecekteki referanslar için: normal github.com'da Markdown'a bakarsanız gösterildiğinden, sade {% raw %}ve {% endraw %}yalnızca ikinci en iyi çözümdür.

En iyi yol, HTML yorumları koymak {% raw %}ve {% endraw %}eklemektir:

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

HTML yorumları nedeniyle Github tarafından yorum olarak görülür. Github sayfalarında ham etiketler, etiketler arasındaki süslü parantezlerin ayrıştırılmasını önleyecektir.

Bu jekyll'de çalışır :

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